org.nuxeo.runtime
Class AbstractRuntimeService

java.lang.Object
  org.nuxeo.runtime.AbstractRuntimeService

All Implemented Interfaces:

RuntimeService

Direct Known Subclasses:

OSGiRuntimeService, SimpleRuntime, TestRuntime

public abstract class AbstractRuntimeService
extends Object
implements RuntimeService

Abstract implementation of the Runtime Service.

Implementors are encouraged to extend this class instead of directly implementing the RuntimeService interface.

Author:

Bogdan Stefanescu

Field Summary

protected RuntimeContext	context
protected List<RuntimeExtension>	extensions
protected boolean	isStarted
protected ComponentManager	manager
protected Properties	properties
protected File	workingDir

Constructor Summary

protected	AbstractRuntimeService(DefaultRuntimeContext context)
protected	AbstractRuntimeService(DefaultRuntimeContext context, Map<String,String> properties)

Method Summary

protected ComponentManager	createComponentManager()
protected void	doStart()
protected void	doStop()
String	expandVars(String expression) Replaces any substring in the form ${property.name} with the corresponding runtime property value if any, otherwise leaves the substring unchanged.
AdapterManager	getAdapterManager()
protected static URL	getBuiltinFeatureURL()
Object	getComponent(ComponentName name) Gets a component given its name.
Object	getComponent(String name) Gets a component given its name as a string.
ComponentInstance	getComponentInstance(ComponentName name) Gets a component implementation instance given its name.
ComponentInstance	getComponentInstance(String name) Gets a component implementation instance given its name as a string.
ComponentManager	getComponentManager() Gets the component manager.
RuntimeContext	getContext() Gets the context of the runtime bundle.
String	getDescription() Gets the description of this runtime service.
File	getHome() Gets the home directory of the runtime.
Properties	getProperties() Gets runtime service properties.
String	getProperty(String name) Gets a runtime service property given its name.
String	getProperty(String name, String defValue) Gets a property value using a default value if the property was not set.
<T> T	getService(Class<T> serviceClass) Gets the service of type serviceClass if such a service was declared by a resolved runtime component.
boolean	isStarted() Tests whether or not the runtime is started.
void	setHome(File home)
void	setProperty(String name, Object value)
void	start() Starts the runtime.
protected void	startExtensions()
void	stop() Stops the runtime.
protected void	stopExtensions()
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.nuxeo.runtime.RuntimeService

getName, getVersion

Field Detail

isStarted

protected boolean isStarted

workingDir

protected File workingDir

properties

protected final Properties properties

manager

protected ComponentManager manager

context

protected final RuntimeContext context

extensions

protected final List<RuntimeExtension> extensions

Constructor Detail

AbstractRuntimeService

protected AbstractRuntimeService(DefaultRuntimeContext context)

AbstractRuntimeService

protected AbstractRuntimeService(DefaultRuntimeContext context,
                                 Map<String,String> properties)

Method Detail

createComponentManager

protected ComponentManager createComponentManager()

getBuiltinFeatureURL

protected static URL getBuiltinFeatureURL()

start

public void start()
           throws Exception

Description copied from interface: RuntimeService

Starts the runtime.

Specified by:

start in interface RuntimeService

Throws:

Exception - if any exception occurred during startup

stop

public void stop()
          throws Exception

Description copied from interface: RuntimeService

Stops the runtime.

Specified by:

stop in interface RuntimeService

Throws:

Exception - if any exception occurred during shutdown

isStarted

public boolean isStarted()

Description copied from interface: RuntimeService

Tests whether or not the runtime is started.

Specified by:

isStarted in interface RuntimeService

Returns:

true if the runtime is started, false otherwise

doStart

protected void doStart()
                throws Exception

Throws:

Exception

doStop

protected void doStop()
               throws Exception

Throws:

Exception

getHome

public File getHome()

Description copied from interface: RuntimeService

Gets the home directory of the runtime.

Specified by:

getHome in interface RuntimeService

Returns:

the home directory

setHome

public void setHome(File home)

getDescription

public String getDescription()

Description copied from interface: RuntimeService

Gets the description of this runtime service.

Specified by:

getDescription in interface RuntimeService

Returns:

the runtime service description

getAdapterManager

public AdapterManager getAdapterManager()

getProperties

public Properties getProperties()

Description copied from interface: RuntimeService

Gets runtime service properties.

Specified by:

getProperties in interface RuntimeService

Returns:

the runtime properties

getProperty

public String getProperty(String name)

Description copied from interface: RuntimeService

Gets a runtime service property given its name.

Specified by:

getProperty in interface RuntimeService

Parameters:

name - the property name

Returns:

the property value if any or null if none

getProperty

public String getProperty(String name,
                          String defValue)

Description copied from interface: RuntimeService

Gets a property value using a default value if the property was not set.

Specified by:

getProperty in interface RuntimeService

Parameters:

name - the property name

defValue - the default value to use when the property doesn't exists

Returns:

setProperty

public void setProperty(String name,
                        Object value)

toString

public String toString()

Overrides:

toString in class Object

getComponent

public Object getComponent(String name)

Description copied from interface: RuntimeService

Gets a component given its name as a string.

Specified by:

getComponent in interface RuntimeService

Parameters:

name - the component name as a string

Returns:

the component

getComponent

public Object getComponent(ComponentName name)

Description copied from interface: RuntimeService

Gets a component given its name.

Specified by:

getComponent in interface RuntimeService

Parameters:

name - the component name

Returns:

the component or null if no such component was registered

getComponentInstance

public ComponentInstance getComponentInstance(String name)

Description copied from interface: RuntimeService

Gets a component implementation instance given its name as a string.

Specified by:

getComponentInstance in interface RuntimeService

Parameters:

name - the component name as a string

Returns:

the component

getComponentInstance

public ComponentInstance getComponentInstance(ComponentName name)

Description copied from interface: RuntimeService

Gets a component implementation instance given its name.

Specified by:

getComponentInstance in interface RuntimeService

Parameters:

name - the component name

Returns:

the component or null if no such component was registered

getComponentManager

public ComponentManager getComponentManager()

Description copied from interface: RuntimeService

Gets the component manager.

Specified by:

getComponentManager in interface RuntimeService

Returns:

the component manager

getContext

public RuntimeContext getContext()

Description copied from interface: RuntimeService

Gets the context of the runtime bundle.

Specified by:

getContext in interface RuntimeService

Returns:

the context object

startExtensions

protected void startExtensions()

stopExtensions

protected void stopExtensions()

getService

public <T> T getService(Class<T> serviceClass)

Description copied from interface: RuntimeService

Gets the service of type serviceClass if such a service was declared by a resolved runtime component.

If the component is not yet activated it will be prior to return the service.

Specified by:

getService in interface RuntimeService

Type Parameters:

T - the service type

Parameters:

serviceClass - the service class

Returns:

the service object

expandVars

public String expandVars(String expression)

Description copied from interface: RuntimeService

Replaces any substring in the form ${property.name} with the corresponding runtime property value if any, otherwise leaves the substring unchanged.

Specified by:

expandVars in interface RuntimeService

Parameters:

expression - the expression to process

Returns:

the expanded expression