java.net
인터페이스 CookieStore

public interface CookieStore

CookieStore 객체는, Cookie 의 기억 영역을 나타냅니다. Cookie 의 포함과 취득을 실시할 수 있습니다.

CookieManager 는, HTTP 응답을 수신할 때마다 CookieStore.add 를 호출해 Cookie 를 보존해, HTTP 요구를 송신할 때마다 CookieStore.get 를 호출해 Cookie 를 가져옵니다. CookieStore 에는, 유효기간이 끊어진 HttpCookie 인스턴스를 삭제할 책임이 있습니다.

도입된 버젼:

1.6

메소드의 개요

void	add (URI uri, HttpCookie cookie) 1 개의 HTTP Cookie 를 스토어에 추가합니다.
List <HttpCookie >	get (URI uri) 지정된 URI 에 관련지을 수 있었던 Cookie, 지정된 URI 에 도메인이 일치하는 Cookie 의 어느쪽이든을 가져옵니다.
List <HttpCookie >	getCookies () Cookie 스토어내의 유효기간이 끊어지지 않은 모든 Cookie 를 가져옵니다.
List <URI >	getURIs () 이 Cookie 스토어내의 Cookie 를 식별하는 모든 URI 를 가져옵니다.
boolean	remove (URI uri, HttpCookie cookie) 있는 Cookie 를 스토어로부터 삭제합니다.
boolean	removeAll () 이 Cookie 스토어내의 모든 Cookie 를 삭제합니다.

메소드의 상세

add

void add(URI  uri,
         HttpCookie  cookie)

1 개의 HTTP Cookie 를 스토어에 추가합니다. 이것은, HTTP 응답을 수신할 때마다 불려 갑니다.

포함하는 Cookie 는, URI 에 관련지어도 붙이지 않아도 괜찮습니다. Cookie 를 URI 에 관련지을 수 있지 않은 경우, Cookie 의 도메인 속성과 패스 속성이 그 발생 장소를 나타냅니다. Cookie 를 URI 에 관련지을 수 있고 있어, 그 도메인 속성과 패스 속성이 지정되어 있지 않은 경우는, 그 지정된 URI 가 이 Cookie 의 발생 장소를 나타냅니다.

지정된 URI 에 대응하는 Cookie 가 벌써 존재하고 있는 경우, 그 Cookie 는 새로운 Cookie 로 옮겨놓을 수 있습니다.

파라미터:

uri - 이 Cookie 를 관련지을 수 있는 URI. 이 Cookie 를 URI 에 관련짓지 않는 경우는 null

cookie - 포함하는 Cookie

예외:

NullPointerException - cookie 가 null 의 경우

관련 항목:

get(java.net.URI)

get

List <HttpCookie > get(URI  uri)

지정된 URI 에 관련지을 수 있었던 Cookie, 지정된 URI 에 도메인이 일치하는 Cookie 의 어느쪽이든을 가져옵니다. 유효기간이 끊어지지 않은 Cookie 만이 돌려주어집니다. 이것은, HTTP 요구를 송신할 때마다 불려 갑니다.

반환값:

HttpCookie 의 불변의 리스트. 지정된 URI 에 일치하는 Cookie 가 존재하지 않는 경우는 빈 상태(empty)의 리스트를 돌려준다

예외:

NullPointerException - uri 가 null 의 경우

관련 항목:

add(java.net.URI, java.net.HttpCookie)

getCookies

List <HttpCookie > getCookies()

Cookie 스토어내의 유효기간이 끊어지지 않은 모든 Cookie 를 가져옵니다.

반환값:

HTTP Cookie 의 불변의 리스트. 스토어내에 HTTP Cookie 가 존재하지 않는 경우는 빈 상태(empty)의 리스트를 돌려준다

getURIs

List <URI > getURIs()

이 Cookie 스토어내의 Cookie 를 식별하는 모든 URI 를 가져옵니다.

반환값:

URI 의 불변의 리스트. URI 에 관련지을 수 있었던 Cookie 가 이 Cookie 스토어내에 존재하지 않는 경우는, 빈 상태(empty)의 리스트를 돌려준다

remove

boolean remove(URI  uri,
               HttpCookie  cookie)

어느 Cookie 를 스토어로부터 삭제합니다.

파라미터:

uri - 이 Cookie 를 관련지을 수 있고 있는 URI . null 의 경우, 삭제 대상의 Cookie 는 추가시에 URI 에 관련지을 수 없었다. null 가 아닌 경우, 삭제 대상의 Cookie 는 추가시에 그 지정된 URI 에 관련지을 수 있었던

cookie - 삭제하는 Cookie

반환값:

지정된 Cookie 가 이 스토어내에 포함되고 있었을 경우는 true

예외:

NullPointerException - cookie 가 null 의 경우

removeAll

boolean removeAll()

이 Cookie 스토어내의 모든 Cookie 를 삭제합니다.

반환값:

이 호출의 결과, 이 스토어가 변경되었을 경우는 true