Attribute

java.lang.Object
- org.jdom2.Attribute

所有已实现的接口:

java.io.Serializable, java.lang.Cloneable, NamespaceAware
```
public class Attribute
extends java.lang.Object
implements NamespaceAware, java.io.Serializable, java.lang.Cloneable
```
An XML attribute. Methods allow the user to obtain the value of the attribute as well as namespace and type information.
JDOM 1.x Compatibility Note:
The Attribute class in JDOM 1.x had a number of int Constants declared to represent different Attribute Types. JDOM2 has introduced an AttributeType enumeration instead. To facilitate compatibility and to simplify JDOM 1.x migrations, the replacement AttributeType enums are referenced still using the JDOM 1.x constant names. In JDOM 1.x these names referenced constant int values. In JDOM2 these names reference Enum constants.

作者:

Brett McLaughlin, Jason Hunter, Elliotte Rusty Harold, Wesley Biggs, Victor Toni, Rolf Lear

另请参阅:

序列化表格

字段概要

字段
限定符和类型	字段和说明
`static AttributeType`	`CDATA_TYPE` JDOM 1.x compatible reference to `AttributeType.CDATA`
`static AttributeType`	`ENTITIES_TYPE` JDOM 1.x compatible reference to `AttributeType.ENTITIES`
`static AttributeType`	`ENTITY_TYPE` JDOM 1.x compatible reference to `AttributeType.ENTITY`
`static AttributeType`	`ENUMERATED_TYPE` JDOM 1.x compatible reference to `AttributeType.ENUMERATION`
`static AttributeType`	`ID_TYPE` JDOM 1.x compatible reference to `AttributeType.ID`
`static AttributeType`	`IDREF_TYPE` JDOM 1.x compatible reference to `AttributeType.IDREF`
`static AttributeType`	`IDREFS_TYPE` JDOM 1.x compatible reference to `AttributeType.IDREFS`
`static AttributeType`	`NMTOKEN_TYPE` JDOM 1.x compatible reference to `AttributeType.NMTOKEN`
`static AttributeType`	`NMTOKENS_TYPE` JDOM 1.x compatible reference to `AttributeType.NMTOKENS`
`static AttributeType`	`NOTATION_TYPE` JDOM 1.x compatible reference to `AttributeType.NOTATION`
`static AttributeType`	`UNDECLARED_TYPE` JDOM 1.x compatible reference to `AttributeType.UNDECLARED`

构造器概要

构造器
构造器和说明
`Attribute(java.lang.String name, java.lang.String value)` This will create a new `Attribute` with the specified (local) name and value, and does not place the attribute in a `Namespace`.
`Attribute(java.lang.String name, java.lang.String value, AttributeType type)` This will create a new `Attribute` with the specified (local) name, value and type, and does not place the attribute in a `Namespace`.
`Attribute(java.lang.String name, java.lang.String value, AttributeType type, Namespace namespace)` This will create a new `Attribute` with the specified (local) name, value, and type, and in the provided `Namespace`.
`Attribute(java.lang.String name, java.lang.String value, int type)` 已过时。 Use `Attribute(String, String, AttributeType)`
`Attribute(java.lang.String name, java.lang.String value, int type, Namespace namespace)` 已过时。 Use `Attribute(String, String, AttributeType, Namespace)`.
`Attribute(java.lang.String name, java.lang.String value, Namespace namespace)` This will create a new `Attribute` with the specified (local) name and value, and in the provided `Namespace`.

方法概要

