com.jcabi.http.wire

Class CookieOptimizingWire

java.lang.Object

com.jcabi.http.wire.CookieOptimizingWire

All Implemented Interfaces:

Wire

@Immutable
public final class CookieOptimizingWire
extends Object
implements Wire

Wire that compresses cookies before sending.

This wire compresses all provided Cookie headers into one and removes empty cookies, for example:

 String html = new JdkRequest("http://goggle.com")
   .through(CookieOptimizingWire.class)
   .header(HttpHeaders.Cookie, "alpha=test")
   .header(HttpHeaders.Cookie, "beta=")
   .header(HttpHeaders.Cookie, "gamma=foo")
   .fetch()
   .body();

An actual HTTP request will be sent with just one Cookie header with a value alpha=test; gamma=foo.

It is highly recommended to use this wire decorator when you're working with cookies.

The class is immutable and thread-safe.

Since:

0.10

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

See Also:

RFC 2965 "HTTP State Management Mechanism"

Constructor Summary

Constructors

Constructor and Description
CookieOptimizingWire(Wire wire) Public ctor.

Method Summary

Methods

Modifier and Type	Method and Description
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

CookieOptimizingWire

public CookieOptimizingWire(@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 (7 lines)