BareJID (Tigase Utils 3.5.0 API)

java.lang.Object
- tigase.xmpp.BareJID

All Implemented Interfaces:

Comparable<BareJID>
```
public final class BareJID
extends Object
implements Comparable<BareJID>
```
Instance of the BareJID class holds a single, bare JID. When the object is created the parameters are checked and processed through the stringprep. An exception is throw in case of stringprep processing error. The instances of the class are immutable objects.
There are planed various optimisations for the class implementation, one of them is to allow for comparing the instanced by references ('==') instead of of equals() method. This is to improve the performance and lower memory usage. Other improvements and optimisations are also planed.
Some of the optimisations require that the instances are created in strictly controlled way, hence there is no public constructor and you have to use factory methods to create a new instance of the BareJID class.
The class also offers a few utility methods for parsing and constructing JID strings. Please see JavaDoc documentation for more details. Created: Dec 28, 2009 10:47:51 PM

Version:

$Rev$

Author:

Artur Hefczyc

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static BareJID`	`bareJIDInstance(String jid)` The method creates an instance of the `BareJID` class.
`static BareJID`	`bareJIDInstance(String p_localpart, String p_domain)` The method creates an instance of the `BareJID` class.
`static BareJID`	`bareJIDInstanceNS(String jid)` The method creates an instance of the `BareJID` class.
`static BareJID`	`bareJIDInstanceNS(String p_localpart, String p_domain)` The method creates an instance of the `BareJID` class.
`int`	`compareTo(BareJID o)` Method compares the `BareJID` instance to the object given as a parameter.
`boolean`	`equals(Object b)` Method compares whether this `BareJID` instance represents the same user bare JID as the one given in parameter.
`String`	`getDomain()` Method returns a domain part of the `BareJID`.
`String`	`getLocalpart()` Method returns a localpart (nickname) of the `BareJID`.
`int`	`hashCode()` Method returns a hash code calculated for the `BareJID` instance.
`static String`	`jidToBareJID(String jid)` A utility method to strip the resource part from the given JID string.
`static String[]`	`parseJID(String jid)` A utility method to parse and split the given JID string into separate parts.
`String`	`toString()` Method returns a `String` representation of the `BareJID` instance.
`static String`	`toString(BareJID bareJid, String p_resource)` A utility method to construct a `String` representing user JID from given parameters.
`static String`	`toString(String p_localpart, String p_domain)` A utility method to construct a `String` representing user JID from given parameters.
`static String`	`toString(String p_localpart, String p_domain, String p_resource)` A utility method to construct a `String` representing user JID from given parameters.
`static void`	`useStringprepProcessor(String stringprepProcessor)` Changes stringprep processor implementation used for the JID checking.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Method Detail
  - bareJIDInstance
```
public static BareJID bareJIDInstance(String jid)
                               throws TigaseStringprepException
```
    The method creates an instance of the BareJID class. The bare JID is parsed and constructed from the String parameter.
    The localpart (nick name) and the domain part of the JID are parsed and processed through the stringprep. If a strngprep parsing error occurs an exception is thrown.
    The resource part, if provided in the JID paramater, is thrown away.
    Please note, the method does not necessarily has to return a new instance of the class. It may return the same exact object every time you pass parameters which refer to the same bare JID identifier.
    
    Parameters:
    
    jid - is a String parameter used to create the bare JID instance.
    
    Returns:
    
    an instance of the BareJID class which corresponds to the JID given as the parameter.
    
    Throws:
    
    TigaseStringprepException - if the stringprep processing fails for any JID part used to create the instance.
  - bareJIDInstance
```
public static BareJID bareJIDInstance(String p_localpart,
                                      String p_domain)
                               throws TigaseStringprepException
```
    The method creates an instance of the BareJID class. The bare JID is parsed and constructed from two String parameters.
    The localpart (nick name) and the domain part of the JID are parsed and processed through the stringprep. If a strngprep parsing error occurs an exception is thrown.
    Please note, the method does not necessarily has to return a new instance of the class. It may return the same exact object every time you pass parameters which refer to the same bare JID identifier.
    
    Parameters:
    
    p_localpart - is a String parameter assumed to be a JID localpart (nickname) and used to create the bare JID instance. The localpart parameter can be null.
    
    p_domain - is a String parameter assumed to be a JID domain part and used to create the bare JID instance. This parameter must not be null.
    
    Returns:
    
    an instance of the BareJID class which corresponds to the JID given as the parameter.
    
    Throws:
    
    TigaseStringprepException - if the stringprep processing fails for any JID part used to create the instance.
  - bareJIDInstanceNS
```
public static BareJID bareJIDInstanceNS(String jid)
```
    The method creates an instance of the BareJID class. The bare JID is parsed and constructed from the String parameter. Note, this method does not perform stringprep processing on input parameters.
    The resource part, if provided in the JID paramater, is thrown away.
    Please note, the method does not necessarily has to return a new instance of the class. It may return the same exact object every time you pass parameters which refer to the same bare JID identifier.
    
    Parameters:
    
    jid - is a String parameter used to create the bare JID instance.
    
    Returns:
    
    an instance of the BareJID class which corresponds to the JID given as the parameter.
  - bareJIDInstanceNS
```
public static BareJID bareJIDInstanceNS(String p_localpart,
                                        String p_domain)
