CookiePolicy (Java SE 13 & JDK 13 )
Description: declaration: module: java.base, package: java.net, interface: CookiePolicy
Keywords: java.net.CookiePolicy interface

Module java.base
Package java.net

# Interface CookiePolicy

    public interface CookiePolicy

CookiePolicy implementations decide which cookies should be accepted and which should be rejected. Three pre-defined policy implementations are provided, namely ACCEPT_ALL, ACCEPT_NONE and ACCEPT_ORIGINAL_SERVER.

See RFC 2965 sec. 3.3 and 7 for more detail.

Since:
  1.6

- ## Field Summary

  Fields
  Modifier and Type | Field | Description
  --- | --- | ---
  `static CookiePolicy` | `ACCEPT_ALL` | One pre-defined policy which accepts all cookies.
  `static CookiePolicy` | `ACCEPT_NONE` | One pre-defined policy which accepts no cookies.
  `static CookiePolicy` | `ACCEPT_ORIGINAL_SERVER` | One pre-defined policy which only accepts cookies from original server.

- ## Method Summary

  Modifier and Type | Method | Description
  --- | --- | ---
  `boolean` | `shouldAccept​(URI uri, HttpCookie cookie)` | Will be called to see whether or not this cookie should be accepted.

- ## Field Details

  - ### ACCEPT_ALL

    static final CookiePolicy ACCEPT_ALL
    One pre-defined policy which accepts all cookies.

  - ### ACCEPT_NONE

    static final CookiePolicy ACCEPT_NONE
    One pre-defined policy which accepts no cookies.

  - ### ACCEPT_ORIGINAL_SERVER

    static final CookiePolicy ACCEPT_ORIGINAL_SERVER
    One pre-defined policy which only accepts cookies from original server.

- ## Method Details

  - ### shouldAccept

    boolean shouldAccept​(URI uri, HttpCookie cookie)
    Will be called to see whether or not this cookie should be accepted.
    Parameters:
      `uri` - the URI to consult accept policy with
      `cookie` - the HttpCookie object in question
    Returns:
      `true` if this cookie should be accepted; otherwise, `false`