Class WstxOutputProperties
XMLOutputFactory
.-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final String
If no encoding is passed, we should just default to what xml in general expects (and can determine), UTF-8.static final String
Default xml version number output, if none was specified by application.static final String
Whether writer is to add a single white space before closing"/>"
of the empty element or not.static final String
Whether stream writer is to automatically add end elements that are needed to properly close the output tree, when the stream is closed (either explicitly by a call toclose
orcloseCompletely
, or implicitly by a call towriteEndDocument
.static final String
Whether writer should copy attributes that were initially expanded using default settings ("implicit" attributes) or not.static final String
Whether writer should just automatically convert all calls that would normally produce CDATA to produce (quoted) text.static final String
Property that defines anEmptyElementHandler
used to determine if the end tag for an empty element should be written or not.static final String
Property that determines whether Carriage Return (\r) characters are to be escaped when output or not.static final String
Property that further modifies handling of invalid content so that ifP_OUTPUT_VALIDATE_CONTENT
is enabled, instead of reporting an error, writer will try to fix the problem.static final String
Property that defines aInvalidCharHandler
used to determine what to do with a Java character that app tries to output but which is not a valid xml character.static final String
Property that can be used to find out the underlyingOutputStream
that anXMLStreamWriter
instance is using, if known (not known if constructed with aWriter
, or other non-stream destination).static final String
Property that can be used to find out the underlyingWriter
that anXMLStreamWriter
instance is using, if known (may not be known if constructed with aOutputStream
, or other non-Writer destination).static final String
Whether output classes should check uniqueness of attribute names, to prevent accidental output of duplicate attributes.static final String
Whether output classes should do basic verification that the textual content output as part of nodes should be checked for validity, if there's a possibility of invalid content.static final String
Whether output classes should check validity of names, ie that they only contain legal XML identifier characters.static final String
Whether output classes should do basic verification that the output structure is well-formed (start and end elements match); that there is one and only one root, and that there is no textual content in prolog/epilog.static final String
Whether writer should use double quotes in the XML declaration. -
Constructor Summary
Constructors -
Method Summary
-
Field Details
-
DEFAULT_XML_VERSION
Default xml version number output, if none was specified by application. Version 1.0 is used to try to maximize compatibility (some older parsers may barf on 1.1 and later...)- See Also:
-
DEFAULT_OUTPUT_ENCODING
If no encoding is passed, we should just default to what xml in general expects (and can determine), UTF-8.Note: you can check out bug entry [WSTX-18] for more details
- See Also:
-
P_USE_DOUBLE_QUOTES_IN_XML_DECL
Whether writer should use double quotes in the XML declaration. The default is to use single quotes.- Since:
- 4.2.2
- See Also:
-
P_OUTPUT_CDATA_AS_TEXT
Whether writer should just automatically convert all calls that would normally produce CDATA to produce (quoted) text.- See Also:
-
P_COPY_DEFAULT_ATTRS
Whether writer should copy attributes that were initially expanded using default settings ("implicit" attributes) or not.- See Also:
-
P_ADD_SPACE_AFTER_EMPTY_ELEM
Whether writer is to add a single white space before closing"/>"
of the empty element or not. It is sometimes useful to add to increase compatibility with HTML browsers, or to increase readability.The default value is 'false', up to Woodstox 4.x.
NOTE: JavaDocs for versions 4.0.0 - 4.0.7 incorrectly state that default is 'true': this is NOT the case.
Note: added to resolve Jira entry WSTX-125.
- See Also:
-
P_AUTOMATIC_END_ELEMENTS
Whether stream writer is to automatically add end elements that are needed to properly close the output tree, when the stream is closed (either explicitly by a call toclose
orcloseCompletely
, or implicitly by a call towriteEndDocument
.The default value is 'true' as of Woodstox 4.x. Prior to 4.0, this feature was always enabled and there was no way to disable it)
- Since:
- 3.2.8
- See Also:
-
P_OUTPUT_VALIDATE_STRUCTURE
Whether output classes should do basic verification that the output structure is well-formed (start and end elements match); that there is one and only one root, and that there is no textual content in prolog/epilog. If false, won't do any checking regarding structure.- See Also:
-
P_OUTPUT_VALIDATE_CONTENT
Whether output classes should do basic verification that the textual content output as part of nodes should be checked for validity, if there's a possibility of invalid content. Nodes that include such constraints are: comment/'--', cdata/']]>'
, proc. instr/'?>'
.- See Also:
-
P_OUTPUT_VALIDATE_ATTR
Whether output classes should check uniqueness of attribute names, to prevent accidental output of duplicate attributes.- See Also:
-
P_OUTPUT_VALIDATE_NAMES
Whether output classes should check validity of names, ie that they only contain legal XML identifier characters.- See Also:
-
P_OUTPUT_FIX_CONTENT
Property that further modifies handling of invalid content so that ifP_OUTPUT_VALIDATE_CONTENT
is enabled, instead of reporting an error, writer will try to fix the problem. Invalid content in this context refers to comment content with "--", CDATA with"]]>"
and proc. instr data with"?>"
. This can be done for some content (CDATA, possibly comment), by splitting content into separate segments; but not for others (proc. instr, since that might change the semantics in unintended ways).- See Also:
-
P_OUTPUT_ESCAPE_CR
Property that determines whether Carriage Return (\r) characters are to be escaped when output or not. If enabled, all instances of of character \r are escaped using a character entity (where possible, that is, within CHARACTERS events, and attribute values). Otherwise they are output as is. The main reason to enable this property is to ensure that carriage returns are preserved as is through parsing, since otherwise they will be converted to canonical xml linefeeds (\n), when occuring along or as part of \r\n pair.- See Also:
-
P_OUTPUT_INVALID_CHAR_HANDLER
Property that defines aInvalidCharHandler
used to determine what to do with a Java character that app tries to output but which is not a valid xml character. Alternatives are converting it to another character or throw an exception: default implementations exist for both behaviors.- See Also:
-
P_OUTPUT_EMPTY_ELEMENT_HANDLER
Property that defines anEmptyElementHandler
used to determine if the end tag for an empty element should be written or not. If specifiedXMLOutputFactory2.P_AUTOMATIC_EMPTY_ELEMENTS
is ignored.- See Also:
-
P_OUTPUT_UNDERLYING_STREAM
Property that can be used to find out the underlyingOutputStream
that anXMLStreamWriter
instance is using, if known (not known if constructed with aWriter
, or other non-stream destination). Null is returned, if not known.Note: in general it is dangerous to operate on returned stream (if any), due to buffering stream writer can do. As such, caller has to take care to know what he is doing, including properly flushing output.
- See Also:
-
P_OUTPUT_UNDERLYING_WRITER
Property that can be used to find out the underlyingWriter
that anXMLStreamWriter
instance is using, if known (may not be known if constructed with aOutputStream
, or other non-Writer destination). Null is returned, if not known. Note that the Writer may be an internal wrapper over an output stream.Note: in general it is dangerous to operate on returned Writer (if any), due to buffering stream writer can do. As such, caller has to take care to know what he is doing, including properly flushing output.
- See Also:
-
-
Constructor Details
-
WstxOutputProperties
public WstxOutputProperties()
-