net.sf.eBus.client

Interface EObject

All Known Subinterfaces:

EPublisher, EReplier, ERequestor, ESubscriber

All Known Implementing Classes:

ERemoteApp, EServer

public interface EObject

This interface solves the problem of start up and shutting down from a non-eBus thread. When an application object is opening feeds, it is possible that eBus will call the object back before the object's start up method is completed. Synchronization must then be used to prevent start up interruption. But synchronization should not be necessary due to eBus guaranteeing clients that it will access clients in a single-threaded fashion.

The solution is to have an eBus thread trigger the object start up and shutdown methods. While the object is opening feeds, any and all callbacks triggered by the feed opening will not be posted until after the start up method returns.

A similar issue exists with shutting down application objects from a non-eBus thread: after a feed is closed, the feed may still deliver messages to the application object. Shutting down feeds from an eBus thread removes this issue since all the object's pending message queue will be cleared.

An application can either override these methods or provide a Runnable lambda expression as the start up and/or shutdown methods to EFeed.register(EObject, String).

Author:

Charles Rapp

Method Summary

Modifier and Type	Method and Description
default void	shutdown() EFeed.shutdown(EObject) calls this method to asynchronously shutdown an eBus client from an eBus thread.
default void	startup() EFeed.startup(EObject) calls this method to asynchronously start up an eBus client from an eBus thread.

Method Detail

startup

default void startup()

EFeed.startup(EObject) calls this method to asynchronously start up an eBus client from an eBus thread. This means that object start up processing will not be interrupted by an eBus callback.

The default implementation does nothing. This method can be "overridden" using a Runnable interface implementation.

See Also:

shutdown()

shutdown

default void shutdown()

EFeed.shutdown(EObject) calls this method to asynchronously shutdown an eBus client from an eBus thread. This means that object shutdown processing will not be interrupted by an eBus callback.

Note: having eBus shutdown an application object results in all open eBus feeds associated with that application object being closed. It is not possible to partially shutdown the object's feeds. The eBus shutdown functionality should be used only when the object is no longer needed.

The default implementation does nothing. This method can be "overridden" using a Runnable interface implementation.

See Also:

startup()