Module org.elasticsearch.server

Package org.elasticsearch.common.blobstore

Class RetryingInputStream<V>

java.lang.Object

java.io.InputStream

org.elasticsearch.common.blobstore.RetryingInputStream<V>

Type Parameters:

V - The type used to represent the version of a blob

All Implemented Interfaces:

Closeable, AutoCloseable

public abstract class RetryingInputStream<V>
extends InputStream

An InputStream that resumes downloads from the point at which they failed when a retry-able error occurs.

This class implements some Elasticsearch-specific retry behavior, including:

• Retrying indefinitely for OperationPurpose.INDICES operations
• Not retrying at all for OperationPurpose.REPOSITORY_ANALYSIS operations
• Extending retries if "meaningful" progress was made on the last attempt
• More detailed logging about the status of operations being retried

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static interface	RetryingInputStream.BlobStoreServices<V>	This implements all the behavior that is blob-store-specific
protected static final class	RetryingInputStream.SingleAttemptInputStream<V>	Represents an InputStream for a single attempt to read a blob.
static enum	RetryingInputStream.StreamAction

Field Summary

Fields

Modifier and Type	Field	Description
protected RetryingInputStream.SingleAttemptInputStream<V>	currentStream
static final int	MAX_SUPPRESSED_EXCEPTIONS

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	RetryingInputStream(RetryingInputStream.BlobStoreServices<V> blobStoreServices, OperationPurpose purpose)
protected	RetryingInputStream(RetryingInputStream.BlobStoreServices<V> blobStoreServices, OperationPurpose purpose, long start, long end)

Method Summary

Modifier and Type	Method	Description
void	close()
protected long	getRetryDelayInMillis()
int	read()
int	read(byte[] b, int off, int len)
void	reset()
long	skip(long n)

Methods inherited from class java.io.InputStream

available, mark, markSupported, nullInputStream, read, readAllBytes, readNBytes, readNBytes, skipNBytes, transferTo

Methods inherited from class java.lang.Object

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

Field Details

MAX_SUPPRESSED_EXCEPTIONS

public static final int MAX_SUPPRESSED_EXCEPTIONS

See Also:

• Constant Field Values

currentStream

protected RetryingInputStream.SingleAttemptInputStream<V> currentStream

Constructor Details

RetryingInputStream

protected RetryingInputStream(RetryingInputStream.BlobStoreServices<V> blobStoreServices,
 OperationPurpose purpose)
                       throws IOException

Throws:

IOException

RetryingInputStream

protected RetryingInputStream(RetryingInputStream.BlobStoreServices<V> blobStoreServices,
 OperationPurpose purpose,
 long start,
 long end)
                       throws IOException

Throws:

IOException

Method Details

read

public int read()
         throws IOException

Specified by:

read in class InputStream

Throws:

IOException

read

public int read(byte[] b,
 int off,
 int len)
         throws IOException

Overrides:

read in class InputStream

Throws:

IOException

getRetryDelayInMillis

protected long getRetryDelayInMillis()

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Overrides:

close in class InputStream

Throws:

IOException

skip

public long skip(long n)
          throws IOException

Overrides:

skip in class InputStream

Throws:

IOException

reset

public void reset()

Overrides:

reset in class InputStream