org.jxmpp.jid.util

Class JidUtil

java.lang.Object

org.jxmpp.jid.util.JidUtil

public class JidUtil
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JidUtil.NotAEntityBareJidStringException

Constructor Summary

Constructors

Constructor and Description
JidUtil()

Method Summary

Modifier and Type	Method and Description
static java.util.Set<EntityBareJid>	entityBareJidSetFrom(java.util.Collection<? extends java.lang.CharSequence> jidStrings) Convert the given collection of CharSequences to bare JIDs.
static void	entityBareJidsFrom(java.util.Collection<? extends java.lang.CharSequence> jidStrings, java.util.Collection<? super EntityBareJid> output, java.util.List<org.jxmpp.stringprep.XmppStringprepException> exceptions) Convert a collection of Strings to a Set of EntityBareJid's.
static void	filterDomainFullJid(java.util.Collection<? extends Jid> in, java.util.Collection<? super DomainFullJid> out) Filter all domain full JIDs.
static java.util.List<DomainFullJid>	filterDomainFullJidList(java.util.Collection<? extends Jid> input) Filter all domain full JIDs.
static java.util.Set<DomainFullJid>	filterDomainFullJidSet(java.util.Collection<? extends Jid> input) Filter all domain full JIDs.
static void	filterEntityBareJid(java.util.Collection<? extends Jid> in, java.util.Collection<? super EntityBareJid> out) Filter all entity bare JIDs.
static java.util.List<EntityBareJid>	filterEntityBareJidList(java.util.Collection<? extends Jid> input) Filter all entity bare JIDs.
static java.util.Set<EntityBareJid>	filterEntityBareJidSet(java.util.Collection<? extends Jid> input) Filter all entity bare JIDs.
static void	filterEntityFullJid(java.util.Collection<? extends Jid> in, java.util.Collection<? super EntityFullJid> out) Filter all entity full JIDs.
static java.util.List<EntityFullJid>	filterEntityFullJidList(java.util.Collection<? extends Jid> input) Filter all full JIDs.
static java.util.Set<EntityFullJid>	filterEntityFullJidSet(java.util.Collection<? extends Jid> input) Filter all full JIDs.
static boolean	isValidEntityBareJid(java.lang.CharSequence jid) Check if the given CharSequence represents a valid entity bare JID.
static java.util.Set<Jid>	jidSetFrom(java.util.Collection<? extends java.lang.CharSequence> jidStrings) Convert the given collection of CharSequences to JIDs.
static java.util.Set<Jid>	jidSetFrom(java.lang.String[] jids) Convert the given array of Strings to JIDs.
static void	jidsFrom(java.util.Collection<? extends java.lang.CharSequence> jidStrings, java.util.Collection<? super Jid> output, java.util.List<org.jxmpp.stringprep.XmppStringprepException> exceptions) Convert a collection of Strings to a Set of Jid's.
static java.util.List<java.lang.String>	toStringList(java.util.Collection<? extends Jid> jids) Convert a collection of JIDs to a list of Strings representing those JIDs.
static void	toStrings(java.util.Collection<? extends Jid> jids, java.util.Collection<? super java.lang.String> jidStrings) Convert a collection of JIDs to a Collection of Strings.
static java.util.Set<java.lang.String>	toStringSet(java.util.Collection<? extends Jid> jids) convert a collection of JIDs to a set of Strings representing those JIDs.
static EntityBareJid	validateEntityBareJid(java.lang.CharSequence jidcs) Check if the given CharSequence is a valid entity bare JID.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JidUtil

public JidUtil()

Method Detail

isValidEntityBareJid

public static boolean isValidEntityBareJid(java.lang.CharSequence jid)

Check if the given CharSequence represents a valid entity bare JID. That is, it must consists exactly of a local- and a domainpart (<localpart@domainpart>).

This method is meant to validate user input and give fast feedback (e.g. with a red or green light) about if the user entered CharSequence represents a bare JID.

Parameters:

jid - the CharSequence to check.

Returns:

true if @{code jid} represents a valid entity bare JID, false otherwise

See Also:

EntityBareJid

validateEntityBareJid

public static EntityBareJid validateEntityBareJid(java.lang.CharSequence jidcs)
                                           throws JidUtil.NotAEntityBareJidStringException,
                                                  org.jxmpp.stringprep.XmppStringprepException

Check if the given CharSequence is a valid entity bare JID. That is, it must consists exactly of a local- and a domainpart (<localpart@domainpart>).

This is a convenience method meant to validate user entered bare JIDs. If the given jid is not a valid bare JID, then this method will throw either JidUtil.NotAEntityBareJidStringException or XmppStringprepException. The NotABareJidStringException will contain a meaningful message explaining why the given CharSequence is not a valid bare JID (e.g. "does not contain a '@' character").

Parameters:

jidcs - the JID CharSequence

Returns:

a BareJid instance representing the given JID CharSequence

Throws:

JidUtil.NotAEntityBareJidStringException - if the given CharSequence is not a bare JID.

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

filterEntityBareJid

public static void filterEntityBareJid(java.util.Collection<? extends Jid> in,
                                       java.util.Collection<? super EntityBareJid> out)

Filter all entity bare JIDs.

Parameters:

in - the input collection.

out - the collection where the filtered JIDs are added to.

