org.universAAL.container.JUnit

Class JUnitContainer

java.lang.Object

org.universAAL.container.JUnit.JUnitContainer

All Implemented Interfaces:

Container

public final class JUnitContainer
extends Object
implements Container

Author:

amedrano, Carsten Stockloew

Method Summary

Methods

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	registerLogListeners(LogListener listener)
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.

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.

registerLogListeners

public void registerLogListeners(LogListener listener)

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()