Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Unpublished - rights reserved under the Copyright Laws of the United States. Copyright � 2003 Sun Microsystems, Inc. All rights reserved. Copyright � 2005 BEA Systems, Inc. All rights reserved. Use is subject to license terms. This distribution may include materials developed by third parties. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Module Name : JSIP Specification File Name : Address.java Author : Phelim O'Doherty HISTORY Version Date Author Comments 1.1 08/10/2002 Phelim O'Doherty Initial version 1.2 18/05/2005 Phelim O'Doherty Added hashcode method ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 package javax.sip.address;
 
 import java.io.*;
This interface represents a user's display name and URI address. The display name of an address is optional but if included can be displayed to an end-user. The address URI (most likely a SipURI) is the user's address. For example a 'To' address of To: Bob sip:duke@jcp.org would have a display name attribute of Bob and an address of sip:duke@jcp.org.

Author(s):
BEA Systems, NIST
Version:
1.2
See also:
SipURI
TelURL
 
 
 public interface Address extends CloneableSerializable{

    
Sets the display name of the Address. The display name is an additional user friendly personalized text that accompanies the address.

Parameters:
displayName - the new string value of the display name.
Throws:
java.text.ParseException which signals that an error has been reached unexpectedly while parsing the displayName value.
 
     public void setDisplayName(String displayNamethrows ParseException;

    
Gets the display name of this Address, or null if the attribute is not set.

Returns:
the display name of this Address
 
     public String getDisplayName();

    
Sets the URI of this Address. The URI can be either a TelURL or a SipURI.

Parameters:
uri - the new URI value of this Address.
 
     public void setURI(URI uri);

    
Returns the URI of this Address. The type of URI can be determined by the scheme.

Returns:
URI parmater of the Address object
 
     public URI getURI();


    
Returns a string representation of this Address.

Returns:
the stringified representation of the Address
 
     public String toString();

    
Indicates whether some other Object is "equal to" this Address. The actual implementation class of a Address object must override the Object.equals method. The new equals method must ensure that the implementation of the method is reflexive, symmetric, transitive and for any non null value X, X.equals(null) returns false.

Parameters:
obj - the Object with which to compare this Address
Returns:
true if this Address is "equal to" the object argument and false otherwise.
See also:
java.lang.Object
 
     public boolean equals(Object obj);

    
Gets a hash code value for this address. Implementations MUST implement a hashCode method that overrides the default hash code method for Objects comparision.

Returns:
a hash code value.
Since:
v1.2
    public int hashCode();    
    
    
This determines if this address is a wildcard address. That is ((SipURI)Address.getURI()).getUser() == *;. This method is specific to SIP and SIPS schemes.

Returns:
true if this address is a wildcard, false otherwise.
    public boolean isWildcard();
    
    
Clone method. An implementation is expected to override the default Object.clone method and return a "deep clone".

Since:
v1.2
    public Object clone();
New to GrepCode? Check out our FAQ X