org.refcodes.connection.ext.observable

Class ObservableConnectionSenderImpl<DATA extends Serializable,CON>

java.lang.Object

org.refcodes.connection.ext.observable.ObservableConnectionSenderImpl<DATA,CON>

Type Parameters:

DATA - The type of the datagram to be operated with.

CON - The type of the connection to be used.

All Implemented Interfaces:

Flushable, org.refcodes.component.Closable, org.refcodes.component.Closable.CloseAutomaton, org.refcodes.component.ClosedAccessor, org.refcodes.component.Component, org.refcodes.component.ConnectableComponent, org.refcodes.component.ConnectableComponent.ConnectableAutomaton, org.refcodes.component.ConnectionComponent<CON>, org.refcodes.component.ConnectionComponent.ConnectionAutomaton<CON>, org.refcodes.component.ConnectionOpenable<CON>, org.refcodes.component.ConnectionOpenable.ConnectionOpenAutomaton<CON>, org.refcodes.component.ConnectionStatusAccessor, org.refcodes.component.Destroyable, org.refcodes.component.OpenedAccessor, ObservableConnectionSender<DATA,CON>, org.refcodes.io.BlockConsumer<DATA>, org.refcodes.io.BlockSender<DATA>, org.refcodes.io.ConnectionSender<DATA,CON>, org.refcodes.io.Consumer<DATA>, org.refcodes.io.DatagramConsumer<DATA>, org.refcodes.io.DatagramSender<DATA>, org.refcodes.io.Sendable, org.refcodes.io.Sender<DATA>, org.refcodes.observer.Observable<org.refcodes.component.ext.observer.ConnectionObserver>

public class ObservableConnectionSenderImpl<DATA extends Serializable,CON>
extends Object
implements ObservableConnectionSender<DATA,CON>

The ObservableConnectionSenderImpl implements the ObservableConnectionSender for wrapping and extending a ConnectionSender with observable functionality.

TODO: Test cases are to be created!

Nested Class Summary

Nested classes/interfaces inherited from interface org.refcodes.connection.ext.observable.ObservableConnectionSender

ObservableConnectionSender.ObservableConnectionRequestSender<DATA extends Serializable,CON>

Nested classes/interfaces inherited from interface org.refcodes.component.ConnectableComponent

org.refcodes.component.ConnectableComponent.ConnectableAutomaton

Nested classes/interfaces inherited from interface org.refcodes.component.OpenedAccessor

org.refcodes.component.OpenedAccessor.OpenedMutator, org.refcodes.component.OpenedAccessor.OpenedProperty

Nested classes/interfaces inherited from interface org.refcodes.component.Closable

org.refcodes.component.Closable.CloseAutomaton, org.refcodes.component.Closable.CloseBuilder<B extends org.refcodes.component.Closable.CloseBuilder<B>>

Nested classes/interfaces inherited from interface org.refcodes.component.ClosedAccessor

org.refcodes.component.ClosedAccessor.ClosedMutator, org.refcodes.component.ClosedAccessor.ClosedProperty

Nested classes/interfaces inherited from interface org.refcodes.component.ConnectionStatusAccessor

org.refcodes.component.ConnectionStatusAccessor.ConnectionStatusMutator, org.refcodes.component.ConnectionStatusAccessor.ConnectionStatusProperty

Nested classes/interfaces inherited from interface org.refcodes.component.Flushable

org.refcodes.component.Flushable.FlushBuilder<B extends org.refcodes.component.Flushable.FlushBuilder<B>>

Nested classes/interfaces inherited from interface org.refcodes.component.ConnectionComponent

org.refcodes.component.ConnectionComponent.ConnectionAutomaton<CON>, org.refcodes.component.ConnectionComponent.ConnectionComponentBuilder<CON,B extends org.refcodes.component.ConnectionComponent.ConnectionComponentBuilder<CON,B>>

Nested classes/interfaces inherited from interface org.refcodes.component.ConnectionOpenable

