Top Description Fields Constructors Methods
com.fasterxml.jackson.dataformat.xml

public Class XmlFactoryBuilder

extends TSFBuilder<XmlFactory, XmlFactoryBuilder>
Class Inheritance
Imports
javax.xml.stream.XMLInputFactory, .XMLOutputFactory, com.fasterxml.jackson.core.TSFBuilder, com.fasterxml.jackson.dataformat.xml.deser.FromXmlParser, com.fasterxml.jackson.dataformat.xml.ser.ToXmlGenerator, com.fasterxml.jackson.dataformat.xml.util.StaxUtil

com.fasterxml.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 {@kink XMLOutputFactory} instances if not explicitly specified by caller.

protected int
_formatGeneratorFeatures

Set of {@@ code ToXmlGenerator.Feature}s 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 com.fasterxml.jackson.core.TSFBuilder:
_errorReportConfiguration_factoryFeatures_generatorDecorators_inputDecorator_outputDecorator_recyclerPool_streamReadConstraints_streamReadFeatures_streamWriteConstraints_streamWriteFeaturesDEFAULT_FACTORY_FEATURE_FLAGSDEFAULT_GENERATOR_FEATURE_FLAGSDEFAULT_PARSER_FEATURE_FLAGS

Constructor Summary

AccessConstructor and Description
protected
public

Method Summary

Modifier and TypeMethod and Description
public XmlFactory
build()

Implements abstract com.fasterxml.jackson.core.TSFBuilder.build.

Method for constructing actual TokenStreamFactory instance, given configuration.
public XmlFactoryBuilder
configure(FromXmlParser.Feature f, boolean state)

public XmlFactoryBuilder
configure(ToXmlGenerator.Feature f, boolean state)

protected XMLInputFactory
protected XMLOutputFactory
public XmlFactoryBuilder
public XmlFactoryBuilder
public XmlFactoryBuilder
public XmlFactoryBuilder
public XmlFactoryBuilder
public XmlFactoryBuilder
public XmlFactoryBuilder
public XmlFactoryBuilder
public int
public int
public XmlFactoryBuilder
inputFactory(XMLInputFactory xmlIn)

Deprecated Since 2.13 use xmlInputFactory() instead
public String
public XmlFactoryBuilder
public XmlFactoryBuilder
outputFactory(XMLOutputFactory xmlOut)

Deprecated Since 2.13 use xmlOutputFactory() instead
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 com.fasterxml.jackson.core.TSFBuilder:
_copy_legacyDisable_legacyDisable_legacyEnable_legacyEnable_thisaddDecoratorconfigureconfigureconfigureconfigureconfiguredisabledisabledisabledisabledisabledisabledisabledisabledisableenableenableenableenableenableenableenableenableenableerrorReportConfigurationfactoryFeaturesMaskinputDecoratorinputDecoratoroutputDecoratoroutputDecoratorrecyclerPoolrecyclerPoolstreamReadConstraintsstreamReadFeaturesstreamWriteConstraintsstreamWriteFeatures

Field Detail

_classLoaderForStaxback to summary
protected ClassLoader _classLoaderForStax

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

Since
2.13
_formatGeneratorFeaturesback to summary
protected int _formatGeneratorFeatures

Set of {@@ code ToXmlGenerator.Feature}s 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 interoperability reasons: JAXB, for example, uses "value" as name.

_nameProcessorback to summary
protected XmlNameProcessor _nameProcessor

See XmlNameProcessor and XmlNameProcessors

Since
2.14
_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 com.fasterxml.jackson.core.TSFBuilder.build.

Doc from com.fasterxml.jackson.core.TSFBuilder.build.

Method for constructing actual TokenStreamFactory instance, given configuration.

Returns:XmlFactory

TokenStreamFactory build based on current configuration

Annotations
@Override
configureback to summary
public XmlFactoryBuilder configure(FromXmlParser.Feature f, boolean state)
configureback to summary
public XmlFactoryBuilder configure(ToXmlGenerator.Feature f, boolean state)
defaultInputFactoryback to summary
protected XMLInputFactory defaultInputFactory()
defaultOutputFactoryback to summary
protected XMLOutputFactory defaultOutputFactory()
disableback to summary
public XmlFactoryBuilder disable(FromXmlParser.Feature f)
disableback to summary
public XmlFactoryBuilder disable(FromXmlParser.Feature first, FromXmlParser.Feature... other)
disableback to summary
public XmlFactoryBuilder disable(ToXmlGenerator.Feature f)
disableback to summary
public XmlFactoryBuilder disable(ToXmlGenerator.Feature first, ToXmlGenerator.Feature... other)
enableback to summary
public XmlFactoryBuilder enable(FromXmlParser.Feature f)
enableback to summary
public XmlFactoryBuilder enable(FromXmlParser.Feature first, FromXmlParser.Feature... other)
enableback to summary
public XmlFactoryBuilder enable(ToXmlGenerator.Feature f)
enableback to summary
public XmlFactoryBuilder enable(ToXmlGenerator.Feature first, ToXmlGenerator.Feature... other)
formatGeneratorFeaturesMaskback to summary
public int formatGeneratorFeaturesMask()
formatParserFeaturesMaskback to summary
public int formatParserFeaturesMask()
inputFactoryback to summary
public XmlFactoryBuilder inputFactory(XMLInputFactory xmlIn)

Deprecated

Since 2.13 use xmlInputFactory() instead

Annotations
@Deprecated
nameForTextElementback to summary
public String nameForTextElement()
nameForTextElementback to summary
public XmlFactoryBuilder nameForTextElement(String name)
outputFactoryback to summary
public XmlFactoryBuilder outputFactory(XMLOutputFactory xmlOut)

Deprecated

Since 2.13 use xmlOutputFactory() instead

Annotations
@Deprecated
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.

Since
2.13
xmlInputFactoryback to summary
public XMLInputFactory xmlInputFactory()
xmlInputFactoryback to summary
public XmlFactoryBuilder xmlInputFactory(XMLInputFactory xmlIn)
Since
2.13 (was misnamed as inputFactory(in) formerly)
xmlNameProcessorback to summary
public XmlNameProcessor xmlNameProcessor()
xmlNameProcessorback to summary
public XmlFactoryBuilder xmlNameProcessor(XmlNameProcessor nameProcessor)
Since
2.14
xmlOutputFactoryback to summary
public XMLOutputFactory xmlOutputFactory()
xmlOutputFactoryback to summary
public XmlFactoryBuilder xmlOutputFactory(XMLOutputFactory xmlOut)
Since
2.13 (was misnamed as outputFactory(in) formerly)