Package org.apache.tomcat.util.http
Interface CookieProcessor
-
- All Known Implementing Classes:
CookieProcessorBase
,LegacyCookieProcessor
,Rfc6265CookieProcessor
public interface CookieProcessor
-
-
Method Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description java.lang.String
generateHeader(Cookie cookie)
Deprecated.This method has been replaced withgenerateHeader(Cookie, HttpServletRequest)
and will be removed from Tomcat 10 onwards.java.lang.String
generateHeader(Cookie cookie, HttpServletRequest request)
Generate theSet-Cookie
HTTP header value for the given Cookie.java.nio.charset.Charset
getCharset()
Obtain the character set that will be used when converting between bytes and characters when parsing and/or generating HTTP headers for cookies.void
parseCookieHeader(MimeHeaders headers, ServerCookies serverCookies)
Parse the provided headers into server cookie objects.
-
-
-
Method Detail
-
parseCookieHeader
void parseCookieHeader(MimeHeaders headers, ServerCookies serverCookies)
Parse the provided headers into server cookie objects.- Parameters:
headers
- The HTTP headers to parseserverCookies
- The server cookies object to populate with the results of the parsing
-
generateHeader
@Deprecated java.lang.String generateHeader(Cookie cookie)
Deprecated.This method has been replaced withgenerateHeader(Cookie, HttpServletRequest)
and will be removed from Tomcat 10 onwards.Generate theSet-Cookie
HTTP header value for the given Cookie.- Parameters:
cookie
- The cookie for which the header will be generated- Returns:
- The header value in a form that can be added directly to the response
-
generateHeader
java.lang.String generateHeader(Cookie cookie, HttpServletRequest request)
Generate theSet-Cookie
HTTP header value for the given Cookie. This method receives as parameter the servlet request so that it can make decisions based on request properties. One such use-case is decide if the SameSite attribute should be added to the cookie based on the User-Agent or other request header because there are browser versions incompatible with the SameSite attribute. This is described by the Chromium project.- Parameters:
request
- The servlet requestcookie
- The cookie for which the header will be generated- Returns:
- The header value in a form that can be added directly to the response
-
getCharset
java.nio.charset.Charset getCharset()
Obtain the character set that will be used when converting between bytes and characters when parsing and/or generating HTTP headers for cookies.- Returns:
- The character set used for byte<->character conversions
-
-