Package org.opendaylight.yangtools.yang.common

Class UnresolvedQName

java.lang.Object

org.opendaylight.yangtools.yang.common.AbstractQName

org.opendaylight.yangtools.yang.common.UnresolvedQName

All Implemented Interfaces:

Serializable, Identifier, Immutable, WritableObject

Direct Known Subclasses:

UnresolvedQName.Qualified, UnresolvedQName.Unqualified

@NonNullByDefault
public abstract sealed class UnresolvedQName
extends AbstractQName
permits UnresolvedQName.Unqualified, UnresolvedQName.Qualified

A QName equivalent which has not been resolved. There are two subclasses:

1. UnresolvedQName.Unqualified, which holds only a local name available through AbstractQName.getLocalName().
3. UnresolvedQName.Qualified, which also holds a string prefix available via UnresolvedQName.Qualified.getPrefix().

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	UnresolvedQName.Qualified	An unresolved, qualified QName.
static final class	UnresolvedQName.Unqualified	An unresolved, unqualified QName.

Method Summary

Modifier and Type	Method	Description
abstract @Nullable String	getPrefix()	Return the prefix of this unresolved QName.
abstract UnresolvedQName	intern()	Return an interned reference to an equivalent object.
static UnresolvedQName.Qualified	qualified(String prefix, String localName)	Deprecated, for removal: This API element is subject to removal in a future version. Use UnresolvedQName.Qualified.of(String, String) instead.
static @Nullable UnresolvedQName.Unqualified	tryLocalName(String localName)	Try to create a new unqualified QName.
static UnresolvedQName.Unqualified	unqualified(String localName)	Deprecated, for removal: This API element is subject to removal in a future version. Use UnresolvedQName.Unqualified.of(String) instead.
abstract UnresolvedQName.Qualified	withPrefix(String newPrefix)	Return a UnresolvedQName.Qualified object bound to specified prefix.

Methods inherited from class org.opendaylight.yangtools.yang.common.AbstractQName

bindTo, equals, getLocalName, hashCode, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.opendaylight.yangtools.concepts.WritableObject

writeTo

Method Details

qualified

@Deprecated(since="9.0.0",
            forRemoval=true)
public static UnresolvedQName.Qualified qualified(String prefix,
 String localName)

Deprecated, for removal: This API element is subject to removal in a future version.

Use UnresolvedQName.Qualified.of(String, String) instead.

Create a new qualified unresolved QName.

Parameters:

prefix - The prefix on this qualified QName

localName - The local name of this qualified QName

Returns:

An UnqualifiedQName instance

Throws:

NullPointerException - if any argument is null

IllegalArgumentException - if localName is not a valid YANG identifier

unqualified

@Deprecated(since="9.0.0",
            forRemoval=true)
public static UnresolvedQName.Unqualified unqualified(String localName)

Deprecated, for removal: This API element is subject to removal in a future version.

Use UnresolvedQName.Unqualified.of(String) instead.

Create a new unqualified unresolved QName.

Parameters:

localName - The local name of this unqualified QName

Returns:

An UnqualifiedQName instance

Throws:

NullPointerException - if localName is null

IllegalArgumentException - if localName is not a valid YANG identifier

tryLocalName

public static @Nullable UnresolvedQName.Unqualified tryLocalName(String localName)

Try to create a new unqualified QName.

Parameters:

localName - The local name of this unqualified QName

Returns:

An UnqualifiedQName instance, or null if localName is not valid

intern

public abstract UnresolvedQName intern()

Description copied from class: AbstractQName

Return an interned reference to an equivalent object.

Specified by:

intern in class AbstractQName

Returns:

Interned reference, or this object if it was interned.

getPrefix

public abstract @Nullable String getPrefix()

Return the prefix of this unresolved QName.

Returns:

This QName's prefix

withPrefix

public abstract UnresolvedQName.Qualified withPrefix(String newPrefix)

Return a UnresolvedQName.Qualified object bound to specified prefix.

Returns:

a UnresolvedQName.Qualified object bound to specified prefix

Throws:

NullPointerException - if newPrefix is null