java.net
클래스 ResponseCache

java.lang.Object 
  java.net.ResponseCache

public abstract class ResponseCache
extends Object 

URLConnection 캐쉬의 구현을 나타냅니다. 이러한 클래스의 인스턴스를 시스템에 등록하려면, ResponseCache.setDefault(ResponseCache)를 실행합니다. 시스템은 다음과 같은 목적으로 이 객체를 호출합니다.

• 외부 소스로부터 취득한 resource data를 캐쉬에 포함한다
• 요구된 자원 (캐쉬내에 포함되고 있는 경우가 있다)의 페치를 시도한다

ResponseCache 구현은 어느 자원을 어느 정도의 기간 캐쉬에 포함할까를 결정합니다. 캐쉬로부터 요구 자원을 꺼낼 수 없는 경우, 프로토콜 핸들러는 요구 자원을 원의 장소로부터 페치 합니다. URLConnection#useCaches 설정은 그 프로토콜이 캐쉬에 포함된 응답을 사용할 수 있을지 어떨지를 제어합니다. HTTP 캐쉬의 상세한 것에 대하여는 「RFC 2616: Hypertext Transfer Protocol -- HTTP/1. 1」을 참조하십시오.

도입된 버전 :

1.5

생성자 개요

ResponseCache ()

메서드 개요

abstract CacheResponse	get (URI uri, String rqstMethod, Map <String, List <String >> rqstHeaders) 요구 uri, 요구 메서드 및 요구 헤더에 기반해 캐쉬에 포함된 응답을 취득합니다.
static ResponseCache	getDefault () 시스템 전체의 응답 캐쉬를 취득합니다.
abstract CacheRequest	put (URI uri, URLConnection conn) 프로토콜 핸들러는 자원의 취득 후에 이 메서드를 호출합니다.
static void	setDefault (ResponseCache responseCache) 시스템 전체의 캐쉬를 설정 (또는 설정 해제)합니다.

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

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

생성자 상세

ResponseCache

public ResponseCache()

메서드의 상세

getDefault

public static ResponseCache  getDefault()

시스템 전체의 응답 캐쉬를 취득합니다.

반환값:

시스템 전체의 ResponseCache

예외:

SecurityException - 시큐러티 매니저가 인스톨 되고 있어NetPermission ("getResponseCache")를 거부했을 경우

도입된 버전 :

1.5

관련 항목:

setDefault(ResponseCache)

setDefault

public static void setDefault(ResponseCache  responseCache)

시스템 전체의 캐쉬를 설정 (또는 설정 해제)합니다. 주: 비표준 프로토콜 핸들러는 이 설정을 무시하는 일이 있습니다.

파라미터:

responseCache - 응답 캐쉬. 캐쉬의 설정을 해제하는 경우는 null

예외:

SecurityException - 시큐러티 매니저가 인스톨 되고 있어NetPermission ("setResponseCache")를 거부했을 경우

도입된 버전 :

1.5

관련 항목:

getDefault()

get

public abstract CacheResponse  get(URI  uri,
                                  String  rqstMethod,
                                  Map <String,
List <String >> rqstHeaders)
                           throws IOException 

요구 uri, 요구 메서드 및 요구 헤더에 기반해 캐쉬에 포함된 응답을 취득합니다. 보통, 이 메서드는 프로토콜 핸들러에의해 네트워크 자원 요구의 송신전에 호출합니다. 캐쉬에 포함된 응답이 리턴된인 경우, 이 자원이 대신에 사용됩니다.

파라미터:

uri - 요구된 네트워크 자원의 참조용 URI

rqstMethod - 요구 메서드를 나타내는 String

rqstHeaders - 요구 헤더 필드명과 현재의 요구 헤더를 나타내는 필드값의 리스트를 대응 붙이는 Map

반환값:

캐쉬로부터 이용할 수 있는 경우는 CacheResponse인스턴스, 그렇지 않은 경우는 null

예외:

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

IllegalArgumentException - 인수가 1개에 서도 null인 경우

관련 항목:

URLConnection.setUseCaches(boolean), URLConnection.getUseCaches(), URLConnection.setDefaultUseCaches(boolean), URLConnection.getDefaultUseCaches()

put

public abstract CacheRequest  put(URI  uri,
                                 URLConnection  conn)
                          throws IOException 

프로토콜 핸들러는 자원의 취득 후에 이 메서드를 호출합니다. ResponseCache는 자원을 캐쉬에 포함할지 어떨지를 결정할 필요가 있습니다. 자원이 캐쉬에 포함되는 경우, put()는 CacheRequest 객체를 리턴합니다. 프로토콜 핸들러는 CacheRequest 객체내의 WriteableByteChannel를 사용해, 자원을 캐쉬에 출력합니다. 자원이 캐쉬에 포함되지 않는 경우, put는 null을 리턴합니다.

파라미터:

uri - 요구된 네트워크 자원의 참조용 URI

conn - 캐쉬에 포함하는 응답의 페치에 사용되는 URLConnection 인스턴스

반환값:

캐쉬에 포함되는 응답의 기록용 CacheRequest. 호출측이 응답을 캐쉬에 포함할 생각이 없는 경우는 null

예외:

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

IllegalArgumentException - 인수가 1개에 서도 null인 경우