javax.xml.namespace

Class QName

Table des matières

    • 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 QName might NOT be valid in a different context. For example, a QName may 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 QName for equality with another Object.

        If the Object to be tested is not a QName or is null, then this method returns false.

        Two QNames are considered equal if and only if both the Namespace URI and local part are equal. This method uses String.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:
        equals in class Object
        Parameters:
        objectToTest - the Object to test for equality with this QName
        Returns:
        true if the given Object is equal to this QName else false
        See Also:
        Object.hashCode(), HashMap

      • toString

        public String toString()

        String representation of this QName.

        The commonly accepted way of representing a QName as a String was 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 a QName as: "{" + 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 String representation.

        This method satisfies the general contract of Object.toString().

        Overrides:
        toString in class Object
        Returns:
        String representation of this QName

      • valueOf

        public static QName valueOf(String qNameAsString)

        QName derived from parsing the formatted String.

        If the String is null or does not conform to QName.toString() formatting, an IllegalArgumentException is thrown.

        The String MUST be in the form returned by QName.toString().

        The commonly accepted way of representing a QName as a String was 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 a String formatted 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 String and will be set to XMLConstants.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 - String representation of the QName
        Returns:
        QName corresponding to the given String
        Throws:
        IllegalArgumentException - When qNameAsString is null or malformed
        See Also:
        QName.toString()

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.

Document créé le 29/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/xml/namespace/QName.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

  1. Consulter le document html Langue du document :fr Manuel PHP : https://docs.oracle.com, QName

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.

Table des matières Haut