java.net
클래스 CookieHandler

java.lang.Object 
  java.net.CookieHandler

직계의 기존의 서브 클래스:

CookieManager

public abstract class CookieHandler
extends Object 

CookieHandler 객체는, HTTP 프로토콜 핸들러에 HTTP 상태 관리 정책 구현을 짜넣기 위한 콜백 기구를 제공합니다. HTTP 상태 관리 기구는, HTTP 의 요구와 응답을 사용해 스테이트 풀 세션을 작성하는 방법을 지정합니다.

HTTP 프로토콜 핸들러가 사용해야 할 시스템 전체의 CookieHandler 를 등록하려면 , CookieHandler.setDefault(CookieHandler)를 실행합니다. 현재 등록되어 있는 CookieHandler 를 가져오려면 , CookieHandler.getDefault()를 호출합니다. HTTP 상태 관리의 상세한 것에 대하여는,RFC 2965: HTTP State Management Mechanism 를 참조해 주세요.

도입된 버젼:

1.5

생성자 의 개요

CookieHandler ()

메소드의 개요

abstract Map <String ,List <String >>	get (URI uri, Map <String ,List <String >> requestHeaders) 요구 헤더내로 지정된 URI 의 Cookie 캐쉬로부터 적용 가능한 모든 Cookie 를 가져옵니다.
static CookieHandler	getDefault () 시스템 전체의 Cookie 핸들러를 가져옵니다.
abstract void	put (URI uri, Map <String ,List <String >> responseHeaders) 응답 헤더내에 존재하는 Set-Cookie2 라는 이름의 응답 헤더 필드 등, 적용 가능한 모든 Cookie 를 Cookie 캐쉬내로 설정합니다.
static void	setDefault (CookieHandler cHandler) 시스템 전체의 Cookie 핸들러를 설정 (또는 설정 해제)합니다.

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

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

생성자 의 상세

CookieHandler

public CookieHandler()

메소드의 상세

getDefault

public static CookieHandler  getDefault()

시스템 전체의 Cookie 핸들러를 가져옵니다.

반환값:

시스템 전체의 Cookie 핸들러. null 가 돌려주어졌을 경우, 그것은, 시스템 전체의 Cookie 핸들러가 현재 설정되어 있지 않은 것을 의미한다

예외:

SecurityException - 시큐리티 매니저가 인스톨 되고 있어, 그것이 NetPermission ("getCookieHandler") 를 거부했을 경우

관련 항목:

setDefault(CookieHandler)

setDefault

public static void setDefault(CookieHandler  cHandler)

시스템 전체의 Cookie 핸들러를 설정 (또는 설정 해제)합니다. 주:표준이 아닌 HTTP 프로토콜 핸들러는, 이 설정을 무시할 가능성이 있습니다.

파라미터:

cHandler - HTTP Cookie 핸들러. 설정 해제하는 경우는 null

예외:

SecurityException - 시큐리티 매니저가 인스톨 되고 있어, 그것이 NetPermission ("setCookieHandler") 를 거부했을 경우

관련 항목:

getDefault()

get

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

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

파라미터:

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

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

반환값:

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

예외:

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

IllegalArgumentException - 어느 쪽인가의 인수가 null 의 경우

관련 항목:

put(URI, Map)

put

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

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

파라미터:

uri - Cookie 의 생성원의 URI

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

예외:

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

IllegalArgumentException - 어느 쪽인가의 인수가 null 의 경우

관련 항목:

get(URI, Map)