- java.lang.Object
-
- org.xml.sax.helpers.AttributesImpl
-
- org.xml.sax.ext.Attributes2Impl
-
- All Implemented Interfaces:
- Attributes, Attributes2
public class Attributes2Impl extends AttributesImpl implements Attributes2
SAX2 extension helper for additional Attributes information, implementing theAttributes2
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(int, boolean)
. 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 usingsetDeclared(int, boolean)
. If you change an attribute's type by hand, you may need to modify its declared flag to match.- Since:
- SAX 2.0 (extensions 1.1 alpha)
-
-
Constructor Summary
Constructors Constructor and Description Attributes2Impl()
Construct a new, empty Attributes2Impl object.Attributes2Impl(Attributes atts)
Copy an existing Attributes or Attributes2 object.
-
Method Summary
Methods Modifier and Type Method and Description void
addAttribute(String uri, String localName, String qName, String type, String value)
Add an attribute to the end of the list, setting its "specified" flag to true.boolean
isDeclared(int index)
Returns the current value of the attribute's "declared" flag.boolean
isDeclared(String qName)
Returns the current value of the attribute's "declared" flag.boolean
isDeclared(String uri, String localName)
Returns the current value of the attribute's "declared" flag.boolean
isSpecified(int index)
Returns the current value of an attribute's "specified" flag.boolean
isSpecified(String qName)
Returns the current value of an attribute's "specified" flag.boolean
isSpecified(String uri, String localName)
Returns the current value of an attribute's "specified" flag.void
removeAttribute(int index)
Remove an attribute from the list.void
setAttributes(Attributes atts)
Copy an entire Attributes object.void
setDeclared(int index, boolean value)
Assign a value to the "declared" flag of a specific attribute.void
setSpecified(int index, boolean value)
Assign a value to the "specified" flag of a specific attribute.-
Methods inherited from class org.xml.sax.helpers.AttributesImpl
clear, getIndex, getIndex, getLength, getLocalName, getQName, getType, getType, getType, getURI, getValue, getValue, getValue, setAttribute, setLocalName, setQName, setType, setURI, setValue
-
-
-
-
Constructor Detail
-
Attributes2Impl
public Attributes2Impl()
Construct a new, empty Attributes2Impl object.
-
Attributes2Impl
public Attributes2Impl(Attributes atts)
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
- The existing Attributes object.
-
-
Method Detail
-
isDeclared
public boolean isDeclared(int index)
Returns the current value of the attribute's "declared" flag.- Specified by:
isDeclared
in interfaceAttributes2
- Parameters:
index
- The attribute index (zero-based).- Returns:
- true if the attribute was declared in the DTD, false otherwise.
-
isDeclared
public boolean isDeclared(String uri, String localName)
Returns the current value of the attribute's "declared" flag.- Specified by:
isDeclared
in interfaceAttributes2
- Parameters:
uri
- The Namespace URI, or the empty string if the name has no Namespace URI.localName
- The attribute's local name.- Returns:
- true if the attribute was declared in the DTD, false otherwise.
-
isDeclared
public boolean isDeclared(String qName)
Returns the current value of the attribute's "declared" flag.- Specified by:
isDeclared
in interfaceAttributes2
- Parameters:
qName
- The XML qualified (prefixed) name.- Returns:
- true if the attribute was declared in the DTD, false otherwise.
-
isSpecified
public boolean isSpecified(int index)
Returns the current value of an attribute's "specified" flag.- Specified by:
isSpecified
in interfaceAttributes2
- Parameters:
index
- The attribute index (zero-based).- Returns:
- current flag value
- Throws:
ArrayIndexOutOfBoundsException
- When the supplied index does not identify an attribute.
-
isSpecified
public boolean isSpecified(String uri, String localName)
Returns the current value of an attribute's "specified" flag.- Specified by:
isSpecified
in interfaceAttributes2
- Parameters:
uri
- The Namespace URI, or the empty string if the name has no Namespace URI.localName
- The attribute's local name.- Returns:
- current flag value
- Throws:
IllegalArgumentException
- When the supplied names do not identify an attribute.
-
isSpecified
public boolean isSpecified(String qName)
Returns the current value of an attribute's "specified" flag.- Specified by:
isSpecified
in interfaceAttributes2
- Parameters:
qName
- The XML qualified (prefixed) name.- Returns:
- current flag value
- Throws:
IllegalArgumentException
- When the supplied name does not identify an attribute.
-
setAttributes
public void setAttributes(Attributes atts)
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.- Overrides:
setAttributes
in classAttributesImpl
- Parameters:
atts
- The attributes to copy.- See Also:
AttributesImpl.setAttributes(org.xml.sax.Attributes)
-
addAttribute
public void addAttribute(String uri, String localName, String qName, String type, String value)
Add an attribute to the end of the list, setting its "specified" flag to true. To set that flag's value to false, usesetSpecified(int, boolean)
.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(int, boolean)
.- Overrides:
addAttribute
in classAttributesImpl
- Parameters:
uri
- The Namespace URI, or the empty string if none is available or Namespace processing is not being performed.localName
- The local name, or the empty string if Namespace processing is not being performed.qName
- The qualified (prefixed) name, or the empty string if qualified names are not available.type
- The attribute type as a string.value
- The attribute value.- See Also:
AttributesImpl.addAttribute(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String)
-
removeAttribute
public void removeAttribute(int index)
Description copied from class:AttributesImpl
Remove an attribute from the list.- Overrides:
removeAttribute
in classAttributesImpl
- Parameters:
index
- The index of the attribute (zero-based).
-
setDeclared
public void setDeclared(int index, boolean value)
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
- The index of the attribute (zero-based).value
- The desired flag value.- Throws:
ArrayIndexOutOfBoundsException
- When the supplied index does not identify an attribute.- See Also:
AttributesImpl.setType(int, java.lang.String)
-
setSpecified
public void setSpecified(int index, boolean value)
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
- The index of the attribute (zero-based).value
- The desired flag value.- Throws:
ArrayIndexOutOfBoundsException
- When the supplied index does not identify an attribute.
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
22/12/2024 12:35:01 Cette version de la page est en cache (à la date du 22/12/2024 12:35:01) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 30/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-org/xml/sax/ext/attributes2impl.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.