com.amazonaws.services.s3.internal

Class RepeatableCipherInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

com.amazonaws.internal.SdkFilterInputStream

com.amazonaws.services.s3.internal.AbstractRepeatableCipherInputStream<CipherFactory>

com.amazonaws.services.s3.internal.RepeatableCipherInputStream

All Implemented Interfaces:

MetricAware, Closeable, AutoCloseable

public class RepeatableCipherInputStream
extends AbstractRepeatableCipherInputStream<CipherFactory>

Wraps an InputStream with a CipherInputStream to encrypt it, and handles resets by attempting to reset on the original, unencrypted data InputStream, and recreate an identical Cipher and identical CipherInputStream on the original data.

It's repeatable if and only if the underlying unencryptedDataStream is repeatable - if the underlying input stream is not repeatable and you're going to buffer to make it repeatable anyways, it makes more sense to do so after wrapping in this object, so we buffer the encrypted data and don't have to bother re-encrypting on retry.

This stream only supports being marked before the first call to read or skip, since it's not possible to rewind the encryption state of a CipherInputStream to an arbitrary point. If you call mark after calling read or skip, it will throw an UnsupportedOperationException.

Field Summary

Fields inherited from class java.io.FilterInputStream

in

Constructor Summary

Constructors

Constructor and Description
RepeatableCipherInputStream(InputStream input, CipherFactory cipherFactory) Constructs a new repeatable cipher input stream using the specified InputStream as the source data, and the CipherFactory for building Cipher objects.

Method Summary

Methods

Modifier and Type	Method and Description
protected FilterInputStream	createCipherInputStream(InputStream unencryptedDataStream, CipherFactory cipherFactory)

Methods inherited from class com.amazonaws.services.s3.internal.AbstractRepeatableCipherInputStream

mark, markSupported, read, read, read, reset, skip

Methods inherited from class com.amazonaws.internal.SdkFilterInputStream

isMetricActivated

Methods inherited from class java.io.FilterInputStream

available, close

Methods inherited from class java.lang.Object

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

Constructor Detail

RepeatableCipherInputStream

public RepeatableCipherInputStream(InputStream input,
                           CipherFactory cipherFactory)

Constructs a new repeatable cipher input stream using the specified InputStream as the source data, and the CipherFactory for building Cipher objects.

Parameters:

input - The original, unencrypted data stream. This stream should be markable/resetable in order for this class to work correctly.

cipherFactory - The factory used for creating identical cipher objects when this stream is reset and a new CipherInputStream is needed.

Method Detail

createCipherInputStream

protected FilterInputStream createCipherInputStream(InputStream unencryptedDataStream,
                                        CipherFactory cipherFactory)

Specified by:

createCipherInputStream in class AbstractRepeatableCipherInputStream<CipherFactory>