net.rim.device.api.crypto.cms
Class CMSSignedDataInputStream

java.lang.Object
  extended by java.io.InputStream
      extended by net.rim.device.api.crypto.cms.CMSInputStream
          extended by net.rim.device.api.crypto.cms.CMSSignedDataInputStream

public final class CMSSignedDataInputStream
extends CMSInputStream

Implements a CMS signed data input stream so that a message that has been signed in the CMS format can be properly parsed and verified.

See Also:
CMSSignedDataOutputStream
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

Field Summary
 
Fields inherited from class net.rim.device.api.crypto.cms.CMSInputStream
_contentType, _data, _input
 
Method Summary
Category: Signed  int available()
          Returns the number of bytes that can be read (or skipped over) from this input stream without blocking by the next caller of a method for this input stream.
Category: Signed  CMSSignedReceiptOutputStream createSignedReceiptStream(CMSSignedDataOutputStream output, CMSEntityIdentifier signer)
          Creates a CMSSignedReceiptOutputStream corresponding to the receipt request found in this CMSSignedDataInputStream.
Category: Signed  X509CertificateRevocationList getCRL()
          Returns the CRL found in this message.
Category: Signed  Certificate[] getCertificates()
          Returns an array of the certificates found in this message, or null if none are present.
Category: Signed  CMSReceiptData[] getReceiptInformation()
          Returns the CMSReceiptData necessary to verify the signed receipts you may make as a result of this message.
Category: Signed  String[] getSignedReceiptRequestors(CMSEntityIdentifier signer)
          Returns all of the strings representing the entities to send the signed receipts to.
Category: Signed  CMSAttribute getSignerAttribute(OID oid, CMSEntityIdentifier signer)
          Return the attribute, associated with the signer of this message, specified by this OID.
Category: Signed  Enumeration getSignerAttributes(CMSEntityIdentifier signer)
          Returns the attributes associated with the signer.
Category: Signed  Certificate getSignerCertificate(CMSEntityIdentifier signer)
          Returns the certificate of the first verified signer.
Category: Signed  Certificate[] getSignerCertificateChain(CMSEntityIdentifier signer)
          Returns the first certificate chain of the specified signer.
Category: Signed  Certificate[][] getSignerCertificateChains(CMSEntityIdentifier signer)
          Returns all of the certificate chain for the specified signer.
Category: Signed  CMSEntityIdentifier[] getSigners()
          Returns a list of all of the signers found in this message.
Category: Signed  boolean isCertificatePresent()
          Returns true if there are certificates in the message, else returns false.
Category: Signed  boolean isContentComplete()
          Determines whether the entire content part ( ie. the inner CMS message ) of this stream was in this stream.
Category: Signed  boolean isDataPresent()
          Returns true if the data has been set, either by being present in the message or else from a setData call.
Category: Signed  boolean isEncrypted()
          Determines if this part, or any nested part, of this CMS message is encrypted.
Category: Signed  boolean isSigned()
          Returns true since this message is signed.
Category: Signed  boolean isSignedReceipt()
          Returns true if the this signed data input stream contains a signed receipt.
Category: Signed  boolean isSignedReceiptRequested()
          A method to determine if any of the signers of this method are requesting a signed receipt for this message.
Category: Signed  boolean isSignedReceiptRequested(CMSEntityIdentifier signer, String recipient)
          A method to determine if recipient is required to send a signed receipt or not.
Category: Signed  boolean isSignerCertificatePresent(CMSEntityIdentifier signer)
          Returns true if the signer's certificate is present in the message.
Category: Signed  boolean isVerificationPossible()
          Returns a boolean to indicate whether or not enough data has been recieved to verify the signature on this message ( ie. all the signed data and the signatures ).
Category: Signed  int read(byte[] buffer, int offset, int length)
          Reads up to len bytes of data from the input stream into an array of bytes.
Category: Signed  void setData(InputStream data)
          Allows the user to set the stream where the signed data can be found.
Category: Signed  CMSReceiptData setReceiptData(CMSReceiptData[] receiptData)
          Set the receipt data for this stream.
Category: Signed  long skip(long n)
          Skips over and discards n bytes of data from this input stream.
Category: Signed  void verify(CMSEntityIdentifier signer)
          Verifies the signature on the message ( as well as any signatures on nested signed data messages ) specified by the signer.
 
