AbstractRuntimeService (Nuxeo ECM Projects 8.10 API)

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

Fields
Modifier and Type	Field and Description
`protected RuntimeContext`	`context`
`protected List<RuntimeExtension>`	`extensions`
`protected boolean`	`isShuttingDown`
`protected boolean`	`isStarted`
`protected ComponentManager`	`manager`
`protected CryptoProperties`	`properties`
`static String`	`REDIRECT_JUL` Property that controls whether or not to redirect JUL to JCL.
`static String`	`REDIRECT_JUL_THRESHOLD`
`protected List<String>`	`warnings`
`protected File`	`workingDir`

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`AbstractRuntimeService(DefaultRuntimeContext context)`
`protected`	`AbstractRuntimeService(DefaultRuntimeContext context, Map<String,String> properties)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`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.
`protected static URL`	`getBuiltinFeatureURL()`
`org.osgi.framework.Bundle`	`getBundle(String symbolicName)` Get an installed bundle given its symbolic name.
`File`	`getBundleFile(org.osgi.framework.Bundle bundle)` OSGi frameworks are using a string `Bundle.getLocation()` to identify bundle locations.
`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.
`CryptoProperties`	`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`	`getStatusMessage(StringBuilder msg)` Computes the runtime status, adds it to the given string builder, and return true if some problems have been detected.
`List<String>`	`getWarnings()` Gets a list of startup warnings.
`boolean`	`isShuttingDown()` Returns true if the runtime is shutting down.
`boolean`	`isStarted()` Returns true if 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, reloadProperties

- Field Detail
  - REDIRECT_JUL
```
public static final String REDIRECT_JUL
```
    Property that controls whether or not to redirect JUL to JCL. By default is true (JUL will be redirected)
    
    See Also:
    
    Constant Field Values
  - REDIRECT_JUL_THRESHOLD
```
public static final String REDIRECT_JUL_THRESHOLD
```
    See Also:
    
    Constant Field Values
  - isStarted
```
protected boolean isStarted
```
  - isShuttingDown
```
protected boolean isShuttingDown
```
  - workingDir
```
protected File workingDir
```
  - properties
```
protected CryptoProperties properties
```
  - manager
```
protected ComponentManager manager
```
  - context
```
protected final RuntimeContext context
```
  - extensions
```
protected final List<RuntimeExtension> extensions
```
  - warnings
```
protected final List<String> warnings
```
- Constructor Detail
  - AbstractRuntimeService
```
protected AbstractRuntimeService(DefaultRuntimeContext context)
```
  - AbstractRuntimeService
```
protected AbstractRuntimeService(DefaultRuntimeContext context,
                                 Map<String,String> properties)
```
- Method Detail
  - getWarnings
```
public List<String> getWarnings()
```
    Description copied from interface: RuntimeService
    
    Gets a list of startup warnings. Can be modified to add new warnings.
    
    Specified by:
    
    getWarnings in interface RuntimeService
    
    Returns:
    
    the warning list
  - createComponentManager
```
protected ComponentManager createComponentManager()
```
  - getBuiltinFeatureURL
```
protected static URL getBuiltinFeatureURL()
```
  - start
```
public void start()
```
    Description copied from interface: RuntimeService
    
    Starts the runtime.
    
    Specified by:
    
    start in interface RuntimeService
  - stop
```
public void stop()
```
    Description copied from interface: RuntimeService
    
    Stops the runtime.
    
    Specified by:
    
    stop in interface RuntimeService
  - isStarted
```
public boolean isStarted()
```
    Description copied from interface: RuntimeService
    
    Returns true if the runtime is started.
    
    Specified by:
    
    isStarted in interface RuntimeService
    
    Returns:
    
    true if the runtime is started, false otherwise
  - isShuttingDown
```
public boolean isShuttingDown()
```
    Description copied from interface: RuntimeService
    
    Returns true if the runtime is shutting down.
    
    Specified by:
    
    isShuttingDown in interface RuntimeService
    
    Returns:
    
    true if the runtime is shutting down, false otherwise
  - doStart
```
protected void doStart()
```
  - doStop
```
protected void doStop()
```
  - 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
  - getProperties
```
public CryptoProperties 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:
    
    the property value
  - setProperty
```
public void setProperty(String name,
                        Object value)
```
    Specified by:
    
    setProperty in interface RuntimeService
  - 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
  - getBundleFile
```
public File getBundleFile(org.osgi.framework.Bundle bundle)
```
    Description copied from interface: RuntimeService
    
    OSGi frameworks are using a string Bundle.getLocation() to identify bundle locations.
    This method try to convert the bundle location to real file if possible. If this bundle location cannot be converted to a file (e.g. it may be a remote URL), null is returned.
    This method works only for bundles that are installed as files on the host file system.
    
    Specified by:
    
    getBundleFile in interface RuntimeService
    
    Returns:
    
    the bundle file, or null
  - getBundle
```
public org.osgi.framework.Bundle getBundle(String symbolicName)
```
    Description copied from interface: RuntimeService
    
    Get an installed bundle given its symbolic name. This method is not handling versions.
    
    Specified by:
    
    getBundle in interface RuntimeService
  - getStatusMessage
```
public boolean getStatusMessage(StringBuilder msg)
```
    Description copied from interface: RuntimeService
    
    Computes the runtime status, adds it to the given string builder, and return true if some problems have been detected.
    
    Specified by:
    
    getStatusMessage in interface RuntimeService
    
    Parameters:
    
    msg - summary message about all components loading status
    
    Returns:
    
    true if there was no detected error, else return false
    
    Since:
    
    5.5

Class AbstractRuntimeService

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface org.nuxeo.runtime.RuntimeService

Field Detail

REDIRECT_JUL

REDIRECT_JUL_THRESHOLD

isStarted

isShuttingDown

workingDir

properties

manager

context

extensions

warnings

Constructor Detail

AbstractRuntimeService

AbstractRuntimeService

Method Detail

getWarnings

createComponentManager

getBuiltinFeatureURL

start

stop

isStarted

isShuttingDown

doStart

doStop

getHome

setHome

getDescription

getProperties

getProperty

getProperty

setProperty

toString

getComponent

getComponent

getComponentInstance

getComponentInstance

getComponentManager

getContext

startExtensions

stopExtensions

getService

expandVars

getBundleFile

getBundle

getStatusMessage