public class

BuildStep

extends Object
java.lang.Object
   ↳ sun.security.provider.certpath.BuildStep

Class Overview

Describes one step of a certification path build, consisting of a Vertex state description, a certificate, a possible throwable, and a result code.

See Also

Summary

Constants
int BACK result code associated with a certificate that was tried, but that represents an unsuccessful path, so the certificate has been backed out to allow backtracking to the next possible path.
int FAIL result code associated with a certificate that represents the end of the last possible path, where no path successfully reached the target.
int FOLLOW result code associated with a certificate that successfully continues the current path, but does not yet reach the target.
int POSSIBLE result code associated with a certificate that may continue a path from the current certificate.
int SUCCEED result code associated with a certificate that represents the end of a path that successfully reaches the target.
Public Constructors
BuildStep(Vertex vtx, int res)
construct a BuildStep
Public Methods
String fullToString()
return a string representation of this build step, including all possible detail of the vertex state, but not including the certificate contents.
X509Certificate getCertificate()
return the certificate associated with this build step
String getIssuerName(String defaultName)
return string form of issuer name from certificate associated with this build step, or a default name if no certificate associated with this build step, or if issuer name could not be obtained from the certificate.
String getIssuerName()
return string form of issuer name from certificate associated with this build step
int getResult()
return the result code associated with this build step.
String getSubjectName(String defaultName)
return string form of subject name from certificate associated with this build step, or a default name if no certificate associated with this build step, or if subject name could not be obtained from the certificate.
String getSubjectName()
return string form of subject name from certificate associated with this build step.
Throwable getThrowable()
return the exception associated with this build step.
Vertex getVertex()
return vertex description for this build step
String resultToString(int res)
return a string representing the meaning of the result code associated with this build step.
String toString()
return a string representation of this build step, showing minimal detail.
String verboseToString()
return a string representation of this build step, showing all detail of the vertex state appropriate to the result of this build step, and the certificate contents.
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final int BACK

result code associated with a certificate that was tried, but that represents an unsuccessful path, so the certificate has been backed out to allow backtracking to the next possible path.

Constant Value: 2 (0x00000002)

public static final int FAIL

result code associated with a certificate that represents the end of the last possible path, where no path successfully reached the target.

Constant Value: 4 (0x00000004)

public static final int FOLLOW

result code associated with a certificate that successfully continues the current path, but does not yet reach the target.

Constant Value: 3 (0x00000003)

public static final int POSSIBLE

result code associated with a certificate that may continue a path from the current certificate.

Constant Value: 1 (0x00000001)

public static final int SUCCEED

result code associated with a certificate that represents the end of a path that successfully reaches the target.

Constant Value: 5 (0x00000005)

Public Constructors

public BuildStep (Vertex vtx, int res)

construct a BuildStep

Parameters
vtx description of the vertex at this step
res result, where result is one of POSSIBLE, BACK, FOLLOW, FAIL, SUCCEED

Public Methods

public String fullToString ()

return a string representation of this build step, including all possible detail of the vertex state, but not including the certificate contents.

public X509Certificate getCertificate ()

return the certificate associated with this build step

public String getIssuerName (String defaultName)

return string form of issuer name from certificate associated with this build step, or a default name if no certificate associated with this build step, or if issuer name could not be obtained from the certificate.

Parameters
defaultName name to use as default if unable to return an issuer name from the certificate, or if no certificate.

public String getIssuerName ()

return string form of issuer name from certificate associated with this build step

public int getResult ()

return the result code associated with this build step. The result codes are POSSIBLE, FOLLOW, BACK, FAIL, SUCCEED.

public String getSubjectName (String defaultName)

return string form of subject name from certificate associated with this build step, or a default name if no certificate associated with this build step, or if subject name could not be obtained from the certificate.

Parameters
defaultName name to use as default if unable to return a subject name from the certificate, or if no certificate.

public String getSubjectName ()

return string form of subject name from certificate associated with this build step.

public Throwable getThrowable ()

return the exception associated with this build step.

public Vertex getVertex ()

return vertex description for this build step

public String resultToString (int res)

return a string representing the meaning of the result code associated with this build step.

Parameters
res result code

public String toString ()

return a string representation of this build step, showing minimal detail.

Returns
  • a string representation of the object.

public String verboseToString ()

return a string representation of this build step, showing all detail of the vertex state appropriate to the result of this build step, and the certificate contents.