jadex.platform.service.message.streams

Class OutputConnection

java.lang.Object

jadex.platform.service.message.streams.AbstractConnection

jadex.platform.service.message.streams.OutputConnection

All Implemented Interfaces:

jadex.bridge.IConnection, jadex.bridge.IOutputConnection

public class OutputConnection
extends AbstractConnection
implements jadex.bridge.IOutputConnection

Output connection for writing data. Must synchronized its internal data because the connection handler and the connection user (i.e. a component) are using the connection concurrently. - the user calls interface methods like write and flush - the connection handler calls close to signal that the connection should close.

Field Summary

Fields inherited from class jadex.platform.service.message.streams.AbstractConnection

ch, closed, closing, id, ini, inited, initiator, input, participant

Constructor Summary

Constructors

Constructor and Description
OutputConnection(jadex.bridge.ITransportComponentIdentifier sender, jadex.bridge.ITransportComponentIdentifier receiver, int id, boolean initiator, IOutputConnectionHandler ch) Create a new connection.

Method Summary

Modifier and Type	Method and Description
void	close() Close the connection.
void	flush() Flush the data.
jadex.commons.future.IFuture<java.lang.Integer>	waitForReady() Wait until the connection is ready for the next write.
jadex.commons.future.IFuture<java.lang.Void>	write(byte[] data) Write the content to the stream.
jadex.commons.future.ISubscriptionIntermediateFuture<java.lang.Long>	writeFromInputStream(java.io.InputStream is, jadex.bridge.IExternalAccess component) Do write all data from the input stream.

Methods inherited from class jadex.platform.service.message.streams.AbstractConnection

getConnectionHandler, getConnectionId, getInitiator, getNonFunctionalProperties, getParticipant, isClosed, isClosing, isInited, isInitiatorSide, isInputConnection, setClosed, setClosing, setInited

Methods inherited from class java.lang.Object

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

Methods inherited from interface jadex.bridge.IConnection

getConnectionId, getInitiator, getNonFunctionalProperties, getParticipant

Constructor Detail

OutputConnection

public OutputConnection(jadex.bridge.ITransportComponentIdentifier sender,
                        jadex.bridge.ITransportComponentIdentifier receiver,
                        int id,
                        boolean initiator,
                        IOutputConnectionHandler ch)

Create a new connection.

Method Detail

write

public jadex.commons.future.IFuture<java.lang.Void> write(byte[] data)

Write the content to the stream.

Specified by:

write in interface jadex.bridge.IOutputConnection

Parameters:

data - The data.

flush

public void flush()

Flush the data.

Specified by:

flush in interface jadex.bridge.IOutputConnection

waitForReady

public jadex.commons.future.IFuture<java.lang.Integer> waitForReady()

Wait until the connection is ready for the next write.

Specified by:

waitForReady in interface jadex.bridge.IOutputConnection

Returns:

Calls future when next data can be written. Provides a value of how much data should be given to the connection for best performance.

close

public void close()

Close the connection. Notifies the other side that the connection has been closed.

Specified by:

close in interface jadex.bridge.IConnection

Overrides:

close in class AbstractConnection

writeFromInputStream

public jadex.commons.future.ISubscriptionIntermediateFuture<java.lang.Long> writeFromInputStream(java.io.InputStream is,
                                                                                                 jadex.bridge.IExternalAccess component)

Do write all data from the input stream.

Specified by:

writeFromInputStream in interface jadex.bridge.IOutputConnection