WstxInputProperties (Woodstox 5.1.0 API)

java.lang.Object
- com.ctc.wstx.api.WstxInputProperties

```
public final class WstxInputProperties
extends Object
```
Class that contains constant for property names used to configure cursor and event readers produced by Wstx implementation of XMLInputFactory.
TODO: - CHECK_CHAR_VALIDITY (separate for white spaces?) - CATALOG_RESOLVER? (or at least, ENABLE_CATALOGS)

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class WstxInputProperties.ParsingMode
Inner class used for creating type-safe enumerations (prior to JDK 1.5).

Nested Classes
Modifier and Type	Class and Description
`static class`	`WstxInputProperties.ParsingMode` Inner class used for creating type-safe enumerations (prior to JDK 1.5).

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`P_BASE_URL` Property of type `URL`, that will allow specifying context URL to use when resolving relative references, for the main-level entities (external DTD subset, references from the internal DTD subset).
`static String`	`P_CACHE_DTDS` Whether readers will try to cache parsed external DTD subsets or not.
`static String`	`P_CACHE_DTDS_BY_PUBLIC_ID` Whether reader is to cache DTDs (when caching enabled) based on public id or not: if not, system id will be primarily used.
`static String`	`P_CUSTOM_INTERNAL_ENTITIES` Deprecated. This feature may be removed from future versions of Woodstox, since the same functionality can be achieved by using custom entity resolvers.
`static String`	`P_DTD_RESOLVER` Property of type `XMLResolver`, that will allow overriding of default DTD and external parameter entity resolution.
`static String`	`P_ENTITY_RESOLVER` Property of type `XMLResolver`, that will allow overriding of default external general entity resolution.
`static String`	`P_INPUT_BUFFER_LENGTH` Size of input buffer (in chars), to use for reading XML content from input stream/reader.
`static String`	`P_INPUT_PARSING_MODE` Three-valued property (one of `PARSING_MODE_DOCUMENT`, `PARSING_MODE_FRAGMENT` or `PARSING_MODE_DOCUMENTS`; default being the document mode) that can be used to handle "non-standard" XML content.
`static String`	`P_LAZY_PARSING` Deprecated. As of Woodstox 4.0 use `XMLInputFactory2.P_LAZY_PARSING` instead (from Stax2 extension API, v3.0)
`static String`	`P_MAX_ATTRIBUTE_SIZE` Maximum length of of individual attribute values (in characters)
`static String`	`P_MAX_ATTRIBUTES_PER_ELEMENT` Maximum number of attributes allowed for single XML element.
`static String`	`P_MAX_CHARACTERS` Maximum length of input document, in characters.
`static String`	`P_MAX_CHILDREN_PER_ELEMENT` Maximum number of child elements for any given element.
`static String`	`P_MAX_ELEMENT_COUNT` Maximum number of all elements in a single document.
`static String`	`P_MAX_ELEMENT_DEPTH` Maximum level of nesting of XML elements, starting with root element.
`static String`	`P_MAX_ENTITY_COUNT` Maximum number of total (general parsed) entity expansions within input.
`static String`	`P_MAX_ENTITY_DEPTH` Maximum depth of nested (general parsed) entity expansions.
`static String`	`P_MAX_TEXT_LENGTH` Maximum length of individual text (cdata) segments in input, in characters.
`static String`	`P_MIN_TEXT_SEGMENT` Property to specify shortest non-complete text segment (part of CDATA section or text content) that parser is allowed to return, if not required to coalesce text.
`static String`	`P_NORMALIZE_LFS` Feature that controls whether linefeeds are normalized into canonical linefeed as mandated by xml specification.
`static String`	`P_RETURN_NULL_FOR_DEFAULT_NAMESPACE` This read-only property indicates whether null is returned for default name space prefix; Boolean.TRUE indicates it does, Boolean.FALSE that it does not.
`static String`	`P_SUPPORT_DTDPP` Deprecated. Never implement, let's phase this out (deprecated in 4.2)
`static String`	`P_TREAT_CHAR_REFS_AS_ENTS` Whether the Reader will treat character references as entities while parsing XML documents.
`static String`	`P_UNDECLARED_ENTITY_RESOLVER` Property of type `XMLResolver`, that will allow graceful handling of references to undeclared (general) entities.
`static String`	`P_VALIDATE_TEXT_CHARS` Whether readers will verify that characters in text content are fully valid XML characters (not just Unicode).
`static WstxInputProperties.ParsingMode`	`PARSING_MODE_DOCUMENT`
`static WstxInputProperties.ParsingMode`	`PARSING_MODE_DOCUMENTS`
`static WstxInputProperties.ParsingMode`	`PARSING_MODE_FRAGMENT`
`static String`	`UNKNOWN_ATTR_TYPE` Constants used when no DTD handling is done, and we do not know the 'real' type of an attribute.