Methods inherited from class net.rim.device.api.crypto.cms.CMSInputStream
close, getCMSContext, getCMSInputStream, getCMSInputStream, getCMSInputStream, getCMSInputStream, getCMSInputStream, getCMSInputStream, getCMSInputStream, getContentType, read, read
 
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

isVerificationPossible

public boolean isVerificationPossible()
Returns a boolean to indicate whether or not enough data has been recieved to verify the signature on this message ( ie. all the signed data and the signatures ). This does not indicate if the signature will verify, rather that enough data is present to try.

Returns:
a boolean to indicate if it is possible to verify this message.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

isSignerCertificatePresent

public boolean isSignerCertificatePresent(CMSEntityIdentifier signer)
                                   throws CMSNoSuchEntityException
Returns true if the signer's certificate is present in the message.

If the signer does not represent a signature on this message, then a CMSNoSuchEntityException exception is thrown.

Parameters:
signer - a CMSEntityIdentifier identifying the signer to check the certificate of.
Returns:
A boolean that returns true if the signer's certificate is present.
Throws:
CMSNoSuchEntityException - Thrown if signer does not represent a signature on the message.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

isSignedReceipt

public boolean isSignedReceipt()
Returns true if the this signed data input stream contains a signed receipt.

Returns:
True if the underlying stream is a signed receipt, otherwise false.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

isSignedReceiptRequested

public boolean isSignedReceiptRequested(CMSEntityIdentifier signer,
                                        String recipient)
                                 throws CMSNoSuchEntityException
A method to determine if recipient is required to send a signed receipt or not.

Parameters:
signer - The CMSEntityIdentifier used to decide which set of signed attributes to consider.
recipient - The recipient to look up to see if it needs a signed receipt.
Returns:
True if a signed receipt is requested, otherwise false.
Throws:
CMSNoSuchEntityException - Thrown if the entity identifier is not present in this signed message.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

isSignedReceiptRequested

public boolean isSignedReceiptRequested()
A method to determine if any of the signers of this method are requesting a signed receipt for this message.

Returns:
True if a signed receipt is requested, otherwise false.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

getReceiptInformation

public CMSReceiptData[] getReceiptInformation()
Returns the CMSReceiptData necessary to verify the signed receipts you may make as a result of this message. This method should only be called if signed receipts were requested on this message otherwise null will be returned.

Returns:
CMSReceiptData[] The array of CMSReceiptData necessary to verify the signed receipts you created. Will be null if no signed receipt request was added, or if some other error occurred.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

getSignedReceiptRequestors

public String[] getSignedReceiptRequestors(CMSEntityIdentifier signer)
                                    throws CMSNoSuchEntityException
Returns all of the strings representing the entities to send the signed receipts to. If no signed receipt is requested, null is returned.

Parameters:
signer - The CMSEntityIdentifier used to decode which set of signed attributes to consider.
Returns:
An array of strings representing who to send signed receipts to, otherwise null.
Throws:
CMSNoSuchEntityException - Thrown if the entity identifier is not present in this signed message.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

createSignedReceiptStream

public CMSSignedReceiptOutputStream createSignedReceiptStream(CMSSignedDataOutputStream output,
                                                              CMSEntityIdentifier signer)
                                                       throws CMSNoSuchEntityException,
                                                              CryptoUnsupportedOperationException
Creates a CMSSignedReceiptOutputStream corresponding to the receipt request found in this CMSSignedDataInputStream.

Parameters:
output - The CMSSignedDataOutputStream that the signed receipt will be contained in. You have to be sure, when you create the CMSSignedDataOutputStream, that you set it's content type to be CMSContentTypes.SIGNED_RECEIPT.
signer - The CMSEntityIdentifier which identifies the signed attributes that contain the receipt request.
Returns:
a CMSSignedReceiptOutputStream or null if there is no signed receipt request for signer or the output stream could not be created for some reason.
Throws:
CMSNoSuchEntityException - Thrown if the entity identifier is not present in this signed message.
CryptoUnsupportedOperationException - Thrown if the digest algorithm is not supported.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

setReceiptData

public CMSReceiptData setReceiptData(CMSReceiptData[] receiptData)
Set the receipt data for this stream. If this contains a signed receipt, the receiptData is necessary in order to verify the signature on this message. The stream will scan the array in order to find the specific CMSReceiptData object needed to verify this message.

