Package org.jxmpp.jid.parts

Class Resourcepart

java.lang.Object

org.jxmpp.jid.parts.Part

org.jxmpp.jid.parts.Resourcepart

All Implemented Interfaces:

java.io.Serializable, java.lang.CharSequence

public class Resourcepart
extends Part

A resourcepart of an XMPP address (JID).

You can create instances of this class from Strings using from(String).

See Also:

RFC 6122 § 2.4. Resourcepart, Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static Resourcepart	EMPTY	The empty resource part.

Method Summary

Modifier and Type	Method	Description
static Resourcepart	from(java.lang.String resource)	Get the Resourcepart representing the input String.
static Resourcepart	from(java.lang.String resource, org.jxmpp.JxmppContext context)	Get the Resourcepart representing the input String.
static Resourcepart	fromOrNull(java.lang.CharSequence cs)	Get a Resourcepart from a given CharSequence or null if the input is not a valid resourcepart.
static Resourcepart	fromOrThrowUnchecked(java.lang.CharSequence cs)	Like from(String) but does throw an unchecked IllegalArgumentException instead of a XmppStringprepException.

Methods inherited from class org.jxmpp.jid.parts.Part

assertNotLongerThan1023BytesOrEmpty, charAt, equals, hashCode, intern, length, subSequence, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.CharSequence

chars, codePoints

Field Detail

EMPTY

public static final Resourcepart EMPTY

The empty resource part.

This empty resource part is the part that is represented by the empty String. This is useful in cases where you have a collection of Resourceparts that does not allow null values, but you want to deal with the "no resource" case.

Method Detail

fromOrNull

public static Resourcepart fromOrNull(java.lang.CharSequence cs)

Get a Resourcepart from a given CharSequence or null if the input is not a valid resourcepart.

Parameters:

cs - the input CharSequence

Returns:

a Resourcepart or null

fromOrThrowUnchecked

public static Resourcepart fromOrThrowUnchecked(java.lang.CharSequence cs)

Like from(String) but does throw an unchecked IllegalArgumentException instead of a XmppStringprepException.

Parameters:

cs - the character sequence which should be transformed to a Resourcepart

Returns:

the Resourcepart if no exception occurs

Throws:

java.lang.IllegalArgumentException - if the given input is not a valid Resourcepart

Since:

0.6.2

See Also:

from(String)

from

public static Resourcepart from(java.lang.String resource)
                         throws org.jxmpp.stringprep.XmppStringprepException

Get the Resourcepart representing the input String.

Parameters:

resource - the input String.

Returns:

the resource part.

Throws:

org.jxmpp.stringprep.XmppStringprepException - if an error occurs.

from

public static Resourcepart from(java.lang.String resource,
                                org.jxmpp.JxmppContext context)
                         throws org.jxmpp.stringprep.XmppStringprepException

Get the Resourcepart representing the input String.

Parameters:

resource - the input String.

context - the JXMPP context.

Returns:

the resource part.

Throws:

org.jxmpp.stringprep.XmppStringprepException - if an error occurs.