所有方法实例方法具体方法已过时的方法
限定符和类型	方法和说明
`Attribute`	`clone()` Return a deep clone of this instance.
`Attribute`	`detach()` Detach this Attribute from its parent.
`AttributeType`	`getAttributeType()` This will return the declared type of this `Attribute`.
`boolean`	`getBooleanValue()` This gets the effective boolean value of the attribute, or throws a `DataConversionException` if a conversion can't be performed.
`Document`	`getDocument()` Get this Attribute's Document.
`double`	`getDoubleValue()` This gets the value of the attribute, in `double` form, and if no conversion can occur, throws a `DataConversionException`
`float`	`getFloatValue()` This gets the value of the attribute, in `float` form, and if no conversion can occur, throws a `DataConversionException`
`int`	`getIntValue()` This gets the value of the attribute, in `int` form, and if no conversion can occur, throws a `DataConversionException`
`long`	`getLongValue()` This gets the value of the attribute, in `long` form, and if no conversion can occur, throws a `DataConversionException`
`java.lang.String`	`getName()` This will retrieve the local name of the `Attribute`.
`Namespace`	`getNamespace()` This will return this `Attribute`'s `Namespace`.
`java.lang.String`	`getNamespacePrefix()` This will retrieve the namespace prefix of the `Attribute`.
`java.util.List<Namespace>`	`getNamespacesInherited()` Obtain a list of all namespaces that are in scope for this content, but were not introduced by this content.
`java.util.List<Namespace>`	`getNamespacesInScope()` Get the namespaces that are in-scope on this Attribute.
`java.util.List<Namespace>`	`getNamespacesIntroduced()` Obtain a list of all namespaces that are introduced to the XML tree by this node.
`java.lang.String`	`getNamespaceURI()` This returns the URI mapped to this `Attribute`'s prefix.
`Element`	`getParent()` This will return the parent of this `Attribute`.
`java.lang.String`	`getQualifiedName()` This will retrieve the qualified name of the `Attribute`.
`java.lang.String`	`getValue()` This will return the actual textual value of this `Attribute`.
`boolean`	`isSpecified()` Get the 'specified' flag.
`Attribute`	`setAttributeType(AttributeType type)` This will set the type of the `Attribute`.
`Attribute`	`setAttributeType(int type)` 已过时。 use `setAttributeType(AttributeType)`
`Attribute`	`setName(java.lang.String name)` This sets the local name of the `Attribute`.
`Attribute`	`setNamespace(Namespace namespace)` This sets this `Attribute`'s `Namespace`.
`void`	`setSpecified(boolean specified)` Change the specified flag to the given value.
`Attribute`	`setValue(java.lang.String value)` This will set the value of the `Attribute`.
`java.lang.String`	`toString()` This returns a `String` representation of the `Attribute`, suitable for debugging.

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 字段详细资料
  - UNDECLARED_TYPE
```
public static final AttributeType UNDECLARED_TYPE
```
    JDOM 1.x compatible reference to AttributeType.UNDECLARED
  - CDATA_TYPE
```
public static final AttributeType CDATA_TYPE
```
    JDOM 1.x compatible reference to AttributeType.CDATA
  - ID_TYPE
```
public static final AttributeType ID_TYPE
```
    JDOM 1.x compatible reference to AttributeType.ID
  - IDREF_TYPE
```
public static final AttributeType IDREF_TYPE
```
    JDOM 1.x compatible reference to AttributeType.IDREF
  - IDREFS_TYPE
```
public static final AttributeType IDREFS_TYPE
```
    JDOM 1.x compatible reference to AttributeType.IDREFS
  - ENTITY_TYPE
```
public static final AttributeType ENTITY_TYPE
```
    JDOM 1.x compatible reference to AttributeType.ENTITY
  - ENTITIES_TYPE
```
public static final AttributeType ENTITIES_TYPE
```
    JDOM 1.x compatible reference to AttributeType.ENTITIES
  - NMTOKEN_TYPE
```
public static final AttributeType NMTOKEN_TYPE
```
    JDOM 1.x compatible reference to AttributeType.NMTOKEN
  - NMTOKENS_TYPE
```
public static final AttributeType NMTOKENS_TYPE
```
    JDOM 1.x compatible reference to AttributeType.NMTOKENS
  - NOTATION_TYPE
```
public static final AttributeType NOTATION_TYPE
```
    JDOM 1.x compatible reference to AttributeType.NOTATION
  - ENUMERATED_TYPE
```
public static final AttributeType ENUMERATED_TYPE
```
    JDOM 1.x compatible reference to AttributeType.ENUMERATION
- 构造器详细资料
  - Attribute
```
public Attribute(java.lang.String name,
                 java.lang.String value,
                 Namespace namespace)
```
    This will create a new Attribute with the specified (local) name and value, and in the provided Namespace.
    
    参数:
    
    name - String name of Attribute.
    
    value - String value for new attribute.
    
    namespace - Namespace namespace for new attribute.
    
    抛出:
    
    IllegalNameException - if the given name is illegal as an attribute name or if if the new namespace is the default namespace. Attributes cannot be in a default namespace.
    
    IllegalDataException - if the given attribute value is illegal character data (as determined by Verifier.checkCharacterData(java.lang.String)).
  - Attribute
