Browse Source

Clarified cookieMaxAge default

Issue: SPR-15155
pull/1296/merge
Juergen Hoeller 8 years ago
parent
commit
874b653314
  1. 12
      spring-web/src/main/java/org/springframework/web/util/CookieGenerator.java
  2. 2
      src/asciidoc/web-mvc.adoc

12
spring-web/src/main/java/org/springframework/web/util/CookieGenerator.java

@ -1,5 +1,5 @@
/* /*
* Copyright 2002-2016 the original author or authors. * Copyright 2002-2017 the original author or authors.
* *
* Licensed under the Apache License, Version 2.0 (the "License"); * Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License. * you may not use this file except in compliance with the License.
@ -55,7 +55,7 @@ public class CookieGenerator {
private String cookiePath = DEFAULT_COOKIE_PATH; private String cookiePath = DEFAULT_COOKIE_PATH;
private Integer cookieMaxAge = null; private Integer cookieMaxAge;
private boolean cookieSecure = false; private boolean cookieSecure = false;
@ -111,7 +111,9 @@ public class CookieGenerator {
/** /**
* Use the given maximum age (in seconds) for cookies created by this generator. * Use the given maximum age (in seconds) for cookies created by this generator.
* Useful special value: -1 ... not persistent, deleted when client shuts down * Useful special value: -1 ... not persistent, deleted when client shuts down.
* <p>Default is no specific maximum age at all, using the Servlet container's
* default.
* @see javax.servlet.http.Cookie#setMaxAge * @see javax.servlet.http.Cookie#setMaxAge
*/ */
public void setCookieMaxAge(Integer cookieMaxAge) { public void setCookieMaxAge(Integer cookieMaxAge) {
@ -128,7 +130,8 @@ public class CookieGenerator {
/** /**
* Set whether the cookie should only be sent using a secure protocol, * Set whether the cookie should only be sent using a secure protocol,
* such as HTTPS (SSL). This is an indication to the receiving browser, * such as HTTPS (SSL). This is an indication to the receiving browser,
* not processed by the HTTP server itself. Default is "false". * not processed by the HTTP server itself.
* <p>Default is "false".
* @see javax.servlet.http.Cookie#setSecure * @see javax.servlet.http.Cookie#setSecure
*/ */
public void setCookieSecure(boolean cookieSecure) { public void setCookieSecure(boolean cookieSecure) {
@ -145,6 +148,7 @@ public class CookieGenerator {
/** /**
* Set whether the cookie is supposed to be marked with the "HttpOnly" attribute. * Set whether the cookie is supposed to be marked with the "HttpOnly" attribute.
* <p>Default is "false".
* @see javax.servlet.http.Cookie#setHttpOnly * @see javax.servlet.http.Cookie#setHttpOnly
*/ */
public void setCookieHttpOnly(boolean cookieHttpOnly) { public void setCookieHttpOnly(boolean cookieHttpOnly) {

2
src/asciidoc/web-mvc.adoc

@ -3518,7 +3518,7 @@ maximum age. Find below an example of defining a `CookieLocaleResolver`.
| The name of the cookie | The name of the cookie
| cookieMaxAge | cookieMaxAge
| Integer.MAX_INT | Servlet container default
| The maximum time a cookie will stay persistent on the client. If -1 is specified, the | The maximum time a cookie will stay persistent on the client. If -1 is specified, the
cookie will not be persisted; it will only be available until the client shuts down cookie will not be persisted; it will only be available until the client shuts down
their browser. their browser.

Loading…
Cancel
Save