com.fasterxml.jackson.dataformat.xml

Class XmlFactory

java.lang.Object

com.fasterxml.jackson.core.TokenStreamFactory

com.fasterxml.jackson.core.JsonFactory

com.fasterxml.jackson.dataformat.xml.XmlFactory

All Implemented Interfaces:

com.fasterxml.jackson.core.Versioned, Serializable

public class XmlFactory
extends com.fasterxml.jackson.core.JsonFactory

Factory used for constructing FromXmlParser and ToXmlGenerator instances.

Implements JsonFactory since interface for constructing XML backed parsers and generators is quite similar to dealing with JSON.

Author:

Tatu Saloranta (tatu.saloranta@iki.fi)

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.fasterxml.jackson.core.JsonFactory

com.fasterxml.jackson.core.JsonFactory.Feature

Field Summary

Fields

Modifier and Type	Field and Description
protected String	_cfgNameForTextElement
protected String	_jdkXmlInFactory Hiding place for JDK-serialization unthawed factories...
protected String	_jdkXmlOutFactory Hiding place for JDK-serialization unthawed factories...
protected XmlNameProcessor	_nameProcessor
protected int	_xmlGeneratorFeatures
protected XMLInputFactory	_xmlInputFactory
protected XMLOutputFactory	_xmlOutputFactory
protected int	_xmlParserFeatures
static String	FORMAT_NAME_XML Name used to identify XML format (and returned by getFormatName()

Fields inherited from class com.fasterxml.jackson.core.JsonFactory

_byteSymbolCanonicalizer, _characterEscapes, _factoryFeatures, _generatorFeatures, _inputDecorator, _maximumNonEscapedChar, _objectCodec, _outputDecorator, _parserFeatures, _quoteChar, _rootCharSymbols, _rootValueSeparator, DEFAULT_FACTORY_FEATURE_FLAGS, DEFAULT_GENERATOR_FEATURE_FLAGS, DEFAULT_PARSER_FEATURE_FLAGS, DEFAULT_QUOTE_CHAR, DEFAULT_ROOT_VALUE_SEPARATOR, FORMAT_NAME_JSON

Constructor Summary

Constructors

Modifier	Constructor and Description
	XmlFactory() Default constructor used to create factory instances.
	XmlFactory(com.fasterxml.jackson.core.ObjectCodec oc)
	XmlFactory(com.fasterxml.jackson.core.ObjectCodec oc, int xpFeatures, int xgFeatures, XMLInputFactory xmlIn, XMLOutputFactory xmlOut, String nameForTextElem)
protected	XmlFactory(com.fasterxml.jackson.core.ObjectCodec oc, int xpFeatures, int xgFeatures, XMLInputFactory xmlIn, XMLOutputFactory xmlOut, String nameForTextElem, XmlNameProcessor nameProcessor)
	XmlFactory(com.fasterxml.jackson.core.ObjectCodec oc, XMLInputFactory xmlIn, XMLOutputFactory xmlOut)
protected	XmlFactory(XmlFactoryBuilder b) Constructors used by JsonFactoryBuilder for instantiation.
protected	XmlFactory(XmlFactory src, com.fasterxml.jackson.core.ObjectCodec oc)
	XmlFactory(XMLInputFactory xmlIn)
	XmlFactory(XMLInputFactory xmlIn, XMLOutputFactory xmlOut)

Method Summary

Modifier and Type	Method and Description
protected com.fasterxml.jackson.core.JsonGenerator	_createGenerator(Writer out, com.fasterxml.jackson.core.io.IOContext ctxt)
protected FromXmlParser	_createParser(byte[] data, int offset, int len, com.fasterxml.jackson.core.io.IOContext ctxt)
protected FromXmlParser	_createParser(char[] data, int offset, int len, com.fasterxml.jackson.core.io.IOContext ctxt, boolean recycleBuffer)
protected FromXmlParser	_createParser(InputStream in, com.fasterxml.jackson.core.io.IOContext ctxt)
protected FromXmlParser	_createParser(Reader r, com.fasterxml.jackson.core.io.IOContext ctxt)
protected XMLStreamWriter	_createXmlWriter(com.fasterxml.jackson.core.io.IOContext ctxt, OutputStream out)
protected XMLStreamWriter	_createXmlWriter(com.fasterxml.jackson.core.io.IOContext ctxt, Writer w)
protected OutputStream	_decorate(com.fasterxml.jackson.core.io.IOContext ioCtxt, OutputStream out)
protected Writer	_decorate(com.fasterxml.jackson.core.io.IOContext ioCtxt, Writer out)
protected void	_initFactories(XMLInputFactory xmlIn, XMLOutputFactory xmlOut)
protected XMLStreamReader	_initializeXmlReader(XMLStreamReader sr)
protected XMLStreamWriter	_initializeXmlWriter(XMLStreamWriter sw)
static XmlFactoryBuilder	builder()
boolean	canUseCharArrays() As of 2.4, we do have actual capability for passing char arrays efficiently, but unfortunately have no working mechanism for recycling buffers.
XmlFactory	configure(FromXmlParser.Feature f, boolean state) Method for enabling or disabling specified XML parser feature.
XmlFactory	configure(ToXmlGenerator.Feature f, boolean state) Method for enabling or disabling specified XML generator feature.
XmlFactory	copy() Note: compared to base implementation by JsonFactory, here the copy will actually share underlying XML input and output factories, as there is no way to make copies of those.
ToXmlGenerator	createGenerator(File f, com.fasterxml.jackson.core.JsonEncoding enc)
ToXmlGenerator	createGenerator(OutputStream out)
ToXmlGenerator	createGenerator(OutputStream out, com.fasterxml.jackson.core.JsonEncoding enc)
ToXmlGenerator	createGenerator(Writer out)
ToXmlGenerator	createGenerator(XMLStreamWriter sw) Factory method that wraps given XMLStreamWriter, usually to allow incremental serialization to compose large output by serializing a sequence of individual objects.
com.fasterxml.jackson.core.JsonParser	createParser(String content) Overridden just to prevent trying to optimize access via char array; while nice idea, problem is that we don't have proper hooks to ensure that temporary buffer gets recycled; so let's just use StringReader.
FromXmlParser	createParser(XMLStreamReader sr) Factory method that wraps given XMLStreamReader, usually to allow partial data-binding.
XmlFactory	disable(FromXmlParser.Feature f) Method for disabling specified XML parser feature.
XmlFactory	disable(ToXmlGenerator.Feature f) Method for disabling specified XML generator feature.
XmlFactory	enable(FromXmlParser.Feature f) Method for enabling specified XML parser feature.
XmlFactory	enable(ToXmlGenerator.Feature f) Method for enabling specified XML generator feature.
int	getFormatGeneratorFeatures()
String	getFormatName() Method that returns short textual id identifying format this factory supports.
int	getFormatParserFeatures()
Class<FromXmlParser.Feature>	getFormatReadFeatureType()
Class<ToXmlGenerator.Feature>	getFormatWriteFeatureType()
XMLInputFactory	getXMLInputFactory()
XmlNameProcessor	getXmlNameProcessor()
XMLOutputFactory	getXMLOutputFactory()
String	getXMLTextElementName()
com.fasterxml.jackson.core.format.MatchStrength	hasFormat(com.fasterxml.jackson.core.format.InputAccessor acc)
static com.fasterxml.jackson.core.format.MatchStrength	hasXMLFormat(com.fasterxml.jackson.core.format.InputAccessor acc) Method that tries to figure out if content seems to be in some kind of XML format.
boolean	isEnabled(FromXmlParser.Feature f) Checked whether specified XML parser feature is enabled.
boolean	isEnabled(ToXmlGenerator.Feature f) Check whether specified XML generator feature is enabled.
protected Object	readResolve() Method that we need to override to actually make restoration go through constructors etc.
XmlFactoryBuilder	rebuild()
boolean	requiresCustomCodec() XML format does require support from custom ObjectCodec (that is, XmlMapper), so need to return true here.
void	setXMLInputFactory(XMLInputFactory f) Deprecated. Since 2.12 -- should be set as part of build process (either in builder, or constructor)
void	setXmlNameProcessor(XmlNameProcessor processor)
void	setXMLOutputFactory(XMLOutputFactory f) Deprecated. Since 2.12 -- should be set as part of build process (either in builder, or constructor)
void	setXMLTextElementName(String name)
com.fasterxml.jackson.core.Version	version()

Methods inherited from class com.fasterxml.jackson.core.JsonFactory

_checkInvalidCopy, _createContentReference, _createContentReference, _createContext, _createContext, _createNonBlockingContext, _createParser, _createUTF8Generator, _createWriter, _decorate, _decorate, _decorate, _decorate, _decorate, _getBufferRecycler, canHandleBinaryNatively, canParseAsync, canUseSchema, configure, configure, configure, createGenerator, createGenerator, createJsonGenerator, createJsonGenerator, createJsonGenerator, createJsonParser, createJsonParser, createJsonParser, createJsonParser, createJsonParser, createJsonParser, createJsonParser, createNonBlockingByteArrayParser, createNonBlockingByteBufferParser, createParser, createParser, createParser, createParser, createParser, createParser, createParser, createParser, createParser, disable, disable, disable, enable, enable, enable, getCharacterEscapes, getCodec, getGeneratorFeatures, getInputDecorator, getOutputDecorator, getParserFeatures, getRootValueSeparator, hasJSONFormat, isEnabled, isEnabled, isEnabled, isEnabled, isEnabled, requiresPropertyOrdering, setCharacterEscapes, setCodec, setInputDecorator, setOutputDecorator, setRootValueSeparator

Methods inherited from class com.fasterxml.jackson.core.TokenStreamFactory

_checkRangeBoundsForByteArray, _checkRangeBoundsForCharArray, _createDataOutputWrapper, _fileInputStream, _fileOutputStream, _optimizedStreamFromURL, _reportRangeError

Methods inherited from class java.lang.Object

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

Field Detail

FORMAT_NAME_XML

public static final String FORMAT_NAME_XML

Name used to identify XML format (and returned by getFormatName()

See Also:

Constant Field Values

_xmlParserFeatures

protected int _xmlParserFeatures

_xmlGeneratorFeatures

protected int _xmlGeneratorFeatures

_xmlInputFactory

protected transient XMLInputFactory _xmlInputFactory

_xmlOutputFactory

protected transient XMLOutputFactory _xmlOutputFactory

_cfgNameForTextElement

protected String _cfgNameForTextElement

_nameProcessor

protected XmlNameProcessor _nameProcessor

_jdkXmlInFactory

protected transient String _jdkXmlInFactory

Hiding place for JDK-serialization unthawed factories...

_jdkXmlOutFactory

protected transient String _jdkXmlOutFactory

Hiding place for JDK-serialization unthawed factories...

Constructor Detail

XmlFactory

public XmlFactory()

Default constructor used to create factory instances. Creation of a factory instance is a light-weight operation, but it is still a good idea to reuse limited number of factory instances (and quite often just a single instance): factories are used as context for storing some reused processing objects (such as symbol tables parsers use) and this reuse only works within context of a single factory instance.

XmlFactory

public XmlFactory(com.fasterxml.jackson.core.ObjectCodec oc)

XmlFactory

public XmlFactory(XMLInputFactory xmlIn)

XmlFactory

public XmlFactory(XMLInputFactory xmlIn,
                  XMLOutputFactory xmlOut)

XmlFactory

public XmlFactory(com.fasterxml.jackson.core.ObjectCodec oc,
                  XMLInputFactory xmlIn,
                  XMLOutputFactory xmlOut)

XmlFactory

public XmlFactory(com.fasterxml.jackson.core.ObjectCodec oc,
                  int xpFeatures,
                  int xgFeatures,
                  XMLInputFactory xmlIn,
                  XMLOutputFactory xmlOut,
                  String nameForTextElem)

XmlFactory

protected XmlFactory(com.fasterxml.jackson.core.ObjectCodec oc,
                     int xpFeatures,
                     int xgFeatures,
                     XMLInputFactory xmlIn,
                     XMLOutputFactory xmlOut,
                     String nameForTextElem,
                     XmlNameProcessor nameProcessor)

XmlFactory

protected XmlFactory(XmlFactory src,
                     com.fasterxml.jackson.core.ObjectCodec oc)

Since:

2.2.1

XmlFactory

protected XmlFactory(XmlFactoryBuilder b)

Constructors used by JsonFactoryBuilder for instantiation.

Since:

2.9

Method Detail

builder

public static XmlFactoryBuilder builder()

rebuild

public XmlFactoryBuilder rebuild()

Overrides:

rebuild in class com.fasterxml.jackson.core.JsonFactory

_initFactories

protected void _initFactories(XMLInputFactory xmlIn,
                              XMLOutputFactory xmlOut)

copy

public XmlFactory copy()

Note: compared to base implementation by JsonFactory, here the copy will actually share underlying XML input and output factories, as there is no way to make copies of those.

Overrides:

copy in class com.fasterxml.jackson.core.JsonFactory

version

public com.fasterxml.jackson.core.Version version()

Specified by:

version in interface com.fasterxml.jackson.core.Versioned

Overrides:

version in class com.fasterxml.jackson.core.JsonFactory

readResolve

protected Object readResolve()

Method that we need to override to actually make restoration go through constructors etc.

Overrides:

readResolve in class com.fasterxml.jackson.core.JsonFactory

setXMLTextElementName

public void setXMLTextElementName(String name)

Since:

2.1

getXMLTextElementName

public String getXMLTextElementName()

Since:

2.2

configure

public final XmlFactory configure(FromXmlParser.Feature f,
                                  boolean state)

Method for enabling or disabling specified XML parser feature.

enable

public XmlFactory enable(FromXmlParser.Feature f)

Method for enabling specified XML parser feature.

disable

public XmlFactory disable(FromXmlParser.Feature f)

Method for disabling specified XML parser feature.

isEnabled

public final boolean isEnabled(FromXmlParser.Feature f)

Checked whether specified XML parser feature is enabled.

getFormatParserFeatures

public int getFormatParserFeatures()

Overrides:

getFormatParserFeatures in class com.fasterxml.jackson.core.JsonFactory

getFormatGeneratorFeatures

public int getFormatGeneratorFeatures()

Overrides:

getFormatGeneratorFeatures in class com.fasterxml.jackson.core.JsonFactory

getXmlNameProcessor

public XmlNameProcessor getXmlNameProcessor()

setXmlNameProcessor

public void setXmlNameProcessor(XmlNameProcessor processor)

configure

public final XmlFactory configure(ToXmlGenerator.Feature f,
                                  boolean state)

Method for enabling or disabling specified XML generator feature.

enable

public XmlFactory enable(ToXmlGenerator.Feature f)

Method for enabling specified XML generator feature.

disable

public XmlFactory disable(ToXmlGenerator.Feature f)

Method for disabling specified XML generator feature.

isEnabled

public final boolean isEnabled(ToXmlGenerator.Feature f)

Check whether specified XML generator feature is enabled.

getXMLInputFactory

public XMLInputFactory getXMLInputFactory()

Since:

2.4

setXMLInputFactory

@Deprecated
public void setXMLInputFactory(XMLInputFactory f)

Deprecated. Since 2.12 -- should be set as part of build process (either in builder, or constructor)

getXMLOutputFactory

public XMLOutputFactory getXMLOutputFactory()

Since:

2.4

setXMLOutputFactory

@Deprecated
public void setXMLOutputFactory(XMLOutputFactory f)

Deprecated. Since 2.12 -- should be set as part of build process (either in builder, or constructor)

getFormatName

public String getFormatName()

Method that returns short textual id identifying format this factory supports.

Note: sub-classes should override this method; default implementation will return null for all sub-classes

Overrides:

getFormatName in class com.fasterxml.jackson.core.JsonFactory

hasFormat

public com.fasterxml.jackson.core.format.MatchStrength hasFormat(com.fasterxml.jackson.core.format.InputAccessor acc)
                                                          throws IOException

Overrides:

hasFormat in class com.fasterxml.jackson.core.JsonFactory

Throws:

IOException

requiresCustomCodec

public boolean requiresCustomCodec()

XML format does require support from custom ObjectCodec (that is, XmlMapper), so need to return true here.

Overrides:

requiresCustomCodec in class com.fasterxml.jackson.core.JsonFactory

Returns:

True since XML format does require support from codec

canUseCharArrays

public boolean canUseCharArrays()

As of 2.4, we do have actual capability for passing char arrays efficiently, but unfortunately have no working mechanism for recycling buffers. So we have to admit that can not make efficient use.

Overrides:

canUseCharArrays in class com.fasterxml.jackson.core.JsonFactory

getFormatReadFeatureType

public Class<FromXmlParser.Feature> getFormatReadFeatureType()

Overrides:

getFormatReadFeatureType in class com.fasterxml.jackson.core.JsonFactory

getFormatWriteFeatureType

public Class<ToXmlGenerator.Feature> getFormatWriteFeatureType()

Overrides:

getFormatWriteFeatureType in class com.fasterxml.jackson.core.JsonFactory

createParser

public com.fasterxml.jackson.core.JsonParser createParser(String content)
                                                   throws IOException

Overridden just to prevent trying to optimize access via char array; while nice idea, problem is that we don't have proper hooks to ensure that temporary buffer gets recycled; so let's just use StringReader.

Overrides:

createParser in class com.fasterxml.jackson.core.JsonFactory

Throws:

IOException

createGenerator

public ToXmlGenerator createGenerator(OutputStream out)
                               throws IOException

Overrides:

createGenerator in class com.fasterxml.jackson.core.JsonFactory

Throws:

IOException

createGenerator

public ToXmlGenerator createGenerator(OutputStream out,
                                      com.fasterxml.jackson.core.JsonEncoding enc)
                               throws IOException

Overrides:

createGenerator in class com.fasterxml.jackson.core.JsonFactory

Throws:

IOException

createGenerator

public ToXmlGenerator createGenerator(Writer out)
                               throws IOException

Overrides:

createGenerator in class com.fasterxml.jackson.core.JsonFactory

Throws:

IOException

createGenerator

public ToXmlGenerator createGenerator(File f,
                                      com.fasterxml.jackson.core.JsonEncoding enc)
                               throws IOException

Overrides:

createGenerator in class com.fasterxml.jackson.core.JsonFactory

Throws:

IOException

createParser

public FromXmlParser createParser(XMLStreamReader sr)
                           throws IOException

Factory method that wraps given XMLStreamReader, usually to allow partial data-binding.

Throws:

IOException

Since:

2.4

createGenerator

public ToXmlGenerator createGenerator(XMLStreamWriter sw)
                               throws IOException

Factory method that wraps given XMLStreamWriter, usually to allow incremental serialization to compose large output by serializing a sequence of individual objects.

Throws:

IOException

Since:

2.4

_createParser

protected FromXmlParser _createParser(InputStream in,
                                      com.fasterxml.jackson.core.io.IOContext ctxt)
                               throws IOException

Overrides:

_createParser in class com.fasterxml.jackson.core.JsonFactory

Throws:

IOException

_createParser

protected FromXmlParser _createParser(Reader r,
                                      com.fasterxml.jackson.core.io.IOContext ctxt)
                               throws IOException

Overrides:

_createParser in class com.fasterxml.jackson.core.JsonFactory

Throws:

IOException

_createParser

protected FromXmlParser _createParser(char[] data,
                                      int offset,
                                      int len,
                                      com.fasterxml.jackson.core.io.IOContext ctxt,
                                      boolean recycleBuffer)
                               throws IOException

Overrides:

_createParser in class com.fasterxml.jackson.core.JsonFactory

Throws:

IOException

_createParser

protected FromXmlParser _createParser(byte[] data,
                                      int offset,
                                      int len,
                                      com.fasterxml.jackson.core.io.IOContext ctxt)
                               throws IOException

Overrides:

_createParser in class com.fasterxml.jackson.core.JsonFactory

Throws:

IOException

_createGenerator

protected com.fasterxml.jackson.core.JsonGenerator _createGenerator(Writer out,
                                                                    com.fasterxml.jackson.core.io.IOContext ctxt)
                                                             throws IOException

Overrides:

_createGenerator in class com.fasterxml.jackson.core.JsonFactory

Throws:

IOException

_createXmlWriter

protected XMLStreamWriter _createXmlWriter(com.fasterxml.jackson.core.io.IOContext ctxt,
                                           OutputStream out)
                                    throws IOException

Throws:

IOException

_createXmlWriter

protected XMLStreamWriter _createXmlWriter(com.fasterxml.jackson.core.io.IOContext ctxt,
                                           Writer w)
                                    throws IOException

Throws:

IOException

_initializeXmlWriter

protected final XMLStreamWriter _initializeXmlWriter(XMLStreamWriter sw)
                                              throws IOException

Throws:

IOException

_initializeXmlReader

protected final XMLStreamReader _initializeXmlReader(XMLStreamReader sr)
                                              throws IOException

Throws:

IOException

hasXMLFormat

public static com.fasterxml.jackson.core.format.MatchStrength hasXMLFormat(com.fasterxml.jackson.core.format.InputAccessor acc)
                                                                    throws IOException

Method that tries to figure out if content seems to be in some kind of XML format. Note that implementation here is not nearly as robust as what underlying Stax parser will do; the idea is to first support common encodings, then expand as needed (for example, it is not all that hard to support UTF-16; but it is some work and not needed quite yet)

Throws:

IOException

_decorate

protected OutputStream _decorate(com.fasterxml.jackson.core.io.IOContext ioCtxt,
                                 OutputStream out)
                          throws IOException

Throws:

IOException

_decorate

protected Writer _decorate(com.fasterxml.jackson.core.io.IOContext ioCtxt,
                           Writer out)
                    throws IOException

Throws:

IOException