```
@Deprecated
public Attribute(java.lang.String name,
                              java.lang.String value,
                              int type,
                              Namespace namespace)
```
    已过时。 Use Attribute(String, String, AttributeType, Namespace).
    
    This will create a new Attribute with the specified (local) name, value, and type, and in the provided Namespace.
    
    参数:
    
    name - String name of Attribute.
    
    value - String value for new attribute.
    
    type - int type for new attribute.
    
    namespace - Namespace namespace for new attribute.
    
    抛出:
    
    IllegalNameException - if the given name is illegal as an attribute name or if if the new namespace is the default namespace. Attributes cannot be in a default namespace.
    
    IllegalDataException - if the given attribute value is illegal character data (as determined by Verifier.checkCharacterData(java.lang.String)) or if the given attribute type is not one of the supported types.
  - Attribute
```
public Attribute(java.lang.String name,
                 java.lang.String value,
                 AttributeType type,
                 Namespace namespace)
```
    This will create a new Attribute with the specified (local) name, value, and type, and in the provided Namespace.
    
    参数:
    
    name - String name of Attribute.
    
    value - String value for new attribute.
    
    type - AttributeType for new attribute.
    
    namespace - Namespace namespace for new attribute.
    
    抛出:
    
    IllegalNameException - if the given name is illegal as an attribute name or if if the new namespace is the default namespace. Attributes cannot be in a default namespace.
    
    IllegalDataException - if the given attribute value is illegal character data (as determined by Verifier.checkCharacterData(java.lang.String)) or if the given attribute type is not one of the supported types.
  - Attribute
```
public Attribute(java.lang.String name,
                 java.lang.String value)
```
    This will create a new Attribute with the specified (local) name and value, and does not place the attribute in a Namespace.
    Note: This actually explicitly puts the Attribute in the "empty" Namespace (Namespace.NO_NAMESPACE).
    
    参数:
    
    name - String name of Attribute.
    
    value - String value for new attribute.
    
    抛出:
    
    IllegalNameException - if the given name is illegal as an attribute name.
    
    IllegalDataException - if the given attribute value is illegal character data (as determined by Verifier.checkCharacterData(java.lang.String)).
  - Attribute
```
public Attribute(java.lang.String name,
                 java.lang.String value,
                 AttributeType type)
```
    This will create a new Attribute with the specified (local) name, value and type, and does not place the attribute in a Namespace.
    Note: This actually explicitly puts the Attribute in the "empty" Namespace (Namespace.NO_NAMESPACE).
    
    参数:
    
    name - String name of Attribute.
    
    value - String value for new attribute.
    
    type - AttributeType for new attribute.
    
    抛出:
    
    IllegalNameException - if the given name is illegal as an attribute name.
    
    IllegalDataException - if the given attribute value is illegal character data (as determined by Verifier.checkCharacterData(java.lang.String)) or if the given attribute type is not one of the supported types.
  - Attribute
```
@Deprecated
public Attribute(java.lang.String name,
                              java.lang.String value,
                              int type)
```
    已过时。 Use Attribute(String, String, AttributeType)
    
    This will create a new Attribute with the specified (local) name, value and type, and does not place the attribute in a Namespace.
    Note: This actually explicitly puts the Attribute in the "empty" Namespace (Namespace.NO_NAMESPACE).
    
    参数:
    
    name - String name of Attribute.
    
    value - String value for new attribute.
    
    type - int type for new attribute.
    
    抛出:
    
    IllegalNameException - if the given name is illegal as an attribute name.
    
    IllegalDataException - if the given attribute value is illegal character data (as determined by Verifier.checkCharacterData(java.lang.String)) or if the given attribute type is not one of the supported types.
- 方法详细资料
  - getParent
```
public Element getParent()
```
    This will return the parent of this Attribute. If there is no parent, then this returns null. Use return-type covariance to override Content's getParent() method to return an Element, not just a Parent
    
    返回:
    
    parent of this Attribute
  - getDocument
```
public Document getDocument()
```
    Get this Attribute's Document.
    
    返回:
    
    The document to which this Attribute is associated, may be null.
  - getName
```
public java.lang.String getName()
```
    This will retrieve the local name of the Attribute. For any XML attribute which appears as [namespacePrefix]:[attributeName], the local name of the attribute would be [attributeName]. When the attribute has no namespace, the local name is simply the attribute name.
    To obtain the namespace prefix for this attribute, the getNamespacePrefix() method should be used.
    
    返回:
    
    String - name of this attribute, without any namespace prefix.
  - setName
```
public Attribute setName(java.lang.String name)
```
    This sets the local name of the Attribute.
    
    参数:
    
    name - the new local name to set
    
    返回:
    
    Attribute - the attribute modified.
    
    抛出:
    
    IllegalNameException - if the given name is illegal as an attribute name.
  - getQualifiedName
