Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit d9003c05 authored by Rowan Merewood's avatar Rowan Merewood Committed by Automerger Merge Worker
Browse files

Merge "Update the WebView docs to point to MDN for cookie attribute... 

Merge "Update the WebView docs to point to MDN for cookie attribute explanations with an explicit callout for the Partitioned attribute." am: f707968b am: fb495c79 am: c672da43 am: 4d1e98ec am: 39f6b1cf

Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/2616390



Change-Id: I8704b64bdd270296aad2c4aefa1b1560b2c2cafa
Signed-off-by: default avatarAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
parents fa78c4a7 39f6b1cf

core/java/android/webkit/CookieManager.java

+34 −16
Original line number Diff line number Diff line
@@ -103,15 +103,22 @@ public abstract class CookieManager { 
     * will be ignored if it is expired. To set multiple cookies, your application should invoke

     * this method multiple times.

     *

     * <p>The {@code value} parameter must follow the format of the {@code Set-Cookie} HTTP

     * response header defined by

     * <a href="https://tools.ietf.org/html/draft-ietf-httpbis-rfc6265bis-03">RFC6265bis</a>.

     * This is a key-value pair of the form {@code "key=value"}, optionally followed by a list of

     * cookie attributes delimited with semicolons (ex. {@code "key=value; Max-Age=123"}). Please

     * consult the RFC specification for a list of valid attributes.

     * <p>The {@code value} parameter must follow the format of the {@code Set-Cookie} HTTP response

     * header. This is a key-value pair of the form {@code "key=value"}, optionally followed by a

     * list of cookie attributes delimited with semicolons (ex. {@code "key=value; Max-Age=123"}).

     * For the header format and attributes supported by WebView, see the <a href=

     * "https://developer.mozilla.org/docs/Web/HTTP/Headers/Set-Cookie">{@code Set-Cookie}

     * documentation on MDN</a>.

     *

     * <p class="note"><b>Note:</b> if specifying a {@code value} containing the {@code "Secure"}

     * attribute, {@code url} must use the {@code "https://"} scheme.

     * <p class="note">

     * <b>Notes:</b>

     * <ul>

     * <li>If specifying a {@code value} containing the {@code "Secure"} attribute,

     * {@code url} must use the {@code "https://"} scheme.</li>

     * <li>if specifying a {@code value} containing the {@code "Partitioned"}

     * attribute, the cookie will be set for the top-level partition of the

     * {@code url}.</li>

     * </ul>

     *

     * @param url the URL for which the cookie is to be set

     * @param value the cookie as a string, using the format of the 'Set-Cookie'
@@ -125,12 +132,12 @@ public abstract class CookieManager { 
     * will be ignored if it is expired. To set multiple cookies, your application should invoke

     * this method multiple times.

     *

     * <p>The {@code value} parameter must follow the format of the {@code Set-Cookie} HTTP

     * response header defined by

     * <a href="https://tools.ietf.org/html/draft-ietf-httpbis-rfc6265bis-03">RFC6265bis</a>.

     * This is a key-value pair of the form {@code "key=value"}, optionally followed by a list of

     * cookie attributes delimited with semicolons (ex. {@code "key=value; Max-Age=123"}). Please

     * consult the RFC specification for a list of valid attributes.

     * <p>The {@code value} parameter must follow the format of the {@code Set-Cookie} HTTP response

     * header. This is a key-value pair of the form {@code "key=value"}, optionally followed by a

     * list of cookie attributes delimited with semicolons (ex. {@code "key=value; Max-Age=123"}).

     * For the header format and attributes supported by WebView, see the <a href=

     * "https://developer.mozilla.org/docs/Web/HTTP/Headers/Set-Cookie">{@code Set-Cookie}

     * documentation on MDN</a>.

     *

     * <p>This method is asynchronous. If a {@link ValueCallback} is provided,

     * {@link ValueCallback#onReceiveValue} will be called on the current
@@ -140,8 +147,15 @@ public abstract class CookieManager { 
     * completes or whether it succeeded, and in this case it is safe to call the method from a

     * thread without a Looper.

     *

     * <p class="note"><b>Note:</b> if specifying a {@code value} containing the {@code "Secure"}

     * attribute, {@code url} must use the {@code "https://"} scheme.

     * <p class="note">

     * <b>Notes:</b>

     * <ul>

     * <li>If specifying a {@code value} containing the {@code "Secure"} attribute,

     * {@code url} must use the {@code "https://"} scheme.</li>

     * <li>if specifying a {@code value} containing the {@code "Partitioned"}

     * attribute, the cookie will be set for the top-level partition of the

     * {@code url}.</li>

     * </ul>

     *

     * @param url the URL for which the cookie is to be set

     * @param value the cookie as a string, using the format of the 'Set-Cookie'
@@ -157,6 +171,10 @@ public abstract class CookieManager { 
     * "; "} characters (semicolon followed by a space). Each key-value pair will be of the form

     * {@code "key=value"}.

     *

     * <p class="note">

     * <b>Note:</b> Any cookies set with the {@code "Partitioned"} attribute will only be returned

     * for the top-level partition of {@code url}.

     *

     * @param url the URL for which the cookies are requested

     * @return value the cookies as a string, using the format of the 'Cookie'

     *               HTTP request header