Top Description Inners Fields Constructors Methods
com.fasterxml.aalto.out

public final Class WriterConfig

extends CommonConfig
Class Inheritance
Imports
java.util.*, java.lang.ref.SoftReference, javax.xml.stream.XMLOutputFactory, org.codehaus.stax2.XMLOutputFactory2, .XMLStreamProperties, com.fasterxml.aalto.impl.CommonConfig, com.fasterxml.aalto.util.BufferRecycler

This is the shared configuration object passed by the factory to writer.

Nested and Inner Type Summary

Modifier and TypeClass and Description
pack-priv static class
WriterConfig.EncodingContext

This is a simple container class that is used to encapsulate per-factory encoding-dependant information like symbol tables.

Field Summary

Modifier and TypeField and Description
pack-priv BufferRecycler
_currRecycler

This is the actually container of the recyclable buffers.

private String
_encoding

Encoding passed in either during construction, or via xml declaration write.

private final WriterConfig.EncodingContext
_encodingContext

A single encoding context instance is shared between all WriterConfig instances created for readers by an output factory.

private String
protected static final String
pack-priv static final int
pack-priv static final int
pack-priv static final int
pack-priv static final int
pack-priv static final int
pack-priv static final ThreadLocal<SoftReference<BufferRecycler>>
mRecyclerRef

This ThreadLocal contains a SoftRerefence to a BufferRecycler used to provide a low-cost buffer recycling between Reader instances.

pack-priv static final int
private static final HashMap<String, Integer>
Inherited from com.fasterxml.aalto.impl.CommonConfig:
_flagMods_flagsIMPL_NAMEIMPL_VERSION

Constructor Summary

AccessConstructor and Description
private
WriterConfig(String encoding, int flags, int flagMods, WriterConfig.EncodingContext encCtxt, String autoNsPrefix)

public

Method Summary

Modifier and TypeMethod and Description
public byte[]
allocFullBBuffer(int minSize)

public char[]
allocFullCBuffer(int minSize)

public char[]
allocMediumCBuffer(int minSize)

public void
public void
configureForSpeed()

For Woodstox, setting this profile disables most checks for validity; specifically anything that can have measurable performance impact.

public void
public WriterConfig
private BufferRecycler
public void
doAutoCloseOutput(boolean state)

public void
public void
freeFullBBuffer(byte[] buffer)

public void
freeFullCBuffer(char[] buffer)

public void
freeMediumCBuffer(char[] buffer)

public String
public WNameTable
public String

Returns:

Prefix to use as the base for automatically generated namespace prefixes ("namespace prefix prefix", so to speak). Defaults to "axns".
getAutomaticNsPrefix
()

public WNameTable
public String
getExternalEncoding()

Implements abstract com.fasterxml.aalto.impl.CommonConfig.getExternalEncoding.

This method returns name of encoding that has been passed explicitly to the reader or writer, from outside.
public WNameTable
public String
public Object
getProperty(String name, boolean
If true, unrecognized property should result in IllegalArgumentException
isMandatory
)

Overrides com.fasterxml.aalto.impl.CommonConfig.getProperty.

public WNameTable
public boolean
public boolean
public boolean
public void
public boolean
public boolean
public boolean
public boolean
public boolean
public boolean
public boolean
public boolean
public boolean
Inherited from com.fasterxml.aalto.impl.CommonConfig:
hasExplicitFlaghasFlaghasFlagBeenModifiedsetFlag

Field Detail

_currRecyclerback to summary
pack-priv BufferRecycler _currRecycler

This is the actually container of the recyclable buffers. It is obtained via ThreadLocal/SoftReference combination, if one exists, when Config instance is created. If one does not exist, it will created first time a buffer is returned.

_encodingback to summary
private String _encoding

Encoding passed in either during construction, or via xml declaration write.

_encodingContextback to summary
private final WriterConfig.EncodingContext _encodingContext

A single encoding context instance is shared between all WriterConfig instances created for readers by an output factory. It is used for sharing symbol tables.

_propAutoNsPrefixback to summary
private String _propAutoNsPrefix
DEFAULT_AUTOMATIC_NS_PREFIXback to summary
protected static final String DEFAULT_AUTOMATIC_NS_PREFIX
DEFAULT_FLAGSback to summary
pack-priv static final int DEFAULT_FLAGS
F_AUTO_CLOSE_OUTPUTback to summary
pack-priv static final int F_AUTO_CLOSE_OUTPUT
F_AUTO_EMPTY_ELEMSback to summary
pack-priv static final int F_AUTO_EMPTY_ELEMS
F_NS_AWAREback to summary
pack-priv static final int F_NS_AWARE
F_NS_REPAIRINGback to summary
pack-priv static final int F_NS_REPAIRING
mRecyclerRefback to summary
pack-priv static final ThreadLocal<SoftReference<BufferRecycler>> mRecyclerRef

This ThreadLocal contains a SoftRerefence to a BufferRecycler used to provide a low-cost buffer recycling between Reader instances.

PROP_AUTO_NS_PREFIXback to summary
pack-priv static final int PROP_AUTO_NS_PREFIX
sPropertiesback to summary
private static final HashMap<String, Integer> sProperties

Constructor Detail

WriterConfigback to summary
private WriterConfig(String encoding, int flags, int flagMods, WriterConfig.EncodingContext encCtxt, String autoNsPrefix)
WriterConfigback to summary
public WriterConfig()

Method Detail

allocFullBBufferback to summary
public byte[] allocFullBBuffer(int minSize)
allocFullCBufferback to summary
public char[] allocFullCBuffer(int minSize)
allocMediumCBufferback to summary
public char[] allocMediumCBuffer(int minSize)
configureForRobustnessback to summary
public void configureForRobustness()
configureForSpeedback to summary
public void configureForSpeed()

