Class BERCharacterString

java.lang.Object

netscape.ldap.ber.stream.BERElement

netscape.ldap.ber.stream.BERCharacterString

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

BERNumericString, BERPrintableString, BERVisibleString

public abstract class BERCharacterString
extends BERElement

This is an abstract base class for character string types.

Version:

1.0 seeAlso CCITT X.209

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected String	m_value	Internal variables

Fields inherited from class BERElement

ANY, APPLICATION, BITSTRING, BOOLEAN, CHOICE, CONSTRUCTED, CONTEXT, ENUMERATED, EOC, EXOP_REQ_OID, EXOP_REQ_VALUE, EXOP_RES_OID, EXOP_RES_VALUE, GENERALSTRING, GRAPHICSTRING, IA5STRING, INTEGER, MRA_DNATTRS, MRA_OID, MRA_TYPE, MRA_VALUE, NULL, NUMERICSTRING, OBJECTID, OCTETSTRING, PRIMITIVE, PRINTABLESTRING, PRIVATE, REAL, SASLCONTEXT, SEQUENCE, SET, SK_MATCHRULE, SK_REVERSE, SR_ATTRTYPE, TAG, TELETEXSTRING, UNIVERSAL, UTCTIME, VIDEOTEXSTRING, VISIBLESTRING

Modifier and Type	Field	Description
static final int	ANY
static final int	APPLICATION
static final int	BITSTRING
static final int	BOOLEAN	Possible element types.
static final int	CHOICE
static final int	CONSTRUCTED
static final int	CONTEXT
static final int	ENUMERATED
static final int	EOC	Possible tags.
static final int	EXOP_REQ_OID
static final int	EXOP_REQ_VALUE
static final int	EXOP_RES_OID
static final int	EXOP_RES_VALUE
static final int	GENERALSTRING
static final int	GRAPHICSTRING
static final int	IA5STRING
static final int	INTEGER
static final int	MRA_DNATTRS
static final int	MRA_OID
static final int	MRA_TYPE
static final int	MRA_VALUE
static final int	NULL
static final int	NUMERICSTRING
static final int	OBJECTID
static final int	OCTETSTRING
static final int	PRIMITIVE
static final int	PRINTABLESTRING
static final int	PRIVATE
static final int	REAL
static final int	SASLCONTEXT
static final int	SEQUENCE
static final int	SET
static final int	SK_MATCHRULE
static final int	SK_REVERSE
static final int	SR_ATTRTYPE
static final int	TAG	Internal (non-transmitted) tags.
static final int	TELETEXSTRING
static final int	UNIVERSAL
static final int	UTCTIME
static final int	VIDEOTEXSTRING
static final int	VISIBLESTRING

Constructor Summary

Constructors

Constructor	Description
BERCharacterString()	Constructs a character string element containing a buffer.
BERCharacterString(byte[] buffer)	Constructs a character string element from a byte array.
BERCharacterString(InputStream stream, int[] bytes_read)	Constructs a character string element from an input stream (for primitive encoding)
BERCharacterString(String string)	Constructs a character string element containing buffer.
BERCharacterString(BERTagDecoder decoder, InputStream stream, int[] bytes_read)	Constructs a character string element from an input stream (for constructed encoding)

Method Summary

Modifier and Type	Method	Description
abstract int	getType()	Gets the element type.
String	getValue()	Gets the element value.
abstract String	toString()	Gets the string representation.
void	write(OutputStream stream)	Writes BER to stream.

Methods inherited from class BERElement

byteToHexString, getElement, readLengthOctets, readTwosComplement, readUnsignedBinary, sendDefiniteLength

Modifier and Type	Method	Description
String	byteToHexString(byte value)	Converts byte to hex string.
static BERElement	getElement(BERTagDecoder decoder, InputStream stream, int[] bytes_read)	Gets a ber element from the input stream.
static int	readLengthOctets(InputStream stream, int[] bytes_read)	Reads and decodes a length byte and then that many octets from the input stream.
protected int	readTwosComplement(InputStream stream, int[] bytes_read, int length)	Reads the two's complement representation of an integer from an input stream.
protected int	readUnsignedBinary(InputStream stream, int[] bytes_read, int length)	Reads a number of bytes from an input stream and form an integer..
static void	sendDefiniteLength(OutputStream stream, int num_content_octets)	Writes length octets (definite length only) to stream.

Methods inherited from class Object

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

Field Details

m_value

protected String m_value

Internal variables

Constructor Details

BERCharacterString

public BERCharacterString()

Constructs a character string element containing a buffer.

BERCharacterString

public BERCharacterString(String string)

Constructs a character string element containing buffer.

Parameters:

string - a string value

BERCharacterString

public BERCharacterString(byte[] buffer)

Constructs a character string element from a byte array.

Parameters:

buffer - buffer containing UTF8 data

BERCharacterString

public BERCharacterString(BERTagDecoder decoder,
 InputStream stream,
 int[] bytes_read)
                   throws IOException

Constructs a character string element from an input stream (for constructed encoding)

Parameters:

stream - input stream

bytes_read - array of 1 int, incremented by number of bytes read

Throws:

IOException - failed to construct

BERCharacterString

public BERCharacterString(InputStream stream,
 int[] bytes_read)
                   throws IOException

Constructs a character string element from an input stream (for primitive encoding)

Parameters:

stream - source

bytes_read - array of 1 int, incremented by number of bytes read

Throws:

IOException - failed to construct

Method Details

write

public void write(OutputStream stream)
           throws IOException

Writes BER to stream.

Specified by:

write in class BERElement

Parameters:

stream - output stream

Throws:

IOException

getValue

public String getValue()

Gets the element value.

getType

public abstract int getType()

Gets the element type.

Specified by:

getType in class BERElement

Returns:

element type.

toString

public abstract String toString()

Gets the string representation.

Specified by:

toString in class BERElement

Returns:

string representation.