org.refcodes.component.ConnectionOpenable.ConnectionOpenAutomaton<CON>, org.refcodes.component.ConnectionOpenable.ConnectionOpenBuilder<CON,B extends org.refcodes.component.ConnectionOpenable.ConnectionOpenBuilder<CON,B>>

Nested classes/interfaces inherited from interface org.refcodes.component.Destroyable

org.refcodes.component.Destroyable.DestroyAutomaton

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.refcodes.logger.RuntimeLogger	LOGGER

Constructor Summary

Constructors

Constructor and Description
ObservableConnectionSenderImpl(org.refcodes.io.ConnectionSender<DATA,CON> aConnectionSender) Constructs a ObservableConnectionSenderImpl with the given attributes.
ObservableConnectionSenderImpl(org.refcodes.io.ConnectionSender<DATA,CON> aConnectionSender, org.refcodes.observer.EventMetaData aEventMetaData) Constructs a ObservableConnectionSenderImpl with the given attributes.
ObservableConnectionSenderImpl(org.refcodes.io.ConnectionSender<DATA,CON> aConnectionSender, org.refcodes.observer.EventMetaData aEventMetaData, ExecutorService aExecutorService, org.refcodes.controlflow.ExecutionStrategy aExecutionStrategy) Constructs a ObservableConnectionSenderImpl with the given attributes.
ObservableConnectionSenderImpl(org.refcodes.io.ConnectionSender<DATA,CON> aConnectionSender, org.refcodes.observer.EventMetaData aEventMetaData, Object aSource) Constructs a ObservableConnectionSenderImpl with the given attributes.
ObservableConnectionSenderImpl(org.refcodes.io.ConnectionSender<DATA,CON> aConnectionSender, org.refcodes.observer.EventMetaData aEventMetaData, Object aSource, ExecutorService aExecutorService, org.refcodes.controlflow.ExecutionStrategy aExecutionStrategy) Constructs a ObservableConnectionSenderImpl with the given attributes.
ObservableConnectionSenderImpl(org.refcodes.io.ConnectionSender<DATA,CON> aConnectionSender, ExecutorService aExecutorService, org.refcodes.controlflow.ExecutionStrategy aExecutionStrategy) Constructs a ObservableConnectionSenderImpl with the given attributes.
ObservableConnectionSenderImpl(org.refcodes.io.ConnectionSender<DATA,CON> aConnectionSender, Object aSource) Constructs a ObservableConnectionSenderImpl with the given attributes.
ObservableConnectionSenderImpl(org.refcodes.io.ConnectionSender<DATA,CON> aConnectionSender, Object aSource, ExecutorService aExecutorService, org.refcodes.controlflow.ExecutionStrategy aExecutionStrategy) Constructs a ObservableConnectionSenderImpl with the given attributes.

Method Summary

Modifier and Type	Method and Description
void	close()
void	destroy()
void	flush()
org.refcodes.component.ConnectionStatus	getConnectionStatus()
boolean	hasObserverSubscription(org.refcodes.component.ext.observer.ConnectionObserver aObserver)
boolean	isClosable()
boolean	isClosed()
boolean	isOpenable(CON aConnection)
boolean	isOpened()
void	open(CON aConnection)
boolean	subscribeObserver(org.refcodes.component.ext.observer.ConnectionObserver aObserver)
boolean	unsubscribeObserver(org.refcodes.component.ext.observer.ConnectionObserver aObserver)
void	writeDatagram(DATA aDatagram)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.refcodes.io.Sender

writeDatagrams

Methods inherited from interface org.refcodes.io.Consumer

writeDatagrams

Methods inherited from interface org.refcodes.component.Closable

closeIn, closeQuietly, closeUnchecked

Methods inherited from interface org.refcodes.component.ConnectionStatusAccessor

isConnectionOpened

Methods inherited from interface org.refcodes.component.Flushable

flushUnchecked, isFlushable

Methods inherited from interface org.refcodes.component.ConnectionOpenable

openUnchecked

Field Detail

LOGGER

protected static org.refcodes.logger.RuntimeLogger LOGGER

Constructor Detail

