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

  <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