org.nuxeo.runtime.remoting
Class RemoteContext

java.lang.Object
  org.nuxeo.runtime.remoting.RemoteContext

All Implemented Interfaces:

RuntimeContext

public class RemoteContext
extends Object
implements RuntimeContext

TODO: Work in progress. What works: loading resources What doesn't work: loading remote objects that refrences on other remote classes (try to use ClassByteClassLoader from jboss-remoting)

Author:

Bogdan Stefanescu

Constructor Summary

RemoteContext(ServerDescriptor sd, ComponentName component, ClassLoader localClassLoader)

Method Summary

RegistrationInfo	deploy(String location) Deploys the component whose XML descriptor is at the given location.
RegistrationInfo	deploy(URL url) Deploys a component XML descriptor given its URL.
void	destroy() Destroys this context.
org.osgi.framework.Bundle	getBundle() Gets the container bundle or null if we are not running in an OSGi environment.
URL	getLocalResource(String name) Finds a local resource having the given name.
URL	getResource(String name) Finds a resource having the given name.
RuntimeService	getRuntime() Gets the current runtime service.
boolean	isDeployed(String location) Checks if the component at the given location is deployed.
boolean	isDeployed(URL url) Checks whether the component XML file at given URL was deployed.
Class<?>	loadClass(String className) Loads the class given its name.
void	undeploy(String location) Undeploys the component at the given location if any was deployed.
void	undeploy(URL url) Undeploys a component XML descriptor given its URL.

Methods inherited from class java.lang.Object

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

Constructor Detail

RemoteContext

public RemoteContext(ServerDescriptor sd,
                     ComponentName component,
                     ClassLoader localClassLoader)

Method Detail

getLocalResource

public URL getLocalResource(String name)

Description copied from interface: RuntimeContext

Finds a local resource having the given name.

Only the current bundle should be searched for the resource.

Specified by:

getLocalResource in interface RuntimeContext

Parameters:

name - the local resource name

Returns:

an URL to the resource having that name or null if not was found

See Also:

ClassLoader.getResource(String)

getResource

public URL getResource(String name)

Description copied from interface: RuntimeContext

Finds a resource having the given name.

Specified by:

getResource in interface RuntimeContext

Parameters:

name - the resource name

Returns:

an URL to the resource having that name or null if not was found

See Also:

ClassLoader.getResource(String)

loadClass

public Class<?> loadClass(String className)
                   throws ClassNotFoundException

Description copied from interface: RuntimeContext

Loads the class given its name.

Specified by:

loadClass in interface RuntimeContext

Parameters:

className - the class name

Returns:

the class object

Throws:

ClassNotFoundException - if no such class were found

See Also:

ClassLoader.loadClass(String)

getRuntime

public RuntimeService getRuntime()

Description copied from interface: RuntimeContext

Gets the current runtime service.

Specified by:

getRuntime in interface RuntimeContext

Returns:

the runtime service

isDeployed

public boolean isDeployed(URL url)

Description copied from interface: RuntimeContext

Checks whether the component XML file at given URL was deployed.

Specified by:

isDeployed in interface RuntimeContext

Parameters:

url - the URL to check

Returns:

true it deployed, false otherwise

isDeployed

public boolean isDeployed(String location)

Description copied from interface: RuntimeContext

Checks if the component at the given location is deployed.

Specified by:

isDeployed in interface RuntimeContext

Parameters:

location - the component location to check

Returns:

true if deployed, false otherwise

undeploy

public void undeploy(URL url)
              throws Exception

Description copied from interface: RuntimeContext

Undeploys a component XML descriptor given its URL.

Do nothing if no component was registered for the given URL.

Specified by:

undeploy in interface RuntimeContext

Parameters:

url - the URL of the XML descriptor

Throws:

Exception - if any error occurs

undeploy

public void undeploy(String location)
              throws Exception

Description copied from interface: RuntimeContext

Undeploys the component at the given location if any was deployed.

If the component was not deployed do nothing.

Specified by:

undeploy in interface RuntimeContext

Parameters:

location - the location of the component to undeploy

Throws:

Exception - if any error occurs

deploy

public RegistrationInfo deploy(URL url)
                        throws Exception

Description copied from interface: RuntimeContext

Deploys a component XML descriptor given its URL.

Do nothing if component is already deployed.

Returns the registration info of the new deployed component or null if the component was not deployed.

Specified by:

deploy in interface RuntimeContext

Parameters:

url - the url of the XML descriptor

Returns:

the component registration info or null if registration failed for some reason

Throws:

Exception - if any error occurs

deploy

public RegistrationInfo deploy(String location)
                        throws Exception

Description copied from interface: RuntimeContext

Deploys the component whose XML descriptor is at the given location.

If the component is already deployed do nothing.

The location is interpreted as a relative path inside the bundle (jar) containing the component - and will be loaded using RuntimeContext.getLocalResource(String).

Returns the registration info of the new deployed component or null if the component was not deployed.

Specified by:

deploy in interface RuntimeContext

Parameters:

location - the location

Returns:

the component registration info or null if registration failed for some reason

Throws:

Exception

destroy

public void destroy()

Description copied from interface: RuntimeContext

Destroys this context.

Specified by:

destroy in interface RuntimeContext

getBundle

public org.osgi.framework.Bundle getBundle()

Description copied from interface: RuntimeContext

Gets the container bundle or null if we are not running in an OSGi environment.

Specified by:

getBundle in interface RuntimeContext