Класс CookieManager

public class CookieManager extends CookieHandler

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

Управление куки HTTP в пакете java.net выглядит следующим образом:

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

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

Существует несколько способов, с помощью которых пользователь может подключить своё собственное поведение управления куки HTTP, например:

• Используйте 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());
       

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