- java.lang.Object
-
- javax.xml.namespace.QName
-
- All Implemented Interfaces:
- Serializable
public class QName extends Object implements Serializable
QNamerepresents a qualified name as defined in the XML specifications: XML Schema Part2: Datatypes specification, Namespaces in XML, Namespaces in XML Errata.The value of a
QNamecontains a Namespace URI, local part and prefix.The prefix is included in
QNameto retain lexical information when present in anXML input source. The prefix is NOT used inQName.equals(Object)or to compute theQName.hashCode(). Equality and the hash code are defined using only the Namespace URI and local part.If not specified, the Namespace URI is set to
XMLConstants.NULL_NS_URI. If not specified, the prefix is set toXMLConstants.DEFAULT_NS_PREFIX.QNameis immutable.- Since:
- 1.5
- See Also:
- XML Schema Part2: Datatypes specification, Namespaces in XML, Namespaces in XML Errata, Serialized Form
-
-
Constructor Summary
Constructors Constructor and Description QName(String localPart)QNameconstructor specifying the local part.QName(String namespaceURI, String localPart)QNameconstructor specifying the Namespace URI and local part.QName(String namespaceURI, String localPart, String prefix)QNameconstructor specifying the Namespace URI, local part and prefix.
-
Method Summary
Methods Modifier and Type Method and Description booleanequals(Object objectToTest)Test thisQNamefor equality with anotherObject.StringgetLocalPart()Get the local part of thisQName.StringgetNamespaceURI()Get the Namespace URI of thisQName.StringgetPrefix()Get the prefix of thisQName.inthashCode()Generate the hash code for thisQName.StringtoString()Stringrepresentation of thisQName.static QNamevalueOf(String qNameAsString)QNamederived from parsing the formattedString.
-
-
-
Constructor Detail
-
QName
public QName(String namespaceURI, String localPart)
QNameconstructor specifying the Namespace URI and local part.If the Namespace URI is
null, it is set toXMLConstants.NULL_NS_URI. This value represents no explicitly defined Namespace as defined by the Namespaces in XML specification. This action preserves compatible behavior with QName 1.0. Explicitly providing theXMLConstants.NULL_NS_URIvalue is the preferred coding style.If the local part is
nullanIllegalArgumentExceptionis thrown. A local part of "" is allowed to preserve compatible behavior with QName 1.0.When using this constructor, the prefix is set to
XMLConstants.DEFAULT_NS_PREFIX.The Namespace URI is not validated as a URI reference. The local part is not validated as a NCName as specified in Namespaces in XML.
- Parameters:
namespaceURI- Namespace URI of theQNamelocalPart- local part of theQName- Throws:
IllegalArgumentException- WhenlocalPartisnull- See Also:
QName(String namespaceURI, String localPart, String prefix)
-
QName
public QName(String namespaceURI, String localPart, String prefix)
QNameconstructor specifying the Namespace URI, local part and prefix.If the Namespace URI is
null, it is set toXMLConstants.NULL_NS_URI. This value represents no explicitly defined Namespace as defined by the Namespaces in XML specification. This action preserves compatible behavior with QName 1.0. Explicitly providing theXMLConstants.NULL_NS_URIvalue is the preferred coding style.If the local part is
nullanIllegalArgumentExceptionis thrown. A local part of "" is allowed to preserve compatible behavior with QName 1.0.If the prefix is
null, anIllegalArgumentExceptionis thrown. UseXMLConstants.DEFAULT_NS_PREFIXto explicitly indicate that no prefix is present or the prefix is not relevant.The Namespace URI is not validated as a URI reference. The local part and prefix are not validated as a NCName as specified in Namespaces in XML.
- Parameters:
namespaceURI- Namespace URI of theQNamelocalPart- local part of theQNameprefix- prefix of theQName- Throws:
IllegalArgumentException- WhenlocalPartorprefixisnull
-
QName
public QName(String localPart)
QNameconstructor specifying the local part.If the local part is
nullanIllegalArgumentExceptionis thrown. A local part of "" is allowed to preserve compatible behavior with QName 1.0.When using this constructor, the Namespace URI is set to
XMLConstants.NULL_NS_URIand the prefix is set toXMLConstants.DEFAULT_NS_PREFIX.In an XML context, all Element and Attribute names exist in the context of a Namespace. Making this explicit during the construction of a
QNamehelps prevent hard to diagnosis XML validity errors. The constructorsQName(String namespaceURI, String localPart)andQName(String namespaceURI, String localPart, String prefix)are preferred.The local part is not validated as a NCName as specified in Namespaces in XML.
- Parameters:
localPart- local part of theQName- Throws:
IllegalArgumentException- WhenlocalPartisnull- See Also:
QName(String namespaceURI, String localPart),QName(String namespaceURI, String localPart, String prefix)
-
-
Method Detail
-
getNamespaceURI
public String getNamespaceURI()
Get the Namespace URI of this
QName.- Returns:
- Namespace URI of this
QName
-
getLocalPart
public String getLocalPart()
Get the local part of this
QName.- Returns:
- local part of this
QName
-
getPrefix
public String getPrefix()
Get the prefix of this
QName.The prefix assigned to a
QNamemight NOT be valid in a different context. For example, aQNamemay be assigned a prefix in the context of parsing a document but that prefix may be invalid in the context of a different document.- Returns:
- prefix of this
QName
-
equals
public final boolean equals(Object objectToTest)
Test this
QNamefor equality with anotherObject.If the
Objectto be tested is not aQNameor isnull, then this method returnsfalse.Two
QNames are considered equal if and only if both the Namespace URI and local part are equal. This method usesString.equals()to check equality of the Namespace URI and local part. The prefix is NOT used to determine equality.This method satisfies the general contract of
Object.equals(Object)- Overrides:
equalsin classObject- Parameters:
objectToTest- theObjectto test for equality with thisQName- Returns:
trueif the givenObjectis equal to thisQNameelsefalse- See Also:
Object.hashCode(),HashMap
-
hashCode
public final int hashCode()
Generate the hash code for this
QName.The hash code is calculated using both the Namespace URI and the local part of the
QName. The prefix is NOT used to calculate the hash code.This method satisfies the general contract of
Object.hashCode().- Overrides:
hashCodein classObject- Returns:
- hash code for this
QNameObject - See Also:
Object.equals(java.lang.Object),System.identityHashCode(java.lang.Object)
-
toString
public String toString()
Stringrepresentation of thisQName.The commonly accepted way of representing a
QNameas aStringwas defined by James Clark. Although this is not a standard specification, it is in common use, e.g.Transformer.setParameter(String name, Object value). This implementation represents aQNameas: "{" + Namespace URI + "}" + local part. If the Namespace URI.equals(XMLConstants.NULL_NS_URI), only the local part is returned. An appropriate use of this method is for debugging or logging for human consumption.Note the prefix value is NOT returned as part of the
Stringrepresentation.This method satisfies the general contract of
Object.toString().
-
valueOf
public static QName valueOf(String qNameAsString)
QNamederived from parsing the formattedString.If the
Stringisnullor does not conform toQName.toString()formatting, anIllegalArgumentExceptionis thrown.The
StringMUST be in the form returned byQName.toString().The commonly accepted way of representing a
QNameas aStringwas defined by James Clark. Although this is not a standard specification, it is in common use, e.g.Transformer.setParameter(String name, Object value). This implementation parses aStringformatted as: "{" + Namespace URI + "}" + local part. If the Namespace URI.equals(XMLConstants.NULL_NS_URI), only the local part should be provided.The prefix value CANNOT be represented in the
Stringand will be set toXMLConstants.DEFAULT_NS_PREFIX.This method does not do full validation of the resulting
QName.The Namespace URI is not validated as a URI reference. The local part is not validated as a NCName as specified in Namespaces in XML.
- Parameters:
qNameAsString-Stringrepresentation of theQName- Returns:
QNamecorresponding to the givenString- Throws:
IllegalArgumentException- WhenqNameAsStringisnullor malformed- See Also:
QName.toString()
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/xml/namespace/QName.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur van deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.