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 : UserAgentHeader.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 User-Agent header field contains information about the UAC originating
28: * the request. This is for statistical purposes, the tracing of protocol
29: * violations, and automated recognition of user agents for the sake of
30: * tailoring Responses to avoid particular user agent limitations. However
31: * revealing the specific software version of the user agent might allow the
32: * user agent to become more vulnerable to attacks against software that is
33: * known to contain security holes. Implementers SHOULD make the User-Agent
34: * header field a configurable option.
35: * <p>
36: * For Example:<br>
37: * <code>User-Agent: Softphone Beta1.5</code>
38: *
39: * @see ServerHeader
40: * @see ViaHeader
41: *
42: * @author BEA Systems, NIST
43: * @version 1.2
44: */
45: public interface UserAgentHeader extends Header {
46:
47: /**
48: * Returns the List of product values.
49: *
50: * @return the List of strings identifying the 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 UserAgentHeader
65: */
66: public final static String NAME = "User-Agent";
67:
68: }
|