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 : ExtensionHeader.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 java.text.ParseException;
24:
25: /**
26: * This interface represents an Extension SIP header that was not defined at the
27: * baseline of this specification. Extension Headers can be added as
28: * required by extending this interface assuming other endpoints understand the Header.
29: * Any Header that extends this class must define a "NAME" String constant identifying the name
30: * of the extension Header. A server must ignore Headers that it does not
31: * understand. A proxy must not remove or modify Headers that it does not
32: * understand. Implementation note : The implementation of any new headers
33: * added since version 1.1 of this specification
34: * <b>SHOULD</b> implement ExtensionHeader for backwards compatibility (even if these
35: * headers are defined in the current version of this specification).
36: * Headers that are not part of the current version of this specification
37: * <b>MUST</b> implement ExtensionHeader.
38: *
39: * @author BEA Systems, NIST
40: * @version 1.2
41: */
42:
43: public interface ExtensionHeader extends Header {
44:
45: /**
46: * Sets the value parameter of the ExtensionHeader.
47: *
48: * @param value - the new value of the ExtensionHeader
49: * @throws ParseException which signals that an error has been reached
50: * unexpectedly while parsing the value parameter.
51: */
52: public void setValue(String value) throws ParseException;
53:
54: /**
55: * Gets the value of the ExtensionHeader.
56: *
57: * @return the string of the value parameter.
58: */
59: public String getValue();
60:
61: }
|