QName (Alfresco 5.1.4.1 Public Java API)

org.alfresco.service.namespace

org.alfresco.service.namespace.QName

All Implemented Interfaces:

@org.alfresco.api.AlfrescoPublicApi
public final class QName

QName represents the qualified name of a Repository item. Each QName consists of a local name qualified by a namespace.

The QNamePattern is implemented to allow instances of this class to be used for direct pattern matching where required on interfaces.

Field Summary
static String	EMPTY_URI_SUBSTITUTE
static int	MAX_LENGTH
static char	NAMESPACE_BEGIN
static char	NAMESPACE_END
static char	NAMESPACE_PREFIX

Method Summary
Object	clone()
int	compareTo(QName qname) Uses the namespace URI and then the localname to do the comparison i.e.
static QName	createQName(String qname) Create a QName from its internal string representation of the following format: `{namespaceURI}localName`
static QName	createQName(String qname, NamespacePrefixResolver prefixResolver) Create a QName (from prefix format) `prefix:localName`
static QName	createQName(String namespaceURI, String localName) Create a QName (With no prefix)
static QName	createQName(String prefix, String localName, NamespacePrefixResolver prefixResolver) Create a QName
static QName	createQNameWithValidLocalName(String namespaceURI, String localName) Create a QName, optionally truncating the localname to MAX_LENGTH.
static String	createValidLocalName(String name) Create a valid local name from the specified name
boolean	equals(Object object) Two QNames are equal only when both their name and namespace match.
String	getLocalName() Gets the name
String	getNamespaceURI() Gets the namespace
QName	getPrefixedQName(NamespacePrefixResolver resolver) Gets a prefix resolved version of this QName
String	getPrefixString() Getter version of toPrefixString()
int	hashCode() Calculate hashCode.
boolean	isMatch(QName qname) Performs a direct comparison between qnames.
static QName	resolveToQName(NamespacePrefixResolver prefixResolver, String str) Creates a QName representation for the given String.
static String	resolveToQNameString(NamespacePrefixResolver prefixResolver, String str) Creates a string representation of a QName for the given string.
static String[]	splitPrefixedQName(String qname) Create a QName
String	toPrefixString() Render string representation of QName using format: `prefix:name`
String	toPrefixString(NamespacePrefixResolver prefixResolver) Render string representation of QName using format: `prefix:name` according to namespace prefix mappings of specified namespace resolver.
String	toString() Render string representation of QName using format: `{namespace}name`

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

EMPTY_URI_SUBSTITUTE

public static final String EMPTY_URI_SUBSTITUTE

public static final int MAX_LENGTH

public static final char NAMESPACE_BEGIN

public static final char NAMESPACE_END

public static final char NAMESPACE_PREFIX

public static QName createQName(String namespaceURI,
String localName)
throws InvalidQNameException

Create a QName (With no prefix)

namespaceURI - the qualifying namespace (maybe null or empty string)

localName - the local name

public static QName createQName(String prefix,
                                String localName,
                                NamespacePrefixResolver prefixResolver)
                         throws InvalidQNameException,
                                NamespaceException

prefix - namespace prefix (maybe null or empty string)

localName - local name

prefixResolver - lookup to resolve mappings between prefix and namespace

public static QName createQName(String qname,
                                NamespacePrefixResolver prefixResolver)
                         throws InvalidQNameException,
                                NamespaceException

Create a QName (from prefix format) prefix:localName

qname - qualified name of the following format prefix:localName

prefixResolver - lookup to resolve mappings between prefix and namespace

public static QName createQName(String qname)
throws InvalidQNameException

Create a QName from its internal string representation of the following format: {namespaceURI}localName

qname - the string representation of the QName

createQNameWithValidLocalName

public static QName createQNameWithValidLocalName(String namespaceURI,
String localName)

Create a QName, optionally truncating the localname to MAX_LENGTH.

namespaceURI - the qualifying namespace (maybe null or empty string)

localName - the local name, which will be truncated, if necessary

the QName with potentially-truncated localname

createValidLocalName

public static String createValidLocalName(String name)

Create a valid local name from the specified name

name - name to create valid local name from

public static String[] splitPrefixedQName(String qname)
throws InvalidQNameException,
NamespaceException

qname - qualified name of the following format prefix:localName

string array where index 0 => prefix and index 1 => local name

public Object clone()
throws CloneNotSupportedException

clone in class Object

public String getLocalName()

public String getNamespaceURI()

the namespace (empty string when not specified, but never null)

public QName getPrefixedQName(NamespacePrefixResolver resolver)

Gets a prefix resolved version of this QName

resolver - namespace prefix resolver

QName with prefix resolved

public boolean equals(Object object)

Two QNames are equal only when both their name and namespace match. Note: The prefix is ignored during the comparison.

equals in class Object

public boolean isMatch(QName qname)

Performs a direct comparison between qnames.

isMatch in interface QNamePattern

qname - the instance to check

Returns true if the qname matches this pattern

public int hashCode()

Calculate hashCode. Follows pattern used by String where hashCode is cached (QName is immutable).

hashCode in class Object

public String toString()

Render string representation of QName using format: {namespace}name

toString in class Object

the string representation

public int compareTo(QName qname)

Uses the namespace URI and then the localname to do the comparison i.e. the comparison is alphabetical.

compareTo in interface Comparable<T>

public String toPrefixString()

Render string representation of QName using format: prefix:name

the string representation

public String getPrefixString()

Getter version of toPrefixString()

the string representation of QName

public String toPrefixString(NamespacePrefixResolver prefixResolver)

Render string representation of QName using format: prefix:name according to namespace prefix mappings of specified namespace resolver.

prefixResolver - namespace prefix resolver

the string representation

public static QName resolveToQName(NamespacePrefixResolver prefixResolver,
String str)

Creates a QName representation for the given String. If the String has no namespace the Alfresco namespace is added. If the String has a prefix an attempt to resolve the prefix to the full URI will be made.

str - The string to convert

A QName representation of the given string

resolveToQNameString

public static String resolveToQNameString(NamespacePrefixResolver prefixResolver,
String str)

Creates a string representation of a QName for the given string. If the given string already has a namespace, either a URL or a prefix, nothing the given string is returned. If it does not have a namespace the Alfresco namespace is added.

str - The string to convert

A QName String representation of the given string

Java API documentation generated with DocFlex/Javadoc 1.6.1 using JavadocPro template set.