org.codehaus.stax2
Interface XMLStreamProperties

All Known Implementing Classes:
ReaderConfig, ValidatorConfig, WriterConfig, WstxInputFactory, WstxOutputFactory, XMLInputFactory2, XMLOutputFactory2

public interface XMLStreamProperties

This interface defines configuration properties shared by multiple kinds of factories (input, output, validation) or instances produces (readers, writers, validators).

Some of the properties here are same as ones earlier defined in XMLInputFactory and XMLOutputFactory, and are redeclared here to emphasize the fact they are usable with broader context (esp. properties that use to be only used with input factories but can now be used with output or validation factories).


Field Summary
static java.lang.String XSP_IMPLEMENTATION_NAME
          This read-only property returns name of the implementation.
static java.lang.String XSP_IMPLEMENTATION_VERSION
          This read-only property returns the version of the implementation, and is to be used with implementation name (XSP_IMPLEMENTATION_NAME) property.
static java.lang.String XSP_NAMESPACE_AWARE
          Property that can be set to indicate that namespace information is to be handled in conformance to the xml namespaces specifiation; or false to indicate no namespace handling should be done.
static java.lang.String XSP_PROBLEM_REPORTER
          Property that can be set to specify a problem handler which will get notified of non-fatal problem (validation errors in non-validating mode, warnings).
static java.lang.String XSP_SUPPORT_XMLID
          Read/write property that can be set to change the level of xml:id specification support, if the implementation implements xml:id specification.
static java.lang.String XSP_SUPPORTS_XML11
          This read-only property indicates whether the implementation supports xml 1.1 content; Boolean.TRUE indicates it does, Boolean.FALSE that it does not.
static java.lang.String XSP_V_XMLID_FULL
          Property value to use with property XSP_SUPPORT_XMLID.
static java.lang.String XSP_V_XMLID_NONE
          Property value to use with property XSP_SUPPORT_XMLID.
static java.lang.String XSP_V_XMLID_TYPING
          Property value to use with property XSP_SUPPORT_XMLID.
 

Field Detail

XSP_IMPLEMENTATION_NAME

static final java.lang.String XSP_IMPLEMENTATION_NAME
This read-only property returns name of the implementation. It can be used to determine implementation-specific feature sets, in case other methods (calling isPropertySupported) does not work adequately.

See Also:
Constant Field Values

XSP_IMPLEMENTATION_VERSION

static final java.lang.String XSP_IMPLEMENTATION_VERSION
This read-only property returns the version of the implementation, and is to be used with implementation name (XSP_IMPLEMENTATION_NAME) property.

See Also:
Constant Field Values

XSP_SUPPORTS_XML11

static final java.lang.String XSP_SUPPORTS_XML11
This read-only property indicates whether the implementation supports xml 1.1 content; Boolean.TRUE indicates it does, Boolean.FALSE that it does not.

See Also:
Constant Field Values

XSP_NAMESPACE_AWARE

static final java.lang.String XSP_NAMESPACE_AWARE
Property that can be set to indicate that namespace information is to be handled in conformance to the xml namespaces specifiation; or false to indicate no namespace handling should be done.

See Also:
Constant Field Values

XSP_PROBLEM_REPORTER

static final java.lang.String XSP_PROBLEM_REPORTER
Property that can be set to specify a problem handler which will get notified of non-fatal problem (validation errors in non-validating mode, warnings). Its value has to be of type XMLReporter

See Also:
Constant Field Values

XSP_SUPPORT_XMLID

static final java.lang.String XSP_SUPPORT_XMLID
Read/write property that can be set to change the level of xml:id specification support, if the implementation implements xml:id specification. Value to set should be one of XSP_V_XMLID_xxx constants (like XSP_V_XMLID_TYPING).

Default value is implementation-specific, but recommended default value is XSP_V_XMLID_TYPING for implementations that do support Xml:id specification: those that do not, have to default to XSP_V_XMLID_NONE. For Xml:id-enabled implementations, typing support is the most logical default, since it provides the intuitive behavior of xml:id functionality, as well as reasonable performance (very little overhead in non-validating mode; usual id checking overhead for validating mode).

See Also:
Constant Field Values

XSP_V_XMLID_NONE

static final java.lang.String XSP_V_XMLID_NONE
Property value to use with property XSP_SUPPORT_XMLID. Property value that indicates that no xml:id support should be enabled.

See Also:
Constant Field Values

XSP_V_XMLID_TYPING

static final java.lang.String XSP_V_XMLID_TYPING
Property value to use with property XSP_SUPPORT_XMLID. Value indicates that the attribute type assignment portion of xml:id should be supported (all 'xml:id' attributes that are not explicitly declared should have attribute type of ID), but that no xml:id specific validation is to be done. Due to typing, value normalization should occur. It is still possible that schema (DTD, RNG, W3C Schema) based validation is done, including validation of values of xml:id attributes, but only based on Schema information.

The main reason for specifying this value (as opposed to the full enabling) is that there is some overhead associated with validation (especially uniqueness constraints checking, which means that all values of xml:id attributes in the input document have to be kept in memory), whereas typing is a low overhead operation.

See Also:
Constant Field Values

XSP_V_XMLID_FULL

static final java.lang.String XSP_V_XMLID_FULL
Property value to use with property XSP_SUPPORT_XMLID. Value indicates that both the attribute type assignment portion and the validation portion of xml:id should be supported. This validation is independent of the actual schema (DTD, RNG, W3C Schema) validation, in the sense that even if no such validation is enabled, xml:id value validation will still be done if this property value is used. Conversely, if schema-based validation is used, both xml:id and schema validation may be done (although schema validator instances may choose to ignore validity checks if they know that full xml:id support is enabled).

See Also:
Constant Field Values