freenet.clients.http

Class ReceivedCookie

java.lang.Object

freenet.clients.http.Cookie

freenet.clients.http.ReceivedCookie

public final class ReceivedCookie
extends Cookie

A cookie which the server has received from the client. This class is not thread-safe!

Field Summary

Fields inherited from class freenet.clients.http.Cookie

discard, domain, expirationDate, httpSeparatorCharacters, name, path, value, version

Method Summary

Modifier and Type	Method and Description
protected java.lang.String	encodeToHeaderValue() Encodes the content of this cookie to the HTTP header value representation as of RFC2965.
java.net.URI	getDomain()
java.lang.String	getName()
java.net.URI	getPath()
java.lang.String	getValue()
protected static java.util.ArrayList<ReceivedCookie>	parseHeader(java.lang.String httpHeader) Parses the value of a "Cookie:" HTTP header and returns a list of received cookies which it contained.

Methods inherited from class freenet.clients.http.Cookie

equals, hashCode, validateDomain, validateDomain, validateExpirationDate, validateName, validatePath, validatePath, validateValue

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Method Detail

parseHeader

protected static java.util.ArrayList<ReceivedCookie> parseHeader(java.lang.String httpHeader)
                                                          throws java.text.ParseException

Parses the value of a "Cookie:" HTTP header and returns a list of received cookies which it contained. - A single "Cookie:" header is allowed to contain multiple cookies. Further, a HTTP request can contain multiple "Cookie" keys!.

Parameters:

httpHeader - The value of a "Cookie:" header (i.e. the prefix "Cookie:" must not be contained in this parameter!)

Returns:

A list of ReceivedCookie objects. The validity of their name/value pairs is not deeply checked, their getName() / getValue() might throw!

Throws:

java.text.ParseException - If the general formatting of the cookie is wrong.

getName

public java.lang.String getName()

Overrides:

getName in class Cookie

Throws:

java.lang.IllegalArgumentException - If the validation of the name fails.

getDomain

public java.net.URI getDomain()

Overrides:

getDomain in class Cookie

Throws:

java.lang.IllegalArgumentException - If the validation of the domain fails.

getPath

public java.net.URI getPath()

Overrides:

getPath in class Cookie

Throws:

java.lang.IllegalArgumentException - If the validation of the path fails.

getValue

public java.lang.String getValue()

Overrides:

getValue in class Cookie

Throws:

java.lang.IllegalArgumentException - If the validation of the name fails.

encodeToHeaderValue

protected java.lang.String encodeToHeaderValue()

Description copied from class: Cookie

Encodes the content of this cookie to the HTTP header value representation as of RFC2965. Does not quote any of the values as Firefox 4 does not support quotation and the latest IETF draft for cookies does not contain quotation: http://tools.ietf.org/html/draft-ietf-httpstate-cookie-23 The key "set-cookie2:" is not prefixed to the returned String!

Overrides:

encodeToHeaderValue in class Cookie