com.jcabi.github.wire

Class RetryCarefulWire

java.lang.Object

com.jcabi.github.wire.RetryCarefulWire

All Implemented Interfaces:

com.jcabi.http.Wire

@Immutable
public final class RetryCarefulWire
extends Object
implements com.jcabi.http.Wire

Wire that waits if the number of remaining requests per hour is less than a given threshold, and in the event of IOException retries a few times before giving up and rethrowing the exception.

Just a wrapper for a RetryWire that wraps a CarefulWire that wraps the underlying wire.

You can use RetryCarefulWire with a Github object:

 Github github = new RtGithub(
     new RtGithub().entry().through(RetryCarefulWire.class, 50)
 );
 
 

Since:

0.23

Version:

$Id$

Author:

Chris Rebert (github@chrisrebert.com)

Constructor Summary

Constructors

Constructor and Description
RetryCarefulWire(com.jcabi.http.Wire wire, int threshold) Public ctor.

Method Summary

Methods

Modifier and Type	Method and Description
com.jcabi.http.Response	send(com.jcabi.http.Request req, String home, String method, Collection<Map.Entry<String,String>> headers, InputStream content)

Methods inherited from class java.lang.Object

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

Constructor Detail

RetryCarefulWire

public RetryCarefulWire(@NotNull(message="wire can\'t be NULL")
                com.jcabi.http.Wire wire,
                int threshold)

Public ctor.

Parameters:

wire - Original wire

threshold - Threshold of number of remaining requests, below which requests are blocked until reset

Method Detail

send

@NotNull(message="response can\'t be NULL")
public com.jcabi.http.Response send(@NotNull(message="req can\'t be NULL")
                                          com.jcabi.http.Request req,
                                          @NotNull(message="home can\'t be NULL")
                                          String home,
                                          @NotNull(message="method can\'t be NULL")
                                          String method,
                                          @NotNull(message="headers can\'t be NULL")
                                          Collection<Map.Entry<String,String>> headers,
                                          @NotNull(message="content can\'t be NULL")
                                          InputStream content)
                             throws IOException

Specified by:

send in interface com.jcabi.http.Wire

Throws:

IOException

Suppressed Checkstyle violations:

ParameterNumber (6 lines)