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 : MimeVersionHeader.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: import javax.sip.InvalidArgumentException;
24:
25: /**
26: * SIP messages MAY include a single MIME-Version general-header field to
27: * indicate what version of the MIME protocol was used to construct the
28: * message. Use of the MIME-Version header field indicates that the message is
29: * in full compliance with the MIME protocol as defined in
30: * <a href = "http://www.ietf.org/rfc/rfc2405.txt">RFC2045</a>. Proxies/gateways
31: * are responsible for ensuring full compliance (where possible) when exporting
32: * SIP messages to strict MIME environments.
33: * <p>
34: * For Example:<br>
35: * <code>MIME-Version: 1.0</code>
36: *
37: * @author BEA Systems, NIST
38: * @version 1.2
39: */
40: public interface MimeVersionHeader extends Header {
41:
42: /**
43: * Gets the Minor version value of this MimeVersionHeader.
44: *
45: * @return the Minor version of this MimeVersionHeader
46: */
47: public int getMinorVersion();
48:
49: /**
50: * Sets the Minor-Version argument of this MimeVersionHeader to the supplied
51: * minorVersion value.
52: *
53: * @param minorVersion - the new minor MIME version
54: * @throws InvalidArgumentException if the supplied value is less than zero.
55: */
56: public void setMinorVersion(int minorVersion)
57: throws InvalidArgumentException;
58:
59: /**
60: * Gets the Major version value of this MimeVersionHeader.
61: *
62: * @return the Major version of this MimeVersionHeader
63: */
64: public int getMajorVersion();
65:
66: /**
67: * Sets the Major-Version argument of this MimeVersionHeader to the supplied
68: * majorVersion value.
69: *
70: * @param majorVersion - the new major MIME version
71: * @throws InvalidArgumentException if the supplied version is less than zero.
72: */
73: public void setMajorVersion(int majorVersion)
74: throws InvalidArgumentException;
75:
76: /**
77: * Name of MimeVersionHeader
78: */
79: public final static String NAME = "MIME-Version";
80:
81: }
|