sqlj.runtime.CharacterStream 

sqlj.runtime.CharacterStream extends java.io.FilterReader

A class derived from java.io.FilterReader whose instances contain Unicode data. When an instance of this class is passed as an input argument to an invocation of an SQL operation, the length of the Reader object must be specified. Therefore, an instance of the Reader class cannot be passed directly, but rather shall be an instance of CharacterStream.

A CharacterStream object can only be used once as an in parameter of a SQL operation, because the operation will consume the stream.

Constructors

public CharacterStream (Reader in)

Creates a new CharacterStream object using the given Reader object in. The length of the CharacterStream object is uninitialized. The length must be set by a call to setLength() before use of a CharacterStream object as an IN (or INOUT) parameter in an invocation of an SQL operation.

public CharacterStream (Reader in, int length)

Creates a new CharacterStream object using the given Reader object in. The length of the CharacterStream object is initialized to the value length.

Methods

public Reader getReader ()

Returns the underlying Reader object wrapped by the CharacterStream object.

public int getLength()

Returns the length in characters of the wrapped Reader object, as specified during construction or in the last call to setLength(). If the length is uninitialized, -1 is returned.