java.net
클래스 CookieManager

java.lang.Object 
  java.net.CookieHandler 
      java.net.CookieManager

public class CookieManager
extends CookieHandler 

CookieManager 는 CookieHandler 의 구상 구현을 제공해, Cookie 의 기억 영역과 Cookie 의 수락/거부에 관한 정책를 분리합니다. CookieManager 는, 기억 영역을 관리하는 CookieStore 와 Cookie 의 수락/거부에 관한 정책 결정을 실시하는 CookiePolicy 객체를 사용해 초기화됩니다.

java.net 패키지에 있어서의 HTTP Cookie 관리는, 다음과 같이 되어 있습니다.

사용
CookieHandler <------- HttpURLConnection
       ^
| 구현
|         사용
CookieManager -------> CookiePolicy
|   사용
|--------> HttpCookie
             |              ^
|              | 사용
|   사용       |
|--------> CookieStore
                            ^
| 구현
                            |
내부의 인 메모리 구현
 

• CookieHandler 가 Cookie 관리의 핵심이 된다. 사용자는 CookieHandler.setDefault 를 호출하는 것으로, 사용해야 할 CookieHanlder 의 구상 구현을 설정할 수 있다.
• CookiePolicy.shouldAccept 가 CookieManager.put 에 의해 불려 가 있는 Cookie 를 받아들여 Cookie 스토어내에 포함해야할 것인가 제발이 확인된다. 사용자는, 3 개의 정의가 끝난 CookiePolicy, 즉 ACCEPT_ALL, ACCEPT_NONE, ACCEPT_ORIGINAL_SERVER, 의 어느쪽이든을 사용할 수도 있고, 사용자 독자적인 CookiePolicy 구현을 정의해, CookieManager 에 그것을 사용하도록 지시할 수도 있다.
• CookieStore 는, 받아들여진 모든 HTTP Cookie 의 포함 장소가 된다. 작성시로 지정되지 않았던 경우, CookieManager 인스턴스는 내부의 인 메모리 구현을 사용한다. 또, 사용자가 다른 것을 구현해, CookieManager 에 그것을 사용하도록 지시할 수도 있다.
• 현시점에서는, CookieManager 에 의해 사용되고 있는 것은, CookieStore.add(URI, HttpCookie)와 CookieStore.get(URI) 뿐이다. 그 이외는 완전을 기하기 위한 것이지만, NetscapeCookieStore 등, 보다 고도의 CookieStore 구현에서는 필요하게 될 가능성이 있다.

사용자가 독자적인 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 에 준거하고 있습니다.

도입된 버젼:

1.6

생성자 의 개요

CookieManager ()
새로운 Cookie 매니저를 작성합니다.

CookieManager (CookieStore store, CookiePolicy cookiePolicy)
지정된 Cookie 스토어와 Cookie 정책를 사용해 새로운 Cookie 매니저를 작성합니다.

메소드의 개요

Map <String ,List <String >>	get (URI uri, Map <String ,List <String >> requestHeaders) 요구 헤더내로 지정된 URI 의 Cookie 캐쉬로부터 적용 가능한 모든 Cookie 를 가져옵니다.
CookieStore	getCookieStore () 현재의 Cookie 스토어를 취득하기 위한의.
void	put (URI uri, Map <String ,List <String >> responseHeaders) 응답 헤더내에 존재하는 Set-Cookie2 라는 이름의 응답 헤더 필드 등, 적용 가능한 모든 Cookie 를 Cookie 캐쉬내로 설정합니다.
void	setCookiePolicy (CookiePolicy cookiePolicy) 이 Cookie 매니저의 Cookie 정책를 설정하기 위한의.

클래스 java.net. CookieHandler 로부터 상속된 메소드

getDefault , setDefault

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

생성자 의 상세

CookieManager

public CookieManager()

새로운 Cookie 매니저를 작성합니다.

이 생성자 은, 디폴트의 Cookie 스토어와 수락 정책를 사용해 새로운 Cookie 매니저를 작성합니다. 그 효과는 CookieManager(null, null) 와 같습니다.

CookieManager

public CookieManager(CookieStore  store,
                     CookiePolicy  cookiePolicy)

지정된 Cookie 스토어와 Cookie 정책를 사용해 새로운 Cookie 매니저를 작성합니다.

파라미터:

store - Cookie 매니저가 사용해야 할 CookieStore. null 의 경우, Cookie 매니저는 디폴트의 인 메모리 CookieStore 구현을 사용하는

cookiePolicy - Cookie 매니저가 정책 콜백으로서 사용해야 할 CookiePolicy 인스턴스. null 의 경우, ACCEPT_ORIGINAL_SERVER 가 사용된다

메소드의 상세

setCookiePolicy

public void setCookiePolicy(CookiePolicy  cookiePolicy)

이 Cookie 매니저의 Cookie 정책를 설정하기 위한의.

CookieManager 의 인스턴스는 디폴트로, Cookie 정책 ACCEPT_ORIGINAL_SERVER 를 가집니다. 사용자는 언제라도 이 메소드를 호출해 다른 Cookie 정책를 설정할 수 있습니다.

파라미터:

cookiePolicy - Cookie 정책. null 도 가능하지만, 이것은 현재의 Cookie 정책에 어떤 효과도 가지지 않는다

getCookieStore

public CookieStore  getCookieStore()

현재의 Cookie 스토어를 취득하기 위한의.

반환값:

Cookie 매니저가 현재 사용하고 있는 Cookie 스토어

get

public Map <String ,List <String >> get(URI  uri,
                                    Map <String ,List <String >> requestHeaders)
                             throws IOException 

클래스 CookieHandler 의 기술:

요구 헤더내로 지정된 URI 의 Cookie 캐쉬로부터 적용 가능한 모든 Cookie 를 가져옵니다. HTTP 프로토콜의 구현자는, Cookie 의 선택에 관계하는 모든 요구 헤더가 추가되고 나서 요구가 송신될 때까지 에, 반드시 이 메소드가 불려 가도록 해 주세요.

정의:

클래스 CookieHandler 내의 get

파라미터:

uri - 요구시에 Cookie 의 송신지가 되는 URI

requestHeaders - 요구 헤더 필드명으로부터 필드치의 리스트에의 Map. 이것은 현재의 요구 헤더를 나타낸다

반환값:

필드명 「Cookie」또는 「Cookie2」를 가지는 상태 관리 헤더로부터 상태 정보가 포함된 Cookie 의 리스트에의 불변의 맵

예외:

IOException - 입출력 에러가 발생했을 경우

관련 항목:

CookieHandler.put(URI, Map)

put

public void put(URI  uri,
                Map <String ,List <String >> responseHeaders)
         throws IOException 

클래스 CookieHandler 의 기술:

응답 헤더내에 존재하는 Set-Cookie2 라는 이름의 응답 헤더 필드 등, 적용 가능한 모든 Cookie 를 Cookie 캐쉬내로 설정합니다.

정의:

클래스 CookieHandler 내의 put

파라미터:

uri - Cookie 의 생성원의 URI

responseHeaders - 필드명으로부터 필드치의 리스트에의 불변의 맵. 이것은 반환된 응답 헤더 필드를 나타낸다

예외:

IOException - 입출력 에러가 발생했을 경우

관련 항목:

CookieHandler.get(URI, Map)