Interface OutputConfigFlags

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static int CFG_ADD_SPACE_AFTER_EMPTY_ELEM
      Flag that indicates whether writer is to add a single white space before closing "/>" of the empty element or not.
      static int CFG_AUTO_CLOSE_OUTPUT
      Property that enables/disables stream write to close the underlying output target, either when it is asked to (.close() is called), or when it doesn't need it any more (reaching EOF, hitting an unrecoverable exception).
      static int CFG_AUTOMATIC_EMPTY_ELEMENTS  
      static int CFG_AUTOMATIC_END_ELEMENTS
      Flag that indicates we can output 'automatic' empty elements; end elements needed to close the logical output tree when stream writer is closed (by closing it explicitly, or by writing end-document event)
      static int CFG_AUTOMATIC_NS  
      static int CFG_COPY_DEFAULT_ATTRS
      Flag that indicates whether attributes expanded from default attribute values should be copied to output, when using copy methods.
      static int CFG_ENABLE_NS
      Flag that indicates whether writer is namespace-aware or not; if not, only local part is ever used.
      static int CFG_ESCAPE_CR
      Flag that indicates whether CR (\r, ascii 13) characters occuring in text (CHARACTERS) and attribute values should be escaped using character entities or not.
      static int CFG_FIX_CONTENT
      Flag that will enable writer that checks for validity of content to try to fix the problem, by splitting output segments as necessary.
      static int CFG_OUTPUT_CDATA_AS_TEXT
      Whether writer should just automatically convert all calls that would normally produce CDATA to produce (quoted) text.
      static int CFG_USE_DOUBLE_QUOTES_IN_XML_DECL
      Property that indicates if singe quotes or double quotes should be used in the XML declaration.
      static int CFG_VALIDATE_ATTR
      Flag that indicates we should check uniqueness of attribute names, to prevent accidental output of duplicate attributes.
      static int CFG_VALIDATE_CONTENT
      Flag that indicates we should check validity of textual content of nodes that have constraints.
      static int CFG_VALIDATE_NAMES
      Flag that indicates we should check validity of names (element and attribute names and prefixes; processing instruction names), that they contain only legal identifier characters.
      static int CFG_VALIDATE_STRUCTURE  
    • Field Detail

      • CFG_ENABLE_NS

        static final int CFG_ENABLE_NS
        Flag that indicates whether writer is namespace-aware or not; if not, only local part is ever used.
        See Also:
        Constant Field Values
      • CFG_AUTOMATIC_EMPTY_ELEMENTS

        static final int CFG_AUTOMATIC_EMPTY_ELEMENTS
        See Also:
        Constant Field Values
      • CFG_OUTPUT_CDATA_AS_TEXT

        static final int CFG_OUTPUT_CDATA_AS_TEXT
        Whether writer should just automatically convert all calls that would normally produce CDATA to produce (quoted) text.
        See Also:
        Constant Field Values
      • CFG_COPY_DEFAULT_ATTRS

        static final int CFG_COPY_DEFAULT_ATTRS
        Flag that indicates whether attributes expanded from default attribute values should be copied to output, when using copy methods.
        See Also:
        Constant Field Values
      • CFG_ESCAPE_CR

        static final int CFG_ESCAPE_CR
        Flag that indicates whether CR (\r, ascii 13) characters occuring in text (CHARACTERS) and attribute values should be escaped using character entities or not. Escaping is needed to enable seamless round-tripping (preserving CR characters).
        See Also:
        Constant Field Values
      • CFG_ADD_SPACE_AFTER_EMPTY_ELEM

        static final int CFG_ADD_SPACE_AFTER_EMPTY_ELEM
        Flag that indicates 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.
        See Also:
        Constant Field Values
      • CFG_AUTOMATIC_END_ELEMENTS

        static final int CFG_AUTOMATIC_END_ELEMENTS
        Flag that indicates we can output 'automatic' empty elements; end elements needed to close the logical output tree when stream writer is closed (by closing it explicitly, or by writing end-document event)
        Since:
        3.2.8
        See Also:
        Constant Field Values
      • CFG_VALIDATE_CONTENT

        static final int CFG_VALIDATE_CONTENT
        Flag that indicates we should check validity of textual content of nodes that have constraints.

        Specifically: comments can not have '--', CDATA sections can not have ']]>' and processing instruction can not have '?>;' character combinations in content passed in.

        See Also:
        Constant Field Values
      • CFG_VALIDATE_NAMES

        static final int CFG_VALIDATE_NAMES
        Flag that indicates we should check validity of names (element and attribute names and prefixes; processing instruction names), that they contain only legal identifier characters.
        See Also:
        Constant Field Values
      • CFG_VALIDATE_ATTR

        static final int CFG_VALIDATE_ATTR
        Flag that indicates we should check uniqueness of attribute names, to prevent accidental output of duplicate attributes.
        See Also:
        Constant Field Values
      • CFG_FIX_CONTENT

        static final int CFG_FIX_CONTENT
        Flag that will enable writer that checks for validity of content to try to fix the problem, by splitting output segments as necessary. If disabled, validation will throw an exception; and without validation no problem is noticed by writer (but instead invalid output is created).
        See Also:
        Constant Field Values
      • CFG_AUTO_CLOSE_OUTPUT

        static final int CFG_AUTO_CLOSE_OUTPUT
        Property that enables/disables stream write to close the underlying output target, either when it is asked to (.close() is called), or when it doesn't need it any more (reaching EOF, hitting an unrecoverable exception). As per Stax 1.0 specification, automatic closing is NOT enabled by default; except if the caller has no access to the target (i.e. when factory created it)
        See Also:
        Constant Field Values
      • CFG_USE_DOUBLE_QUOTES_IN_XML_DECL

        static final int CFG_USE_DOUBLE_QUOTES_IN_XML_DECL
        Property that indicates if singe quotes or double quotes should be used in the XML declaration. The default is to use single quotes.
        See Also:
        Constant Field Values