AbstractSoftwareProcessDriver (Apache Brooklyn)

java.lang.Object
- brooklyn.entity.basic.AbstractSoftwareProcessDriver

All Implemented Interfaces:

SoftwareProcessDriver, EntityDriver

Direct Known Subclasses:

AbstractSoftwareProcessSshDriver
```
public abstract class AbstractSoftwareProcessDriver
extends java.lang.Object
implements SoftwareProcessDriver
```
An abstract implementation of the SoftwareProcessDriver.

Constructor Summary

Constructors
Constructor and Description

AbstractSoftwareProcessDriver(EntityLocal entity, Location location)

Constructors
Constructor and Description
`AbstractSoftwareProcessDriver(EntityLocal entity, Location location)`

Method Summary

Methods
Modifier and Type	Method and Description
`abstract void`	`copyInstallResources()`
`abstract void`	`copyRuntimeResources()`
`abstract void`	`customize()`
`EntityLocal`	`getEntity()` The entity whose components we are controlling.
`Location`	`getLocation()` The location the entity is running in.
`java.io.InputStream`	`getResource(java.lang.String url)`
`java.lang.String`	`getResourceAsString(java.lang.String url)`
`abstract void`	`install()`
`void`	`kill()` Kills the process, ungracefully and immediately where possible (e.g.
`abstract void`	`launch()`
`void`	`postLaunch()` Implement this method in child classes to add some post-launch behavior
`void`	`preInstall()` Implement this method in child classes to add some post-launch behavior
`java.lang.String`	`processTemplate(java.io.File templateConfigFile)`
`java.lang.String`	`processTemplate(java.io.File templateConfigFile, java.util.Map<java.lang.String,java.lang.Object> extraSubstitutions)`
`java.lang.String`	`processTemplate(java.lang.String templateConfigUrl)` Takes the contents of a template file from the given URL (often a classpath://com/myco/myprod/myfile.conf or .sh) and replaces "${entity.xxx}" with the result of entity.getXxx() and similar for other driver, location; as well as replacing config keys on the management context
`java.lang.String`	`processTemplate(java.lang.String templateConfigUrl, java.util.Map<java.lang.String,? extends java.lang.Object> extraSubstitutions)`
`java.lang.String`	`processTemplateContents(java.lang.String templateContents)`
`java.lang.String`	`processTemplateContents(java.lang.String templateContents, java.util.Map<java.lang.String,? extends java.lang.Object> extraSubstitutions)`
`void`	`rebind()` Rebinds the driver to a pre-existing software process.
`void`	`restart()` Performs software restart (or queues tasks to do this).
`abstract void`	`runPostInstallCommand(java.lang.String command)`
`abstract void`	`runPostLaunchCommand(java.lang.String command)`
`abstract void`	`runPreInstallCommand(java.lang.String command)`
`abstract void`	`runPreLaunchCommand(java.lang.String command)`
`abstract void`	`setup()`
`void`	`start()` Start the entity.
`abstract void`	`stop()` Performs software stop (or queues tasks to do this)

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface brooklyn.entity.basic.SoftwareProcessDriver
isRunning

- Constructor Detail
  - AbstractSoftwareProcessDriver
```
public AbstractSoftwareProcessDriver(EntityLocal entity,
                             Location location)
```
- Method Detail
  - rebind
```
public void rebind()
```
    Description copied from interface: SoftwareProcessDriver
    
    Rebinds the driver to a pre-existing software process.
    
    Specified by:
    
    rebind in interface SoftwareProcessDriver
  - start
```
public void start()
```
    Start the entity.
    This installs, configures and launches the application process. However, users can also call the install(), customize() and launch() steps independently. The postLaunch() will be called after the launch() metheod is executed, but the process may not be completely initialised at this stage, so care is required when implementing these stages.
    The BrooklynConfigKeys#ENTITY_RUNNING key can be set on the location or the entity to skip the startup process if the entity is already running, according to the SoftwareProcessDriver.isRunning() method. To force the startup to be skipped, BrooklynConfigKeys.SKIP_ENTITY_START can be set on the entity. The BrooklynConfigKeys.SKIP_ENTITY_INSTALLATION key can also be used to skip the setup(), copyInstallResources() and install() methods if set on the entity or location.
    
    Specified by:
    
    start in interface SoftwareProcessDriver
    
    See Also:
    stop()
  - stop
```
public abstract void stop()
```
    Description copied from interface: SoftwareProcessDriver
    
    Performs software stop (or queues tasks to do this)
    
    Specified by:
    
    stop in interface SoftwareProcessDriver
    
    See Also:
    Startable.stop()
  - preInstall
```
public void preInstall()
```
    Implement this method in child classes to add some post-launch behavior
  - runPreInstallCommand
```
public abstract void runPreInstallCommand(java.lang.String command)
```
  - setup
```
public abstract void setup()
```
  - copyInstallResources
```
public abstract void copyInstallResources()
```
  - install
```
public abstract void install()
```
  - runPostInstallCommand
```
public abstract void runPostInstallCommand(java.lang.String command)
```
  - copyRuntimeResources
```
public abstract void copyRuntimeResources()
```
  - customize
```
public abstract void customize()
```
  - runPreLaunchCommand
```
public abstract void runPreLaunchCommand(java.lang.String command)
```
  - launch
```
public abstract void launch()
```
  - runPostLaunchCommand
```
public abstract void runPostLaunchCommand(java.lang.String command)
```
  - kill
```
public void kill()
```
    Description copied from interface: SoftwareProcessDriver
    
    Kills the process, ungracefully and immediately where possible (e.g. with `kill -9`).
    
    Specified by:
    
    kill in interface SoftwareProcessDriver
  - postLaunch
```
public void postLaunch()
```
    Implement this method in child classes to add some post-launch behavior
  - restart
```
public void restart()
```
    Description copied from interface: SoftwareProcessDriver
    
    Performs software restart (or queues tasks to do this). Unlike stop/start implementations here are expected to update SERVICE_STATE for STOPPING and STARTING as appropriate (but framework will set RUNNING afterwards, after detecting it is running).
    
    Specified by:
    
    restart in interface SoftwareProcessDriver
    
    See Also:
    Startable.restart()
  - getEntity
```
public EntityLocal getEntity()
```
    Description copied from interface: SoftwareProcessDriver
    
    The entity whose components we are controlling.
    
    Specified by:
    
    getEntity in interface SoftwareProcessDriver
    
    Specified by:
    
    getEntity in interface EntityDriver
  - getLocation
```
public Location getLocation()
```
    Description copied from interface: EntityDriver
    
    The location the entity is running in.
    
    Specified by:
    
    getLocation in interface EntityDriver
  - getResource
```
public java.io.InputStream getResource(java.lang.String url)
```
  - getResourceAsString
```
public java.lang.String getResourceAsString(java.lang.String url)
```
  - processTemplate
```
public java.lang.String processTemplate(java.io.File templateConfigFile,
                               java.util.Map<java.lang.String,java.lang.Object> extraSubstitutions)
```
  - processTemplate
```
public java.lang.String processTemplate(java.io.File templateConfigFile)
```
  - processTemplate
```
public java.lang.String processTemplate(java.lang.String templateConfigUrl)
```
    Takes the contents of a template file from the given URL (often a classpath://com/myco/myprod/myfile.conf or .sh) and replaces "${entity.xxx}" with the result of entity.getXxx() and similar for other driver, location; as well as replacing config keys on the management context
    uses Freemarker templates under the covers
  - processTemplate
```
public java.lang.String processTemplate(java.lang.String templateConfigUrl,
                               java.util.Map<java.lang.String,? extends java.lang.Object> extraSubstitutions)
```
  - processTemplateContents
```
public java.lang.String processTemplateContents(java.lang.String templateContents)
```
  - processTemplateContents
```
public java.lang.String processTemplateContents(java.lang.String templateContents,
                                       java.util.Map<java.lang.String,? extends java.lang.Object> extraSubstitutions)
```

Class AbstractSoftwareProcessDriver

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface brooklyn.entity.basic.SoftwareProcessDriver

Constructor Detail

AbstractSoftwareProcessDriver

Method Detail

rebind

start

stop

preInstall

runPreInstallCommand

setup

copyInstallResources

install

runPostInstallCommand

copyRuntimeResources

customize

runPreLaunchCommand

launch

runPostLaunchCommand

kill

postLaunch

restart

getEntity

getLocation

getResource

getResourceAsString

processTemplate

processTemplate

processTemplate

processTemplate

processTemplateContents

processTemplateContents