Parameters:
receiptData - The CMSReceiptData[] needed to verify the message.
Returns:
CMSReceiptData The CMSReceiptData, from receiptData, that corresponds to the inner signed receipt. This will be null if the inner message is not a signed receipt, or no match is found.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

isSigned

public boolean isSigned()
Returns true since this message is signed.

Specified by:
isSigned in class CMSInputStream
Returns:
A boolean that returns true if this message is signed.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

isEncrypted

public boolean isEncrypted()
Description copied from class: CMSInputStream
Determines if this part, or any nested part, of this CMS message is encrypted.

Specified by:
isEncrypted in class CMSInputStream
Returns:
A boolean that represents whether the message part is encrypted.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

read

public int read(byte[] buffer,
                int offset,
                int length)
         throws IOException
Description copied from class: InputStream
Reads up to len 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.

Specified by:
read in class CMSInputStream
Parameters:
buffer - 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.
Returns:
the total number of bytes read into the buffer, or -1 if there is no more data because the end of the stream has been reached.
Throws:
IOException - if an I/O error occurs.
See Also:
InputStream.read()
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

available

public int available()
              throws IOException
Description copied from class: InputStream
Returns the number of bytes that can be read (or skipped over) from this input stream without blocking by the next caller of a method for this input stream. The next caller might be the same thread or or another thread.

The available method for class InputStream always returns 0.

This method should be overridden by subclasses.

Overrides:
available in class CMSInputStream
Returns:
the number of bytes that can be read from this input stream without blocking.
Throws:
IOException - if an I/O error occurs.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

skip

public long skip(long n)
          throws IOException
Description copied from class: InputStream
Skips over and discards n bytes of data from this input stream. The skip method may, for a variety of reasons, end up skipping over some smaller number of bytes, possibly 0. This may result from any of a number of conditions; reaching end of file before n bytes have been skipped is only one possibility. The actual number of bytes skipped is returned. If n is negative, no bytes are skipped.

The skip method of InputStream creates a byte array and then repeatedly reads into it until n bytes have been read or the end of the stream has been reached. Subclasses are encouraged to provide a more efficient implementation of this method.

Overrides:
skip in class CMSInputStream
Parameters:
n - the number of bytes to be skipped.
Returns:
the actual number of bytes skipped.
Throws:
IOException - if an I/O error occurs.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

isDataPresent

public boolean isDataPresent()
Returns true if the data has been set, either by being present in the message or else from a setData call.

Returns:
A boolean returns true if the data is present.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

setData

public void setData(InputStream data)
             throws IOException,
                    CMSException,
                    CryptoTokenException,
                    KeyStoreCancelException,
                    CryptoUnsupportedOperationException,
                    UnsupportedCryptoSystemException,
                    InvalidCryptoSystemException,
                    InvalidKeyException,
                    InvalidKeyEncodingException
Allows the user to set the stream where the signed data can be found.

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.

Specified by:
setData in class CMSInputStream
Parameters:
data - The input stream containing the data.
Throws:
IOException - Thrown if an I/O 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.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

getSignerCertificate

public Certificate getSignerCertificate(CMSEntityIdentifier signer)
                                 throws CMSNoSuchEntityException
Returns the certificate of the first verified signer.

If the signer does not represent a signature on this message, then a CMSNoSuchEntityException exception is thrown.

Parameters:
signer - a CMSEntityIdentifier identifying the signer to try and get the certificate of.
Returns:
The signer's certificate. May be null.
Throws:
CMSNoSuchEntityException - Thrown if signer does not represent a signature on the message.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

getSignerCertificateChain

public Certificate[] getSignerCertificateChain(CMSEntityIdentifier signer)
                                        throws CMSNoSuchEntityException
Returns the first certificate chain of the specified signer.

If the signer does not represent a signature on this message, then a CMSNoSuchEntityException exception is thrown.

Parameters:
signer - a CMSEntityIdentifier identifying the signer to try and get the certificate chain of.
Returns:
An array containing the signer's first certificate chain. May be null.
Throws:
CMSNoSuchEntityException - Thrown if signer does not represent a signature on the message.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

getSignerCertificateChains

public Certificate[][] getSignerCertificateChains(CMSEntityIdentifier signer)
                                           throws CMSNoSuchEntityException
Returns all of the certificate chain for the specified signer.

If the signer does not represent a signature on this message, then a CMSNoSuchEntityException exception is thrown.

Parameters:
signer - a CMSEntityIdentifier identifying the signer to try and get the certificate chain of.
Returns:
A double array containing all of the signer's certificate chain. May be null.
Throws:
CMSNoSuchEntityException - Thrown if signer does not represent a signature on the message.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.1.0

getCRL

public X509CertificateRevocationList getCRL()
                                     throws CRLEncodingException,
                                            CRLVerificationException,
                                            IOException,
                                            CryptoTokenException,
                                            CryptoUnsupportedOperationException
Returns the CRL found in this message. Note: The issuer of the CRL ( the CA of the signers certificate ) must be present in the verification keystore that was passed into the constructor of this class.

Returns:
The X509CertificateRevocationList found in this message. May be null.
Throws:
CRLEncodingException - Thrown if the crl was not encoded properly.
CRLVerificationException - Thrown if the response could not be verified. For example if the CRL issuer is not present in the verification keystore, or the verification keystore is null.
IOException - Thrown if an I/O error occurs.
CryptoTokenException - Thrown if an error occured with a crypto token.
CryptoUnsupportedOperationException - Thrown if a call is made to an unsupported operation.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

getSignerAttribute

public CMSAttribute getSignerAttribute(OID oid,
                                       CMSEntityIdentifier signer)
                                throws CMSNoSuchEntityException
Return the attribute, associated with the signer of this message, specified by this OID.

If the signer does not represent a signature on this message, then a CMSNoSuchEntityException exception is thrown.

Parameters:
oid - The OID used to specify the desired attribute.
signer - a CMSEntityIdentifier identifying the signature to pull attributes from
Returns:
A CMSAttribute corresponding to the OID. May be null.
Throws:
CMSNoSuchEntityException - Thrown if signer does not represent a signature on the message.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

getSignerAttributes

public Enumeration getSignerAttributes(CMSEntityIdentifier signer)
                                throws CMSNoSuchEntityException
Returns the attributes associated with the signer.

If the signer does not represent a signature on this message, then a CMSNoSuchEntityException exception is thrown.

Parameters:
signer - a CMSEntityIdentifier identifying the signature to pull attributes from
Returns:
An Enumeration of all of the CMSAttributes.
Throws:
CMSNoSuchEntityException - Thrown if signer does not represent a signature on the message.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

getCertificates

public Certificate[] getCertificates()
Returns an array of the certificates found in this message, or null if none are present.

Returns:
An array of all of the certificates found in the message. May be null.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

isCertificatePresent

public boolean isCertificatePresent()
Returns true if there are certificates in the message, else returns false.

Returns:
A boolean which is true if there are certificates in the message.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

verify

public void verify(CMSEntityIdentifier signer)
            throws CMSException,
                   CryptoTokenException,
                   CryptoUnsupportedOperationException
Verifies the signature on the message ( as well as any signatures on nested signed data messages ) specified by the signer.

If the signer does not represent a signature on this message, then a CMSNoSuchEntityException exception is thrown.

Parameters:
signer - a CMSEntityIdentifier identifying the signature to try and verify
Throws:
CMSException - Thrown if an error occurs while interpreting the data or if the signature did not verify.
CryptoTokenException - Thrown if an error occurs with a crypto token.
CryptoUnsupportedOperationException - Thrown if the operation was not supported.
CMSNoCertificateFoundException - Thrown if no certificate is found.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

getSigners

public CMSEntityIdentifier[] getSigners()
                                 throws CMSParsingException
Returns a list of all of the signers found in this message.

Returns:
An array of CMSEntityIdentifiers representing the signers of this message. May be null.
Throws:
CMSParsingException - Thrown if a CMS parsing error occurs.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0

isContentComplete

public boolean isContentComplete()
Description copied from class: CMSInputStream
Determines whether the entire content part ( ie. the inner CMS message ) of this stream was in this stream.

Specified by:
isContentComplete in class CMSInputStream
Returns:
True if the content is complete within this stream, false if it was cut-off.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 4.0.0





Copyright 1999-2011 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Java is a trademark of Oracle America Inc. in the US and other countries.
Legal