Top Description Fields Constructors Methods
tools.jackson.dataformat.xml

public Class XmlFactoryBuilder

extends DecorableTSFactory.DecorableTSFBuilder<XmlFactory, XmlFactoryBuilder>
Class Inheritance
Imports
javax.xml.stream.FactoryConfigurationError, .XMLInputFactory, .XMLOutputFactory, tools.jackson.core.ErrorReportConfiguration, .StreamReadConstraints, .StreamWriteConstraints, tools.jackson.core.base.DecorableTSFactory.DecorableTSFBuilder, tools.jackson.dataformat.xml.deser.FromXmlParser

tools.jackson.core.TSFBuilder implementation for constructing XmlFactory instances.

Field Summary

Modifier and TypeField and Description
protected ClassLoader
_classLoaderForStax

Optional ClassLoader to use for constructing XMLInputFactory and XMLOutputFactory instances if not explicitly specified by caller.

protected int
_formatGeneratorFeatures

Set of ToXmlGenerator.Features enabled, as bitmask.

protected int
_formatParserFeatures

Set of FromXmlParser.Features enabled, as bitmask.

protected String
_nameForTextElement

In cases where a start element has both attributes and non-empty textual value, we have to create a bogus property; we will use this as the property name.

protected XmlNameProcessor
protected XMLInputFactory
_xmlInputFactory

Stax factory for creating underlying input stream readers; `null` for "use default instance with default settings"

protected XMLOutputFactory
_xmlOutputFactory

Stax factory for creating underlying output stream writers; `null` for "use default instance with default settings"

Inherited from tools.jackson.core.base.DecorableTSFactory.DecorableTSFBuilder:
_generatorDecorators_inputDecorator_outputDecorator

Constructor Summary

AccessConstructor and Description
protected
public

Method Summary

Modifier and TypeMethod and Description
public XmlFactory
build()

Implements abstract tools.jackson.core.TSFBuilder.build.

Method for constructing actual TokenStreamFactory instance, given configuration.

public XmlFactoryBuilder
configure(XmlReadFeature f, boolean state)

public XmlFactoryBuilder
configure(XmlWriteFeature f, boolean state)

protected XMLInputFactory
protected static XMLInputFactory
protected XMLOutputFactory
protected static XMLOutputFactory
public XmlFactoryBuilder
public XmlFactoryBuilder
public XmlFactoryBuilder
public XmlFactoryBuilder
public XmlFactoryBuilder
public XmlFactoryBuilder
public XmlFactoryBuilder
public XmlFactoryBuilder
public String
public XmlFactoryBuilder
protected ClassLoader
public XmlFactoryBuilder
staxClassLoader(ClassLoader cl)

Method that can be used to specific ClassLoader for creating XMLInputFactory and XMLOutputFactory instances if those are not explicitly defined by caller: passed to respective newFactory() methods.

public XMLInputFactory
public XmlFactoryBuilder
public XmlNameProcessor
public XmlFactoryBuilder
public XMLOutputFactory
public XmlFactoryBuilder
Inherited from tools.jackson.core.base.DecorableTSFactory.DecorableTSFBuilder:
addDecoratorgeneratorDecoratorsinputDecoratorinputDecoratoroutputDecoratoroutputDecorator

Field Detail

_classLoaderForStaxback to summary
protected ClassLoader _classLoaderForStax

Optional ClassLoader to use for constructing XMLInputFactory and XMLOutputFactory instances if not explicitly specified by caller. If not specified, will default to ClassLoader that loaded this class.

_formatGeneratorFeaturesback to summary
protected int _formatGeneratorFeatures

Set of ToXmlGenerator.Features enabled, as bitmask.

_formatParserFeaturesback to summary
protected int _formatParserFeatures

Set of FromXmlParser.Features enabled, as bitmask.

_nameForTextElementback to summary
protected String _nameForTextElement

In cases where a start element has both attributes and non-empty textual value, we have to create a bogus property; we will use this as the property name.

