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) 프로토콜 핸들러가 자원의 취득 완료 후에 이 메소드를 호출해, ResponseCache 가 그 자원을 캐쉬내에 포함해야할 것인가 제발을 결정합니다.
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 - 인수중 한쪽이 null 의 경우

관련 항목:

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

put

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

프로토콜 핸들러가 자원의 취득 완료 후에 이 메소드를 호출해, ResponseCache 가 그 자원을 캐쉬내에 포함해야할 것인가 제발을 결정합니다. 자원이 캐쉬에 포함되는 경우, put()는, WriteableByteChannel 를 포함한 CacheRequest 객체를 돌려줍니다. 프로토콜 핸들러는 이것을 사용해 자원을 캐쉬내에 기입합니다. 자원이 캐쉬에 포함되지 않는 경우, put 는 null 를 돌려줍니다.

파라미터:

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

conn - 캐쉬 대상의 응답의 취득에 사용되는 URLConnection 인스턴스

반환값:

캐쉬 대상의 응답을 기록하기 위한 CacheRequest. null 가 돌려주어졌을 경우, 그것은, 호출원이 응답을 캐쉬에 포함할 생각이 없는 것을 나타낸다

예외:

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

IllegalArgumentException - 인수중 한쪽이 null 의 경우