com.jcabi.http.wire

Class RetryWire

java.lang.Object

com.jcabi.http.wire.RetryWire

All Implemented Interfaces:

Wire

@Immutable
public final class RetryWire
extends Object
implements Wire

Wire that retries a few times before giving up and throwing exception.

This wire retries again (at least three times) if an original one throws IOException:

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

The class is immutable and thread-safe.

Since:

0.10

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

Constructor Summary

Constructors

Constructor and Description
RetryWire(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, InputStream 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

RetryWire

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

Public ctor.

Parameters:

wire - Original wire

Method Detail

send

@RetryOnFailure(attempts=5,
                delay=1L,
                unit=SECONDS,
                verbose=false)
public Response send(Request req,
                                                          String home,
                                                          String method,
                                                          Collection<Map.Entry<String,String>> headers,
                                                          InputStream 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)