org.openmdx.base.stream.rmi.cci
Interface CharacterSource_1_0

All Superinterfaces:

Remote, Source_1_0

All Known Implementing Classes:

CharacterSource_1, CharacterSource_1, CharacterSource_1, CharacterSource_1Proxy, CharacterSource_1Proxy, CharacterSource_1Proxy

public interface CharacterSource_1_0
extends Remote, Source_1_0

The CharacterSource_1_0 interface defines the transport protocol for remote streams.

Method Summary

char[]

readCharacters(int capacity) Retrieves a copy of the specified substring in the CLOB value designated by this CLOB object.

Methods inherited from interface org.openmdx.base.stream.cci.Source_1_0

close, length

Method Detail

readCharacters

char[] readCharacters(int capacity)
                      throws IOException

Retrieves a copy of the specified substring in the CLOB value designated by this CLOB object. The substring begins at the specified position and has up to capaciy consecutive characters.

Parameters:

capacity - the number of consecutive characters to be copied

Returns:

a character array containing up to capacity consecutive characters from the CLOB; or null in case of an end of stream condition

Throws:

IOException - if an I/O error occurs.