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 : ServerHeader.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: import java.util.*;
25:
26: /**
27: * The Server header field contains information about the software used by
28: * the UAS to handle the request. Revealing the specific software version of
29: * the server might allow the server to become more vulnerable to attacks
30: * against software that is known to contain security holes. Implementers
31: * SHOULD make the Server header field a configurable option. If the Response
32: * is being forwarded through a proxy, the proxy application must not modify
33: * the ServerHeaders. Instead, it should include a ViaHeader.
34: * <p>
35: * For Example:<br>
36: * <code>Server: HomeServer v2</code>
37: *
38: * @see ViaHeader
39: * @see UserAgentHeader
40: *
41: * @author BEA Systems, NIST
42: * @version 1.2
43: */
44: public interface ServerHeader extends Header {
45:
46: /**
47: * Returns a ListIterator over the List of product values.
48: *
49: * @return a ListIterator over the List of strings identifying the
50: * software of this ServerHeader
51: */
52: public ListIterator getProduct();
53:
54: /**
55: * Sets the List of product values of the ServerHeader.
56: *
57: * @param product - a List of Strings specifying the product values
58: * @throws ParseException which signals that an error has been reached
59: * unexpectedly while parsing the List of product value strings.
60: */
61: public void setProduct(List product) throws ParseException;
62:
63: /**
64: * Name of ServerHeader
65: */
66: public final static String NAME = "Server";
67:
68: }
|