Class Cookie


  • public class Cookie
    extends java.lang.Object

    Cookie header parser based on RFC6265

    The parsing of cookies using RFC6265 is more relaxed that the specification in the following ways:

    • Values 0x80 to 0xFF are permitted in cookie-octet to support the use of UTF-8 in cookie values as used by HTML 5.
    • For cookies without a value, the '=' is not required after the name as some browsers do not sent it.

    Implementation note:
    This class has been carefully tuned. Before committing any changes, ensure that the TesterCookiePerformance unit test continues to give results within 1% for the old and new parsers.

    • Method Detail

      • parseCookie

        @Deprecated
        public static void parseCookie​(byte[] bytes,
                                       int offset,
                                       int len,
                                       ServerCookies serverCookies)
        Deprecated.
        Unused. This method will be removed in Tomcat 11 onwards.
        Parse byte array as cookie header.
        Parameters:
        bytes - Source
        offset - Start point in array
        len - Number of bytes to read
        serverCookies - Structure to store results
      • parseCookie

        public static void parseCookie​(byte[] bytes,
                                       int offset,
                                       int len,
                                       ServerCookies serverCookies,
                                       CookiesWithoutEquals cookiesWithoutEquals)
        Parse byte array as cookie header.
        Parameters:
        bytes - Source
        offset - Start point in array
        len - Number of bytes to read
        serverCookies - Structure to store results
        cookiesWithoutEquals - How to handle a cookie name-value-pair that does not contain an equals character