net.sf.scuba.tlv

Class TLVInputStream

java.lang.Object

java.io.InputStream

net.sf.scuba.tlv.TLVInputStream

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class TLVInputStream
extends java.io.InputStream

An input-stream for parsing TLV structures that wraps an existing input-stream.

Constructor Summary

Constructors

Constructor and Description
TLVInputStream(java.io.InputStream inputStream) Constructs a new TLV stream based on another stream.

Method Summary

Modifier and Type	Method and Description
int	available() Returns an estimate of the number of bytes that can be read (or skipped over) from this input-stream without blocking by the next invocation of a method for this input-stream.
void	close() Closes this input-stream.
void	mark(int readLimit) Marks the underlying input-stream if supported.
boolean	markSupported() Whether marking and resetting are supported.
int	read() Reads the next byte of data from the input-stream.
int	readLength() Reads a length.
int	readTag() Reads a tag.
byte[]	readValue() Reads a value.
void	reset() Resets the underlying input-stream if supported.
long	skip(long n) Attempts to skip over n bytes.
void	skipToTag(int searchTag) Skips in this stream until a given tag is found (depth first).
java.lang.String	toString()

Methods inherited from class java.io.InputStream

read, read

Methods inherited from class java.lang.Object

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

Constructor Detail

TLVInputStream

public TLVInputStream(java.io.InputStream inputStream)

Constructs a new TLV stream based on another stream.

Parameters:

inputStream - a TLV object

Method Detail

readTag

public int readTag()
            throws java.io.IOException

Reads a tag.

Returns:

the tag just read

Throws:

java.io.IOException - if reading goes wrong

readLength

public int readLength()
               throws java.io.IOException

Reads a length.

Returns:

the length just read

Throws:

java.io.IOException - if reading goes wrong

readValue

public byte[] readValue()
                 throws java.io.IOException

Reads a value.

Returns:

the value just read

Throws:

java.io.IOException - if reading goes wrong

skipToTag

public void skipToTag(int searchTag)
               throws java.io.IOException

Skips in this stream until a given tag is found (depth first). The stream is positioned right after the first occurrence of the tag.

Parameters:

searchTag - the tag to search for

Throws:

java.io.IOException - on error

available

public int available()
              throws java.io.IOException

Returns an estimate of the number of bytes that can be read (or skipped over) from this input-stream without blocking by the next invocation of a method for this input-stream.

Overrides:

available in class java.io.InputStream

Returns:

a number of bytes

Throws:

java.io.IOException - if something goes wrong

read

public int read()
         throws java.io.IOException

Reads the next byte of data from the input-stream.

Specified by:

read in class java.io.InputStream

Returns:

a byte

Throws:

java.io.IOException - if reading goes wrong

skip

public long skip(long n)
          throws java.io.IOException

Attempts to skip over n bytes.

Overrides:

skip in class java.io.InputStream

Returns:

the actual number of bytes skipped

Throws:

java.io.IOException - if something goes wrong

mark

public void mark(int readLimit)

Marks the underlying input-stream if supported.

Overrides:

mark in class java.io.InputStream

Parameters:

readLimit - limit for marking

markSupported

public boolean markSupported()

Whether marking and resetting are supported. We support this whenever the underlying input-stream supports it.

Overrides:

markSupported in class java.io.InputStream

Returns:

whether mark and reset are supported

reset

public void reset()
           throws java.io.IOException

Resets the underlying input-stream if supported.

Overrides:

reset in class java.io.InputStream

Throws:

java.io.IOException - if something goes wrong

close

public void close()
           throws java.io.IOException

Closes this input-stream.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Overrides:

close in class java.io.InputStream

Throws:

java.io.IOException - if something goes wrong

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object