Класс CookieManager

public class CookieManager extends CookieHandler

CookieManager предоставляет конкретную реализацию CookieHandler, которая отделяет хранение файлов cookie от политики их принятия и отклонения. CookieManager инициализируется объектом CookieStore, управляющим хранением, и объектом CookiePolicy, который принимает решения о политике принятия или отклонения файлов cookie.

Управление HTTP-файлами cookie в пакете java.net устроено следующим образом:

                 use
CookieHandler <------- HttpURLConnection
      ^
      | impl
      |         use
CookieManager -------> CookiePolicy
            |   use
            |--------> HttpCookie
            |              ^
            |              | use
            |   use        |
            |--------> CookieStore
                           ^
                           | impl
                           |
                 Internal in-memory implementation

• CookieHandler лежит в основе управления файлами cookie. Пользователь может вызвать CookieHandler.setDefault, чтобы задать конкретную реализацию CookieHandler, которую следует использовать.
• CookieManager.put вызовет CookiePolicy.shouldAccept, чтобы определить, следует ли принимать файл cookie и помещать его в хранилище файлов cookie. Пользователь может использовать одну из трёх предопределённых политик CookiePolicy — ACCEPT_ALL, ACCEPT_NONE и ACCEPT_ORIGINAL_SERVER — или определить собственную реализацию CookiePolicy и указать CookieManager использовать её.
• CookieStore — это место, где хранятся все принятые HTTP-файлы cookie. Если при создании не указано иное, экземпляр CookieManager использует внутреннюю реализацию в памяти. Пользователь также может реализовать собственное хранилище и указать CookieManager использовать его.
• В настоящее время CookieManager использует только CookieStore.add(URI, HttpCookie) и CookieStore.get(URI). Остальные методы приведены для полноты и могут понадобиться более сложной реализации CookieStore, например NetscapeCookieStore.

Пользователь может подключить собственное поведение для управления HTTP-файлами cookie разными способами, например:

• Использовать CookieHandler.setDefault, чтобы задать совершенно новую реализацию CookieHandler
• Оставить CookieManager реализацией CookieHandler по умолчанию, но реализовать собственные CookieStore и CookiePolicy и указать CookieManager по умолчанию использовать их:

        // this should be done at the beginning of an HTTP session
        CookieHandler.setDefault(new CookieManager(new MyCookieStore(), new MyCookiePolicy()));
      

• Оставить CookieManager реализацией CookieHandler по умолчанию, но использовать настроенную CookiePolicy:

        // this should be done at the beginning of an HTTP session
        CookieHandler.setDefault(new CookieManager());
        // this can be done at any point of an HTTP session
        ((CookieManager)CookieHandler.getDefault()).setCookiePolicy(new MyCookiePolicy());
      

Реализация соответствует разделу 3.3 RFC 2965.