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 : SubjectHeader.java
15: * Author : Phelim O'Doherty
16: *
17: * HISTORY
18: * Version Date Author Comments
19: * 1.1 08/10/2002 Phelim O'Doherty
20: *~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
21: */package javax.sip.header;
22:
23: import java.text.ParseException;
24:
25: /**
26:
27: * The Subject header field provides a summary or indicates the nature of the
28:
29: * call, allowing call filtering without having to parse the session
30:
31: * description. The session description does not have to use the same subject
32:
33: * indication as the invitation.
34:
35: * <p>
36:
37: * For Example:<br>
38:
39: * <code>Subject: Where is the Moscone?</code>
40:
41: *
42: * @author BEA Systems, NIST
43: * @version 1.2
44:
45: */
46:
47: public interface SubjectHeader extends Header {
48:
49: /**
50:
51: * Sets the subject value of the SubjectHeader to the supplied string
52:
53: * subject value.
54:
55: *
56:
57: * @param subject - the new subject value of this header.
58:
59: * @throws ParseException which signals that an error has been reached
60:
61: * unexpectedly while parsing the subject value.
62:
63: */
64:
65: public void setSubject(String subject) throws ParseException;
66:
67: /**
68:
69: * Gets the subject value of SubjectHeader.
70:
71: *
72:
73: * @return subject of SubjectHeader.
74:
75: */
76:
77: public String getSubject();
78:
79: /**
80:
81: * Name of SubjectHeader
82:
83: */
84:
85: public final static String NAME = "Subject";
86:
87: }
|