netscape.ldap.ber.stream
Class BERTag

java.lang.Object
  |
  +--netscape.ldap.ber.stream.BERElement
        |
        +--netscape.ldap.ber.stream.BERTag

All Implemented Interfaces:

java.io.Serializable

public class BERTag

extends BERElement

This class is for the tagged object type. A nested tag is allowed. A tagged element contains another ber element.

 ENCODING RULE:
  tag    = whatever it is constructed with
 

See Also:

Serialized Form

Field Summary

Fields inherited from class netscape.ldap.ber.stream.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

Constructor Summary

BERTag(BERTagDecoder decoder, int tag, java.io.InputStream stream, int[] bytes_read)
Constructs a tag element from an input stream.

BERTag(int tag, BERElement element, boolean implicit)
Constructs a tag element.

Method Summary

int	getTag() Gets the element tag.
int	getType() Gets the element type.
BERElement	getValue() Gets the element from the tagged object.
void	setImplicit(boolean value) Sets the implicit tag.
java.lang.String	toString() Gets the string representation.
void	write(java.io.OutputStream stream) Sends the BER encoding directly to a stream.

Methods inherited from class netscape.ldap.ber.stream.BERElement

byteToHexString, getElement, readLengthOctets, readTwosComplement, readUnsignedBinary, sendDefiniteLength

Methods inherited from class java.lang.Object

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

Constructor Detail

BERTag

public BERTag(int tag,
              BERElement element,
              boolean implicit)

Constructs a tag element.

Parameters:

tag - tag value

element - ber element

implicit - tagged implicitly

BERTag

public BERTag(BERTagDecoder decoder,
              int tag,
              java.io.InputStream stream,
              int[] bytes_read)
       throws java.io.IOException

Constructs a tag element from an input stream.

Parameters:

decoder - decoder object for application-specific tags

tag - tag value; already stripped from stream

stream - source

bytes_read - array of 1 int; incremented by number of bytes read from stream

Throws:

java.io.IOException - failed to construct

Method Detail

getValue

public BERElement getValue()

Gets the element from the tagged object.

Returns:

BER element.

setImplicit

public void setImplicit(boolean value)

Sets the implicit tag. If it is an implicit tag, the next element tag can be omitted (it will not be sent to a stream or buffer).

Parameters:

value - implicit flag

write

public void write(java.io.OutputStream stream)
           throws java.io.IOException

Sends the BER encoding directly to a stream.

Specified by:

write in class BERElement

Parameters:

stream - output stream

Returns:

bytes written to stream.

Throws:

java.io.IOException - failed to send

getType

public int getType()

Gets the element type.

Specified by:

getType in class BERElement

Returns:

element type.

getTag

public int getTag()

Gets the element tag.

Returns:

element tag.

toString

public java.lang.String toString()

Gets the string representation.

Specified by:

toString in class BERElement

Returns:

string representation of tag.