filterEntityBareJidSet

public static java.util.Set<EntityBareJid> filterEntityBareJidSet(java.util.Collection<? extends Jid> input)

Filter all entity bare JIDs.

Parameters:

input - the input collection.

Returns:

a set containing all bare JIDs of the input collection.

filterEntityBareJidList

public static java.util.List<EntityBareJid> filterEntityBareJidList(java.util.Collection<? extends Jid> input)

Filter all entity bare JIDs.

Parameters:

input - the input collection.

Returns:

a list containing all bare JIDs of the input collection.

filterEntityFullJid

public static void filterEntityFullJid(java.util.Collection<? extends Jid> in,
                                       java.util.Collection<? super EntityFullJid> out)

Filter all entity full JIDs.

Parameters:

in - the input collection.

out - the collection where the filtered JIDs are added to.

filterEntityFullJidSet

public static java.util.Set<EntityFullJid> filterEntityFullJidSet(java.util.Collection<? extends Jid> input)

Filter all full JIDs.

Parameters:

input - the input collection.

Returns:

a set containing all full JIDs of the input collection.

filterEntityFullJidList

public static java.util.List<EntityFullJid> filterEntityFullJidList(java.util.Collection<? extends Jid> input)

Filter all full JIDs.

Parameters:

input - the input collection.

Returns:

a list containing all full JIDs of the input collection.

filterDomainFullJid

public static void filterDomainFullJid(java.util.Collection<? extends Jid> in,
                                       java.util.Collection<? super DomainFullJid> out)

Filter all domain full JIDs.

Parameters:

in - the input collection.

out - the collection where the filtered JIDs are added to.

filterDomainFullJidSet

public static java.util.Set<DomainFullJid> filterDomainFullJidSet(java.util.Collection<? extends Jid> input)

Filter all domain full JIDs.

Parameters:

input - the input collection.

Returns:

a set containing all domain full JIDs of the input collection.

filterDomainFullJidList

public static java.util.List<DomainFullJid> filterDomainFullJidList(java.util.Collection<? extends Jid> input)

Filter all domain full JIDs.

Parameters:

input - the input collection.

Returns:

a list containing all domain full JIDs of the input collection.

entityBareJidSetFrom

public static java.util.Set<EntityBareJid> entityBareJidSetFrom(java.util.Collection<? extends java.lang.CharSequence> jidStrings)

Convert the given collection of CharSequences to bare JIDs.

Parameters:

jidStrings - the collection of CharSequences.

Returns:

a set of bare JIDs.

entityBareJidsFrom

public static void entityBareJidsFrom(java.util.Collection<? extends java.lang.CharSequence> jidStrings,
                                      java.util.Collection<? super EntityBareJid> output,
                                      java.util.List<org.jxmpp.stringprep.XmppStringprepException> exceptions)

Convert a collection of Strings to a Set of EntityBareJid's.

If the optional argument exceptions is given, then all XmppStringprepException thrown while converting will be added to the list. Otherwise, if an XmppStringprepExceptions is thrown, it will be wrapped in a AssertionError Exception and throw.

Parameters:

jidStrings - the strings that are going to get converted

output - the collection where the BareJid's will be added to

exceptions - the list of exceptions thrown while converting.

jidSetFrom

public static java.util.Set<Jid> jidSetFrom(java.lang.String[] jids)

Convert the given array of Strings to JIDs.

Note that errors while converting the Strings will be silently ignored.

Parameters:

jids - a array of JID Strings.

Returns:

a set of JIDs.

jidSetFrom

public static java.util.Set<Jid> jidSetFrom(java.util.Collection<? extends java.lang.CharSequence> jidStrings)

Convert the given collection of CharSequences to JIDs.

Parameters:

jidStrings - the collection of CharSequences.

Returns:

a set of JIDs.

jidsFrom

public static void jidsFrom(java.util.Collection<? extends java.lang.CharSequence> jidStrings,
                            java.util.Collection<? super Jid> output,
                            java.util.List<org.jxmpp.stringprep.XmppStringprepException> exceptions)

Convert a collection of Strings to a Set of Jid's.

If the optional argument exceptions is given, then all XmppStringprepException thrown while converting will be added to the list. Otherwise, if an XmppStringprepExceptions is thrown, it will be wrapped in a AssertionError Exception and throw.

Parameters:

jidStrings - the strings that are going to get converted

output - the collection where the Jid's will be added to

exceptions - the list of exceptions thrown while converting.

toStringList

public static java.util.List<java.lang.String> toStringList(java.util.Collection<? extends Jid> jids)

Convert a collection of JIDs to a list of Strings representing those JIDs.

Parameters:

jids - a collection of JIDs.

Returns:

a list of Strings.

toStringSet

public static java.util.Set<java.lang.String> toStringSet(java.util.Collection<? extends Jid> jids)

convert a collection of JIDs to a set of Strings representing those JIDs.

Parameters:

jids - a collection of JIDs.

Returns:

a set of String.

toStrings

public static void toStrings(java.util.Collection<? extends Jid> jids,
                             java.util.Collection<? super java.lang.String> jidStrings)

Convert a collection of JIDs to a Collection of Strings.

Parameters:

jids - the collection of Strings to convert.

jidStrings - the collection of Strings to append to.