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

javax.sip.header.AlertInfoHeader Maven / Gradle / Ivy

There is a newer version: 1.3.0-91
Show newest version
/**
 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 * 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     : AlertInfoHeader.java
 * Author        : Phelim O'Doherty
 *
 *  HISTORY
 *  Version   Date      Author              Comments
 *  1.1     08/10/2002  Phelim O'Doherty   
 *~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 */
package javax.sip.header;

import javax.sip.address.URI;

/**
 * When present in an INVITE request, the Alert-Info header field
 * specifies an alternative ring tone to the UAS.  When present in a 180
 * (Ringing) response, the Alert-Info header field specifies an
 * alternative ringback tone to the UAC.  A typical usage is for a proxy
 * to insert this header field to provide a distinctive ring feature.
 * 

* The Alert-Info header field can introduce security risks, which are * identical to the Call-Info header field risk, see section 20.9 of * RFC3261. * In addition, a user SHOULD be able to disable this feature selectively. * This helps prevent disruptions that could result from the use of this * header field by untrusted elements. *

* For Example:
* Alert-Info: * * @author BEA Systems, NIST * @version 1.2 */ public interface AlertInfoHeader extends Parameters, Header { /** * Sets the AlertInfo of the AlertInfoHeader to the alertInfo * parameter value. * * @param alertInfo the new Alert Info URI of this AlertInfoHeader. */ public void setAlertInfo(URI alertInfo); /** * Returns the AlertInfo value of this AlertInfoHeader. * * @return the URI representing the AlertInfo. */ public URI getAlertInfo(); /** * Name of the AlertInfoHeader */ public final static String NAME = "Alert-Info"; }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy