org.ops4j.pax.exam.rbc.internal

Class RemoteBundleContextImpl

java.lang.Object

org.ops4j.pax.exam.rbc.internal.RemoteBundleContextImpl

All Implemented Interfaces:

Serializable, Remote, RemoteBundleContext

public class RemoteBundleContextImpl
extends Object
implements RemoteBundleContext, Serializable

RemoteBundleContext implementaton.

Since:

0.1.0, June 10, 2008

Author:

Toni Menzel (tonit), Alin Dreghiciu (adreghiciu@gmail.com)

See Also:

Serialized Form

Field Summary

Fields inherited from interface org.ops4j.pax.exam.rbc.internal.RemoteBundleContext

NO_WAIT, WAIT_FOREVER

Constructor Summary

Constructors

Constructor and Description
RemoteBundleContextImpl(org.osgi.framework.BundleContext bundleContext) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
long	installBundle(String bundleUrl) Installs a bundle remotly.
long	installBundle(String bundleLocation, byte[] bundle) Installs a bundle remotly given the bundle content.
Object	remoteCall(Class<?> serviceType, String methodName, Class<?>[] methodParams, String filter, org.ops4j.pax.exam.RelativeTimeout timeout, Object... actualParams) Makes a remote call on a service.
void	setBundleStartLevel(long bundleId, int startLevel) Sets bundle start level.
void	startBundle(long bundleId) Starts a bundle.
void	stopBundle(long bundleId) Stops a bundle.
void	uninstallBundle(long id)
void	waitForState(long bundleId, int state, org.ops4j.pax.exam.RelativeTimeout timeout) Waits for a bundle to be in a certain state and returns.

Methods inherited from class java.lang.Object

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

Constructor Detail

RemoteBundleContextImpl

public RemoteBundleContextImpl(org.osgi.framework.BundleContext bundleContext)

Constructor.

Parameters:

bundleContext - bundle context (cannot be null)

Throws:

IllegalArgumentException - - If bundle context is null

Method Detail

remoteCall

public Object remoteCall(Class<?> serviceType,
                String methodName,
                Class<?>[] methodParams,
                String filter,
                org.ops4j.pax.exam.RelativeTimeout timeout,
                Object... actualParams)
                  throws NoSuchServiceException,
                         NoSuchMethodException,
                         IllegalAccessException,
                         InvocationTargetException

Description copied from interface: RemoteBundleContext

Makes a remote call on a service.

Specified by:

remoteCall in interface RemoteBundleContext

Parameters:

serviceType - service class of the remote service

methodName - method name

methodParams - method parameters types

filter - service filter

timeout - timeout for looking up the service

actualParams - actual parameters (must match the given method params)

Returns:

remote call rsult

Throws:

NoSuchServiceException - - If a service of the specified type cannot be located

NoSuchMethodException - - If the given method cannot be found

IllegalAccessException - - Specified method cannot be accessed

InvocationTargetException - - Wraps an eventual exception occured during method invocation

installBundle

public long installBundle(String bundleUrl)
                   throws org.osgi.framework.BundleException

Description copied from interface: RemoteBundleContext

Installs a bundle remotly.

Specified by:

installBundle in interface RemoteBundleContext

Parameters:

bundleUrl - url of the bundle to be installed. The url must be accessible from the remote OSGi container.

Returns:

bundle id of the installed bundle

Throws:

org.osgi.framework.BundleException - - Re-thrown from installing the bundle

installBundle

public long installBundle(String bundleLocation,
                 byte[] bundle)
                   throws org.osgi.framework.BundleException

Description copied from interface: RemoteBundleContext

Installs a bundle remotly given the bundle content.

Specified by:

installBundle in interface RemoteBundleContext

Parameters:

bundleLocation - bundle location

bundle - bundle content as a byte array

Returns:

bundle id of the installed bundle

Throws:

org.osgi.framework.BundleException - - Re-thrown from installing the bundle

uninstallBundle

public void uninstallBundle(long id)
                     throws org.osgi.framework.BundleException

Specified by:

uninstallBundle in interface RemoteBundleContext

Parameters:

id - of bundle to uninstall

Throws:

org.osgi.framework.BundleException - - If bundle cannot be found

startBundle

public void startBundle(long bundleId)
                 throws org.osgi.framework.BundleException

Description copied from interface: RemoteBundleContext

Starts a bundle.

Specified by:

startBundle in interface RemoteBundleContext

Parameters:

bundleId - id of the bundle to be started

Throws:

org.osgi.framework.BundleException - - Re-thrown from starting the bundle

stopBundle

public void stopBundle(long bundleId)
                throws org.osgi.framework.BundleException

Description copied from interface: RemoteBundleContext

Stops a bundle.

Specified by:

stopBundle in interface RemoteBundleContext

Parameters:

bundleId - id of the bundle to be stopped

Throws:

org.osgi.framework.BundleException - - Re-thrown from stopping the bundle

setBundleStartLevel

public void setBundleStartLevel(long bundleId,
                       int startLevel)
                         throws RemoteException,
                                org.osgi.framework.BundleException

Description copied from interface: RemoteBundleContext

Sets bundle start level.

Specified by:

setBundleStartLevel in interface RemoteBundleContext

Parameters:

bundleId - id of the bundle to which the start level should be set

startLevel - bundle start level

Throws:

RemoteException - - Remote communication related exception (mandatory by RMI)

org.osgi.framework.BundleException - - If bundle level cannot be set

waitForState

public void waitForState(long bundleId,
                int state,
                org.ops4j.pax.exam.RelativeTimeout timeout)

Description copied from interface: RemoteBundleContext

Waits for a bundle to be in a certain state and returns.

Specified by:

waitForState in interface RemoteBundleContext

Parameters:

bundleId - bundle id

state - expected state

timeout - max time to wait for state