Constructor Summary

Constructors
Constructor and Description

WstxInputProperties()

Constructors
Constructor and Description
`WstxInputProperties()`

Method Summary
- Methods inherited from class java.lang.Object
  clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - UNKNOWN_ATTR_TYPE
```
public static final String UNKNOWN_ATTR_TYPE
```
    Constants used when no DTD handling is done, and we do not know the 'real' type of an attribute. Seems like CDATA is the safe choice.
    
    See Also:
    Constant Field Values
  - P_NORMALIZE_LFS
```
public static final String P_NORMALIZE_LFS
```
    Feature that controls whether linefeeds are normalized into canonical linefeed as mandated by xml specification.
    Note that disabling this property (from its default enabled state) will result in non-conforming XML processing. It may be useful for use cases where changes to input content should be minimized.
    Note: this property was initially removed from Woodstox 4.0, but was reintroduced in 4.0.8 due to user request.
    
    See Also:
    Constant Field Values
  - P_VALIDATE_TEXT_CHARS
```
public static final String P_VALIDATE_TEXT_CHARS
```
    Whether readers will verify that characters in text content are fully valid XML characters (not just Unicode). If true, will check that they are valid (including white space); if false, will not check.
    Note that this property will NOT have effect on all encoding problems, specifically:
    - UTF-8 decoder will still report invalid UTF-8 byte sequences (and same for other character encodings).
    - XML Name character rules follow separate validation which will not be affected
    Turning this option off may improve parsing performance; leaving it on guarantees compatibility with XML 1.0 specs regarding character validity rules.
    See Also:
    Constant Field Values
  - P_CACHE_DTDS
```
public static final String P_CACHE_DTDS
```
    Whether readers will try to cache parsed external DTD subsets or not.
    
    See Also:
    Constant Field Values
  - P_CACHE_DTDS_BY_PUBLIC_ID
```
public static final String P_CACHE_DTDS_BY_PUBLIC_ID
```
    Whether reader is to cache DTDs (when caching enabled) based on public id or not: if not, system id will be primarily used. Although theoretically public IDs should be unique, and should be good caching keys, sometimes broken documents use 'wrong' public IDs, and such by default caching keys are based on system id only.
    
    See Also:
    Constant Field Values
  - P_LAZY_PARSING
```
@Deprecated
public static final String P_LAZY_PARSING
```
    Deprecated. As of Woodstox 4.0 use XMLInputFactory2.P_LAZY_PARSING instead (from Stax2 extension API, v3.0)
    
    Whether stream readers are allowed to do lazy parsing, meaning to parse minimal part of the event when XMLStreamReader.next() is called, and only parse the rest as needed (or skip remainder of no extra information is needed). Alternative to lazy parsing is called "eager parsing", and is what most xml parsers use by default.
    Enabling lazy parsing can improve performance for tasks where number of textual events are skipped. The downside is that not all well-formedness problems are reported when XMLStreamReader.next() is called, but only when the rest of event are read or skipped.
    Default value for Woodstox is such that lazy parsing is enabled.
    
    See Also:
    Constant Field Values
  - P_RETURN_NULL_FOR_DEFAULT_NAMESPACE
```
public static final String P_RETURN_NULL_FOR_DEFAULT_NAMESPACE
```
    This read-only property indicates whether null is returned for default name space prefix; Boolean.TRUE indicates it does, Boolean.FALSE that it does not.
    Default value for 4.1 is 'false'; this will most likely change for 5.0 since Stax API actually specifies null to be used.
    
    Since:
    
    4.1.2
    
    See Also:
    Constant Field Values
  - P_SUPPORT_DTDPP
