Package org.apache.http.client.cache

Interface ResourceFactory

All Known Implementing Classes:

FileResourceFactory, HeapResourceFactory

public interface ResourceFactory

Generates Resource instances for handling cached HTTP response bodies.

Since:

4.1

Method Summary

Modifier and Type	Method	Description
Resource	copy(java.lang.String requestId, Resource resource)	Clones an existing Resource.
Resource	generate(java.lang.String requestId, java.io.InputStream inStream, InputLimit limit)	Creates a Resource from a given response body.

Method Detail

generate

Resource generate(java.lang.String requestId,
                  java.io.InputStream inStream,
                  InputLimit limit)
           throws java.io.IOException

Creates a Resource from a given response body.

Parameters:

requestId - a unique identifier for this particular response body

inStream - the original InputStream containing the response body of the origin HTTP response.

limit - maximum number of bytes to consume of the response body; if this limit is reached before the response body is fully consumed, mark the limit has having been reached and return a Resource containing the data read to that point.

Returns:

a Resource containing however much of the response body was successfully read.

Throws:

java.io.IOException

copy

Resource copy(java.lang.String requestId,
              Resource resource)
       throws java.io.IOException

Clones an existing Resource.

Parameters:

requestId - unique identifier provided to associate with the cloned response body.

resource - the original response body to clone.

Returns:

the Resource copy

Throws:

java.io.IOException