sip.header.MinExpiresHeader Maven / Gradle / Ivy
/**
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* 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 : MinExpiresHeader.java
* Author : Phelim O'Doherty
*
* HISTORY
* Version Date Author Comments
* 1.1 08/10/2002 Phelim O'Doherty Initial version
*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*/
package javax.sip.header;
/**
* The Min-Expires header field conveys the minimum refresh interval supported
* for soft-state elements managed by that server. This includes Contact
* header fields that are stored by a registrar. The header field contains a
* decimal integer number of seconds from 0 to (2**32)-1.
*
* Allowing the registrar to set the registration interval protects it against
* excessively frequent registration refreshes while limiting the state that it
* needs to maintain and decreasing the likelihood of registrations going
* stale. The expiration interval of a registration is frequently used in the
* creation of services. An example is a follow-me service, where the user may
* only be available at a terminal for a brief period. Therefore, registrars
* should accept brief registrations; a request should only be rejected if the
* interval is so short that the refreshes would degrade registrar performance.
*
* If a User Agent receives a 423 (Interval Too Brief) response to a REGISTER request,
* it MAY retry the registration after making the expiration interval of all
* contact addresses in the REGISTER request equal to or greater than the
* expiration interval within the Min-Expires header field of the 423
* (Interval Too Brief) response. The Min-Expires header field that states the
* minimum expiration interval the registrar is willing to honor.
*
* For Example:
* Min-Expires: 60
*
* @author BEA Systems, NIST
* @version 1.2
*/
public interface MinExpiresHeader extends ExpiresHeader {
/**
* Name of ExpiresHeader
*/
public final static String NAME = "Min-Expires";
}