Package org.simpleframework.xml.stream
Interface Attribute
-
- All Known Implementing Classes:
DocumentReader.Entry
,EventAttribute
,PullReader.Entry
,StreamReader.Entry
interface Attribute
TheAttribute
interface represents an attribute that is associated with an event node. An attribute is required to provide the name and value for the attribute, and optionally the namespace reference and prefix. For debugging purposes the source object from the internal XML provider can be returned also.- See Also:
EventNode
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description java.lang.String
getName()
This provides the name of the attribute.java.lang.String
getPrefix()
This is used to acquire the namespace prefix associated with this attribute.java.lang.String
getReference()
This is used to acquire the namespace reference that this attribute is in.java.lang.Object
getSource()
This is used to return the source of the attribute.java.lang.String
getValue()
This returns the value of the event.boolean
isReserved()
This returns true if the attribute is reserved.
-
-
-
Method Detail
-
getName
java.lang.String getName()
This provides the name of the attribute. This should be the name of the XML attribute without any namespace prefix. If the name begins with "xml" then this attribute is reserved. according to the namespaces for XML 1.0 specification.- Returns:
- this returns the name of this attribute object
-
getValue
java.lang.String getValue()
This returns the value of the event. Typically this will be the text value that the attribute contains. If the attribute does not contain a value then this returns null.- Returns:
- this returns the value represented by this attribute
-
getReference
java.lang.String getReference()
This is used to acquire the namespace reference that this attribute is in. A namespace is normally associated with an attribute if that attribute is prefixed with a known token. If there is no prefix then this will return null.- Returns:
- this provides the associated namespace reference
-
getPrefix
java.lang.String getPrefix()
This is used to acquire the namespace prefix associated with this attribute. A prefix is used to qualify the attribute within a namespace. So, if this has a prefix then it should have a reference associated with it.- Returns:
- this returns the namespace prefix for the attribute
-
getSource
java.lang.Object getSource()
This is used to return the source of the attribute. Depending on which provider was selected to parse the XML document an object for the internal parsers representation of this will be returned. This is useful for debugging purposes.- Returns:
- this will return the source object for this event
-
isReserved
boolean isReserved()
This returns true if the attribute is reserved. An attribute is considered reserved if it begins with "xml" according to the namespaces in XML 1.0 specification. Such attributes are used for namespaces and other such details.- Returns:
- this returns true if the attribute is reserved
-
-