```
public java.lang.String getQualifiedName()
```
    This will retrieve the qualified name of the Attribute. For any XML attribute whose name is [namespacePrefix]:[elementName], the qualified name of the attribute would be everything (both namespace prefix and element name). When the attribute has no namespace, the qualified name is simply the attribute's local name.
    To obtain the local name of the attribute, the getName() method should be used.
    To obtain the namespace prefix for this attribute, the getNamespacePrefix() method should be used.
    
    返回:
    
    String - full name for this element.
  - getNamespacePrefix
```
public java.lang.String getNamespacePrefix()
```
    This will retrieve the namespace prefix of the Attribute. For any XML attribute which appears as [namespacePrefix]:[attributeName], the namespace prefix of the attribute would be [namespacePrefix]. When the attribute has no namespace, an empty String is returned.
    
    返回:
    
    String - namespace prefix of this attribute.
  - getNamespaceURI
```
public java.lang.String getNamespaceURI()
```
    This returns the URI mapped to this Attribute's prefix. If no mapping is found, an empty String is returned.
    
    返回:
    
    String - namespace URI for this Attribute.
  - getNamespace
```
public Namespace getNamespace()
```
    This will return this Attribute's Namespace.
    
    返回:
    
    Namespace - Namespace object for this Attribute
  - setNamespace
```
public Attribute setNamespace(Namespace namespace)
```
    This sets this Attribute's Namespace. If the provided namespace is null, the attribute will have no namespace. The namespace must have a prefix.
    
    参数:
    
    namespace - the new namespace
    
    返回:
    
    Element - the element modified.
    
    抛出:
    
    IllegalNameException - if the new namespace is the default namespace. Attributes cannot be in a default namespace.
  - getValue
```
public java.lang.String getValue()
```
    This will return the actual textual value of this Attribute. This will include all text within the quotation marks.
    
    返回:
    
    String - value for this attribute.
  - setValue
```
public Attribute setValue(java.lang.String value)
```
    This will set the value of the Attribute.
    
    参数:
    
    value - String value for the attribute.
    
    返回:
    
    Attribute - this Attribute modified.
    
    抛出:
    
    IllegalDataException - if the given attribute value is illegal character data (as determined by Verifier.checkCharacterData(java.lang.String)).
  - getAttributeType
```
public AttributeType getAttributeType()
```
    This will return the declared type of this Attribute.
    
    返回:
    
    AttributeType - type for this attribute.
  - setAttributeType
```
public Attribute setAttributeType(AttributeType type)
```
    This will set the type of the Attribute.
    
    参数:
    
    type - int type for the attribute.
    
    返回:
    
    Attribute - this Attribute modified.
    
    抛出:
    
    IllegalDataException - if the given attribute type is not one of the supported types.
  - setAttributeType
```
@Deprecated
public Attribute setAttributeType(int type)
```
    已过时。 use setAttributeType(AttributeType)
    
    This will set the type of the Attribute.
    
    参数:
    
    type - int type for the attribute.
    
    返回:
    
    Attribute - this Attribute modified.
    
    抛出:
    
    IllegalDataException - if the given attribute type is not one of the supported types.
  - isSpecified
```
public boolean isSpecified()
```
    Get the 'specified' flag. True values indicate this attribute was part of an XML document, false indicates it was defaulted from a DTD.
    
    返回:
    
    the specified flag.
    
    从以下版本开始:
    
    JDOM2
  - setSpecified
```
public void setSpecified(boolean specified)
```
    Change the specified flag to the given value.
    
    参数:
    
    specified - The value to set the specified flag to.
    
    从以下版本开始:
    
    JDOM2
  - toString
```
public java.lang.String toString()
```
    This returns a String representation of the Attribute, suitable for debugging.
    
    覆盖:
    
    toString 在类中 java.lang.Object
    
    返回:
    
    String - information about the Attribute
  - clone
```
public Attribute clone()
```
    Return a deep clone of this instance. Even if this instance has a parent, the returned clone will not.
    All JDOM core classes are Cloneable, and never throw CloneNotSupportedException. Additionally all Cloneable JDOM classes return the correct type of instance from this method and there is no need to cast the result (co-variant return vaue).
    Subclasses of this should still call super.clone() in their clone method.
  - detach
```
public Attribute detach()
```
    Detach this Attribute from its parent.
    
    返回:
    
    this Attribute (detached).
  - getIntValue
```
public int getIntValue()
                throws DataConversionException
```
    This gets the value of the attribute, in int form, and if no conversion can occur, throws a DataConversionException
    
    返回:
    
    int value of attribute.
    
    抛出:
    
    DataConversionException - when conversion fails.
  - getLongValue
