Attributes2Impl
open class Attributes2Impl : AttributesImpl, Attributes2
SAX2 extension helper for additional Attributes information, implementing the Attributes2
interface. This module, both source code and documentation, is in the Public Domain, and comes with NO WARRANTY.
This is not part of core-only SAX2 distributions.
The specified flag for each attribute will always be true, unless it has been set to false in the copy constructor or using setSpecified
. Similarly, the declared flag for each attribute will always be false, except for defaulted attributes (specified is false), non-CDATA attributes, or when it is set to true using setDeclared
. If you change an attribute's type by hand, you may need to modify its declared flag to match.
Summary
Public constructors |
Construct a new, empty Attributes2Impl object.
|
Copy an existing Attributes or Attributes2 object.
|
Public methods |
open Unit |
Add an attribute to the end of the list, setting its "specified" flag to true.
|
open Boolean |
|
open Boolean |
|
open Boolean |
|
open Boolean |
Returns the current value of an attribute's "specified" flag.
|
open Boolean |
Returns the current value of an attribute's "specified" flag.
|
open Boolean |
Returns the current value of an attribute's "specified" flag.
|
open Unit |
|
open Unit |
Copy an entire Attributes object.
|
open Unit |
Assign a value to the "declared" flag of a specific attribute.
|
open Unit |
Assign a value to the "specified" flag of a specific attribute.
|
Inherited functions |
From class AttributesImpl
Unit |
clear()
Clear the attribute list for reuse.
Note that little memory is freed by this call: the current array is kept so it can be reused.
|
Int |
getIndex(uri: String!, localName: String!)
Look up an attribute's index by Namespace name.
In many cases, it will be more efficient to look up the name once and use the index query methods rather than using the name query methods repeatedly.
|
Int |
getIndex(qName: String!)
Look up an attribute's index by qualified (prefixed) name.
|
Int |
getLength()
Return the number of attributes in the list.
|
String! |
getLocalName(index: Int)
Return an attribute's local name.
|
String! |
getQName(index: Int)
Return an attribute's qualified (prefixed) name.
|
String! |
getType(index: Int)
Return an attribute's type by index.
|
String! |
getType(uri: String!, localName: String!)
Look up an attribute's type by Namespace-qualified name.
|
String! |
getType(qName: String!)
Look up an attribute's type by qualified (prefixed) name.
|
String! |
getURI(index: Int)
Return an attribute's Namespace URI.
|
String! |
getValue(index: Int)
Return an attribute's value by index.
|
String! |
getValue(uri: String!, localName: String!)
Look up an attribute's value by Namespace-qualified name.
|
String! |
getValue(qName: String!)
Look up an attribute's value by qualified (prefixed) name.
|
Unit |
setAttribute(index: Int, uri: String!, localName: String!, qName: String!, type: String!, value: String!)
Set an attribute in the list.
For the sake of speed, this method does no checking for name conflicts or well-formedness: such checks are the responsibility of the application.
|
Unit |
setLocalName(index: Int, localName: String!)
Set the local name of a specific attribute.
|
Unit |
setQName(index: Int, qName: String!)
Set the qualified name of a specific attribute.
|
Unit |
setType(index: Int, type: String!)
Set the type of a specific attribute.
|
Unit |
setURI(index: Int, uri: String!)
Set the Namespace URI of a specific attribute.
|
Unit |
setValue(index: Int, value: String!)
Set the value of a specific attribute.
|
|
Public constructors
Attributes2Impl
Attributes2Impl()
Construct a new, empty Attributes2Impl object.
Attributes2Impl
Attributes2Impl(atts: Attributes!)
Copy an existing Attributes or Attributes2 object. If the object implements Attributes2, values of the specified and declared flags for each attribute are copied. Otherwise the flag values are defaulted to assume no DTD was used, unless there is evidence to the contrary (such as attributes with type other than CDATA, which must have been declared).
This constructor is especially useful inside a startElement
event.
Parameters |
atts |
Attributes!: The existing Attributes object. |
Public methods
addAttribute
open fun addAttribute(
uri: String!,
localName: String!,
qName: String!,
type: String!,
value: String!
): Unit
Add an attribute to the end of the list, setting its "specified" flag to true. To set that flag's value to false, use setSpecified
.
Unless the attribute type is CDATA, this attribute is marked as being declared in the DTD. To set that flag's value to true for CDATA attributes, use setDeclared
.
Parameters |
uri |
String!: The Namespace URI, or the empty string if none is available or Namespace processing is not being performed. |
localName |
String!: The local name, or the empty string if Namespace processing is not being performed. |
qName |
String!: The qualified (prefixed) name, or the empty string if qualified names are not available. |
type |
String!: The attribute type as a string. |
value |
String!: The attribute value. |
isDeclared
open fun isDeclared(index: Int): Boolean
Parameters |
index |
Int: The attribute index (zero-based). |
Return |
Boolean |
true if the attribute was declared in the DTD, false otherwise. |
isDeclared
open fun isDeclared(
uri: String!,
localName: String!
): Boolean
Parameters |
uri |
String!: The Namespace URI, or the empty string if the name has no Namespace URI. |
localName |
String!: The attribute's local name. |
Return |
Boolean |
true if the attribute was declared in the DTD, false otherwise. |
isDeclared
open fun isDeclared(qName: String!): Boolean
Parameters |
qName |
String!: The XML qualified (prefixed) name. |
Return |
Boolean |
true if the attribute was declared in the DTD, false otherwise. |
isSpecified
open fun isSpecified(index: Int): Boolean
Returns the current value of an attribute's "specified" flag.
Parameters |
index |
Int: The attribute index (zero-based). |
Exceptions |
java.lang.ArrayIndexOutOfBoundsException |
When the supplied index does not identify an attribute. |
isSpecified
open fun isSpecified(
uri: String!,
localName: String!
): Boolean
Returns the current value of an attribute's "specified" flag.
Parameters |
uri |
String!: The Namespace URI, or the empty string if the name has no Namespace URI. |
localName |
String!: The attribute's local name. |
Exceptions |
java.lang.IllegalArgumentException |
When the supplied names do not identify an attribute. |
isSpecified
open fun isSpecified(qName: String!): Boolean
Returns the current value of an attribute's "specified" flag.
Parameters |
qName |
String!: The XML qualified (prefixed) name. |
Exceptions |
java.lang.IllegalArgumentException |
When the supplied name does not identify an attribute. |
removeAttribute
open fun removeAttribute(index: Int): Unit
Parameters |
index |
Int: The index of the attribute (zero-based). |
setAttributes
open fun setAttributes(atts: Attributes!): Unit
Copy an entire Attributes object. The "specified" flags are assigned as true, and "declared" flags as false (except when an attribute's type is not CDATA), unless the object is an Attributes2 object. In that case those flag values are all copied.
Parameters |
atts |
Attributes!: The attributes to copy. |
setDeclared
open fun setDeclared(
index: Int,
value: Boolean
): Unit
Assign a value to the "declared" flag of a specific attribute. This is normally needed only for attributes of type CDATA, including attributes whose type is changed to or from CDATA.
Parameters |
index |
Int: The index of the attribute (zero-based). |
value |
Boolean: The desired flag value. |
Exceptions |
java.lang.ArrayIndexOutOfBoundsException |
When the supplied index does not identify an attribute. |
setSpecified
open fun setSpecified(
index: Int,
value: Boolean
): Unit
Assign a value to the "specified" flag of a specific attribute. This is the only way this flag can be cleared, except clearing by initialization with the copy constructor.
Parameters |
index |
Int: The index of the attribute (zero-based). |
value |
Boolean: The desired flag value. |
Exceptions |
java.lang.ArrayIndexOutOfBoundsException |
When the supplied index does not identify an attribute. |