com.ibm.cloud.objectstorage.services.s3.internal

Class AbstractRepeatableCipherInputStream<T>

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

com.ibm.cloud.objectstorage.internal.SdkFilterInputStream

com.ibm.cloud.objectstorage.services.s3.internal.AbstractRepeatableCipherInputStream<T>

All Implemented Interfaces:

MetricAware, Releasable, Closeable, AutoCloseable

Deprecated.

this class is no longer used and will be removed in the future

Common base class used to wrap an InputStream with a cipher input stream 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.

@Deprecated
public abstract class AbstractRepeatableCipherInputStream<T>
extends SdkFilterInputStream

Field Summary

Fields inherited from class java.io.FilterInputStream

in

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractRepeatableCipherInputStream(InputStream input, FilterInputStream cipherInputStream, T cipherFactory) Deprecated. Constructs a new repeatable cipher input stream using the specified InputStream as the source data, and the CipherFactory for building Cipher objects.

Method Summary

Modifier and Type	Method and Description
protected abstract FilterInputStream	createCipherInputStream(InputStream unencryptedDataStream, T cipherFactory) Deprecated.
void	mark(int readlimit) Deprecated.
boolean	markSupported() Deprecated.
int	read() Deprecated.
int	read(byte[] b) Deprecated.
int	read(byte[] b, int off, int len) Deprecated.
void	reset() Deprecated.
long	skip(long n) Deprecated.

Methods inherited from class com.ibm.cloud.objectstorage.internal.SdkFilterInputStream

abort, abortIfNeeded, available, close, getDelegateStream, isAborted, isMetricActivated, release

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractRepeatableCipherInputStream

protected AbstractRepeatableCipherInputStream(InputStream input,
                                              FilterInputStream cipherInputStream,
                                              T cipherFactory)

Deprecated.

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.

cipherInputStream - The cipher input stream wrapping the original input stream

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

Method Detail

markSupported

public boolean markSupported()

Deprecated.

Overrides:

markSupported in class SdkFilterInputStream

mark

public void mark(int readlimit)

Deprecated.

Overrides:

mark in class SdkFilterInputStream

reset

public void reset()
           throws IOException

Deprecated.

Overrides:

reset in class SdkFilterInputStream

Throws:

IOException

read

public int read()
         throws IOException

Deprecated.

Overrides:

read in class SdkFilterInputStream

Throws:

IOException

read

public int read(byte[] b)
         throws IOException

Deprecated.

Overrides:

read in class FilterInputStream

Throws:

IOException

read

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

Deprecated.

Overrides:

read in class SdkFilterInputStream

Throws:

IOException

skip

public long skip(long n)
          throws IOException

Deprecated.

Overrides:

skip in class SdkFilterInputStream

Throws:

IOException

createCipherInputStream

protected abstract FilterInputStream createCipherInputStream(InputStream unencryptedDataStream,
                                                             T cipherFactory)

Deprecated.