```
@Deprecated
public static final String P_SUPPORT_DTDPP
```
    Deprecated. Never implement, let's phase this out (deprecated in 4.2)
    
    Whether the Reader will recognized DTD++ extensions when parsing DTD subsets.
    Note: not implemented by Woodstox.
    
    See Also:
    Constant Field Values
  - P_TREAT_CHAR_REFS_AS_ENTS
```
public static final String P_TREAT_CHAR_REFS_AS_ENTS
```
    Whether the Reader will treat character references as entities while parsing XML documents.
    
    See Also:
    Constant Field Values
  - P_INPUT_BUFFER_LENGTH
```
public static final String P_INPUT_BUFFER_LENGTH
```
    Size of input buffer (in chars), to use for reading XML content from input stream/reader.
    
    See Also:
    Constant Field Values
  - P_MIN_TEXT_SEGMENT
```
public static final String P_MIN_TEXT_SEGMENT
```
    Property to specify shortest non-complete text segment (part of CDATA section or text content) that parser is allowed to return, if not required to coalesce text.
    
    See Also:
    Constant Field Values
  - P_MAX_ATTRIBUTES_PER_ELEMENT
```
public static final String P_MAX_ATTRIBUTES_PER_ELEMENT
```
    Maximum number of attributes allowed for single XML element.
    
    Since:
    
    4.2
    
    See Also:
    Constant Field Values
  - P_MAX_ATTRIBUTE_SIZE
```
public static final String P_MAX_ATTRIBUTE_SIZE
```
    Maximum length of of individual attribute values (in characters)
    
    Since:
    
    4.2
    
    See Also:
    Constant Field Values
  - P_MAX_CHILDREN_PER_ELEMENT
```
public static final String P_MAX_CHILDREN_PER_ELEMENT
```
    Maximum number of child elements for any given element.
    
    Since:
    
    4.2
    
    See Also:
    Constant Field Values
  - P_MAX_ELEMENT_COUNT
```
public static final String P_MAX_ELEMENT_COUNT
```
    Maximum number of all elements in a single document.
    
    Since:
    
    4.2
    
    See Also:
    Constant Field Values
  - P_MAX_ELEMENT_DEPTH
```
public static final String P_MAX_ELEMENT_DEPTH
```
    Maximum level of nesting of XML elements, starting with root element.
    
    Since:
    
    4.2
    
    See Also:
    Constant Field Values
  - P_MAX_CHARACTERS
```
public static final String P_MAX_CHARACTERS
```
    Maximum length of input document, in characters.
    
    Since:
    
    4.2
    
    See Also:
    Constant Field Values
  - P_MAX_TEXT_LENGTH
```
public static final String P_MAX_TEXT_LENGTH
```
    Maximum length of individual text (cdata) segments in input, in characters.
    
    Since:
    
    4.2
    
    See Also:
    Constant Field Values
  - P_MAX_ENTITY_COUNT
```
public static final String P_MAX_ENTITY_COUNT
```
    Maximum number of total (general parsed) entity expansions within input.
    
    Since:
    
    4.3
    
    See Also:
    Constant Field Values
  - P_MAX_ENTITY_DEPTH
```
public static final String P_MAX_ENTITY_DEPTH
```
    Maximum depth of nested (general parsed) entity expansions.
    
    Since:
    
    4.3
    
    See Also:
    Constant Field Values
  - P_CUSTOM_INTERNAL_ENTITIES
```
@Deprecated
public static final String P_CUSTOM_INTERNAL_ENTITIES
```
    Deprecated. This feature may be removed from future versions of Woodstox, since the same functionality can be achieved by using custom entity resolvers.
    
    Property of type Map, that defines explicit set of internal (generic) entities that will define of override any entities defined in internal or external subsets; except for the 5 pre-defined entities (lt, gt, amp, apos, quot). Can be used to explicitly define entites that would normally come from a DTD.
    
    See Also:
    Constant Field Values
  - P_DTD_RESOLVER
