com.caucho.env.deploy

Interface DeployControllerStrategy

All Known Implementing Classes:

AbstractDeployControllerStrategy, StartAutoRedeployAutoStrategy, StartAutoRedeployManualStrategy, StartLazyRedeployAutomaticStrategy, StartLazyRedeployManualStrategy, StartManualRedeployManualStrategy

public interface DeployControllerStrategy

DeployController controls the lifecycle of the DeployInstance.

States

• active - responds to requests normally
• modified - active with a dependency change like a web.xml
• active-idle - active idle state, which can be stopped on timeout
• active-error - configuration error (before timeout)
• error - configuration error (after timeout)
• stop - admin stop, refuses requests with a 503
• stop-lazy - lazy stop

error-wait is equivalent to the active state. idle and inactive only applies to startup=lazy.

events

• startOnInit - called at startup time for automatic start
• start - admin start
• stop - admin stop
• update - admin update/restart, ends up in initial state
• request - top-level request
• subrequest - include/forward
• alarm - timeout

Method Summary

Modifier and Type	Method and Description
<I extends DeployInstance> void	alarm(DeployController<I> controller) On a timeout, update or restart as necessary.
<I extends DeployInstance> I	request(DeployController<I> controller) On a top-level request, returns the deploy instance, starting if necessary.
<I extends DeployInstance> void	start(DeployController<I> controller) Starts the instance from an admin command.
<I extends DeployInstance> void	startOnInit(DeployController<I> controller) Called at initialization time for automatic start.
<I extends DeployInstance> void	stop(DeployController<I> controller) Stops the instance from an admin command.
<I extends DeployInstance> I	subrequest(DeployController<I> controller) On a sub-request, returns the deploy instance, starting if necessary.
<I extends DeployInstance> void	update(DeployController<I> controller) Checks for updates from an admin command.

Method Detail

startOnInit

<I extends DeployInstance> void startOnInit(DeployController<I> controller)

Called at initialization time for automatic start.

Parameters:

controller - the owning controller

start

<I extends DeployInstance> void start(DeployController<I> controller)

Starts the instance from an admin command.

Parameters:

controller - the owning controller

stop

<I extends DeployInstance> void stop(DeployController<I> controller)

Stops the instance from an admin command.

Parameters:

controller - the owning controller

update

<I extends DeployInstance> void update(DeployController<I> controller)

Checks for updates from an admin command. The target state will be the initial state, i.e. update will not start a lazy instance.

Parameters:

controller - the owning controller

request

<I extends DeployInstance> I request(DeployController<I> controller)

On a top-level request, returns the deploy instance, starting if necessary.

Parameters:

controller - the owning controller

Returns:

the active deploy instance or null if none are active

subrequest

<I extends DeployInstance> I subrequest(DeployController<I> controller)

On a sub-request, returns the deploy instance, starting if necessary.

Parameters:

controller - the owning controller

Returns:

the active deploy instance or null if none are active

alarm

<I extends DeployInstance> void alarm(DeployController<I> controller)

On a timeout, update or restart as necessary.

Parameters:

controller - the owning controller