com.jcabi.http.wire

Class CachingWire

java.lang.Object

com.jcabi.http.wire.CachingWire

All Implemented Interfaces:

Wire

@Immutable
public final class CachingWire
extends Object
implements Wire

Wire that caches GET requests (for five minutes).

This decorator can be used when you want to avoid duplicate GET requests to load-sensitive resources, for example:

 String html = new JdkRequest("http://goggle.com")
   .through(CachingWire.class)
   .header(HttpHeaders.ACCEPT, MediaType.TEXT_PLAIN)
   .fetch()
   .body();

The class is immutable and thread-safe.

Since:

1.0

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

Constructor Summary

Constructors

Constructor and Description
CachingWire(Wire wire) Public ctor.

Method Summary

Methods

Modifier and Type	Method and Description
Response	get(Request req, String home, Collection<Map.Entry<String,String>> headers, byte[] content) Fetch GET request and cache it.
Response	send(Request req, String home, String method, Collection<Map.Entry<String,String>> headers, byte[] content) Send request and return response.

Methods inherited from class java.lang.Object

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

Constructor Detail

CachingWire

public CachingWire(@NotNull(message="wire can\'t be NULL")
           Wire wire)

Public ctor.

Parameters:

wire - Original wire

Method Detail

send

public Response send(Request req,
            String home,
            String method,
            Collection<Map.Entry<String,String>> headers,
            byte[] content)
              throws IOException

Send request and return response.

Specified by:

send in interface Wire

Parameters:

req - Request

home - URI to fetch

method - HTTP method

headers - Headers

content - HTTP body

Returns:

Response obtained

Throws:

IOException - if fails

Suppressed Checkstyle violations:

ParameterNumber (13 lines)

get

@Cacheable(lifetime=5,
           unit=MINUTES)
public Response get(Request req,
                            String home,
                            Collection<Map.Entry<String,String>> headers,
                            byte[] content)
             throws IOException

Fetch GET request and cache it.

Parameters:

req - Request

home - URI to fetch

headers - Headers

content - HTTP body

Returns:

Response obtained

Throws:

IOException - if fails

Suppressed Checkstyle violations:

ParameterNumber (13 lines)