Add generic attribute support to SessionCookieConfig

Also adds an entry to the change log.
The schema also requires an update. A separate PR will be provided
shortly to the schema project for that change.

api/src/main/java/jakarta/servlet/SessionCookieConfig.java

@@ -17,6 +17,8 @@
 
 package jakarta.servlet;
 
+import java.util.Map;
+
 /**
  * Class that may be used to configure various properties of cookies used for session tracking purposes.
  *
@@ -231,4 +233,45 @@ public interface SessionCookieConfig {
      * @see jakarta.servlet.http.Cookie#getMaxAge
      */
     public int getMaxAge();
+
+    /**
+     * Sets the value for the given session cookie attribute. When a value is set via this method, the value returned by the
+     * attribute specific getter (if any) must be consistent with the value set via this method.
+     *
+     * @param name Name of attribute to set, case insensitive
+     * @param value Value of attribute
+     *
+     * @throws IllegalStateException if the associated ServletContext has already been initialised
+     *
+     * @throws IllegalArgumentException If the attribute name is null or contains any characters not permitted for use in
+     * Cookie names.
+     *
+     * @throws NumberFormatException If the attribute is known to be numerical but the provided value cannot be parsed to a
+     * number.
+     *
+     * @since Servlet 6.0
+     */
+    public void setAttribute(String name, String value);
+
+    /**
+     * Obtain the value for a given session cookie attribute. Values returned from this method must be consistent with the
+     * values set and returned by the attribute specific getters and setters in this class.
+     *
+     * @param name Name of attribute to return, case insensitive
+     *
+     * @return Value of specified attribute
+     *
+     * @since Servlet 6.0
+     */
+    public String getAttribute(String name);
+
+    /**
+     * Obtain the Map (keys are case insensitive) of all attributes and values, including those set via the attribute
+     * specific setters, (excluding version) for this <tt>SessionCookieConfig</tt>.
+     *
+     * @return A read-only Map of attributes to values, excluding version.
+     *
+     * @since Servlet 6.0
+     */
+    public Map<String, String> getAttributes();
 }

spec/src/main/asciidoc/servlet-spec-body.adoc

@@ -8381,6 +8381,10 @@ Jakarta Servlet {spec-version} specification developed under the Jakarta EE Work
 
 === Changes Since Jakarta Servlet 5.0
 
+link:https://github.com/eclipse-ee4j/servlet-api/issues/175[Issue 175]::
+Provide generic attribute support to cookies, including session cookies, to
+provide support for additional attributes such as the `SameSite` attribute.
+
 link:https://github.com/eclipse-ee4j/servlet-api/issues/225[Issue 225]::
 Deprecated wrapped response handling in the `doHead` method in favour of container implementation of `HEAD` method behavior.