```
public static final String P_DTD_RESOLVER
```
    Property of type XMLResolver, that will allow overriding of default DTD and external parameter entity resolution.
    
    See Also:
    Constant Field Values
  - P_ENTITY_RESOLVER
```
public static final String P_ENTITY_RESOLVER
```
    Property of type XMLResolver, that will allow overriding of default external general entity resolution. Note that using this property overrides settings done using XMLInputFactory.RESOLVER (and vice versa).
    
    See Also:
    Constant Field Values
  - P_UNDECLARED_ENTITY_RESOLVER
```
public static final String P_UNDECLARED_ENTITY_RESOLVER
```
    Property of type XMLResolver, that will allow graceful handling of references to undeclared (general) entities.
    
    See Also:
    Constant Field Values
  - P_BASE_URL
```
public static final String P_BASE_URL
```
    Property of type URL, that will allow specifying context URL to use when resolving relative references, for the main-level entities (external DTD subset, references from the internal DTD subset).
    
    See Also:
    Constant Field Values
  - P_INPUT_PARSING_MODE
```
public static final String P_INPUT_PARSING_MODE
```
    Three-valued property (one of PARSING_MODE_DOCUMENT, PARSING_MODE_FRAGMENT or PARSING_MODE_DOCUMENTS; default being the document mode) that can be used to handle "non-standard" XML content. The default mode (PARSING_MODE_DOCUMENT) allows parsing of only well-formed XML documents, but the other two modes allow more lenient parsing. Fragment mode allows parsing of XML content that does not have a single root element (can have zero or more), nor can have XML or DOCTYPE declarations: this may be useful if parsing a subset of a full XML document. Multi-document (PARSING_MODE_DOCUMENTS) mode on the other hand allows parsing of a stream that contains multiple consequtive well-formed documents, with possibly multiple XML and DOCTYPE declarations.
    The main difference from the API perspective is that in first two modes, START_DOCUMENT and END_DOCUMENT are used as usual (as the first and last events returned), whereas the multi-document mode can return multiple pairs of these events: although it is still true that the first event (one cursor points to when reader is instantiated or returned by the event reader), there may be intervening pairs that signal boundary between two adjacent enclosed documents.
    
    See Also:
    Constant Field Values
  - PARSING_MODE_DOCUMENT
```
public static final WstxInputProperties.ParsingMode PARSING_MODE_DOCUMENT
```
  - PARSING_MODE_FRAGMENT
```
public static final WstxInputProperties.ParsingMode PARSING_MODE_FRAGMENT
```
  - PARSING_MODE_DOCUMENTS
```
public static final WstxInputProperties.ParsingMode PARSING_MODE_DOCUMENTS
```
- Constructor Detail
  - WstxInputProperties
```
public WstxInputProperties()
```

Class WstxInputProperties

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

UNKNOWN_ATTR_TYPE

P_NORMALIZE_LFS

P_VALIDATE_TEXT_CHARS

P_CACHE_DTDS

P_CACHE_DTDS_BY_PUBLIC_ID

P_LAZY_PARSING

P_RETURN_NULL_FOR_DEFAULT_NAMESPACE

P_SUPPORT_DTDPP

P_TREAT_CHAR_REFS_AS_ENTS

P_INPUT_BUFFER_LENGTH

P_MIN_TEXT_SEGMENT

P_MAX_ATTRIBUTES_PER_ELEMENT

P_MAX_ATTRIBUTE_SIZE

P_MAX_CHILDREN_PER_ELEMENT

P_MAX_ELEMENT_COUNT

P_MAX_ELEMENT_DEPTH

P_MAX_CHARACTERS

P_MAX_TEXT_LENGTH

P_MAX_ENTITY_COUNT

P_MAX_ENTITY_DEPTH

P_CUSTOM_INTERNAL_ENTITIES

P_DTD_RESOLVER

P_ENTITY_RESOLVER

P_UNDECLARED_ENTITY_RESOLVER

P_BASE_URL

P_INPUT_PARSING_MODE

PARSING_MODE_DOCUMENT

PARSING_MODE_FRAGMENT

PARSING_MODE_DOCUMENTS

Constructor Detail

WstxInputProperties