All Downloads are FREE. Search and download functionalities are using the official Maven repository.

gov.nist.javax.sip.header.CallIdentifier Maven / Gradle / Ivy

There is a newer version: 1.3.0-91
Show newest version
/*
* Conditions Of Use
*
* This software was developed by employees of the National Institute of
* Standards and Technology (NIST), an agency of the Federal Government.
* Pursuant to title 15 Untied States Code Section 105, works of NIST
* employees are not subject to copyright protection in the United States
* and are considered to be in the public domain.  As a result, a formal
* license is not needed to use the software.
*
* This software is provided by NIST as a service and is expressly
* provided "AS IS."  NIST MAKES NO WARRANTY OF ANY KIND, EXPRESS, IMPLIED
* OR STATUTORY, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTY OF
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT
* AND DATA ACCURACY.  NIST does not warrant or make any representations
* regarding the use of the software or the results thereof, including but
* not limited to the correctness, accuracy, reliability or usefulness of
* the software.
*
* Permission to use this software is contingent upon your acceptance
* of the terms of this agreement
*
* .
*
*/
/*******************************************************************************
* Product of NIST/ITL Advanced Networking Technologies Division (ANTD).        *
*******************************************************************************/
package gov.nist.javax.sip.header;

/**
 * The call identifer that goes into a callID header and a in-reply-to header.
 *
 * @author M. Ranganathan   
* @version 1.2 $Revision: 1.8 $ $Date: 2010-05-06 14:07:46 $ * @see CallID * @see InReplyTo * @since 1.1 */ public final class CallIdentifier extends SIPObject { /** * Comment for serialVersionUID */ private static final long serialVersionUID = 7314773655675451377L; /** * localId field */ protected String localId; /** * host field */ protected String host; /** * Default constructor */ public CallIdentifier() { } /** * Constructor * @param localId id is the local id. * @param host is the host. */ public CallIdentifier(String localId, String host) { this.localId = localId; this.host = host; } /** * constructor * @param cid String to set * @throws IllegalArgumentException if cid is null or is not a token, * or token@token */ public CallIdentifier(String cid) throws IllegalArgumentException { setCallID(cid); } /** * Get the encoded version of this id. * @return String to set */ public String encode() { return encode(new StringBuilder()).toString(); } public StringBuilder encode(StringBuilder buffer) { buffer.append(localId); if (host != null) { buffer.append(AT).append(host); } return buffer; } /** * Compare two call identifiers for equality. * @param other Object to set * @return true if the two call identifiers are equals, false * otherwise */ public boolean equals(Object other) { if (other == null ) return false; if (!other.getClass().equals(this.getClass())) { return false; } CallIdentifier that = (CallIdentifier) other; if (this.localId.compareTo(that.localId) != 0) { return false; } if (this.host == that.host) return true; if ((this.host == null && that.host != null) || (this.host != null && that.host == null)) return false; if (host.compareToIgnoreCase(that.host) != 0) { return false; } return true; } @Override public int hashCode() { if (this.localId == null ) { throw new UnsupportedOperationException("Hash code called before id is set"); } return this.localId.hashCode(); } /** get the LocalId field * @return String */ public String getLocalId() { return localId; } /** get the host field * @return host member String */ public String getHost() { return host; } /** * Set the localId member * @param localId String to set */ public void setLocalId(String localId) { this.localId = localId; } /** set the callId field * @param cid Strimg to set * @throws IllegalArgumentException if cid is null or is not a token or * token@token */ public void setCallID(String cid) throws IllegalArgumentException { if (cid == null) throw new IllegalArgumentException("NULL!"); int index = cid.indexOf('@'); if (index == -1) { localId = cid; host = null; } else { localId = cid.substring(0, index); host = cid.substring(index + 1, cid.length()); if (localId == null || host == null) { throw new IllegalArgumentException("CallID must be token@token or token"); } } } /** * Set the host member * @param host String to set */ public void setHost(String host) { this.host = host; } }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy