iaik.asn1

Class BOOLEAN

java.lang.Object

iaik.asn1.ASN1Object

iaik.asn1.BOOLEAN

public class BOOLEAN
extends ASN1Object

This class implements the native ASN.1 type "BOOLEAN". BOOLEAN is a simple non-string ASN.1 type represented by the UNIVERSAL TAG number 1. Possible values are TRUE and FALSE.

For supplying a Java boolean value when creating a new BOOLEAN object, an application shall use the corresponding BOOLEAN(boolean value) constructor, e.g:

 boolean value = true;
 BOOLEAN asn1Boolean = new BOOLEAN(boolean_value);
 

When calling the getValue method for getting the inherent value from an ASN.1 BOOLEAN instance, a Java object of type Boolean is returned:

 Boolean boolValue = (Boolean)asn1Boolean.getValue();
 boolean value = boolValue.booleanValue();
 

DER en/decoding generally is done by means of the several methods of the DerCoder class; decoding alternatively may be performed by using the DerInputStream utility.

See Also:

ASN1Object, ASN

Field Summary

Fields inherited from class iaik.asn1.ASN1Object

asnType, constructed, encode_listener, indefinite_length, isStringType, stream_mode

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BOOLEAN() Creates an empty object.
	BOOLEAN(boolean value) Creates a new ASN.1 BOOLEAN object for the given Java boolean value.

Method Summary

Modifier and Type	Method and Description
protected void	decode(int length, java.io.InputStream is) Decodes a BOOLEAN value from the given InputStream.
protected void	encode(java.io.OutputStream os) DER encodes this BOOLEAN ASN1Object and writes the result to the given output stream.
java.lang.Object	getValue() Returns the value of this BOOLEAN as a Java object of type Boolean.
void	setValue(java.lang.Object value) Sets the value of this BOOLEAN.
java.lang.String	toString() Returns a string that represents the contents of this BOOLEAN ASN.1 object.

Methods inherited from class iaik.asn1.ASN1Object

addComponent, addEncodeListener, countComponents, encodeObject, getAsnType, getComponentAt, indefiniteLength, isA, isConstructed, isStringType, setAutomaticRepair, setAutomaticRepairRecursive, setIndefiniteLength, setIndefiniteRecursive

Methods inherited from class java.lang.Object

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

Constructor Detail

BOOLEAN

protected BOOLEAN()

Creates an empty object.

BOOLEAN

public BOOLEAN(boolean value)

Creates a new ASN.1 BOOLEAN object for the given Java boolean value.

Parameters:

value - the boolean value this BOOLEAN object should represent

Method Detail

getValue

public java.lang.Object getValue()

Returns the value of this BOOLEAN as a Java object of type Boolean.

Specified by:

getValue in class ASN1Object

Returns:

the value of this BOOLEAN as a Boolean object

setValue

public void setValue(java.lang.Object value)

Sets the value of this BOOLEAN. The supplied value has to be a Java object of type Boolean.

Specified by:

setValue in class ASN1Object

Parameters:

value - the Java Boolean value to be set for this BOOLEAN object

encode

protected void encode(java.io.OutputStream os)
               throws java.io.IOException

DER encodes this BOOLEAN ASN1Object and writes the result to the given output stream. This is a protected method and will not be used by an application for DER encoding a BOOLEAN object. An application will call one of the encode methods of the DerCoder class for performing the encoding, and the DerCoder internally will call this encode method.

Specified by:

encode in class ASN1Object

Parameters:

os - the output stream to which to write the data

Throws:

java.io.IOException - if an I/O error occurs while writing to the stream

decode

protected void decode(int length,
                      java.io.InputStream is)
               throws java.io.IOException,
                      CodingException

Decodes a BOOLEAN value from the given InputStream. The given input stream carries DER encoded data, and the next length bytes to be read represent the value of an ASN.1 object of type BOOLEAN.

This is a protected method and will not be used by an application for decoding a DER encoded BOOLEAN. An application will call one of the decode methods of the DerCoder class for performing the decoding. The DerCoder then determines the number of bytes (length) occupied by the value of this BOOLEAN object and internally calls this decode method for actually reading the value.

Specified by:

decode in class ASN1Object

Parameters:

length - the already decoded length, i.e. number of the bytes representing the value of the BOOLEAN to be decoded; since a BOOLEAN value only will occupy one byte, length has to be 1

is - the input stream from which the DER encoded data is read in

Throws:

java.io.IOException - if there is a problem with the InputStream

CodingException - if some decodeding error occurs, e.g. the supplied length is not equal to 1

toString

public java.lang.String toString()

Returns a string that represents the contents of this BOOLEAN ASN.1 object.

Overrides:

toString in class ASN1Object

Returns:

the string representation