For Woodstox, setting this profile disables most checks for validity; specifically anything that can have measurable performance impact.

configureForXmlConformanceback to summary
public void configureForXmlConformance()
createNonSharedback to summary
public WriterConfig createNonShared()
createRecyclerback to summary
private BufferRecycler createRecycler()
doAutoCloseOutputback to summary
public void doAutoCloseOutput(boolean state)
enableXml11back to summary
public void enableXml11()
freeFullBBufferback to summary
public void freeFullBBuffer(byte[] buffer)
freeFullCBufferback to summary
public void freeFullCBuffer(char[] buffer)
freeMediumCBufferback to summary
public void freeMediumCBuffer(char[] buffer)
getActualEncodingback to summary
public String getActualEncoding()

Implements abstract com.fasterxml.aalto.impl.CommonConfig.getActualEncoding.

Returns:String

Doc from com.fasterxml.aalto.impl.CommonConfig.getActualEncoding.

Actual encoding in use, as determined by the processor.

Annotations
@Override
getAsciiSymbolsback to summary
public WNameTable getAsciiSymbols(WNameFactory f)
getAutomaticNsPrefixback to summary
public String getAutomaticNsPrefix()
Returns:String

Prefix to use as the base for automatically generated namespace prefixes ("namespace prefix prefix", so to speak). Defaults to "axns".

getCharSymbolsback to summary
public WNameTable getCharSymbols(WNameFactory f)
getExternalEncodingback to summary
public String getExternalEncoding()

Implements abstract com.fasterxml.aalto.impl.CommonConfig.getExternalEncoding.

Doc from com.fasterxml.aalto.impl.CommonConfig.getExternalEncoding.

This method returns name of encoding that has been passed explicitly to the reader or writer, from outside. An example is that HTTP server may pass encoding as declared in HTTP headers. This should either be null (if none passed), or the same as actual encoding (which is determined from physical stream contents [for readers], or from encoder properties / configuration [for writers]

Returns:String

Encoding that has been passed externally by the application

Annotations
@Override
getLatin1Symbolsback to summary
public WNameTable getLatin1Symbols(WNameFactory f)
getPreferredEncodingback to summary
public String getPreferredEncoding()
getPropertyback to summary
public Object getProperty(String name, boolean isMandatory)

Overrides com.fasterxml.aalto.impl.CommonConfig.getProperty.

Parameters
isMandatory:boolean

Doc from com.fasterxml.aalto.impl.CommonConfig.getProperty.

If true, unrecognized property should result in IllegalArgumentException

Annotations
@Override
getUtf8Symbolsback to summary
public WNameTable getUtf8Symbols(WNameFactory f)
isNamespaceAwareback to summary
public boolean isNamespaceAware()
isPropertySupportedback to summary
public boolean isPropertySupported(String propName)

Overrides com.fasterxml.aalto.impl.CommonConfig.isPropertySupported.

Annotations
@Override
isXml11back to summary
public boolean isXml11()

Implements abstract com.fasterxml.aalto.impl.CommonConfig.isXml11.

Returns:boolean

Doc from com.fasterxml.aalto.impl.CommonConfig.isXml11.

True, if the processing will be done according to Xml 1.1 rules; false if according to xml 1.0

Annotations
@Override
setActualEncodingIfNotSetback to summary
public void setActualEncodingIfNotSet(String enc)
setPropertyback to summary
public boolean setProperty(String name, Object value)

Overrides com.fasterxml.aalto.impl.CommonConfig.setProperty.

Returns:boolean

Doc from com.fasterxml.aalto.impl.CommonConfig.setProperty.

True, if the specified property was succesfully set to specified value; false if its value was not changed

Annotations
@Override
willAutoCloseOutputback to summary
public boolean willAutoCloseOutput()
willCheckAttributesback to summary
public boolean willCheckAttributes()
willCheckContentback to summary
public boolean willCheckContent()
willCheckNamesback to summary
public boolean willCheckNames()
willCheckStructureback to summary
public boolean willCheckStructure()
willEscapeCRback to summary
public boolean willEscapeCR()
willFixContentback to summary
public boolean willFixContent()
willRepairNamespacesback to summary
public boolean willRepairNamespaces()
com.fasterxml.aalto.out back to summary

pack-priv final Class WriterConfig.EncodingContext

extends Object
Class Inheritance

This is a simple container class that is used to encapsulate per-factory encoding-dependant information like symbol tables.

Field Summary

Modifier and TypeField and Description
pack-priv WNameTable
pack-priv WNameTable
pack-priv WNameTable
pack-priv WNameTable

Constructor Summary

AccessConstructor and Description
pack-priv

Method Summary

Modifier and TypeMethod and Description
public synchronized WNameTable
public synchronized WNameTable
public synchronized WNameTable
public synchronized WNameTable
Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

mAsciiTableback to summary
pack-priv WNameTable mAsciiTable
mCharTableback to summary
pack-priv WNameTable mCharTable
mLatin1Tableback to summary
pack-priv WNameTable mLatin1Table
mUtf8Tableback to summary
pack-priv WNameTable mUtf8Table

Constructor Detail

EncodingContextback to summary
pack-priv EncodingContext()

Method Detail

getAsciiSymbolsback to summary
public synchronized WNameTable getAsciiSymbols(WNameFactory f)
getCharSymbolsback to summary
public synchronized WNameTable getCharSymbols(WNameFactory f)
getLatin1Symbolsback to summary
public synchronized WNameTable getLatin1Symbols(WNameFactory f)
getUtf8Symbolsback to summary
public synchronized WNameTable getUtf8Symbols(WNameFactory f)