01: /**
02: * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
03: * Unpublished - rights reserved under the Copyright Laws of the United States.
04: * Copyright © 2003 Sun Microsystems, Inc. All rights reserved.
05: * Copyright © 2005 BEA Systems, Inc. All rights reserved.
06: *
07: * Use is subject to license terms.
08: *
09: * This distribution may include materials developed by third parties.
10: *
11: * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
12: *
13: * Module Name : JSIP Specification
14: * File Name : MinExpiresHeader.java
15: * Author : Phelim O'Doherty
16: *
17: * HISTORY
18: * Version Date Author Comments
19: * 1.1 08/10/2002 Phelim O'Doherty Initial version
20: *~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
21: */package javax.sip.header;
22:
23: /**
24:
25: * The Min-Expires header field conveys the minimum refresh interval supported
26:
27: * for soft-state elements managed by that server. This includes Contact
28:
29: * header fields that are stored by a registrar. The header field contains a
30:
31: * decimal integer number of seconds from 0 to (2**32)-1.
32:
33: * <p>
34:
35: * Allowing the registrar to set the registration interval protects it against
36:
37: * excessively frequent registration refreshes while limiting the state that it
38:
39: * needs to maintain and decreasing the likelihood of registrations going
40:
41: * stale. The expiration interval of a registration is frequently used in the
42:
43: * creation of services. An example is a follow-me service, where the user may
44:
45: * only be available at a terminal for a brief period. Therefore, registrars
46:
47: * should accept brief registrations; a request should only be rejected if the
48:
49: * interval is so short that the refreshes would degrade registrar performance.
50:
51: * <p>
52:
53: * If a User Agent receives a 423 (Interval Too Brief) response to a REGISTER request,
54:
55: * it MAY retry the registration after making the expiration interval of all
56:
57: * contact addresses in the REGISTER request equal to or greater than the
58:
59: * expiration interval within the Min-Expires header field of the 423
60:
61: * (Interval Too Brief) response. The Min-Expires header field that states the
62:
63: * minimum expiration interval the registrar is willing to honor.
64:
65: * <p>
66:
67: * For Example:<br>
68:
69: * <code>Min-Expires: 60</code>
70:
71: *
72:
73: * @author BEA Systems, NIST
74: * @version 1.2
75:
76: */
77:
78: public interface MinExpiresHeader extends ExpiresHeader {
79:
80: /**
81:
82: * Name of ExpiresHeader
83:
84: */
85:
86: public final static String NAME = "Min-Expires";
87:
88: }
|