net.rim.device.api.crypto.certificate.status
Class CertificateStatusUtilities

java.lang.Object
  net.rim.device.api.crypto.certificate.status.CertificateStatusUtilities

public class CertificateStatusUtilities
extends Object

Provides various utility methods for working with CertificateStatus objects.

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.2

Method Summary
	static int	compareStatusCertificate(CertificateStatus object1, CertificateStatus object2) Compares two CertificateStatus objects and indicates which is more important in this context.
	static int	compareStatusCertificateChain(CertificateStatus object1, CertificateStatus object2) Compares two CertificateStatus objects and indicates which is more important in this context.

Methods inherited from class java.lang.Object

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

Method Detail

compareStatusCertificate

public static int compareStatusCertificate(CertificateStatus object1,
                                           CertificateStatus object2)

Compares two CertificateStatus objects and indicates which is more important in this context. This method should be used when comparing multiple statuses for the same Certificate. If the two objects and have the same status, the one that was produced most recently is considered the most important. Otherwise,

1. if the first object has a status of UNKNOWN, it is never considered more important,
2. if the first object has a status of GOOD, is is considered more important unless the second object has a status of REVOKED, and
3. if the first object has a status of REVOKED, it is always considered more important.

Parameters:

status1 - the first object that should be used for the comparison

status2 - the second object that should be used for the comparison

Returns:

1 if the first object is considered more important, 0 if the two objects are considered equally important, and -1 if the second object is considered more important

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.2

compareStatusCertificateChain

public static int compareStatusCertificateChain(CertificateStatus object1,
                                                CertificateStatus object2)

Compares two CertificateStatus objects and indicates which is more important in this context. This method should be used when comparing the statuses of Certificates in a chain. If the two objects and have the same status, the one that was produced least recently is considered the most important. Otherwise,

1. if the first object has a status of UNKNOWN, it is considered more important unless the second object has a status of REVOKED,
2. if the first object has a status of GOOD, is is never considered more important, and
3. if the first object has a status of REVOKED, it is always considered more important.

Parameters:

status1 - the first object that should be used for the comparison

status2 - the second object that should be used for the comparison

Returns:

1 if the first object is considered more important, 0 if the two objects are considered equally important, and -1 if the second object is considered more important

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.2