uk.ac.ed.ph.snuggletex.internal.util

类 XMLUtilities

java.lang.Object

uk.ac.ed.ph.snuggletex.internal.util.XMLUtilities

public final class XMLUtilities
extends java.lang.Object

Some trivial little helpers for creating suitably-configured TransformerFactory instances.

(This is based on similar utility methods in ph-commons.)

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	SAXON_TRANSFORMER_FACTORY_CLASS_NAME Explicit name of the SAXON 9.X TransformerFactoryImpl Class, as used by the up-conversion extensions

构造器概要

构造器

构造器和说明
XMLUtilities()

方法概要

限定符和类型	方法和说明
static javax.xml.transform.TransformerFactory	createJAXPTransformerFactory() Creates an instance of the currently specified JAXP TransformerFactory, ensuring that the result supports the DOMSource.FEATURE and DOMResult.FEATURE features.
static javax.xml.parsers.DocumentBuilder	createNSAwareDocumentBuilder() Creates a (namespace-aware) DOM DocumentBuilder, throwing a SnuggleRuntimeException if such a thing cannot be created/configured.
static javax.xml.transform.TransformerFactory	createSaxonTransformerFactory() Explicitly creates a Saxon 9 TransformerFactory, as used by the up-conversion extensions.
static java.lang.String	extractTextElementValue(org.w3c.dom.Element textElement) Trivial convenience method to extract the value of a (text) Element, coping with the possibility that text child Nodes may not have been coalesced.
static boolean	isSaxonAvailable()
static boolean	isXMLName(java.lang.String string)
static boolean	isXMLNCName(java.lang.String string)
static void	requireFeature(javax.xml.transform.TransformerFactory transformerFactory, java.lang.String feature)
static java.lang.String	serializeNode(org.w3c.dom.Node node, SerializationSpecifier serializationOptions) Serializes the given Node to a well-formed external parsed entity.
static java.lang.String	serializeNode(StylesheetManager stylesheetManager, org.w3c.dom.Node node, SerializationSpecifier serializationOptions) Serializes the given Node to a well-formed external parsed entity.
static java.lang.String	serializeNodeChildren(StylesheetManager stylesheetManager, org.w3c.dom.Node node, SerializationSpecifier serializationOptions) Serializes the children of given Node to a well-formed external parsed entity.
static void	setIndentation(javax.xml.transform.Transformer transformer, int indent) Helper to turn on indentation for a Transformer that works correctly for both Saxon and Xalan.
static boolean	supportsXSLT20(javax.xml.transform.Transformer tranformer)
static boolean	supportsXSLT20(javax.xml.transform.TransformerFactory tranformerFactory) Tests whether the given TransformerFactory is known to support XSLT 2.0.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

SAXON_TRANSFORMER_FACTORY_CLASS_NAME

public static final java.lang.String SAXON_TRANSFORMER_FACTORY_CLASS_NAME

Explicit name of the SAXON 9.X TransformerFactoryImpl Class, as used by the up-conversion extensions

另请参阅:

常量字段值

构造器详细资料

XMLUtilities

public XMLUtilities()

方法详细资料

createJAXPTransformerFactory

public static javax.xml.transform.TransformerFactory createJAXPTransformerFactory()

Creates an instance of the currently specified JAXP TransformerFactory, ensuring that the result supports the DOMSource.FEATURE and DOMResult.FEATURE features.

requireFeature

public static void requireFeature(javax.xml.transform.TransformerFactory transformerFactory,
                                  java.lang.String feature)

isSaxonAvailable

public static boolean isSaxonAvailable()

createSaxonTransformerFactory

public static javax.xml.transform.TransformerFactory createSaxonTransformerFactory()

Explicitly creates a Saxon 9 TransformerFactory, as used by the up-conversion extensions.

supportsXSLT20

public static boolean supportsXSLT20(javax.xml.transform.TransformerFactory tranformerFactory)

Tests whether the given TransformerFactory is known to support XSLT 2.0.

(Currently, this involves checking for a suitable version of Saxon; this will change once more processors become available.)

supportsXSLT20

public static boolean supportsXSLT20(javax.xml.transform.Transformer tranformer)

setIndentation

public static void setIndentation(javax.xml.transform.Transformer transformer,
                                  int indent)

Helper to turn on indentation for a Transformer that works correctly for both Saxon and Xalan.

参数:

transformer - Transformer to configure

indent - required indentation, where 0 or more provides indentation and negative numbers turns indentation off.

createNSAwareDocumentBuilder

public static javax.xml.parsers.DocumentBuilder createNSAwareDocumentBuilder()

Creates a (namespace-aware) DOM DocumentBuilder, throwing a SnuggleRuntimeException if such a thing cannot be created/configured.

extractTextElementValue

public static java.lang.String extractTextElementValue(org.w3c.dom.Element textElement)

Trivial convenience method to extract the value of a (text) Element, coping with the possibility that text child Nodes may not have been coalesced.

参数:

textElement -

serializeNode

public static java.lang.String serializeNode(org.w3c.dom.Node node,
                                             SerializationSpecifier serializationOptions)

Serializes the given Node to a well-formed external parsed entity. (If the given Node is an Element or a Document then the result will be a well-formed XML String.)

参数:

node - DOM Node to serialize.

serializationOptions - XML serialization options

serializeNode

public static java.lang.String serializeNode(StylesheetManager stylesheetManager,
                                             org.w3c.dom.Node node,
                                             SerializationSpecifier serializationOptions)

Serializes the given Node to a well-formed external parsed entity. (If the given Node is an Element or a Document then the result will be a well-formed XML String.)

(This may use an XSLT 2.0 stylesheet to help with named entities, hence the requirement for a StylesheetManager).

参数:

stylesheetManager - used to help compile and cache stylesheets used in this process.

node - DOM Node to serialize.

serializationOptions - XML serialization options

serializeNodeChildren

public static java.lang.String serializeNodeChildren(StylesheetManager stylesheetManager,
                                                     org.w3c.dom.Node node,
                                                     SerializationSpecifier serializationOptions)

Serializes the children of given Node to a well-formed external parsed entity.

(This uses a little XSLT stylesheet to help, hence the requirement for a StylesheetManager).

参数:

stylesheetManager - used to help compile and cache stylesheets used in this process.

node - DOM Node to serialize.

serializationOptions - XML serialization options

isXMLName

public static boolean isXMLName(java.lang.String string)

isXMLNCName

public static boolean isXMLNCName(java.lang.String string)