ObservableConnectionSenderImpl

public ObservableConnectionSenderImpl(org.refcodes.io.ConnectionSender<DATA,CON> aConnectionSender)

Constructs a ObservableConnectionSenderImpl with the given attributes.

Parameters:

aConnectionSender - The ConnectionSender to which the connection method calls are to be delegated to.

ObservableConnectionSenderImpl

public ObservableConnectionSenderImpl(org.refcodes.io.ConnectionSender<DATA,CON> aConnectionSender,
                                      Object aSource)

Constructs a ObservableConnectionSenderImpl with the given attributes.

Parameters:

aConnectionSender - The ConnectionSender to which the connection method calls are to be delegated to.

aSource - The source instance to be used when firing events in case the source is to be different from this class' instance.

ObservableConnectionSenderImpl

public ObservableConnectionSenderImpl(org.refcodes.io.ConnectionSender<DATA,CON> aConnectionSender,
                                      org.refcodes.observer.EventMetaData aEventMetaData)

Constructs a ObservableConnectionSenderImpl with the given attributes.

Parameters:

aConnectionSender - The ConnectionSender to which the connection method calls are to be delegated to.

aEventMetaData - The EventMetaData to be used when firing events in case the EventMetaData is to be different from the auto-generated EventMetaData.

ObservableConnectionSenderImpl

public ObservableConnectionSenderImpl(org.refcodes.io.ConnectionSender<DATA,CON> aConnectionSender,
                                      org.refcodes.observer.EventMetaData aEventMetaData,
                                      Object aSource)

Constructs a ObservableConnectionSenderImpl with the given attributes.

Parameters:

aConnectionSender - The ConnectionSender to which the connection method calls are to be delegated to.

aEventMetaData - The EventMetaData to be used when firing events in case the EventMetaData is to be different from the auto-generated EventMetaData.

aSource - The source instance to be used when firing events in case the source is to be different from this class' instance.

ObservableConnectionSenderImpl

public ObservableConnectionSenderImpl(org.refcodes.io.ConnectionSender<DATA,CON> aConnectionSender,
                                      ExecutorService aExecutorService,
                                      org.refcodes.controlflow.ExecutionStrategy aExecutionStrategy)

Constructs a ObservableConnectionSenderImpl with the given attributes.

Parameters:

aConnectionSender - The ConnectionSender to which the connection method calls are to be delegated to.

aExecutorService - The executor service to be used when firing ActionEvent instances in multiple threads (if null then a default one is used).

aExecutionStrategy - The ExecutionStrategy to be used when firing ActionEvent instance (if null then the default ExecutionStrategy.SEQUENTIAL is used).

ObservableConnectionSenderImpl

public ObservableConnectionSenderImpl(org.refcodes.io.ConnectionSender<DATA,CON> aConnectionSender,
                                      Object aSource,
                                      ExecutorService aExecutorService,
                                      org.refcodes.controlflow.ExecutionStrategy aExecutionStrategy)

Constructs a ObservableConnectionSenderImpl with the given attributes.

Parameters:

aConnectionSender - The ConnectionSender to which the connection method calls are to be delegated to.

aSource - The source instance to be used when firing events in case the source is to be different from this class' instance.

aExecutorService - The executor service to be used when firing ActionEvent instances in multiple threads (if null then a default one is used).

aExecutionStrategy - The ExecutionStrategy to be used when firing ActionEvent instance (if null then the default ExecutionStrategy.SEQUENTIAL is used).

ObservableConnectionSenderImpl

public ObservableConnectionSenderImpl(org.refcodes.io.ConnectionSender<DATA,CON> aConnectionSender,
                                      org.refcodes.observer.EventMetaData aEventMetaData,
                                      ExecutorService aExecutorService,
                                      org.refcodes.controlflow.ExecutionStrategy aExecutionStrategy)

Constructs a ObservableConnectionSenderImpl with the given attributes.

Parameters:

aConnectionSender - The ConnectionSender to which the connection method calls are to be delegated to.

