Package org.jxmpp.jid.impl
Class JidCreate
- java.lang.Object
-
- org.jxmpp.jid.impl.JidCreate
-
public class JidCreate extends Object
API to create JIDs (XMPP addresses) from Strings and CharSequences.If the input was user generated, e.g. captured from some sort of user interface,
fromUnescaped(String)
should be used instead. This allows the user to enter unescaped JID values. You can useJidUtil.isValidEntityBareJid(CharSequence)
to query, e.g. while the user it entering it, if a given CharSequence is a valid bare JID.JIDs created from input received from an XMPP source should use
from(String)
.JidCreate uses caches for efficient Jid construction, But it's not guaranteed that the same String or CharSequence will yield the same Jid instance.
- See Also:
Jid
-
-
Constructor Summary
Constructors Constructor Description JidCreate()
-
Method Summary
-
-
-
Constructor Detail
-
JidCreate
public JidCreate()
-
-
Method Detail
-
from
public static Jid from(CharSequence localpart, CharSequence domainpart, CharSequence resource) throws XmppStringprepException
Get aJid
from the given parts.Only the domainpart is required.
- Parameters:
localpart
- a optional localpart.domainpart
- a required domainpart.resource
- a optional resourcepart.- Returns:
- a JID which consists of the given parts.
- Throws:
XmppStringprepException
- if an error occurs.
-
from
public static Jid from(String localpart, String domainpart, String resource) throws XmppStringprepException
Get aJid
from the given parts.Only the domainpart is required.
- Parameters:
localpart
- a optional localpart.domainpart
- a required domainpart.resource
- a optional resourcepart.- Returns:
- a JID which consists of the given parts.
- Throws:
XmppStringprepException
- if an error occurs.
-
from
public static Jid from(String localpart, String domainpart, String resource, JxmppContext context) throws XmppStringprepException
Get aJid
from the given parts.Only the domainpart is required.
- Parameters:
localpart
- a optional localpart.domainpart
- a required domainpart.resource
- a optional resourcepart.context
- the JXMPP context.- Returns:
- a JID which consists of the given parts.
- Throws:
XmppStringprepException
- if an error occurs.
-
fromOrThrowUnchecked
public static Jid fromOrThrowUnchecked(CharSequence cs)
Likefrom(CharSequence)
but does throw an uncheckedIllegalArgumentException
instead of aXmppStringprepException
.- Parameters:
cs
- the character sequence which should be transformed to aJid
- Returns:
- the
Jid
if no exception occurs - Throws:
IllegalArgumentException
- if the given input is not a valid JID- Since:
- 0.6.2
- See Also:
from(String)
-
from
public static Jid from(CharSequence jid) throws XmppStringprepException
Get aJid
from a CharSequence.- Parameters:
jid
- the input CharSequence.- Returns:
- the Jid represented by the input CharSequence.
- Throws:
XmppStringprepException
- if an error occurs.- See Also:
from(String)
-
from
public static Jid from(String jidString) throws XmppStringprepException
Get aJid
from the given String.- Parameters:
jidString
- the input String.- Returns:
- the Jid represented by the input String.
- Throws:
XmppStringprepException
- if an error occurs.- See Also:
from(CharSequence)
-
from
public static Jid from(String jidString, JxmppContext context) throws XmppStringprepException
Get aJid
from the given String.- Parameters:
jidString
- the input String.context
- the JXMPP context.- Returns:
- the Jid represented by the input String.
- Throws:
XmppStringprepException
- if an error occurs.- See Also:
from(CharSequence)
-
fromOrNull
public static Jid fromOrNull(CharSequence cs)
- Parameters:
cs
- the inputCharSequence
- Returns:
- a JID or
null
-
fromUnescapedOrThrowUnchecked
public static Jid fromUnescapedOrThrowUnchecked(CharSequence cs)
LikefromUnescaped(CharSequence)
but does throw an uncheckedIllegalArgumentException
instead of aXmppStringprepException
.- Parameters:
cs
- the character sequence which should be transformed to aJid
- Returns:
- the
Jid
if no exception occurs - Throws:
IllegalArgumentException
- if the given input is not a valid JID- Since:
- 0.6.2
- See Also:
fromUnescaped(CharSequence)
-
fromUnescaped
public static Jid fromUnescaped(CharSequence unescapedJid) throws XmppStringprepException
Get aJid
from the given unescaped CharSequence.- Parameters:
unescapedJid
- an unescaped CharSequence representing a JID.- Returns:
- a JID.
- Throws:
XmppStringprepException
- if an error occurs.
-
fromUnescaped
public static Jid fromUnescaped(String unescapedJidString) throws XmppStringprepException
Get aJid
from the given unescaped String.- Parameters:
unescapedJidString
- a unescaped String representing a JID.- Returns:
- a JID.
- Throws:
XmppStringprepException
- if an error occurs.
-
fromUnescapedOrNull
public static Jid fromUnescapedOrNull(CharSequence cs)
- Parameters:
cs
- the inputCharSequence
- Returns:
- a JID or
null
-
fromUrlEncoded
public static Jid fromUrlEncoded(CharSequence cs) throws XmppStringprepException
Get aJid
from an URL encoded CharSequence.- Parameters:
cs
- a CharSequence representing an URL encoded JID.- Returns:
- a JID
- Throws:
XmppStringprepException
- if an error occurs.- See Also:
URLDecoder
-
bareFromOrThrowUnchecked
public static BareJid bareFromOrThrowUnchecked(CharSequence cs)
LikebareFrom(CharSequence)
but does throw an uncheckedIllegalArgumentException
instead of aXmppStringprepException
.- Parameters:
cs
- the character sequence which should be transformed to aBareJid
- Returns:
- the
BareJid
if no exception occurs - Throws:
IllegalArgumentException
- if the given input is not a valid JID- Since:
- 0.6.2
- See Also:
bareFrom(CharSequence)
-
bareFrom
public static BareJid bareFrom(CharSequence jid) throws XmppStringprepException
Get aBareJid
representing the given CharSequence.- Parameters:
jid
- the input CharSequence.- Returns:
- a bare JID representing the given CharSequence.
- Throws:
XmppStringprepException
- if an error occurs.
-
bareFrom
public static BareJid bareFrom(String jid) throws XmppStringprepException
Get aBareJid
representing the given String.- Parameters:
jid
- the input String.- Returns:
- a bare JID representing the given String.
- Throws:
XmppStringprepException
- if an error occurs.
-
bareFrom
public static BareJid bareFrom(String jid, JxmppContext context) throws XmppStringprepException
Get aBareJid
representing the given String.- Parameters:
jid
- the input String.context
- the JXMPP context.- Returns:
- a bare JID representing the given String.
- Throws:
XmppStringprepException
- if an error occurs.
-
bareFrom
public static BareJid bareFrom(Localpart localpart, DomainBareJid domainBareJid)
- Parameters:
localpart
- a optional localpart.domainBareJid
- a domain bare JID.- Returns:
- a bare JID.
-
bareFrom
public static BareJid bareFrom(Localpart localpart, Domainpart domain)
- Parameters:
localpart
- a optional localpart.domain
- a domainpart.- Returns:
- a bare JID constructed from the given parts.
-
bareFromOrNull
public static BareJid bareFromOrNull(CharSequence cs)
- Parameters:
cs
- the inputCharSequence
- Returns:
- a JID or
null
-
bareFromUrlEncoded
public static BareJid bareFromUrlEncoded(CharSequence cs) throws XmppStringprepException
Get aBareJid
from an URL encoded CharSequence.- Parameters:
cs
- a CharSequence representing an URL encoded bare JID.- Returns:
- a bare JID
- Throws:
XmppStringprepException
- if an error occurs.- See Also:
URLDecoder
-
fullFromOrThrowUnchecked
public static FullJid fullFromOrThrowUnchecked(CharSequence cs)
LikefullFrom(CharSequence)
but does throw an uncheckedIllegalArgumentException
instead of aXmppStringprepException
.- Parameters:
cs
- the character sequence which should be transformed to aFullJid
- Returns:
- the
FullJid
if no exception occurs - Throws:
IllegalArgumentException
- if the given input is not a valid JID- Since:
- 0.6.2
- See Also:
fullFrom(CharSequence)
-
fullFrom
public static FullJid fullFrom(CharSequence jid) throws XmppStringprepException
Get aFullJid
representing the given CharSequence.- Parameters:
jid
- a CharSequence representing a JID.- Returns:
- a full JID representing the given CharSequence.
- Throws:
XmppStringprepException
- if an error occurs.
-
fullFrom
public static FullJid fullFrom(String jid) throws XmppStringprepException
Get aFullJid
representing the given String.- Parameters:
jid
- the JID's String.- Returns:
- a full JID representing the input String.
- Throws:
XmppStringprepException
- if an error occurs.
-
fullFrom
public static FullJid fullFrom(String localpart, String domainpart, String resource) throws XmppStringprepException
Get aFullJid
constructed from the given parts.- Parameters:
localpart
- a optional localpart.domainpart
- a domainpart.resource
- a resourcepart.- Returns:
- a full JID.
- Throws:
XmppStringprepException
- if an error occurs.
-
fullFrom
public static FullJid fullFrom(String localpart, String domainpart, String resource, JxmppContext context) throws XmppStringprepException
Get aFullJid
constructed from the given parts.- Parameters:
localpart
- a optional localpart.domainpart
- a domainpart.resource
- a resourcepart.context
- the JXMPP context.- Returns:
- a full JID.
- Throws:
XmppStringprepException
- if an error occurs.
-
fullFrom
public static FullJid fullFrom(Localpart localpart, DomainBareJid domainBareJid, Resourcepart resource)
Get aFullJid
constructed from the given parts.- Parameters:
localpart
- a optional localpart.domainBareJid
- a domain bare JID.resource
- a resourcepart- Returns:
- a full JID.
-
fullFrom
public static FullJid fullFrom(Localpart localpart, Domainpart domainpart, Resourcepart resource)
Get aFullJid
constructed from the given parts.- Parameters:
localpart
- the optional localpart.domainpart
- the domainpart.resource
- the resourcepart.- Returns:
- a full JID.
-
fullFrom
public static FullJid fullFrom(BareJid bareJid, Resourcepart resource)
- Parameters:
bareJid
- a entity bare JID.resource
- a resourcepart.- Returns:
- a full JID.
-
fullFromOrNull
public static FullJid fullFromOrNull(CharSequence cs)
- Parameters:
cs
- the inputCharSequence
- Returns:
- a JID or
null
-
fullFromUrlEncoded
public static FullJid fullFromUrlEncoded(CharSequence cs) throws XmppStringprepException
Get aFullJid
from an URL encoded CharSequence.- Parameters:
cs
- a CharSequence representing an URL encoded full JID.- Returns:
- a full JID
- Throws:
XmppStringprepException
- if an error occurs.- See Also:
URLDecoder
-
entityFromOrThrowUnchecked
public static EntityJid entityFromOrThrowUnchecked(CharSequence cs)
LikeentityFrom(CharSequence)
but does throw an uncheckedIllegalArgumentException
instead of aXmppStringprepException
.- Parameters:
cs
- the character sequence which should be transformed to aEntityJid
- Returns:
- the
EntityJid
if no exception occurs - Throws:
IllegalArgumentException
- if the given input is not a valid JID- Since:
- 0.6.2
- See Also:
entityFrom(CharSequence)
-
entityFrom
public static EntityJid entityFrom(CharSequence jid) throws XmppStringprepException
Get aEntityJid
representing the given String.- Parameters:
jid
- the JID's string.- Returns:
- an entity JID representing the given String.
- Throws:
XmppStringprepException
- if an error occurs.
-
entityFrom
public static EntityJid entityFrom(String jidString) throws XmppStringprepException
Get aEntityJid
representing the given String.- Parameters:
jidString
- the JID's string.- Returns:
- an entity JID representing the given String.
- Throws:
XmppStringprepException
- if an error occurs.
-
entityFromUnescapedOrThrowUnchecked
public static EntityJid entityFromUnescapedOrThrowUnchecked(CharSequence cs)
LikeentityFromUnescaped(CharSequence)
but does throw an uncheckedIllegalArgumentException
instead of aXmppStringprepException
.- Parameters:
cs
- the character sequence which should be transformed to aEntityJid
- Returns:
- the
EntityJid
if no exception occurs - Throws:
IllegalArgumentException
- if the given input is not a valid JID- Since:
- 0.6.2
- See Also:
entityFromUnescaped(CharSequence)
-
entityFromUnescaped
public static EntityJid entityFromUnescaped(CharSequence jid) throws XmppStringprepException
Get aEntityJid
representing the given String.- Parameters:
jid
- the JID.- Returns:
- an entity JID representing the given input..
- Throws:
XmppStringprepException
- if an error occurs.
-
entityFromUnescaped
public static EntityJid entityFromUnescaped(String jidString) throws XmppStringprepException
Get aEntityJid
representing the given String.- Parameters:
jidString
- the JID's string.- Returns:
- an entity JID representing the given String.
- Throws:
XmppStringprepException
- if an error occurs.
-
entityFromUnesacpedOrNull
@Deprecated public static EntityJid entityFromUnesacpedOrNull(CharSequence cs)
Deprecated.useentityFromUnescapedOrNull(CharSequence)
instead.- Parameters:
cs
- the inputCharSequence
- Returns:
- a JID or
null
-
entityFromUnescapedOrNull
public static EntityJid entityFromUnescapedOrNull(CharSequence cs)
- Parameters:
cs
- the inputCharSequence
- Returns:
- a JID or
null
-
entityFromOrNull
public static EntityJid entityFromOrNull(CharSequence cs)
- Parameters:
cs
- the inputCharSequence
- Returns:
- a JID or
null
-
entityFromUrlEncoded
public static EntityJid entityFromUrlEncoded(CharSequence cs) throws XmppStringprepException
Get aEntityJid
from an URL encoded CharSequence.- Parameters:
cs
- a CharSequence representing an URL encoded entity JID.- Returns:
- an entity JID
- Throws:
XmppStringprepException
- if an error occurs.- See Also:
URLDecoder
-
entityBareFromOrThrowUnchecked
public static EntityBareJid entityBareFromOrThrowUnchecked(CharSequence cs)
LikeentityBareFrom(CharSequence)
but does throw an uncheckedIllegalArgumentException
instead of aXmppStringprepException
.- Parameters:
cs
- the character sequence which should be transformed to aEntityBareJid
- Returns:
- the
EntityBareJid
if no exception occurs - Throws:
IllegalArgumentException
- if the given input is not a valid JID- Since:
- 0.6.2
- See Also:
entityBareFrom(CharSequence)
-
entityBareFrom
public static EntityBareJid entityBareFrom(CharSequence jid) throws XmppStringprepException
Get aEntityBareJid
representing the given CharSequence.- Parameters:
jid
- the input CharSequence.- Returns:
- a bare JID representing the given CharSequence.
- Throws:
XmppStringprepException
- if an error occurs.
-
entityBareFrom
public static EntityBareJid entityBareFrom(String jid) throws XmppStringprepException
Get aEntityBareJid
representing the given String.- Parameters:
jid
- the input String.- Returns:
- a bare JID representing the given String.
- Throws:
XmppStringprepException
- if an error occurs.
-
entityBareFrom
public static EntityBareJid entityBareFrom(String jid, JxmppContext context) throws XmppStringprepException
Get aEntityBareJid
representing the given String.- Parameters:
jid
- the input String.context
- the JXMPP context.- Returns:
- a bare JID representing the given String.
- Throws:
XmppStringprepException
- if an error occurs.
-
entityBareFromUnescapedOrThrowUnchecked
public static EntityBareJid entityBareFromUnescapedOrThrowUnchecked(CharSequence cs)
LikeentityBareFromUnescaped(CharSequence)
but does throw an uncheckedIllegalArgumentException
instead of aXmppStringprepException
.- Parameters:
cs
- the character sequence which should be transformed to aEntityBareJid
- Returns:
- the
EntityBareJid
if no exception occurs - Throws:
IllegalArgumentException
- if the given input is not a valid JID- Since:
- 0.6.2
- See Also:
entityBareFromUnescaped(CharSequence)
-
entityBareFromUnescaped
public static EntityBareJid entityBareFromUnescaped(CharSequence unescapedJid) throws XmppStringprepException
Get aEntityBareJid
representing the given unescaped CharSequence.- Parameters:
unescapedJid
- the input CharSequence.- Returns:
- a bare JID representing the given CharSequence.
- Throws:
XmppStringprepException
- if an error occurs.
-
entityBareFromUnescaped
public static EntityBareJid entityBareFromUnescaped(String unescapedJidString) throws XmppStringprepException
Get aEntityBareJid
representing the given unescaped String.- Parameters:
unescapedJidString
- the input String.- Returns:
- a bare JID representing the given String.
- Throws:
XmppStringprepException
- if an error occurs.
-
entityBareFromUnescaped
public static EntityBareJid entityBareFromUnescaped(String unescapedJidString, JxmppContext context) throws XmppStringprepException
Get aEntityBareJid
representing the given unescaped String.- Parameters:
unescapedJidString
- the input String.context
- the JXMPP context.- Returns:
- a bare JID representing the given String.
- Throws:
XmppStringprepException
- if an error occurs.
-
entityBareFromUnescapedOrNull
public static EntityBareJid entityBareFromUnescapedOrNull(CharSequence cs)
- Parameters:
cs
- the inputCharSequence
- Returns:
- a JID or
null
-
entityBareFrom
public static EntityBareJid entityBareFrom(Localpart localpart, DomainBareJid domainBareJid)
Get aEntityBareJid
constructed from the givenLocalpart
and {link DomainBareJid}.- Parameters:
localpart
- a localpart.domainBareJid
- a domain bare JID.- Returns:
- a bare JID.
-
entityBareFrom
public static EntityBareJid entityBareFrom(Localpart localpart, Domainpart domain)
- Parameters:
localpart
- a localpart.domain
- a domainpart.- Returns:
- a bare JID constructed from the given parts.
-
entityBareFromOrNull
public static EntityBareJid entityBareFromOrNull(CharSequence cs)
- Parameters:
cs
- the inputCharSequence
- Returns:
- a JID or
null
-
entityBareFromUrlEncoded
public static EntityBareJid entityBareFromUrlEncoded(CharSequence cs) throws XmppStringprepException
Get aEntityBareJid
from an URL encoded CharSequence.- Parameters:
cs
- a CharSequence representing an URL encoded entity bare JID.- Returns:
- an entity bare JID
- Throws:
XmppStringprepException
- if an error occurs.- See Also:
URLDecoder
-
entityFullFromOrThrowUnchecked
public static EntityFullJid entityFullFromOrThrowUnchecked(CharSequence cs)
LikeentityFullFrom(CharSequence)
but does throw an uncheckedIllegalArgumentException
instead of aXmppStringprepException
.- Parameters:
cs
- the character sequence which should be transformed to aEntityFullJid
- Returns:
- the
EntityFullJid
if no exception occurs - Throws:
IllegalArgumentException
- if the given input is not a valid JID- Since:
- 0.6.2
- See Also:
entityFullFrom(CharSequence)
-
entityFullFrom
public static EntityFullJid entityFullFrom(CharSequence jid) throws XmppStringprepException
Get aEntityFullJid
representing the given CharSequence.- Parameters:
jid
- a CharSequence representing a JID.- Returns:
- a full JID representing the given CharSequence.
- Throws:
XmppStringprepException
- if an error occurs.
-
entityFullFrom
public static EntityFullJid entityFullFrom(String jid) throws XmppStringprepException
Get aEntityFullJid
representing the given String.- Parameters:
jid
- the JID's String.- Returns:
- a full JID representing the input String.
- Throws:
XmppStringprepException
- if an error occurs.
-
entityFullFromOrNull
public static EntityFullJid entityFullFromOrNull(CharSequence cs)
- Parameters:
cs
- the inputCharSequence
- Returns:
- a JID or
null
-
entityFullFromUnescapedOrThrowUnchecked
public static EntityFullJid entityFullFromUnescapedOrThrowUnchecked(CharSequence cs)
LikeentityFullFromUnescaped(CharSequence)
but does throw an uncheckedIllegalArgumentException
instead of aXmppStringprepException
.- Parameters:
cs
- the character sequence which should be transformed to aEntityFullJid
- Returns:
- the
EntityFullJid
if no exception occurs - Throws:
IllegalArgumentException
- if the given input is not a valid JID- Since:
- 0.6.2
- See Also:
entityFullFromUnescaped(CharSequence)
-
entityFullFromUnescaped
public static EntityFullJid entityFullFromUnescaped(CharSequence unescapedJid) throws XmppStringprepException
Get aEntityFullJid
representing the given unescaped CharSequence.- Parameters:
unescapedJid
- a CharSequence representing a JID.- Returns:
- a full JID representing the given CharSequence.
- Throws:
XmppStringprepException
- if an error occurs.
-
entityFullFromUnescaped
public static EntityFullJid entityFullFromUnescaped(String unescapedJidString) throws XmppStringprepException
Get aEntityFullJid
representing the given unescaped String.- Parameters:
unescapedJidString
- the JID's String.- Returns:
- a full JID representing the input String.
- Throws:
XmppStringprepException
- if an error occurs.
-
entityFullFromUnescaped
public static EntityFullJid entityFullFromUnescaped(String unescapedJidString, JxmppContext context) throws XmppStringprepException
Get aEntityFullJid
representing the given unescaped String.- Parameters:
unescapedJidString
- the JID's String.context
- the JXMPP context.- Returns:
- a full JID representing the input String.
- Throws:
XmppStringprepException
- if an error occurs.
-
entityFullFromUnescapedOrNull
public static EntityFullJid entityFullFromUnescapedOrNull(CharSequence cs)
- Parameters:
cs
- the inputCharSequence
- Returns:
- a JID or
null
-
entityFullFrom
public static EntityFullJid entityFullFrom(String localpart, String domainpart, String resource) throws XmppStringprepException
Get aEntityFullJid
constructed from the given parts.- Parameters:
localpart
- a localpart.domainpart
- a domainpart.resource
- a resourcepart.- Returns:
- a full JID.
- Throws:
XmppStringprepException
- if an error occurs.
-
entityFullFrom
public static EntityFullJid entityFullFrom(String localpart, String domainpart, String resource, JxmppContext context) throws XmppStringprepException
Get aEntityFullJid
constructed from the given parts.- Parameters:
localpart
- a localpart.domainpart
- a domainpart.resource
- a resourcepart.context
- the JXMPP context.- Returns:
- a full JID.
- Throws:
XmppStringprepException
- if an error occurs.
-
entityFullFrom
public static EntityFullJid entityFullFrom(Localpart localpart, DomainBareJid domainBareJid, Resourcepart resource)
Get aEntityFullJid
constructed from the given parts.- Parameters:
localpart
- a localpart.domainBareJid
- a domain bare JID..resource
- a resourcepart- Returns:
- a full JID.
-
entityFullFrom
public static EntityFullJid entityFullFrom(Localpart localpart, Domainpart domainpart, Resourcepart resource)
Get aEntityFullJid
constructed from the given parts.- Parameters:
localpart
- the localpart.domainpart
- the domainpart.resource
- the resourcepart.- Returns:
- a full JID.
-
entityFullFrom
public static EntityFullJid entityFullFrom(EntityBareJid bareJid, Resourcepart resource)
- Parameters:
bareJid
- a bare JID.resource
- a resourcepart.- Returns:
- a full JID.
-
entityFullFromUrlEncoded
public static EntityFullJid entityFullFromUrlEncoded(CharSequence cs) throws XmppStringprepException
Get aEntityFullJid
from an URL encoded CharSequence.- Parameters:
cs
- a CharSequence representing an URL encoded entity full JID.- Returns:
- an entity full JID
- Throws:
XmppStringprepException
- if an error occurs.- See Also:
URLDecoder
-
domainBareFromOrThrowUnchecked
public static DomainBareJid domainBareFromOrThrowUnchecked(CharSequence cs)
LikedomainBareFrom(CharSequence)
but does throw an uncheckedIllegalArgumentException
instead of aXmppStringprepException
.- Parameters:
cs
- the character sequence which should be transformed to aEntityFullJid
- Returns:
- the
EntityFullJid
if no exception occurs - Since:
- 0.6.2
- See Also:
from(String)
-
domainBareFrom
public static DomainBareJid domainBareFrom(CharSequence jid) throws XmppStringprepException
Get a domain bare JID.- Parameters:
jid
- the JID CharSequence.- Returns:
- a domain bare JID.
- Throws:
XmppStringprepException
- if an error occurs.
-
domainBareFrom
public static DomainBareJid domainBareFrom(String jid) throws XmppStringprepException
Get a domain bare JID.- Parameters:
jid
- the JID String.- Returns:
- a domain bare JID.
- Throws:
XmppStringprepException
- if an error occurs.
-
domainBareFrom
public static DomainBareJid domainBareFrom(String jid, JxmppContext context) throws XmppStringprepException
Get a domain bare JID.- Parameters:
jid
- the JID String.context
- the JXMPP context.- Returns:
- a domain bare JID.
- Throws:
XmppStringprepException
- if an error occurs.
-
domainBareFrom
public static DomainBareJid domainBareFrom(Domainpart domainpart)
Get aDomainBareJid
consisting of the givenDomainpart
.- Parameters:
domainpart
- the domainpart.- Returns:
- a domain bare JID.
-
domainBareFromOrNull
public static DomainBareJid domainBareFromOrNull(CharSequence cs)
- Parameters:
cs
- the inputCharSequence
- Returns:
- a JID or
null
-
domainBareFromUrlEncoded
public static DomainBareJid domainBareFromUrlEncoded(CharSequence cs) throws XmppStringprepException
Get aDomainBareJid
from an URL encoded CharSequence.- Parameters:
cs
- a CharSequence representing an URL encoded domain bare JID.- Returns:
- a domain bare JID
- Throws:
XmppStringprepException
- if an error occurs.- See Also:
URLDecoder
-
domainFullFromOrThrowUnchecked
public static DomainFullJid domainFullFromOrThrowUnchecked(CharSequence cs)
LikedomainFullFrom(CharSequence)
but does throw an uncheckedIllegalArgumentException
instead of aXmppStringprepException
.- Parameters:
cs
- the character sequence which should be transformed to aDomainFullJid
- Returns:
- the
DomainFullJid
if no exception occurs - Throws:
IllegalArgumentException
- if the given input is not a valid JID- Since:
- 0.6.2
- See Also:
domainFullFrom(CharSequence)
-
domainFullFrom
public static DomainFullJid domainFullFrom(CharSequence jid) throws XmppStringprepException
Get a domain full JID from the given CharSequence.- Parameters:
jid
- the JID.- Returns:
- a domain full JID.
- Throws:
XmppStringprepException
- if an error happens.
-
domainFullFrom
public static DomainFullJid domainFullFrom(String jid) throws XmppStringprepException
Get a domain full JID from the given String.- Parameters:
jid
- the JID.- Returns:
- a DomainFullJid.
- Throws:
XmppStringprepException
- if an error happens.
-
domainFullFrom
public static DomainFullJid domainFullFrom(String jid, JxmppContext context) throws XmppStringprepException
Get a domain full JID from the given String.- Parameters:
jid
- the JID.context
- the JXMPP context.- Returns:
- a DomainFullJid.
- Throws:
XmppStringprepException
- if an error happens.
-
domainFullFrom
public static DomainFullJid domainFullFrom(Domainpart domainpart, Resourcepart resource)
Get a domain full JID.- Parameters:
domainpart
- the domainpart.resource
- the resourcepart.- Returns:
- a domain full JID.
-
domainFullFrom
public static DomainFullJid domainFullFrom(DomainBareJid domainBareJid, Resourcepart resource)
Get a domain full JID.- Parameters:
domainBareJid
- a domain bare JID.resource
- a resourcepart.- Returns:
- a domain full JID.
-
domainFullFromOrNull
public static DomainFullJid domainFullFromOrNull(CharSequence cs)
- Parameters:
cs
- the inputCharSequence
- Returns:
- a JID or
null
-
domainFullFromUrlEncoded
public static DomainFullJid domainFullFromUrlEncoded(CharSequence cs) throws XmppStringprepException
Get aDomainFullJid
from an URL encoded CharSequence.- Parameters:
cs
- a CharSequence representing an URL encoded domain full JID.- Returns:
- a domain full JID
- Throws:
XmppStringprepException
- if an error occurs.- See Also:
URLDecoder
-
-