com.infoengine.object
Class IeInputStream

java.lang.Object
  java.io.InputStream
      com.infoengine.object.IeInputStream

All Implemented Interfaces:

java.io.Closeable

Direct Known Subclasses:

IeMultipartInputStream

public class IeInputStream
extends java.io.InputStream

This class implements a buffered input stream class for Info*Engine.

Version:

1.0 12/7/99

Constructor Summary

IeInputStream()
Constructs an instance that is not initially associated with an input stream.

IeInputStream(java.io.InputStream is)
Constructs an instance that reads from a specific input stream.

Method Summary

int	available() Returns the number of bytes that can be read without blocking.
void	close() Closes the input stream and releases all resources allocated to it.
java.io.InputStream	getInputStream() Returns the input stream currently associated with this object.
void	mark(int readLimit) Marks the current position in the input stream.
boolean	markSupported() Returns an indication of support for input stream marking.
int	read() Returns a byte from the input stream.
int	read(byte[] b) Reads bytes from the input stream into an array.
int	read(byte[] b, int off, int len) Read bytes from the input stream into an array or subarray.
java.lang.String	readLine() Reads a line of text from the input stream using the default character encoding for the platform.
java.lang.String	readLine(java.lang.String encoding) Read a line of text from the input stream using a specified character encoding.
void	reset() Resets the input stream to the position of the last mark set.
void	setInputStream(java.io.InputStream is) Sets the input stream associated with this object.
long	skip(long n) Reads and discards bytes from the input stream.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IeInputStream

public IeInputStream()

Constructs an instance that is not initially associated with an input stream. Use setInputStream to associate the instance with an input stream.

IeInputStream

public IeInputStream(java.io.InputStream is)

Constructs an instance that reads from a specific input stream.

Parameters:

is - The input stream to read.

Method Detail

available

public int available()
              throws java.io.IOException

Returns the number of bytes that can be read without blocking.

Overrides:

available in class java.io.InputStream

Returns:

The number of bytes that can be read without blocking.

Throws:

java.io.IOException - if the number of available bytes can not be determined.

close

public void close()
           throws java.io.IOException

Closes the input stream and releases all resources allocated to it.

Specified by:

close in interface java.io.Closeable

Overrides:

close in class java.io.InputStream

Throws:

java.io.IOException - if the output stream can not be closed.

mark

public void mark(int readLimit)

Marks the current position in the input stream.

Overrides:

mark in class java.io.InputStream

Parameters:

readLimit - The position to be marked.

markSupported

public boolean markSupported()

Returns an indication of support for input stream marking.

Overrides:

markSupported in class java.io.InputStream

Returns:

true if marking is supported.

read

public int read()
         throws java.io.IOException

Returns a byte from the input stream.

Specified by:

read in class java.io.InputStream

Returns:

The next byte from input stream, or -1 if the stream is positioned at end of file.

Throws:

java.io.IOException - if the input stream can not be read.

read

public int read(byte[] b)
         throws java.io.IOException

Reads bytes from the input stream into an array. This method blocks until the array can be filled, or the end of the stream is reached.

Overrides:

read in class java.io.InputStream

Parameters:

b - The array in which to store the bytes read.

Returns:

The number of bytes stored in the array, or -1 if the input stream is positioned at end of file.

Throws:

java.io.IOException - if the input stream can not be read.

read

public int read(byte[] b,
                int off,
                int len)
         throws java.io.IOException

Read bytes from the input stream into an array or subarray. This method blocks until the maximum specified number of bytes are read, or the end of the stream is reached.

Overrides:

read in class java.io.InputStream

Parameters:

b - The array in which to store the bytes read.

off - The offset in the array at which to begin storing bytes.

len - The maximum number of bytes to read.

Returns:

The number of bytes read, or -1 if the input stream is positioned at end of file.

Throws:

java.io.IOException - if the input stream can not be read.

readLine

public java.lang.String readLine()
                          throws java.io.IOException

Reads a line of text from the input stream using the default character encoding for the platform.

Returns:

The line of text read, with end of line sequence removed, or null if the stream is positioned at end of file.

Throws:

java.io.IOException - if the input stream can not be read.

readLine

public java.lang.String readLine(java.lang.String encoding)
                          throws java.io.IOException

Read a line of text from the input stream using a specified character encoding.

Parameters:

encoding - the character encoding to apply to the connection

Returns:

A line of text with end of line sequence removed

Throws:

java.io.IOException

reset

public void reset()
           throws java.io.IOException

Resets the input stream to the position of the last mark set.

Overrides:

reset in class java.io.InputStream

Throws:

java.io.IOException - if the input stream can not be reset.

skip

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

Reads and discards bytes from the input stream.

Overrides:

skip in class java.io.InputStream

Parameters:

n - The number of bytes to read and discard.

Returns:

The actual number of bytes read and discarded.

Throws:

java.io.IOException - if the input stream can not be read.

setInputStream

public void setInputStream(java.io.InputStream is)

Sets the input stream associated with this object.

Parameters:

is - The input stream to associate with this object.

getInputStream

public java.io.InputStream getInputStream()

Returns the input stream currently associated with this object.

Returns:

The input stream currently associated with this object.