```
    The method creates an instance of the BareJID class. The bare JID is parsed and constructed from two String parameters. Note, this method does not perform stringprep processing on input parameters.
    Please note, the method does not necessarily has to return a new instance of the class. It may return the same exact object every time you pass parameters which refer to the same bare JID identifier.
    
    Parameters:
    
    p_localpart - is a String parameter assumed to be a JID localpart (nickname) and used to create the bare JID instance. The localpart parameter can be null.
    
    p_domain - is a String parameter assumed to be a JID domain part and used to create the bare JID instance. This parameter must not be null.
    
    Returns:
    
    an instance of the BareJID class which corresponds to the JID given as the parameter.
  - jidToBareJID
```
public static String jidToBareJID(String jid)
```
    A utility method to strip the resource part from the given JID string. The method doesn't perform any checkings and it doesn't run stringprep processing on the given parameter. This is a pure string manipulation utility method.
    
    Parameters:
    
    jid - is a String representing user full JID.
    
    Returns:
    
    a new String instance of the JID wihout resource part.
  - parseJID
```
public static String[] parseJID(String jid)
```
    A utility method to parse and split the given JID string into separate parts. The result is returned as a three elements' String array:
    1. The first element (index 0) of the array is the JID's localpart (nickname). Can be null.
    2. The second element (index 1) of the array is the JID's domain part.
    3. The third element (index 2) of the array is the JID's resource part. Can be null.
    The method doesn't perform any checkings and it doesn't run stringprep processing on the given parameter. This is a pure string manipulation utility method.
    Parameters:
    
    jid - is a String representing user full JID.
    
    Returns:
    
    a three element String array with parsed JID parts. The array may contain null elements.
  - toString
```
public static String toString(String p_localpart,
                              String p_domain)
```
    A utility method to construct a String representing user JID from given parameters. The method doesn't perform any checkings and it doesn't run stringprep processing on the given parameter. This is a pure string manipulation utility method.
    
    Parameters:
    
    p_localpart - is a JID's localpart (nickname)
    
    p_domain - is a JID's domain part.
    
    Returns:
    
    a new String representing user's JID build from given parameters. If the localpart is null then the method simply returns parameter given as domain part.
  - toString
```
public static String toString(String p_localpart,
                              String p_domain,
                              String p_resource)
```
    A utility method to construct a String representing user JID from given parameters. The method doesn't perform any checkings and it doesn't run stringprep processing on the given parameter. This is a pure string manipulation utility method.
    
    Parameters:
    
    p_localpart - is a JID's localpart (nickname)
    
    p_domain - is a JID's domain part.
    
    p_resource - is a JID's resource part.
    
    Returns:
    
    a new String representing user's JID build from given parameters. If the localpart and resource part is null then the method simply returns parameter given as domain part.
  - toString
```
public static String toString(BareJID bareJid,
                              String p_resource)
```
    A utility method to construct a String representing user JID from given parameters. The method doesn't perform any checkings and it doesn't run stringprep processing on the resource parameter.
    
    Parameters:
    
    bareJid - is a BareJID instance.
    
    p_resource - is a JID's resource part.
    
    Returns:
    
    a new String representing user's JID build from given parameters.
  - useStringprepProcessor
```
public static void useStringprepProcessor(String stringprepProcessor)
```
    Changes stringprep processor implementation used for the JID checking. The method can be called at any time to change used processor. All subsequent JID and BareJID instances are created using a new processor.
    
    Parameters:
    
    stringprepProcessor - is a String value with stringprep processor name or class name implementing stringprep processing interface.
  - compareTo
```
public int compareTo(BareJID o)
```
    Method compares the BareJID instance to the object given as a parameter. The method implements the compareTo specification contract and returns values as we would expect from the call:
```
 bareJID_1.toString().compareTo(bareJID_2.toString())
 
```
    Specified by:
    
    compareTo in interface Comparable<BareJID>
    
    Parameters:
    
    o - is an BareJID instance with which the comparision is performed.
    
    Returns:
    values as we would expect from the call:
    bareJID_1.toString().compareTo(bareJID_2.toString())
  - equals
```
public boolean equals(Object b)
```
    Method compares whether this BareJID instance represents the same user bare JID as the one given in parameter. It returns true of both the localpart (nickname) and domain part are the same for both objects.
    
    Overrides:
    
    equals in class Object
    
    Parameters:
    
    b - is a BareJID object to which the instance is compared.
    
    Returns:
    
    a boolean value of true if both instances represent the same bare JID and false otherwise.
  - getDomain
```
public String getDomain()
```
    Method returns a domain part of the BareJID. Please note the String returned is parsed, checked and processed via stringprep, hence it represents a valid domain name as defined in XMPP RFC.
    
    Returns:
    
    a domain part of the BareJID instance.
  - getLocalpart
```
public String getLocalpart()
```
    Method returns a localpart (nickname) of the BareJID. Please note the String returned is parsed, checked and processed via stringprep, hence it represents a valid localpart as defined in XMPP RFC.
    
    Returns:
    
    a localpart (nickname) of the BareJID instance.
  - hashCode
```
public int hashCode()
```
    Method returns a hash code calculated for the BareJID instance.
    
    Overrides:
    
    hashCode in class Object
    
    Returns:
    
    an object hash code.
  - toString
```
public String toString()
```
    Method returns a String representation of the BareJID instance.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    a String representation of the BareJID instance.

Class BareJID

Method Summary

Methods inherited from class java.lang.Object

Method Detail

bareJIDInstance

bareJIDInstance

bareJIDInstanceNS

bareJIDInstanceNS

jidToBareJID

parseJID

toString

toString

toString

useStringprepProcessor

compareTo

equals

getDomain

getLocalpart

hashCode

toString