org.apache.tomcat.util.http
Class Cookies

java.lang.Object
  org.apache.tomcat.util.http.Cookies

public final class Cookies
extends java.lang.Object

A collection of cookies - reusable and tuned for server side performance. Based on RFC2965 ( and 2109 ) This class is not synchronized.

Author:

Costin Manolache, kevin seguin

INITIAL_SIZE

public static final int INITIAL_SIZE

See Also:

Constant Field Values

ALLOW_EQUALS_IN_VALUE

public static final boolean ALLOW_EQUALS_IN_VALUE

If true, cookie values are allowed to contain an equals character without being quoted.

PRESERVE_COOKIE_HEADER

public static final boolean PRESERVE_COOKIE_HEADER

If set to true, the cookie header will be preserved. In most cases except debugging, this is not useful.

SEPARATORS

public static final char[] SEPARATORS

separators

protected static final boolean[] separators

Cookies

public Cookies(MimeHeaders headers)

Construct a new cookie collection, that will extract the information from headers.

Parameters:

headers - Cookies are lazy-evaluated and will extract the information from the provided headers.

Cookies

public Cookies()

Construct a new uninitialized cookie collection. Use setHeaders(org.apache.tomcat.util.http.MimeHeaders) to initialize.

setLimit

public void setLimit(int limit)

setHeaders

public void setHeaders(MimeHeaders headers)

Set the headers from which cookies will be pulled. This has the side effect of recycling the object.

Parameters:

headers - Cookies are lazy-evaluated and will extract the information from the provided headers.

recycle

public void recycle()

Recycle.

toString

public java.lang.String toString()

EXPENSIVE!!! only for debugging.

Overrides:

toString in class java.lang.Object

getCookie

public ServerCookie getCookie(int idx)

getCookieCount

public int getCookieCount()

addCookie

public ServerCookie addCookie()

Register a new, unitialized cookie. Cookies are recycled, and most of the time an existing ServerCookie object is returned. The caller can set the name/value and attributes for the cookie

processCookies

public void processCookies(MimeHeaders headers)

Add all Cookie found in the headers of a request.

equals

public static boolean equals(java.lang.String s,
                             byte[] b,
                             int start,
                             int end)

log

public void log(java.lang.String s)

isSeparator

public static final boolean isSeparator(byte c)

Returns true if the byte is a separator character as defined in RFC2619. Since this is called often, this function should be organized with the most probable outcomes first. JVK

isWhiteSpace

public static final boolean isWhiteSpace(byte c)

Returns true if the byte is a whitespace character as defined in RFC2619 JVK

processCookieHeader

public final void processCookieHeader(byte[] bytes,
                                      int off,
                                      int len)

Parses a cookie header after the initial "Cookie:" [WS][$]token[WS]=[WS](token|QV)[;|,] RFC 2965 JVK

getTokenEndPosition

public static final int getTokenEndPosition(byte[] bytes,
                                            int off,
                                            int end)

Deprecated. - Use private method getTokenEndPosition(byte[], int, int, boolean) instead

getQuotedValueEndPosition

public static final int getQuotedValueEndPosition(byte[] bytes,
                                                  int off,
                                                  int end)

Given a starting position after an initial quote chracter, this gets the position of the end quote. This escapes anything after a '\' char JVK RFC 2616