org.apache.commons.crypto.stream

? CryptoInputStream

java.lang.Object

java.io.InputStream

org.apache.commons.crypto.stream.CryptoInputStream

????????:

Closeable, AutoCloseable, Channel, ReadableByteChannel

??????:

CtrCryptoInputStream

public class CryptoInputStream
extends InputStream
implements ReadableByteChannel

CryptoInputStream reads input data and decrypts data in stream manner. It supports any mode of operations such as AES CBC/CTR/GCM mode in concept.It is not thread-safe.

????

??

??????	?????
static String	STREAM_BUFFER_SIZE_KEY The configuration key of the buffer size for stream.

?????

???

???	??????
protected	CryptoInputStream(Input input, CryptoCipher cipher, int bufferSize, Key key, AlgorithmParameterSpec params) Constructs a CryptoInputStream.
protected	CryptoInputStream(InputStream in, CryptoCipher cipher, int bufferSize, Key key, AlgorithmParameterSpec params) Constructs a CryptoInputStream.
protected	CryptoInputStream(ReadableByteChannel in, CryptoCipher cipher, int bufferSize, Key key, AlgorithmParameterSpec params) Constructs a CryptoInputStream.
	CryptoInputStream(String transformation, Properties props, InputStream in, Key key, AlgorithmParameterSpec params) Constructs a CryptoInputStream.
	CryptoInputStream(String transformation, Properties props, ReadableByteChannel in, Key key, AlgorithmParameterSpec params) Constructs a CryptoInputStream.

????

??????	?????
int	available() Overrides the InputStream.available().
protected void	checkStream() Checks whether the stream is closed.
void	close() Overrides the InputStream.close().
protected void	decrypt() Does the decryption using inBuffer as input and outBuffer as output.
protected void	decryptFinal() Does final of the cipher to end the decrypting stream.
protected int	decryptMore() Decrypts more data by reading the under layer stream.
protected void	freeBuffers() Forcibly free the direct buffers.
protected int	getBufferSize() Gets the buffer size.
protected CryptoCipher	getCipher() Gets the internal CryptoCipher.
protected Input	getInput() Gets the input.
protected Key	getKey() Gets the key.
protected AlgorithmParameterSpec	getParams() Gets the specification of cryptographic parameters.
protected void	initCipher() Initializes the cipher.
boolean	isOpen() Overrides the Channel.isOpen().
void	mark(int readlimit) Overrides the InputStream.mark(int).
boolean	markSupported() Overrides the InputStream.markSupported().
int	read() Overrides the InputStream.read().
int	read(byte[] b, int off, int len) Overrides the InputStream.read(byte[], int, int).
int	read(ByteBuffer dst) Overrides the ReadableByteChannel.read(ByteBuffer).
void	reset() Overrides the InputStream.reset().
long	skip(long n) Overrides the InputStream.skip(long).

??????? java.io.InputStream

read

??????? java.lang.Object

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

??????

STREAM_BUFFER_SIZE_KEY

public static final String STREAM_BUFFER_SIZE_KEY

The configuration key of the buffer size for stream.

????:

?????

???????

CryptoInputStream

public CryptoInputStream(String transformation,
                         Properties props,
                         InputStream in,
                         Key key,
                         AlgorithmParameterSpec params)
                  throws IOException

Constructs a CryptoInputStream.

??:

transformation - the name of the transformation, e.g., AES/CBC/PKCS5Padding. See the Java Cryptography Architecture Standard Algorithm Name Documentation for information about standard transformation names.

props - The Properties class represents a set of properties.

in - the input stream.

key - crypto key for the cipher.

params - the algorithm parameters.

??:

IOException - if an I/O error occurs.

CryptoInputStream

public CryptoInputStream(String transformation,
                         Properties props,
                         ReadableByteChannel in,
                         Key key,
                         AlgorithmParameterSpec params)
                  throws IOException

Constructs a CryptoInputStream.

??:

transformation - the name of the transformation, e.g., AES/CBC/PKCS5Padding. See the Java Cryptography Architecture Standard Algorithm Name Documentation for information about standard transformation names.

props - The Properties class represents a set of properties.

in - the ReadableByteChannel object.

key - crypto key for the cipher.

params - the algorithm parameters.

??:

IOException - if an I/O error occurs.

CryptoInputStream

protected CryptoInputStream(InputStream in,
                            CryptoCipher cipher,
                            int bufferSize,
                            Key key,
                            AlgorithmParameterSpec params)
                     throws IOException

Constructs a CryptoInputStream.

??:

cipher - the cipher instance.

in - the input stream.

bufferSize - the bufferSize.

key - crypto key for the cipher.

params - the algorithm parameters.

??:

IOException - if an I/O error occurs.

CryptoInputStream

protected CryptoInputStream(ReadableByteChannel in,
                            CryptoCipher cipher,
                            int bufferSize,
                            Key key,
                            AlgorithmParameterSpec params)
                     throws IOException

Constructs a CryptoInputStream.

??:

in - the ReadableByteChannel instance.

cipher - the cipher instance.

bufferSize - the bufferSize.

key - crypto key for the cipher.

params - the algorithm parameters.

??:

IOException - if an I/O error occurs.

CryptoInputStream

protected CryptoInputStream(Input input,
                            CryptoCipher cipher,
                            int bufferSize,
                            Key key,
                            AlgorithmParameterSpec params)
                     throws IOException

Constructs a CryptoInputStream.

??:

input - the input data.

cipher - the cipher instance.

bufferSize - the bufferSize.

key - crypto key for the cipher.

params - the algorithm parameters.

??:

IOException - if an I/O error occurs.

??????

read

public int read()
         throws IOException

Overrides the InputStream.read(). Reads the next byte of data from the input stream.

???:

read ??? InputStream

??:

the next byte of data, or -1 if the end of the stream is reached.

??:

IOException - if an I/O error occurs.

read

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

Overrides the InputStream.read(byte[], int, int). Decryption is buffer based. If there is data in outBuffer, then read it out of this buffer. If there is no data in outBuffer, then read more from the underlying stream and do the decryption.

??:

read ??? InputStream

??:

b - the buffer into which the decrypted data is read.

off - the buffer offset.

len - the maximum number of decrypted data bytes to read.

??:

int the total number of decrypted data bytes read into the buffer.

??:

IOException - if an I/O error occurs.

skip

public long skip(long n)
          throws IOException

Overrides the InputStream.skip(long). Skips over and discards n bytes of data from this input stream.

??:

skip ??? InputStream

??:

n - the number of bytes to be skipped.

??:

the actual number of bytes skipped.

??:

IOException - if an I/O error occurs.

available

public int available()
              throws IOException

Overrides the InputStream.available(). Returns an estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking by the next invocation of a method for this input stream.

??:

available ??? InputStream

??:

an estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking or 0 when it reaches the end of the input stream.

??:

IOException - if an I/O error occurs.

close

public void close()
           throws IOException

Overrides the InputStream.close(). Closes this input stream and releases any system resources associated with the stream.

???:

close ???? Closeable

???:

close ???? AutoCloseable

???:

close ???? Channel

??:

close ??? InputStream

??:

IOException - if an I/O error occurs.

mark

public void mark(int readlimit)

Overrides the InputStream.mark(int). For CryptoInputStream,we don't support the mark method.

??:

mark ??? InputStream

??:

readlimit - the maximum limit of bytes that can be read before the mark position becomes invalid.

reset

public void reset()
           throws IOException

Overrides the InputStream.reset(). For CryptoInputStream ,we don't support the reset method.

??:

reset ??? InputStream

??:

IOException - if an I/O error occurs.

markSupported

public boolean markSupported()

Overrides the InputStream.markSupported().

??:

markSupported ??? InputStream

??:

false,the CtrCryptoInputStream don't support the mark method.

isOpen

public boolean isOpen()

Overrides the Channel.isOpen().

???:

isOpen ???? Channel

??:

true if, and only if, this channel is open.

read

public int read(ByteBuffer dst)
         throws IOException

Overrides the ReadableByteChannel.read(ByteBuffer). Reads a sequence of bytes from this channel into the given buffer.

???:

read ???? ReadableByteChannel

??:

dst - The buffer into which bytes are to be transferred.

??:

The number of bytes read, possibly zero, or -1 if the channel has reached end-of-stream.

??:

IOException - if an I/O error occurs.

getBufferSize

protected int getBufferSize()

Gets the buffer size.

??:

the bufferSize.

getKey

protected Key getKey()

Gets the key.

??:

the key.

getCipher

protected CryptoCipher getCipher()

Gets the internal CryptoCipher.

??:

the cipher instance.

getParams

protected AlgorithmParameterSpec getParams()

Gets the specification of cryptographic parameters.

??:

the params.

getInput

protected Input getInput()

Gets the input.

??:

the input.

initCipher

protected void initCipher()
                   throws IOException

Initializes the cipher.

??:

IOException - if an I/O error occurs.

decryptMore

protected int decryptMore()
                   throws IOException

Decrypts more data by reading the under layer stream. The decrypted data will be put in the output buffer. If the end of the under stream reached, we will do final of the cipher to finish all the decrypting of data.

??:

The number of decrypted data. -1 if end of the decrypted stream.

??:

IOException - if an I/O error occurs.

decrypt

protected void decrypt()
                throws IOException

Does the decryption using inBuffer as input and outBuffer as output. Upon return, inBuffer is cleared; the decrypted data starts at outBuffer.position() and ends at outBuffer.limit().

??:

IOException - if an I/O error occurs.

decryptFinal

protected void decryptFinal()
                     throws IOException

Does final of the cipher to end the decrypting stream.

??:

IOException - if an I/O error occurs.

checkStream

protected void checkStream()
                    throws IOException

Checks whether the stream is closed.

??:

IOException - if an I/O error occurs.

freeBuffers

protected void freeBuffers()

Forcibly free the direct buffers.