```
public long getLongValue()
                  throws DataConversionException
```
    This gets the value of the attribute, in long form, and if no conversion can occur, throws a DataConversionException
    
    返回:
    
    long value of attribute.
    
    抛出:
    
    DataConversionException - when conversion fails.
  - getFloatValue
```
public float getFloatValue()
                    throws DataConversionException
```
    This gets the value of the attribute, in float form, and if no conversion can occur, throws a DataConversionException
    
    返回:
    
    float value of attribute.
    
    抛出:
    
    DataConversionException - when conversion fails.
  - getDoubleValue
```
public double getDoubleValue()
                      throws DataConversionException
```
    This gets the value of the attribute, in double form, and if no conversion can occur, throws a DataConversionException
    
    返回:
    
    double value of attribute.
    
    抛出:
    
    DataConversionException - when conversion fails.
  - getBooleanValue
```
public boolean getBooleanValue()
                        throws DataConversionException
```
    This gets the effective boolean value of the attribute, or throws a DataConversionException if a conversion can't be performed. True values are: "true", "on", "1", and "yes". False values are: "false", "off", "0", and "no". Values are trimmed before comparison. Values other than those listed here throw the exception.
    
    返回:
    
    boolean value of attribute.
    
    抛出:
    
    DataConversionException - when conversion fails.
  - getNamespacesInScope
```
public java.util.List<Namespace> getNamespacesInScope()
```
    Get the namespaces that are in-scope on this Attribute.
    Attribute has peculiarities that affect the in-scope Namespaces because there are conditions in which the Attribute's scope is different to its parent Element's scope. Specifically, if the parent Element is in a 'default' Namespace that is not the empty Namespace (e.g. xmlns="someurl") and this Attribute is also in the default Namespace (has no prefix - but for Attributes that means the Namespace URL is ""), then this Attribute has a different namespace scope from it's parent Element because it does not include the 'someurl' Namespace.
    In the above conditions (no-prefix Attribute in an Element with a non-empty no-prefix Namespace) this Attribute effectively re-binds the "" prefix to the "" URL, thus the Attribute 'introduces' the Namespace. It follows then that the getNamespacesIntroduced() will return a list with the single member Namespace.NO_NAMESPACE.
    Note that the Attribute's Namespace will always be reported first.
    Description copied from NamespaceAware.getNamespacesInScope():
    Obtain a list of all namespaces that are in scope for the current content.
    The contents of this list will always be the combination of getNamespacesIntroduced() and getNamespacesInherited().
    See NamespaceAware documentation for details on what the order of the Namespaces will be in the returned list.
    
    指定者:
    
    getNamespacesInScope 在接口中 NamespaceAware
    
    返回:
    
    a read-only list of Namespaces.
  - getNamespacesIntroduced
```
public java.util.List<Namespace> getNamespacesIntroduced()
```
    从接口复制的说明: NamespaceAware
    
    Obtain a list of all namespaces that are introduced to the XML tree by this node. Only Elements and Attributes can introduce namespaces, so all other Content types will return an empty list.
    The contents of this list will always be a subset (but in the same order) of getNamespacesInScope(), and will never intersect getNamspacesInherited()
    
    指定者:
    
    getNamespacesIntroduced 在接口中 NamespaceAware
    
    返回:
    
    a read-only list of Namespaces.
  - getNamespacesInherited
```
public java.util.List<Namespace> getNamespacesInherited()
```
    从接口复制的说明: NamespaceAware
    
    Obtain a list of all namespaces that are in scope for this content, but were not introduced by this content.
    The contents of this list will always be a subset (but in the same order) of getNamespacesInScope(), and will never intersect getNamspacesIntroduced()
    
    指定者:
    
    getNamespacesInherited 在接口中 NamespaceAware
    
    返回:
    
    a read-only list of Namespaces.

类 Attribute

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

UNDECLARED_TYPE

CDATA_TYPE

ID_TYPE

IDREF_TYPE

IDREFS_TYPE

ENTITY_TYPE

ENTITIES_TYPE

NMTOKEN_TYPE

NMTOKENS_TYPE

NOTATION_TYPE

ENUMERATED_TYPE

构造器详细资料

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

方法详细资料

getParent

getDocument

getName

setName

getQualifiedName

getNamespacePrefix

getNamespaceURI

getNamespace

setNamespace

getValue

setValue

getAttributeType

setAttributeType

setAttributeType

isSpecified

setSpecified

toString

clone

detach

getIntValue

getLongValue

getFloatValue

getDoubleValue

getBooleanValue

getNamespacesInScope

getNamespacesIntroduced

getNamespacesInherited