Name used for pseudo-property used for returning XML Text value (which does not have actual element name to use). Defaults to empty String, but may be changed for inter-operability reasons: JAXB, for example, uses "value" as name.

_nameProcessorback to summary
protected XmlNameProcessor _nameProcessor

See XmlNameProcessor and XmlNameProcessors

_xmlInputFactoryback to summary
protected XMLInputFactory _xmlInputFactory

Stax factory for creating underlying input stream readers; `null` for "use default instance with default settings"

_xmlOutputFactoryback to summary
protected XMLOutputFactory _xmlOutputFactory

Stax factory for creating underlying output stream writers; `null` for "use default instance with default settings"

Constructor Detail

XmlFactoryBuilderback to summary
protected XmlFactoryBuilder()
XmlFactoryBuilderback to summary
public XmlFactoryBuilder(XmlFactory base)

Method Detail

buildback to summary
public XmlFactory build()

Implements abstract tools.jackson.core.TSFBuilder.build.

Doc from tools.jackson.core.TSFBuilder.build.

Method for constructing actual TokenStreamFactory instance, given configuration.

Annotations
@Override
configureback to summary
public XmlFactoryBuilder configure(XmlReadFeature f, boolean state)
configureback to summary
public XmlFactoryBuilder configure(XmlWriteFeature f, boolean state)
defaultXmlInputFactoryback to summary
protected XMLInputFactory defaultXmlInputFactory()
defaultXmlInputFactoryback to summary
protected static XMLInputFactory defaultXmlInputFactory(ClassLoader cl)
defaultXmlOutputFactoryback to summary
protected XMLOutputFactory defaultXmlOutputFactory()
defaultXmlOutputFactoryback to summary
protected static XMLOutputFactory defaultXmlOutputFactory(ClassLoader cl)
disableback to summary
public XmlFactoryBuilder disable(XmlReadFeature f)
disableback to summary
public XmlFactoryBuilder disable(XmlReadFeature first, XmlReadFeature... other)
disableback to summary
public XmlFactoryBuilder disable(XmlWriteFeature f)
disableback to summary
public XmlFactoryBuilder disable(XmlWriteFeature first, XmlWriteFeature... other)
enableback to summary
public XmlFactoryBuilder enable(XmlReadFeature f)
enableback to summary
public XmlFactoryBuilder enable(XmlReadFeature first, XmlReadFeature... other)
enableback to summary
public XmlFactoryBuilder enable(XmlWriteFeature f)
enableback to summary
public XmlFactoryBuilder enable(XmlWriteFeature first, XmlWriteFeature... other)
nameForTextElementback to summary
public String nameForTextElement()
nameForTextElementback to summary
public XmlFactoryBuilder nameForTextElement(String name)
staxClassLoaderback to summary
protected ClassLoader staxClassLoader()
staxClassLoaderback to summary
public XmlFactoryBuilder staxClassLoader(ClassLoader cl)

Method that can be used to specific ClassLoader for creating XMLInputFactory and XMLOutputFactory instances if those are not explicitly defined by caller: passed to respective newFactory() methods.

Note

recommended approach is to explicitly pass XMLInputFactory and XMLOutputFactory methods instead of relying on JDK SPI mechanism.

xmlInputFactoryback to summary
public XMLInputFactory xmlInputFactory()
xmlInputFactoryback to summary
public XmlFactoryBuilder xmlInputFactory(XMLInputFactory xmlIn)
xmlNameProcessorback to summary
public XmlNameProcessor xmlNameProcessor()
xmlNameProcessorback to summary
public XmlFactoryBuilder xmlNameProcessor(XmlNameProcessor nameProcessor)
xmlOutputFactoryback to summary
public XMLOutputFactory xmlOutputFactory()
xmlOutputFactoryback to summary
public XmlFactoryBuilder xmlOutputFactory(XMLOutputFactory xmlOut)