Класс CookieManager

public class CookieManager extends CookieHandler

CookieManager предоставляет конкретное реализацию CookieHandler, которая отделяет хранение файлов cookie от политики, связанной с принятием и отклонением файлов 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, которую нужно использовать.
• CookiePolicy.shouldAccept будет вызываться CookieManager.put, чтобы определить, следует ли принимать и добавлять файл 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());
       

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