com.jcabi.urn

Class URN

java.lang.Object

com.jcabi.urn.URN

All Implemented Interfaces:

Serializable, Comparable<URN>

public final class URN
extends Object
implements Comparable<URN>, Serializable

Uniform Resource Name (URN) as in RFC 2141.

Usage is similar to URI or URL:

 URN urn = new URN("urn:foo:A123,456");
 assert urn.nid().equals("foo");
 assert urn.nss().equals("A123,456");

NOTICE: the implementation is not fully compliant with RFC 2141. It will become compliant in one of our future versions. Once it becomes fully compliant this notice will be removed.

The class is immutable and thread-safe.

Since:

0.6

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

See Also:

RFC 2141, Serialized Form

Constructor Summary

Constructors

Constructor and Description
URN() Public ctor (for JAXB mostly) that creates an "empty" URN.
URN(String text) Public ctor.
URN(String nid, String nss) Public ctor.

Method Summary

Methods

Modifier and Type	Method and Description
int	compareTo(URN urn)
static URN	create(String text) Creates an instance of URN and throws a runtime exception if its syntax is not valid.
boolean	equals(Object obj)
int	hashCode()
boolean	hasParams() Whether this URN has params?
boolean	isEmpty() Is it empty?
static boolean	isValid(String text) Is it a valid URN?
boolean	matches(String pattern) Does it match the pattern?
String	nid() Get namespace ID.
String	nss() Get namespace specific string.
String	param(String name) Get query param by name.
URN	param(String name, Object value) Add (overwrite) a query param and return a new URN.
Map<String,String>	params() Get all params.
URN	pure() Get just body of URN, without params.
String	toString()
URI	toURI() Convert it to URI.

Methods inherited from class java.lang.Object

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

Constructor Detail

URN

public URN()

Public ctor (for JAXB mostly) that creates an "empty" URN.

URN

public URN(String text)
    throws URISyntaxException

Public ctor.

Parameters:

text - The text of the URN

Throws:

URISyntaxException - If syntax is not correct

URN

public URN(String nid,
   String nss)

Public ctor.

Parameters:

nid - The namespace ID

nss - The namespace specific string

Method Detail

create

public static URN create(String text)

Creates an instance of URN and throws a runtime exception if its syntax is not valid.

Parameters:

text - The text of the URN

Returns:

The URN created

toString

public String toString()

Overrides:

toString in class Object

compareTo

public int compareTo(URN urn)

Specified by:

compareTo in interface Comparable<URN>

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

isValid

public static boolean isValid(String text)

Is it a valid URN?

Parameters:

text - The text to validate

Returns:

Yes of no

matches

public boolean matches(String pattern)

Does it match the pattern?

Parameters:

pattern - The pattern to match

Returns:

Yes of no

isEmpty

public boolean isEmpty()

Is it empty?

Returns:

Yes of no

toURI

public URI toURI()

Convert it to URI.

Returns:

The URI

nid

public String nid()

Get namespace ID.

Returns:

Namespace ID

nss

public String nss()

Get namespace specific string.

Returns:

Namespace specific string

params

public Map<String,String> params()

Get all params.

Returns:

The params

param

public String param(String name)

Get query param by name.

Parameters:

name - Name of parameter

Returns:

The value of it

param

public URN param(String name,
        Object value)

Add (overwrite) a query param and return a new URN.

Parameters:

name - Name of parameter

value - The value of parameter

Returns:

New URN

pure

public URN pure()

Get just body of URN, without params.

Returns:

Clean version of it

hasParams

public boolean hasParams()

Whether this URN has params?

Returns:

Has them?