com.ctc.wstx.cfg
Interface OutputConfigFlags

All Known Implementing Classes:
BaseNsStreamWriter, BaseStreamWriter, NonNsStreamWriter, RepairingNsStreamWriter, SimpleNsStreamWriter, TypedStreamWriter, WriterConfig, WstxOutputFactory

public interface OutputConfigFlags

Constant interface that contains configuration flag used by output classes internally, for presenting on/off configuration options.


Field Summary
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_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_NS

static final int CFG_AUTOMATIC_NS
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_STRUCTURE

static final int CFG_VALIDATE_STRUCTURE
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