Package com.ctc.wstx.dtd

Class DTDSubsetImpl

java.lang.Object

com.ctc.wstx.dtd.DTDSubset

com.ctc.wstx.dtd.DTDSubsetImpl

All Implemented Interfaces:

org.codehaus.stax2.validation.DTDValidationSchema, org.codehaus.stax2.validation.XMLValidationSchema

public final class DTDSubsetImpl
extends DTDSubset

The default implementation of DTDSubset

Field Summary

Fields

Modifier and Type	Field	Description
(package private) final HashMap<String,EntityDecl>	mDefinedPEs	Map (name-to-WEntityDeclaration) that contains all parameter entities defined by this subset.
(package private) final HashMap<PrefixedName,DTDElement>	mElements
(package private) final boolean	mFullyValidating	Whether this subset has full validation information; and consequently whether it will do actual validation, or just allow access to type information, notations, entities, and add default attribute values.
(package private) final HashMap<String,EntityDecl>	mGeneralEntities	Map (name-to-EntityDecl) of general entity declarations (internal, external) for this DTD subset.
(package private) List<EntityDecl>	mGeneralEntityList	Lazily instantiated List that contains all notations from mGeneralEntities (preferably in their declaration order; depends on whether platform, ie.
(package private) final boolean	mHasNsDefaults	Flag that indicates whether any of the elements declarared has any attribute default values for namespace pseudo-attributes.
(package private) final boolean	mIsCachable	Whether this subset is cachable.
(package private) final HashMap<String,Location>	mNotationForwardRefs	Notation references made in this subset that had not been resolved by the time parsing of this subset finished.
(package private) List<NotationDeclaration>	mNotationList	Lazily instantiated List that contains all notations from mNotations (preferably in their declaration order; depends on whether platform, ie.
(package private) final HashMap<String,NotationDeclaration>	mNotations	Map (name-to-NotationDecl) that this subset has defined.
(package private) final Set<String>	mRefdGEs	Set of names of general entities references by this subset.
(package private) final Set<String>	mRefdPEs	Set of names of parameter entities references by this subset.

Fields inherited from interface org.codehaus.stax2.validation.XMLValidationSchema

SCHEMA_ID_DTD, SCHEMA_ID_RELAXNG, SCHEMA_ID_TREX, SCHEMA_ID_W3C_SCHEMA

Constructor Summary

Constructors

Modifier	Constructor	Description
private	DTDSubsetImpl(boolean cachable, HashMap<String,EntityDecl> genEnt, Set<String> refdGEs, HashMap<String,EntityDecl> paramEnt, Set<String> peRefs, HashMap<String,NotationDeclaration> notations, HashMap<PrefixedName,DTDElement> elements, boolean fullyValidating, HashMap<String,Location> notationForwardRefs)

Method Summary

Modifier and Type	Method	Description
private static void	checkNotations(HashMap<String,NotationDeclaration> fromInt, HashMap<String,NotationDeclaration> fromExt)
private void	combineElements(InputProblemReporter rep, HashMap<PrefixedName,DTDElement> intElems, HashMap<PrefixedName,DTDElement> extElems)	Method that will try to merge in elements defined in the external subset, into internal subset; it will also check for redeclarations when doing this, as it's invalid to redeclare elements.
private static <K, V> void	combineMaps(Map<K,V> m1, Map<K,V> m2)	Note: The first Map argument WILL be modified; second one not.
DTDSubset	combineWithExternalSubset(InputProblemReporter rep, DTDSubset extSubset)	Method that will combine definitions from internal and external subsets, producing a single DTD set.
static DTDSubsetImpl	constructInstance(boolean cachable, HashMap<String,EntityDecl> genEnt, Set<String> refdGEs, HashMap<String,EntityDecl> paramEnt, Set<String> refdPEs, HashMap<String,NotationDeclaration> notations, HashMap<PrefixedName,DTDElement> elements, boolean fullyValidating)
static DTDSubsetImpl	constructInstance(boolean cachable, HashMap<String,EntityDecl> genEnt, Set<String> refdGEs, HashMap<String,EntityDecl> paramEnt, Set<String> refdPEs, HashMap<String,NotationDeclaration> notations, HashMap<PrefixedName,DTDElement> elements, boolean fullyValidating, HashMap<String,Location> notationForwardRefs)
org.codehaus.stax2.validation.XMLValidator	createValidator(org.codehaus.stax2.validation.ValidationContext ctxt)
HashMap<PrefixedName,DTDElement>	getElementMap()
int	getEntityCount()
List<EntityDecl>	getGeneralEntityList()
HashMap<String,EntityDecl>	getGeneralEntityMap()
int	getNotationCount()
List<NotationDeclaration>	getNotationList()
HashMap<String,NotationDeclaration>	getNotationMap()
HashMap<String,EntityDecl>	getParameterEntityMap()
boolean	isCachable()
boolean	isReusableWith(DTDSubset intSubset)	Method used in determining whether cached external subset instance can be used with specified internal subset.
static void	throwElementException(DTDElement oldElem, Location loc)
static void	throwNotationException(NotationDeclaration oldDecl, NotationDeclaration newDecl)
String	toString()

Methods inherited from class com.ctc.wstx.dtd.DTDSubset

getSchemaType

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

mIsCachable

final boolean mIsCachable

Whether this subset is cachable. Only those external subsets that do not refer to PEs defined by internal subsets (or GEs via default attribute value expansion) are cachable.

mFullyValidating

final boolean mFullyValidating

Whether this subset has full validation information; and consequently whether it will do actual validation, or just allow access to type information, notations, entities, and add default attribute values.

mHasNsDefaults

final boolean mHasNsDefaults

Flag that indicates whether any of the elements declarared has any attribute default values for namespace pseudo-attributes.

mGeneralEntities

final HashMap<String,EntityDecl> mGeneralEntities

Map (name-to-EntityDecl) of general entity declarations (internal, external) for this DTD subset.

mGeneralEntityList

transient volatile List<EntityDecl> mGeneralEntityList

Lazily instantiated List that contains all notations from mGeneralEntities (preferably in their declaration order; depends on whether platform, ie. JDK version, has insertion-ordered Maps available), used by DTD event Objects.

mRefdGEs

final Set<String> mRefdGEs

Set of names of general entities references by this subset. Note that only those GEs that are referenced by default attribute value definitions count, since GEs in text content are only expanded when reading documents, but attribute default values are expanded when reading DTD subset itself.

Needed for determinining if external subset materially depends on definitions from internal subset; if so, such subset is not cachable. This also means that information is not stored for non-cachable instance.

mDefinedPEs

final HashMap<String,EntityDecl> mDefinedPEs

Map (name-to-WEntityDeclaration) that contains all parameter entities defined by this subset. May be empty if such information will not be needed for use; for example, external subset's definitions are needed, nor are combined DTD set's.

mRefdPEs

final Set<String> mRefdPEs

Set of names of parameter entities references by this subset. Needed when determinining if external subset materially depends on definitions from internal subset, which is needed to know when caching external subsets.

Needed for determinining if external subset materially depends on definitions from internal subset; if so, such subset is not cachable. This also means that information is not stored for non-cachable instance.

mNotations

final HashMap<String,NotationDeclaration> mNotations

Map (name-to-NotationDecl) that this subset has defined.

mNotationList

transient List<NotationDeclaration> mNotationList

Lazily instantiated List that contains all notations from mNotations (preferably in their declaration order; depends on whether platform, ie. JDK version, has insertion-ordered Maps available), used by DTD event Objects.

mNotationForwardRefs

final HashMap<String,Location> mNotationForwardRefs

Notation references made in this subset that had not been resolved by the time parsing of this subset finished. Used by combineWithExternalSubset(InputProblemReporter, DTDSubset) to validate against the combined notation map. See [woodstox-core#184]. Only set for internal subsets; always null for external or combined subsets.

mElements

final HashMap<PrefixedName,DTDElement> mElements

Constructor Details

DTDSubsetImpl

private DTDSubsetImpl(boolean cachable,
 HashMap<String,EntityDecl> genEnt,
 Set<String> refdGEs,
 HashMap<String,EntityDecl> paramEnt,
 Set<String> peRefs,
 HashMap<String,NotationDeclaration> notations,
 HashMap<PrefixedName,DTDElement> elements,
 boolean fullyValidating,
 HashMap<String,Location> notationForwardRefs)

Method Details

constructInstance

public static DTDSubsetImpl constructInstance(boolean cachable,
 HashMap<String,EntityDecl> genEnt,
 Set<String> refdGEs,
 HashMap<String,EntityDecl> paramEnt,
 Set<String> refdPEs,
 HashMap<String,NotationDeclaration> notations,
 HashMap<PrefixedName,DTDElement> elements,
 boolean fullyValidating)

constructInstance

public static DTDSubsetImpl constructInstance(boolean cachable,
 HashMap<String,EntityDecl> genEnt,
 Set<String> refdGEs,
 HashMap<String,EntityDecl> paramEnt,
 Set<String> refdPEs,
 HashMap<String,NotationDeclaration> notations,
 HashMap<PrefixedName,DTDElement> elements,
 boolean fullyValidating,
 HashMap<String,Location> notationForwardRefs)

Since:

7.2

combineWithExternalSubset

public DTDSubset combineWithExternalSubset(InputProblemReporter rep,
 DTDSubset extSubset)
                                    throws XMLStreamException

Method that will combine definitions from internal and external subsets, producing a single DTD set.

Specified by:

combineWithExternalSubset in class DTDSubset

Throws:

XMLStreamException

createValidator

public org.codehaus.stax2.validation.XMLValidator createValidator(org.codehaus.stax2.validation.ValidationContext ctxt)
                                                           throws XMLStreamException

Specified by:

createValidator in interface org.codehaus.stax2.validation.XMLValidationSchema

Specified by:

createValidator in class DTDSubset

Throws:

XMLStreamException

getEntityCount

public int getEntityCount()

Specified by:

getEntityCount in interface org.codehaus.stax2.validation.DTDValidationSchema

Specified by:

getEntityCount in class DTDSubset

getNotationCount

public int getNotationCount()

Specified by:

getNotationCount in interface org.codehaus.stax2.validation.DTDValidationSchema

Specified by:

getNotationCount in class DTDSubset

isCachable

public boolean isCachable()

Specified by:

isCachable in class DTDSubset

getGeneralEntityMap

public HashMap<String,EntityDecl> getGeneralEntityMap()

Specified by:

getGeneralEntityMap in class DTDSubset

getGeneralEntityList

public List<EntityDecl> getGeneralEntityList()

Specified by:

getGeneralEntityList in class DTDSubset

getParameterEntityMap

public HashMap<String,EntityDecl> getParameterEntityMap()

Specified by:

getParameterEntityMap in class DTDSubset

getNotationMap

public HashMap<String,NotationDeclaration> getNotationMap()

Specified by:

getNotationMap in class DTDSubset

getNotationList

public List<NotationDeclaration> getNotationList()

Specified by:

getNotationList in class DTDSubset

getElementMap

public HashMap<PrefixedName,DTDElement> getElementMap()

Specified by:

getElementMap in class DTDSubset

isReusableWith

public boolean isReusableWith(DTDSubset intSubset)

Method used in determining whether cached external subset instance can be used with specified internal subset. If ext. subset references any parameter/general entities int subset (re-)defines, it can not; otherwise it can be used.

Specified by:

isReusableWith in class DTDSubset

Returns:

True if this (external) subset refers to a parameter entity defined in passed-in internal subset.

toString

public String toString()

Overrides:

toString in class Object

throwNotationException

public static void throwNotationException(NotationDeclaration oldDecl,
 NotationDeclaration newDecl)
                                   throws XMLStreamException

Throws:

XMLStreamException

throwElementException

public static void throwElementException(DTDElement oldElem,
 Location loc)
                                  throws XMLStreamException

Throws:

XMLStreamException

combineMaps

private static <K,
V> void combineMaps(Map<K,V> m1,
 Map<K,V> m2)

Note: The first Map argument WILL be modified; second one not. Caller needs to ensure this is acceptable.

combineElements

private void combineElements(InputProblemReporter rep,
 HashMap<PrefixedName,DTDElement> intElems,
 HashMap<PrefixedName,DTDElement> extElems)
                      throws XMLStreamException

Method that will try to merge in elements defined in the external subset, into internal subset; it will also check for redeclarations when doing this, as it's invalid to redeclare elements. Care has to be taken to only check actual redeclarations: placeholders should not cause problems.

Throws:

XMLStreamException

checkNotations

private static void checkNotations(HashMap<String,NotationDeclaration> fromInt,
 HashMap<String,NotationDeclaration> fromExt)
                            throws XMLStreamException

Throws:

XMLStreamException