XmlPull v1 API Properties That Were Never Used ...

The property mechanism allows to pass information to XmlPull parser implementation that is not part of API.

Please note: the key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.

Standard properties

Currently there is no standard properties defined.

 


Optional properties

They MAY be supported but are not part of XmlPull API.

Please report them to XmlPull discussion group so they can be added here and made easier to discover.

 

NOTE:

to detect if optional property is supported try to call getProperty() and only if it returns non-null value it can be assumed that the property is supported. Parser implementation is required to return null for all unknown properties names as null is assumed to be default value for all properties.

 

Optional property: PUBLIC IDENTIFIER

This property is identified by http://xmlpull.org/v1/doc/properties.html#public-identifier

Irregardless of value of PROCESS DOCDECL feature this property can be used to retrieve system identifier from DOCDECL if DOCDECL was present in XML input.

Property value is available and as soon as DOCDECL is read (by next()) or read and reported (by nextToken()) and is derived from ExternalID declared by doctypedecl.

If there was no system identifier declared this property has null value.

 

Optional property: SYSTEM IDENTIFIER

This property is identified by http://xmlpull.org/v1/doc/properties.html#system-identifier

Irregardless of value of PROCESS DOCDECL feature this property can be used to retrieve system identifier from DOCDECL if DOCDECL was present in XML input.

Property value is available as soon as DOCDECL is read (by next()) or read and reported (by nextToken()) and is derived from ExternalID declared by doctypedecl.

If there is no external subset this property has no value.

 


Aleksander Slominski