1600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/*
2600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* Conditions Of Use
3600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang*
4600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* This software was developed by employees of the National Institute of
5600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* Standards and Technology (NIST), an agency of the Federal Government.
6600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* Pursuant to title 15 Untied States Code Section 105, works of NIST
7600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* employees are not subject to copyright protection in the United States
8600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* and are considered to be in the public domain.  As a result, a formal
9600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* license is not needed to use the software.
10600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang*
11600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* This software is provided by NIST as a service and is expressly
12600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* provided "AS IS."  NIST MAKES NO WARRANTY OF ANY KIND, EXPRESS, IMPLIED
13600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* OR STATUTORY, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTY OF
14600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT
15600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* AND DATA ACCURACY.  NIST does not warrant or make any representations
16600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* regarding the use of the software or the results thereof, including but
17600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* not limited to the correctness, accuracy, reliability or usefulness of
18600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* the software.
19600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang*
20600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* Permission to use this software is contingent upon your acceptance
21600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* of the terms of this agreement
22600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang*
23600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* .
24600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang*
25600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang*/
26600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/*******************************************************************************
27600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* Product of NIST/ITL Advanced Networking Technologies Division (ANTD).        *
28600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang*******************************************************************************/
29600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangpackage gov.nist.javax.sip.header;
30600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang
31600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangimport javax.sip.*;
32600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangimport javax.sip.header.*;
33600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang
34600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/**
35600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * MinExpires SIP Header.
36600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
37600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @version 1.2 $Revision: 1.6 $ $Date: 2009/10/18 13:46:35 $
38600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @since 1.1
39600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
40600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @author M. Ranganathan   <br/>
41600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @author Olivier Deruelle <br/>
42600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
43600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
44600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
45600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */
46600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangpublic class MinExpires extends SIPHeader implements MinExpiresHeader {
47600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang
48600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    /**
49600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     * Comment for <code>serialVersionUID</code>
50600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     */
51600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    private static final long serialVersionUID = 7001828209606095801L;
52600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    /** expires field
53600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     */
54600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    protected int expires;
55600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang
56600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    /** default constructor
57600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     */
58600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    public MinExpires() {
59600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang        super(NAME);
60600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    }
61600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang
62600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    /**
63600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     * Return canonical form.
64600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     * @return String
65600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     */
66600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    public String encodeBody() {
67600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang        return Integer.toString(expires);
68600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    }
69600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang
70600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    /**
71600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     * Gets the expires value of the ExpiresHeader. This expires value is
72600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     * relative time.
73600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     *
74600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     * @return the expires value of the ExpiresHeader.
75600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     *
76600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     */
77600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    public int getExpires() {
78600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang        return expires;
79600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    }
80600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang
81600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    /**
82600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     * Sets the relative expires value of the ExpiresHeader.
83600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     * The expires value MUST be greater than zero and MUST be
84600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     * less than 2**31.
85600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     *
86600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     * @param expires - the new expires value of this ExpiresHeader
87600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     *
88600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     * @throws InvalidArgumentException if supplied value is less than zero.
89600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     *
90600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     *
91600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     *
92600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang     */
93600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    public void setExpires(int expires) throws InvalidArgumentException {
94600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang        if (expires < 0)
95600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang            throw new InvalidArgumentException("bad argument " + expires);
96600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang        this.expires = expires;
97600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang    }
98600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang
99600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang}
100600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/*
101600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * $Log: MinExpires.java,v $
102600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.6  2009/10/18 13:46:35  deruelle_jean
103600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * FindBugs Fixes (Category Performance Warnings)
104600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
105600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Issue number:
106600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Obtained from:
107600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Submitted by: Jean Deruelle
108600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Reviewed by:
109600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
110600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.5  2009/07/17 18:57:32  emcho
111600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Converts indentation tabs to spaces so that we have a uniform indentation policy in the whole project.
112600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
113600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.4  2006/07/13 09:01:20  mranga
114600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Issue number:
115600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Obtained from:
116600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Submitted by:  jeroen van bemmel
117600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Reviewed by:   mranga
118600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Moved some changes from jain-sip-1.2 to java.net
119600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
120600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: ----------------------------------------------------------------------
121600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Issue number:
122600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   If this change addresses one or more issues,
123600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   then enter the issue number(s) here.
124600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Obtained from:
125600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   If this change has been taken from another system,
126600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   then name the system in this line, otherwise delete it.
127600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Submitted by:
128600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   If this code has been contributed to the project by someone else; i.e.,
129600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   they sent us a patch or a set of diffs, then include their name/email
130600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   address here. If this is your work then delete this line.
131600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Reviewed by:
132600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   If we are doing pre-commit code reviews and someone else has
133600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   reviewed your changes, include their name(s) here.
134600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   If you have not had it reviewed then delete this line.
135600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
136600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.3  2006/06/19 06:47:26  mranga
137600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * javadoc fixups
138600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
139600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.2  2006/06/16 15:26:28  mranga
140600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Added NIST disclaimer to all public domain files. Clean up some javadoc. Fixed a leak
141600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
142600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.1.1.1  2005/10/04 17:12:34  mranga
143600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
144600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Import
145600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
146600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
147600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.2  2004/01/22 13:26:29  sverker
148600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Issue number:
149600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Obtained from:
150600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Submitted by:  sverker
151600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Reviewed by:   mranga
152600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
153600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Major reformat of code to conform with style guide. Resolved compiler and javadoc warnings. Added CVS tags.
154600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
155600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: ----------------------------------------------------------------------
156600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Issue number:
157600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   If this change addresses one or more issues,
158600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   then enter the issue number(s) here.
159600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Obtained from:
160600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   If this change has been taken from another system,
161600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   then name the system in this line, otherwise delete it.
162600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Submitted by:
163600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   If this code has been contributed to the project by someone else; i.e.,
164600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   they sent us a patch or a set of diffs, then include their name/email
165600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   address here. If this is your work then delete this line.
166600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Reviewed by:
167600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   If we are doing pre-commit code reviews and someone else has
168600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   reviewed your changes, include their name(s) here.
169600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS:   If you have not had it reviewed then delete this line.
170600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *
171600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */
172