|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.security.cert.CertPathBuilder
public class CertPathBuilder
This class builds certificate paths (also called certificate chains), which can be used to establish trust for a particular certificate by building a path from a trusted certificate (a trust anchor) to the untrusted certificate.
CertPath
Constructor Summary | |
---|---|
protected |
CertPathBuilder(CertPathBuilderSpi cpbSpi,
Provider provider,
String algorithm)
Creates a new CertPathBuilder. |
Method Summary | |
---|---|
CertPathBuilderResult |
build(CertPathParameters params)
Builds a certificate path. |
String |
getAlgorithm()
Return the name of this CertPathBuilder algorithm. |
static String |
getDefaultType()
Get the default cert path builder type. |
static CertPathBuilder |
getInstance(String algorithm)
Returns an instance of a named CertPathBuilder from the
first provider that implements it. |
static CertPathBuilder |
getInstance(String algorithm,
Provider provider)
Returns an instance of a named CertPathBuilder from the
specified provider. |
static CertPathBuilder |
getInstance(String algorithm,
String provider)
Returns an instance of a named CertPathBuilder from a named
provider. |
Provider |
getProvider()
Return the provider of this instance's implementation. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
protected CertPathBuilder(CertPathBuilderSpi cpbSpi, Provider provider, String algorithm)
cpbSpi
- The underlying implementation.provider
- The provider of the implementation.algorithm
- This implementation's name.Method Detail |
---|
public static final String getDefaultType()
This value can be set at run-time by the security property
"certpathbuilder.type"
. If this property is not set,
then the value returned is "PKIX"
.
public static CertPathBuilder getInstance(String algorithm) throws NoSuchAlgorithmException
CertPathBuilder
from the
first provider that implements it.
algorithm
- The name of the CertPathBuilder
to create.
NoSuchAlgorithmException
- If no installed provider implements the
named algorithm.
IllegalArgumentException
- if algorithm
is
null
or is an empty string.public static CertPathBuilder getInstance(String algorithm, String provider) throws NoSuchAlgorithmException, NoSuchProviderException
CertPathBuilder
from a named
provider.
algorithm
- The name of the CertPathBuilder
to create.provider
- The name of the provider to use.
NoSuchAlgorithmException
- If no installed provider implements the
named algorithm.
NoSuchProviderException
- If the named provider does not exist.
IllegalArgumentException
- if either algorithm
or
provider
is null
, or if
algorithm
is an empty string.public static CertPathBuilder getInstance(String algorithm, Provider provider) throws NoSuchAlgorithmException
CertPathBuilder
from the
specified provider.
algorithm
- The name of the CertPathBuilder
to create.provider
- The provider to use.
NoSuchAlgorithmException
- If no installed provider implements the
named algorithm.
IllegalArgumentException
- if either algorithm
or
provider
is null
, or if
algorithm
is an empty string.public final String getAlgorithm()
public final Provider getProvider()
public final CertPathBuilderResult build(CertPathParameters params) throws CertPathBuilderException, InvalidAlgorithmParameterException
CertPathParameters
parameter
passed to this method is implementation-specific, but in general
should contain some number of certificates and some number of
trusted certificates (or "trust anchors").
params
- The parameters.
CertPathBuilderException
- If the certificate path cannot be
built.
InvalidAlgorithmParameterException
- If the implementation
rejects the specified parameters.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |