java.io.InputStream
net.rim.device.api.crypto.cms.CMSInputStream
net.rim.device.api.crypto.cms.CMSSignedReceiptInputStream
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Object
public final class CMSSignedReceiptInputStream
A CMSSignedReceiptInputStream allows the user to read in a signed receipt and process it properly.
CMSSignedReceiptOutputStream| Field Summary |
|---|
| Fields inherited from class net.rim.device.api.crypto.cms.CMSInputStream |
|---|
_contentType, _data, _input |
| Method Summary | ||
|---|---|---|
|
OID |
getReceiptContentType()
Returns the content type of the original email this receipt covers. |
|
byte[] |
getSignature()
Returns the encoding of the signature from the original message this receipt covers. |
|
byte[] |
getSignedContentIdentifier()
Returns the signed content identifier of this receipt. |
|
boolean |
isContentComplete()
Determines whether the entire content part ( ie. the inner CMS message ) of this stream was in this stream. |
|
boolean |
isEncrypted()
Determines if this part, or any nested part, of this CMS message is encrypted. |
|
boolean |
isSigned()
Determines if this part, or any nested part, of this CMS message is signed. |
|
int |
read(byte[] data,
int offset,
int length)
Reads up to len bytes of data from the input stream into
an array of bytes. |
|
void |
setData(InputStream data)
Allows the user to set the stream where the compressed data can be found. |
| Methods inherited from class net.rim.device.api.crypto.cms.CMSInputStream |
|---|
available, close, getCMSContext, getCMSInputStream, getCMSInputStream, getCMSInputStream, getCMSInputStream, getCMSInputStream, getCMSInputStream, getCMSInputStream, getContentType, read, read, skip |
| Methods inherited from class java.io.InputStream |
|---|
mark, markSupported, reset |
| Methods inherited from class java.lang.Object |
|---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Method Detail |
|---|
public OID getReceiptContentType()
public byte[] getSignedContentIdentifier()
public byte[] getSignature()
public boolean isEncrypted()
CMSInputStream
isEncrypted in class CMSInputStreampublic boolean isSigned()
CMSInputStream
isSigned in class CMSInputStream
public int read(byte[] data,
int offset,
int length)
InputStreamlen bytes of data from the input stream into
an array of bytes. An attempt is made to read as many as
len bytes, but a smaller number may be read, possibly
zero. The number of bytes actually read is returned as an integer.
This method blocks until input data is available, end of file is detected, or an exception is thrown.
If b is null, a
NullPointerException is thrown.
If off is negative, or len is negative, or
off+len is greater than the length of the array
b, then an IndexOutOfBoundsException is
thrown.
If len is zero, then no bytes are read and
0 is returned; otherwise, there is an attempt to read at
least one byte. If no byte is available because the stream is at end of
file, the value -1 is returned; otherwise, at least one
byte is read and stored into b.
The first byte read is stored into element b[off], the
next one into b[off+1], and so on. The number of bytes read
is, at most, equal to len. Let k be the number of
bytes actually read; these bytes will be stored in elements
b[off] through b[off+k-1],
leaving elements b[off+k] through
b[off+len-1] unaffected.
In every case, elements b[0] through
b[off] and elements b[off+len] through
b[b.length-1] are unaffected.
If the first byte cannot be read for any reason other than end of
file, then an IOException is thrown. In particular, an
IOException is thrown if the input stream has been closed.
The read(b, off, len) method
for class InputStream simply calls the method
read() repeatedly. If the first such call results in an
IOException, that exception is returned from the call to
the read(b, off, len) method. If
any subsequent call to read() results in a
IOException, the exception is caught and treated as if it
were end of file; the bytes read up to that point are stored into
b and the number of bytes read before the exception
occurred is returned. Subclasses are encouraged to provide a more
efficient implementation of this method.
read in class CMSInputStreamdata - the buffer into which the data is read.offset - the start offset in array b
at which the data is written.length - the maximum number of bytes to read.
-1 if there is no more data because the end of
the stream has been reached.InputStream.read()
public void setData(InputStream data)
throws IOException,
CMSException,
CryptoTokenException,
KeyStoreCancelException,
CryptoUnsupportedOperationException,
UnsupportedCryptoSystemException,
InvalidCryptoSystemException,
InvalidKeyException,
InvalidKeyEncodingException
You would call this function in the case that the contents of the message is detached from the actual CMS encoding. For example, in a clear signed SMIME message, the text ( what is signed ) is in a different MIME part then the CMS encoding. You could use this function to give CMS an input stream that points to the MIME part containing the text of the message.
setData in class CMSInputStreamdata - The input stream containing the data.
IOException - Thrown if an IO error occurs.
CMSException - Thrown if a cms error occurs.
CryptoTokenException - Thrown if an error occurs with a crypto
token or the crypto token is invalid.
KeyStoreCancelException - Thrown if the user fails to enter a
password or the password is invalid.
CryptoUnsupportedOperationException - Thrown if a call is made to an
unsupported operation.
UnsupportedCryptoSystemException - Thrown if the specified crypto
system is invalid.
InvalidCryptoSystemException - Thrown if the specified crypto
system is invalid.
InvalidKeyException - Thrown if the specified key is invalid.
InvalidKeyEncodingException - Thrown if the key is improperly formatted.public boolean isContentComplete()
isContentComplete in class CMSInputStream
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.