aEventMetaData - The EventMetaData to be used when firing events in case the EventMetaData is to be different from the auto-generated EventMetaData.

aExecutorService - The executor service to be used when firing ActionEvent instances in multiple threads (if null then a default one is used).

aExecutionStrategy - The ExecutionStrategy to be used when firing ActionEvent instance (if null then the default ExecutionStrategy.SEQUENTIAL is used).

ObservableConnectionSenderImpl

public ObservableConnectionSenderImpl(org.refcodes.io.ConnectionSender<DATA,CON> aConnectionSender,
                                      org.refcodes.observer.EventMetaData aEventMetaData,
                                      Object aSource,
                                      ExecutorService aExecutorService,
                                      org.refcodes.controlflow.ExecutionStrategy aExecutionStrategy)

Constructs a ObservableConnectionSenderImpl with the given attributes.

Parameters:

aConnectionSender - The ConnectionSender to which the connection method calls are to be delegated to.

aEventMetaData - The EventMetaData to be used when firing events in case the EventMetaData is to be different from the auto-generated EventMetaData.

aSource - The source instance to be used when firing events in case the source is to be different from this class' instance.

aExecutorService - The executor service to be used when firing ActionEvent instances in multiple threads (if null then a default one is used).

aExecutionStrategy - The ExecutionStrategy to be used when firing ActionEvent instance (if null then the default ExecutionStrategy.SEQUENTIAL is used).

Method Detail

isClosed

public boolean isClosed()

Specified by:

isClosed in interface org.refcodes.component.ClosedAccessor

isOpened

public boolean isOpened()

Specified by:

isOpened in interface org.refcodes.component.OpenedAccessor

getConnectionStatus

public org.refcodes.component.ConnectionStatus getConnectionStatus()

Specified by:

getConnectionStatus in interface org.refcodes.component.ConnectionStatusAccessor

flush

public void flush()
           throws org.refcodes.component.OpenException

Specified by:

flush in interface Flushable

Specified by:

flush in interface org.refcodes.io.Sender<DATA extends Serializable>

Throws:

org.refcodes.component.OpenException

close

public void close()
           throws org.refcodes.component.CloseException

Specified by:

close in interface org.refcodes.component.Closable

Throws:

org.refcodes.component.CloseException

open

public void open(CON aConnection)
          throws org.refcodes.component.OpenException

Specified by:

open in interface org.refcodes.component.ConnectionOpenable<CON>

Throws:

org.refcodes.component.OpenException

writeDatagram

public void writeDatagram(DATA aDatagram)
                   throws org.refcodes.component.OpenException

Specified by:

writeDatagram in interface org.refcodes.io.Consumer<DATA extends Serializable>

Specified by:

writeDatagram in interface org.refcodes.io.DatagramConsumer<DATA extends Serializable>

Throws:

org.refcodes.component.OpenException

isClosable

public boolean isClosable()

Specified by:

isClosable in interface org.refcodes.component.Closable.CloseAutomaton

isOpenable

public boolean isOpenable(CON aConnection)

Specified by:

isOpenable in interface org.refcodes.component.ConnectionOpenable.ConnectionOpenAutomaton<CON>

hasObserverSubscription

public boolean hasObserverSubscription(org.refcodes.component.ext.observer.ConnectionObserver aObserver)

Specified by:

hasObserverSubscription in interface org.refcodes.observer.Observable<org.refcodes.component.ext.observer.ConnectionObserver>

subscribeObserver

public boolean subscribeObserver(org.refcodes.component.ext.observer.ConnectionObserver aObserver)

Specified by:

subscribeObserver in interface org.refcodes.observer.Observable<org.refcodes.component.ext.observer.ConnectionObserver>

unsubscribeObserver

public boolean unsubscribeObserver(org.refcodes.component.ext.observer.ConnectionObserver aObserver)

Specified by:

unsubscribeObserver in interface org.refcodes.observer.Observable<org.refcodes.component.ext.observer.ConnectionObserver>

destroy

public void destroy()

Specified by:

destroy in interface org.refcodes.component.Destroyable