public class JidUtil extends Object
Modifier and Type | Class and Description |
---|---|
static class |
JidUtil.NotABareJidStringException |
Constructor and Description |
---|
JidUtil() |
Modifier and Type | Method and Description |
---|---|
static Set<BareJid> |
bareJidSetFrom(Collection<CharSequence> jidStrings) |
static void |
bareJidsFrom(Collection<CharSequence> jidStrings,
Collection<BareJid> output,
List<XmppStringprepException> exceptions)
Convert a collection of Strings to a Set of
BareJid 's. |
static void |
filterBareJid(Collection<? extends Jid> in,
Collection<BareJid> out) |
static List<BareJid> |
filterBareJidList(Collection<? extends Jid> input) |
static Set<BareJid> |
filterBareJidSet(Collection<? extends Jid> input) |
static void |
filterDomainBareJid(Collection<? extends Jid> in,
Collection<DomainBareJid> out) |
static List<DomainBareJid> |
filterDomainBareJidList(Collection<? extends Jid> input) |
static Set<DomainBareJid> |
filterDomainBareJidSet(Collection<? extends Jid> input) |
static void |
filterDomainFullJid(Collection<? extends Jid> in,
Collection<DomainFullJid> out) |
static List<DomainFullJid> |
filterDomainFullJidList(Collection<? extends Jid> input) |
static Set<DomainFullJid> |
filterDomainFullJidSet(Collection<? extends Jid> input) |
static void |
filterFullJid(Collection<? extends Jid> in,
Collection<FullJid> out) |
static List<FullJid> |
filterFullJidList(Collection<? extends Jid> input) |
static Set<FullJid> |
filterFullJidSet(Collection<? extends Jid> input) |
static boolean |
isValidBareJid(CharSequence jid)
Check if the given CharSequence represents a valid bare JID.
|
static Set<Jid> |
jidSetFrom(Collection<CharSequence> jidStrings) |
static void |
jidsFrom(Collection<CharSequence> jidStrings,
Collection<Jid> output,
List<XmppStringprepException> exceptions)
Convert a collection of Strings to a Set of
Jid 's. |
static List<String> |
toStringList(Collection<? extends Jid> jids) |
static void |
toStrings(Collection<? extends Jid> jids,
Collection<String> jidStrings) |
static Set<String> |
toStringSet(Collection<? extends Jid> jids) |
static BareJid |
validateBareJid(CharSequence jidcs)
Check if the given CharSequence is a valid bare JID.
|
static Jid |
withoutResource(Jid jid)
Safely transform a JID to any JID without a resource.
|
public static Jid withoutResource(Jid jid)
Useful for situations where you don't want to put a resource on the wire.
jid
- public static boolean isValidBareJid(CharSequence jid)
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.
jid
- public static BareJid validateBareJid(CharSequence jidcs) throws JidUtil.NotABareJidStringException, XmppStringprepException
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.NotABareJidStringException
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").
jidcs
- the JID CharSequenceJidUtil.NotABareJidStringException
XmppStringprepException
public static void filterBareJid(Collection<? extends Jid> in, Collection<BareJid> out)
public static Set<BareJid> filterBareJidSet(Collection<? extends Jid> input)
public static List<BareJid> filterBareJidList(Collection<? extends Jid> input)
public static void filterFullJid(Collection<? extends Jid> in, Collection<FullJid> out)
public static Set<FullJid> filterFullJidSet(Collection<? extends Jid> input)
public static List<FullJid> filterFullJidList(Collection<? extends Jid> input)
public static void filterDomainBareJid(Collection<? extends Jid> in, Collection<DomainBareJid> out)
public static Set<DomainBareJid> filterDomainBareJidSet(Collection<? extends Jid> input)
public static List<DomainBareJid> filterDomainBareJidList(Collection<? extends Jid> input)
public static void filterDomainFullJid(Collection<? extends Jid> in, Collection<DomainFullJid> out)
public static Set<DomainFullJid> filterDomainFullJidSet(Collection<? extends Jid> input)
public static List<DomainFullJid> filterDomainFullJidList(Collection<? extends Jid> input)
public static Set<BareJid> bareJidSetFrom(Collection<CharSequence> jidStrings)
public static void bareJidsFrom(Collection<CharSequence> jidStrings, Collection<BareJid> output, List<XmppStringprepException> exceptions)
BareJid
'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.
jidStrings
- the strings that are going to get convertedoutput
- the collection where the BareJid's will be added toexceptions
- public static Set<Jid> jidSetFrom(Collection<CharSequence> jidStrings)
public static void jidsFrom(Collection<CharSequence> jidStrings, Collection<Jid> output, List<XmppStringprepException> exceptions)
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.
jidStrings
- the strings that are going to get convertedoutput
- the collection where the Jid's will be added toexceptions
- public static List<String> toStringList(Collection<? extends Jid> jids)
public static Set<String> toStringSet(Collection<? extends Jid> jids)
public static void toStrings(Collection<? extends Jid> jids, Collection<String> jidStrings)
Copyright © 2016. All rights reserved.