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

gov.nist.javax.sip.header.ParametersHeader 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 Advanced Networking Technologies Division  */
/**************************************************************************/

package android.gov.nist.javax.sip.header;
import android.gov.nist.core.DuplicateNameValueList;
import android.gov.nist.core.NameValue;
import android.gov.nist.core.NameValueList;
import android.gov.nist.javax.sip.address.GenericURI;

import java.io.Serializable;
import java.text.ParseException;
import java.util.Iterator;

import android.javax.sip.header.Parameters;

/**
 * Parameters header. Suitable for extension by headers that have parameters.
 *
 * @author M. Ranganathan   
* * * @version 1.2 $Revision: 1.17 $ $Date: 2010-07-28 08:39:26 $ * */ public abstract class ParametersHeader extends SIPHeader implements android.javax.sip.header.Parameters, ParametersExt, Serializable { protected NameValueList parameters; protected DuplicateNameValueList duplicates; protected ParametersHeader() { this.parameters = new NameValueList(); this.duplicates = new DuplicateNameValueList(); } protected ParametersHeader(String hdrName) { super(hdrName); this.parameters = new NameValueList(); this.duplicates = new DuplicateNameValueList(); } protected ParametersHeader(String hdrName, boolean sync) { super(hdrName); this.parameters = new NameValueList(sync); this.duplicates = new DuplicateNameValueList(); } /* * (non-Javadoc) * @see android.javax.sip.header.Parameters#getParameter(java.lang.String) */ public String getParameter(String name) { return this.parameters.getParameter(name); } /* * (non-Javadoc) * @see android.gov.nist.javax.sip.header.ParametersExt#getParameter(java.lang.String, boolean) */ public String getParameter(String name, boolean stripQuotes) { return this.parameters.getParameter(name, stripQuotes); } /** * Return the parameter as an object (dont convert to string). * * @param name is the name of the parameter to get. * @return the object associated with the name. */ public Object getParameterValue(String name) { return this.parameters.getValue(name); } /** * Returns an Iterator over the names (Strings) of all parameters present * in this ParametersHeader. * * @return an Iterator over all the parameter names */ public Iterator getParameterNames() { return parameters.getNames(); } /** Return true if you have a parameter and false otherwise. * *@return true if the parameters list is non-empty. */ public boolean hasParameters() { return parameters != null && !parameters.isEmpty(); } /** * Removes the specified parameter from Parameters of this ParametersHeader. * This method returns silently if the parameter is not part of the * ParametersHeader. * * @param name - a String specifying the parameter name */ public void removeParameter(String name) { this.parameters.delete(name); } /** * Sets the value of the specified parameter. If the parameter already had * * a value it will be overwritten. A zero-length String indicates flag * * parameter. * * * * @param name - a String specifying the parameter name * * @param value - a String specifying the parameter value * * @throws ParseException which signals that an error has been reached * * unexpectedly while parsing the parameter name or value. * */ public void setParameter(String name, String value) throws ParseException { NameValue nv = parameters.getNameValue(name); if (nv != null) { nv.setValueAsObject(value); } else { nv = new NameValue(name, value); this.parameters.set(nv); } } /** * Sets the value of the specified parameter. If the parameter already had * * a value it will be overwritten. A zero-length String indicates flag * * parameter. * * * * @param name - a String specifying the parameter name * * @param value - a String specifying the parameter value * * @throws ParseException which signals that an error has been reached * * unexpectedly while parsing the parameter name or value. * */ public void setQuotedParameter(String name, String value) throws ParseException { NameValue nv = parameters.getNameValue(name); if (nv != null) { nv.setValueAsObject(value); nv.setQuotedValue(); } else { nv = new NameValue(name, value); nv.setQuotedValue(); this.parameters.set(nv); } } /** * Sets the value of the specified parameter. If the parameter already had * * a value it will be overwritten. * * * @param name - a String specifying the parameter name * * @param value - an int specifying the parameter value * * @throws ParseException which signals that an error has been reached * * unexpectedly while parsing the parameter name or value. * */ protected void setParameter(String name, int value) { Integer val = Integer.valueOf(value); this.parameters.set(name,val); } /** * Sets the value of the specified parameter. If the parameter already had * * a value it will be overwritten. * * * @param name - a String specifying the parameter name * * @param value - a boolean specifying the parameter value * * @throws ParseException which signals that an error has been reached * * unexpectedly while parsing the parameter name or value. * */ protected void setParameter(String name, boolean value) { Boolean val = Boolean.valueOf(value); this.parameters.set(name,val); } /** * Sets the value of the specified parameter. If the parameter already had * * a value it will be overwritten. * * @param name - a String specifying the parameter name * * @param value - a boolean specifying the parameter value * * @throws ParseException which signals that an error has been reached * * unexpectedly while parsing the parameter name or value. * */ protected void setParameter(String name, float value) { Float val = Float.valueOf(value); NameValue nv = parameters.getNameValue(name); if (nv != null) { nv.setValueAsObject(val); } else { nv = new NameValue(name, val); this.parameters.set(nv); } } /** * Sets the value of the specified parameter. If the parameter already had * * a value it will be overwritten. A zero-length String indicates flag * * parameter. * * * * @param name - a String specifying the parameter name * * @param value - a String specifying the parameter value * * @throws ParseException which signals that an error has been reached * * unexpectedly while parsing the parameter name or value. * */ protected void setParameter(String name, Object value) { this.parameters.set(name,value); } /** * Return true if has a parameter. * * @param parameterName is the name of the parameter. * * @return true if the parameter exists and false if not. */ public boolean hasParameter(String parameterName) { return this.parameters.hasNameValue(parameterName); } /** *Remove all parameters. */ public void removeParameters() { this.parameters = new NameValueList(); } /** * get the parameter list. * @return parameter list */ public NameValueList getParameters() { return parameters; } /** Set the parameter given a name and value. * * @param nameValue - the name value of the parameter to set. */ public void setParameter(NameValue nameValue) { this.parameters.set(nameValue); } /** * Set the parameter list. * * @param parameters The name value list to set as the parameter list. */ public void setParameters(NameValueList parameters) { this.parameters = parameters; } /** * Get the parameter as an integer value. * * @param parameterName -- the parameter name to fetch. * * @return -1 if the parameter is not defined in the header. */ protected int getParameterAsInt(String parameterName) { if (this.getParameterValue(parameterName) != null) { try { if (this.getParameterValue(parameterName) instanceof String) { return Integer.parseInt(this.getParameter(parameterName)); } else { return ((Integer) getParameterValue(parameterName)) .intValue(); } } catch (NumberFormatException ex) { return -1; } } else return -1; } /** Get the parameter as an integer when it is entered as a hex. * *@param parameterName -- The parameter name to fetch. * *@return -1 if the parameter is not defined in the header. */ protected int getParameterAsHexInt(String parameterName) { if (this.getParameterValue(parameterName) != null) { try { if (this.getParameterValue(parameterName) instanceof String) { return Integer.parseInt( this.getParameter(parameterName), 16); } else { return ((Integer) getParameterValue(parameterName)) .intValue(); } } catch (NumberFormatException ex) { return -1; } } else return -1; } /** Get the parameter as a float value. * *@param parameterName -- the parameter name to fetch * *@return -1 if the parameter is not defined or the parameter as a float. */ protected float getParameterAsFloat(String parameterName) { if (this.getParameterValue(parameterName) != null) { try { if (this.getParameterValue(parameterName) instanceof String) { return Float.parseFloat(this.getParameter(parameterName)); } else { return ((Float) getParameterValue(parameterName)) .floatValue(); } } catch (NumberFormatException ex) { return -1; } } else return -1; } /** * Get the parameter as a long value. * * @param parameterName -- the parameter name to fetch. * * @return -1 if the parameter is not defined or the parameter as a long. */ protected long getParameterAsLong(String parameterName) { if (this.getParameterValue(parameterName) != null) { try { if (this.getParameterValue(parameterName) instanceof String) { return Long.parseLong(this.getParameter(parameterName)); } else { return ((Long) getParameterValue(parameterName)) .longValue(); } } catch (NumberFormatException ex) { return -1; } } else return -1; } /** * Get the parameter value as a URI. * * @param parameterName -- the parameter name * * @return value of the parameter as a URI or null if the parameter * not present. */ protected GenericURI getParameterAsURI(String parameterName) { Object val = getParameterValue(parameterName); if (val instanceof GenericURI) return (GenericURI) val; else { try { return new GenericURI((String) val); } catch (ParseException ex) { //catch ( URISyntaxException ex) { return null; } } } /** * Get the parameter value as a boolean. * * @param parameterName -- the parameter name * @return boolean value of the parameter. */ protected boolean getParameterAsBoolean(String parameterName) { Object val = getParameterValue(parameterName); if (val == null) { return false; } else if (val instanceof Boolean) { return ((Boolean) val).booleanValue(); } else if (val instanceof String) { return Boolean.valueOf((String) val).booleanValue(); } else return false; } /** * This is for the benifit of the TCK. * * @return the name value pair for the given parameter name. */ public NameValue getNameValue(String parameterName) { return parameters.getNameValue(parameterName); } public Object clone() { ParametersHeader retval = (ParametersHeader) super.clone(); if (this.parameters != null) retval.parameters = (NameValueList) this.parameters.clone(); return retval; } //------------------------- /** * Introduced specifically for the P-Charging-Function-Addresses Header and * all other headers that may have multiple header parameters of the same name, but * with multiple possible values. * * Example: P-Charging-Function-Addresses: ccf=[5555::b99:c88:d77:e66]; ccf=[5555::a55:b44:c33:d22]; * ecf=[5555::1ff:2ee:3dd:4cc]; ecf=[5555::6aa:7bb:8cc:9dd] * @param name of the parameter * @param value of the parameter */ public void setMultiParameter(String name, String value) { NameValue nv = new NameValue(); nv.setName(name); nv.setValue(value); duplicates.set(nv); } /** Set the parameter given a name and value. * * @param nameValue - the name value of the parameter to set. */ public void setMultiParameter(NameValue nameValue) { this.duplicates.set(nameValue); } /** * Returns the parameter name * @param name * @return */ public String getMultiParameter(String name) { return this.duplicates.getParameter(name); } public DuplicateNameValueList getMultiParameters() { return duplicates; } /** * Return the parameter as an object (dont convert to string). * * @param name is the name of the parameter to get. * @return the object associated with the name. */ public Object getMultiParameterValue(String name) { return this.duplicates.getValue(name); } /** * Returns an Iterator over the names (Strings) of all parameters present * in this ParametersHeader. * * @return an Iterator over all the parameter names */ public Iterator getMultiParameterNames() { return duplicates.getNames(); } /** Return true if you have a parameter and false otherwise. * *@return true if the parameters list is non-empty. */ public boolean hasMultiParameters() { return duplicates != null && !duplicates.isEmpty(); } /** * Removes the specified parameter from Parameters of this ParametersHeader. * This method returns silently if the parameter is not part of the * ParametersHeader. * * @param name - a String specifying the parameter name */ public void removeMultiParameter(String name) { this.duplicates.delete(name); } /** * Return true if has a parameter. * * @param parameterName is the name of the parameter. * * @return true if the parameter exists and false if not. */ public boolean hasMultiParameter(String parameterName) { return this.duplicates.hasNameValue(parameterName); } /** *Remove all parameters. */ public void removeMultiParameters() { this.duplicates = new DuplicateNameValueList(); } //------------------------------- @SuppressWarnings("unchecked") protected final boolean equalParameters( Parameters other ) { if (this==other) return true; for ( Iterator i = this.getParameterNames(); i.hasNext();) { String pname = (String) i.next(); String p1 = this.getParameter( pname ); String p2 = other.getParameter( pname ); // getting them based on this.getParameterNames. Note that p1 may be null // if this is a name-only parameter like rport or lr. if (p1 == null ^ p2 == null) return false; else if (p1 != null && !p1.equalsIgnoreCase(p2) ) return false; } // Also compare other's parameters; some duplicate testing here... for ( Iterator i = other.getParameterNames(); i.hasNext();) { String pname = (String) i.next(); String p1 = other.getParameter( pname ); String p2 = this.getParameter( pname ); // assert( p1 != null ); // if ( p1 == null ) throw new RuntimeException("Assertion check failed!"); // if (p2==null) return false; // getting them based on this.getParameterNames. Note that p1 may be null // if this is a name-only parameter like rport or lr. if (p1 == null ^ p2 == null) return false; else if (p1 != null && !p1.equalsIgnoreCase(p2) ) return false; } return true; } // ----------- Abstract methods -------------- protected abstract StringBuilder encodeBody(StringBuilder buffer); }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy