ej.ecom.io

Interface CommConnection

All Superinterfaces:

Connection, InputConnection, OutputConnection, StreamConnection

public interface CommConnection
extends StreamConnection

This interface defines a Connection to a logical serial port, which is a StreamConnection. There is no way from this side of the connection to know the connection state on the other side (particularly, closing the other side has no effect on this side; a thread blocked on InputStream.read() will infinitely block).

The generic URL format described in Connector is specified as following:

• protocol: comm
• name: the CommPort name
• params: optional connection parameters in the following list
• baudrate: positive integer (9600 by default)
• bitsperchar: positive integer (8 by default)
• stopbits:1|2|1.5 (1 by default)
• parity:odd|even|none (none by default)

Method Summary

Modifier and Type	Method and Description
int	getBaudrate() Gets the current configured baudrate.
InputStream	openInputStream() Returns an InputStream which implements the BitsInput interface.
OutputStream	openOutputStream() Returns an OutputStream which implements the BitsOutput interface.
int	setBaudrate(int baudrate) Configures the baudrate.

Methods inherited from interface ej.ecom.io.InputConnection

openDataInputStream

Methods inherited from interface ej.ecom.io.OutputConnection

openDataOutputStream

Methods inherited from interface ej.ecom.io.Connection

close

Method Detail

getBaudrate

int getBaudrate()

Gets the current configured baudrate.

Returns:

the current configured baudrate.

setBaudrate

int setBaudrate(int baudrate)

Configures the baudrate. If the given baudrate cannot be configured, connection is configured with valid baudrate that can be retrieved by getBaudrate().

Parameters:

baudrate - the new baudrate

Returns:

the previous baudrate.

openInputStream

InputStream openInputStream()
                     throws IOException

Returns an InputStream which implements the BitsInput interface. This implementation is useful when this Connection supports more than 8 bits per frame.

Specified by:

openInputStream in interface InputConnection

Returns:

the open InputStream.

Throws:

IOException - if a stream is already open

openOutputStream

OutputStream openOutputStream()
                       throws IOException

Returns an OutputStream which implements the BitsOutput interface. This implementation is useful when this Connection supports more than 8 bits per frame.

Specified by:

openOutputStream in interface OutputConnection

Returns:

the open OutputStream.

Throws:

IOException - if a stream is already open