org.universAAL.middleware.container.JUnit

Class JUnitContainer

java.lang.Object

org.universAAL.middleware.container.JUnit.JUnitContainer

All Implemented Interfaces:

Container

public final class JUnitContainer
extends Object
implements Container

Author:

amedrano, Carsten Stockloew

Method Summary

Modifier and Type	Method and Description
Object	fetchSharedObject(ModuleContext requester, Object[] fetchParams) Returns an object previously shared by another module for usage within this container.
Object[]	fetchSharedObject(ModuleContext requester, Object[] fetchParams, SharedObjectListener listener) Returns an object previously shared by another module for usage within this container.
static JUnitContainer	getInstance()
ModuleContext	installModule(ModuleContext requester, Object[] installParams) Provides possibility for programmatically installing (downloaded) modules.
Iterator	logListeners() Returns an Iterator object over all registered instances of LogListener.
void	registerLogListener(LogListener listener) Register a LogListener
ModuleContext	registerModule(Object[] regParams) Provides possibility for wrapping container-specific context for a module in terms of an instance of the universAAL ModuleContext.
void	removeAllSharedObjects()
void	removeSharedObject(ModuleContext requester, Object objToRemove, Object[] shareParams) Removes an object previously shared by a module for usage within this container.
void	removeSharedObjectListener(SharedObjectListener listener) This method allows a SharedObjectListener instance to be removed from the list of listeners managed by this container
void	shareObject(ModuleContext requester, Object objToShare, Object[] shareParams) Makes a given object accessible for the other modules hosted by this container.
void	unregisterLogListener(LogListener listener) Remove a LogListener

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static JUnitContainer getInstance()

fetchSharedObject

public Object fetchSharedObject(ModuleContext requester,
                                Object[] fetchParams)

Returns an object previously shared by another module for usage within this container.

Specified by:

fetchSharedObject in interface Container

Parameters:

requester - The module in the context of which the shared object is going to be used.

fetchParams - Container-specific parameters for fetching shared objects.

fetchSharedObject

public Object[] fetchSharedObject(ModuleContext requester,
                                  Object[] fetchParams,
                                  SharedObjectListener listener)

Returns an object previously shared by another module for usage within this container.

Specified by:

fetchSharedObject in interface Container

Parameters:

requester - The module in the context of which the shared object is going to be used.

fetchParams - Container-specific parameters for fetching shared objects.

listener - If not null, the listener will be notified asynchronously each time a new matching object is shared within this container.

removeSharedObjectListener

public void removeSharedObjectListener(SharedObjectListener listener)

This method allows a SharedObjectListener instance to be removed from the list of listeners managed by this container

Specified by:

removeSharedObjectListener in interface Container

Parameters:

listener - the SharedObjectListener to be removed

installModule

public ModuleContext installModule(ModuleContext requester,
                                   Object[] installParams)

Provides possibility for programmatically installing (downloaded) modules.

Specified by:

installModule in interface Container

Parameters:

requester - The module requesting the installation; only an certain modules should be allowed to install modules on the fly

installParams - Container-specific parameters for installing modules

Returns:

The context of the newly installed module if the operation is successful, null otherwise.

registerLogListener

public void registerLogListener(LogListener listener)

Register a LogListener

unregisterLogListener

public void unregisterLogListener(LogListener listener)

Remove a LogListener

logListeners

public Iterator logListeners()

Returns an Iterator object over all registered instances of LogListener.

Specified by:

logListeners in interface Container

registerModule

public ModuleContext registerModule(Object[] regParams)

Provides possibility for wrapping container-specific context for a module in terms of an instance of the universAAL ModuleContext.

Specified by:

registerModule in interface Container

Parameters:

regParams - The container-specific parameters for identifying the module.

Returns:

The universAAL wrapper object as an instance of ModuleContext.

shareObject

public void shareObject(ModuleContext requester,
                        Object objToShare,
                        Object[] shareParams)

Makes a given object accessible for the other modules hosted by this container.

Specified by:

shareObject in interface Container

Parameters:

requester - The module in the context of which the shared object is going to be used.

objToShare - The actual object to be shared.

shareParams - Container-specific parameters for sharing a specific object.

removeSharedObject

public void removeSharedObject(ModuleContext requester,
                               Object objToRemove,
                               Object[] shareParams)

Description copied from interface: Container

Removes an object previously shared by a module for usage within this container.

Specified by:

removeSharedObject in interface Container

Parameters:

requester - The module in the context of which the shared object was shared.

removeAllSharedObjects

public void removeAllSharedObjects()