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 Modifier and Type Method Description 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
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
-
-