org.eclipse.osbp.runtime.common.dispose

Interface IDisposable

All Known Subinterfaces:

II18nService

All Known Implementing Classes:

AbstractDisposable, DataState, DirtyDataState, GlobalDataState, I18nAdapter, SharedStateContext, URLI18nService

public interface IDisposable

Disposable objects can be destroyed. Which means, that the state is invalid for further use and internal references are prepared for garbage collection.
Object that have been disposed once cannot be used anymore. The creation of a new object is required.

No implement by clients.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	IDisposable.DisposableUtil A public helper util that can be used to check the dispose state of an element.
static class	IDisposable.DisposeException Will be thrown if disposed objects are accessed.
static interface	IDisposable.Listener A listener that is notified if the observed object was disposed.

Method Summary

Modifier and Type	Method and Description
void	addDisposeListener(IDisposable.Listener listener) Adds a listener which will be notified if the object was disposed. Adding a listener twice has no effect.
void	dispose() If called, the element will be disposed.
boolean	isDisposed() Returns true, if this object was already disposed.
boolean	isDisposing() Returns true, during the disposal process.
void	removeDisposeListener(IDisposable.Listener listener) Remove the dispose listener.

Method Detail

isDisposing

boolean isDisposing()

Returns true, during the disposal process.

Returns:

disposing

isDisposed

boolean isDisposed()

Returns true, if this object was already disposed.

Returns:

disposed

dispose

void dispose()

If called, the element will be disposed. All created ui elements will be removed from its parent and this class will be prepared for garbage collection.
NO further use is possible. Creation of a new element required.

Calling this method twice is allowed.

addDisposeListener

void addDisposeListener(IDisposable.Listener listener)

Adds a listener which will be notified if the object was disposed.
Adding a listener twice has no effect.

Parameters:

listener - Listener to be added

removeDisposeListener

void removeDisposeListener(IDisposable.Listener listener)

Remove the dispose listener.

Parameters:

listener - Listener to be removed