Класс 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.