com.entrust.toolkit.x509.extensions

Class OldBasicConstraints

java.lang.Object

iaik.x509.V3Extension

iaik.x509.extensions.BasicConstraints

com.entrust.toolkit.x509.extensions.OldBasicConstraints

public class OldBasicConstraints
extends BasicConstraints

This class implements the OldBasicConstraints Extension.

The OldBasicConstraints extension is obsolete, and has been replaced by the BasicConstraints extension. It is provided here for backward compatibility with older certificates only.

The OldBasicConstraints OID is "2.5.29.10".

The ASN.1 definition of the OldBasicConstraints extension is specified as follows:

 OldBasicConstraints ::= SEQUENCE {
     subjectType             BIT_STRING,
     pathLenConstraint       INTEGER (0..MAX) OPTIONAL }
 

The subjectType field supports two meaningful bits. Bit 0 indicates a CA certificate, and bit 1 indicates an end-entity certificate. Exactly one of these bits must be set. Other patterns are not supported.

The pathLenConstraint field is identical in structure and meaning to the pathLenConstraint field in the BasicConstraints extension. Please refer to the BasicConstraints extension for usage details.

This class provides several methods for getting (but not setting) the component values of an OldBasicConstraints extension object.

See Also:

V3Extension, X509Certificate, BasicConstraints

Field Summary

Fields

Modifier and Type	Field and Description
static ObjectID	oid

Fields inherited from class iaik.x509.V3Extension

critical

Constructor Summary

Constructors

Constructor and Description
OldBasicConstraints() Default constructor.

Method Summary

Modifier and Type	Method and Description
boolean	ca() Returns true if the subject of the certificate holding this BasicConstraints extension is a CA.
ObjectID	getObjectID() Returns the object ID of this OldBasicConstraints extension
int	getPathLenConstraint() Returns the pathLenConstraint value of this OldBasicConstraints extension specifying the maximum number of CA certificates that may follow the certificate in a certification path.
int	hashCode() Returns a hashcode for this identity.
void	init(ASN1Object seq) Inits this OldBasicConstraints implementation with an ASN1Object representing the value of this extension.
ASN1Object	toASN1Object() Stub function to meet V3Extension criteria.
java.lang.String	toString() Returns a string that represents the contents of this OldBasicConstraints extension.

Methods inherited from class iaik.x509.extensions.BasicConstraints

setCa, setPathLenConstraint

Methods inherited from class iaik.x509.V3Extension

getName, isCritical, setCritical

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

oid

public static final ObjectID oid

Constructor Detail

OldBasicConstraints

public OldBasicConstraints()

Default constructor.

The OldBasicConstraints extension is obsolete and has been replaced by the BasicConstraints extension in the current X.509 specification.

Generating a new OldBasicConstraints extension is not supported. This class is provided for backward compatibility with existing certificates only.

Method Detail

getObjectID

public ObjectID getObjectID()

Returns the object ID of this OldBasicConstraints extension

Overrides:

getObjectID in class BasicConstraints

Returns:

the object ID

init

public void init(ASN1Object seq)
          throws X509ExtensionException

Inits this OldBasicConstraints implementation with an ASN1Object representing the value of this extension.

The ASN1Object is the extensionValue from ASN.1 type "Extension" representing the subjectType and (optional) pathLenConstraint values of this extension.

Overrides:

init in class BasicConstraints

Parameters:

seq - the extensionValue as an ASN1Object

Throws:

X509ExtensionException - if the extension could not be parsed

toASN1Object

public ASN1Object toASN1Object()

Stub function to meet V3Extension criteria. Returns null.

Overrides:

toASN1Object in class BasicConstraints

Returns:

the value of this BasicConstraints as ASN1Object

ca

public boolean ca()

Returns true if the subject of the certificate holding this BasicConstraints extension is a CA.

Overrides:

ca in class BasicConstraints

Returns:

true if the subject is a CA, false if not.

See Also:

BasicConstraints.setCa(boolean)

getPathLenConstraint

public int getPathLenConstraint()

Returns the pathLenConstraint value of this OldBasicConstraints extension specifying the maximum number of CA certificates that may follow the certificate in a certification path.

The pathLenConstraint field is meaningful only if the cA bit in the subjectType field is set. If cA bit is set and pathLenConstraint is set, this method returns the maximum number of CA certificates that may follow the certificate in a certification path.

If cA bit is set and pathLenConstraint is not specified, this method returns -1 indicating that there is no limit to the allowed length of the certification path.

Overrides:

getPathLenConstraint in class BasicConstraints

Returns:

the pathLenConstraint value.

See Also:

BasicConstraints.setPathLenConstraint(int)

hashCode

public int hashCode()

Returns a hashcode for this identity.

Overrides:

hashCode in class BasicConstraints

Returns:

a hash code for this identity

toString

public java.lang.String toString()

Returns a string that represents the contents of this OldBasicConstraints extension.

Overrides:

toString in class BasicConstraints

Returns:

the string representation