com.entrust.toolkit.capi

Class CertChainContext

java.lang.Object

com.entrust.toolkit.capi.CapiHandle

com.entrust.toolkit.capi.CertChainContext

public class CertChainContext
extends CapiHandle

Represents a handle to a certificate chain in CAPI. Instances of this class are obtained by calling the getCertificateChain method of CertContext.

Since:

7.0

See Also:

CertContext.getCertificateChain(java.util.Date, com.entrust.toolkit.capi.CertStore, int)

Method Summary

Methods

Modifier and Type	Method and Description
protected void	addCertToChain(long certHandle) Adds a certificate to the chain.
void	close() Close the handle, releasing the certificate chain.
java.util.List<CertContext>	getCertChain() Returns an ordered list of CertContext objects that forms a chain to a root certificate.

Methods inherited from class com.entrust.toolkit.capi.CapiHandle

clearHandle, debugInfo, debugInfo, equals, finalize, getHandle, hashCode, setExtendedDebugging

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, toString, wait, wait, wait

Method Detail

close

public void close()

Close the handle, releasing the certificate chain. After this call, the handle cannot be used for any more native calls.

It is okay to call this method multiple times on the same object.

Specified by:

close in class CapiHandle

addCertToChain

protected void addCertToChain(long certHandle)

Adds a certificate to the chain. This is called from native code, and the handle belongs to a PCCERT_CHAIN_CONTEXT, which will be closed when the cert chain is released.

Parameters:

certHandle - A handle to the certificate context to be added to the chain.

getCertChain

public java.util.List<CertContext> getCertChain()

Returns an ordered list of CertContext objects that forms a chain to a root certificate. The first element in the list is the end-entity certificate, and the last element is the root certificate.

Note that the CertContext objects in the list do not need to be closed.

Returns:

a list of CertContext objects that forms a chain to a root certificate.