/*
* Copyright (c) 1998-2011 Caucho Technology -- all rights reserved
*
* This file is part of Resin(R) Open Source
*
* Each copy or derived work must preserve the copyright notice and this
* notice unmodified.
*
* Resin Open Source is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* Resin Open Source is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, or any warranty
* of NON-INFRINGEMENT. See the GNU General Public License for more
* details.
*
* You should have received a copy of the GNU General Public License
* along with Resin Open Source; if not, write to the
*
* Free Software Foundation, Inc.
* 59 Temple Place, Suite 330
* Boston, MA 02111-1307 USA
*
* @author Scott Ferguson
*/
package com.caucho.env.deploy;
import com.caucho.inject.Module;
import com.caucho.lifecycle.LifecycleState;
/**
* The start-mode="lazy", redeploy-model="automatic" controller strategy.
*
* <table>
* <tr><th>input <th>stopped <th>active <th>modified <th>error
* <tr><td>request<td>startImpl<td>- <td>restartImpl<td>restartImpl
* <tr><td>include<td>startImpl<td>- <td>- <td>-
* <tr><td>start <td>startImpl<td>- <td>restartImpl<td>restartImpl
* <tr><td>restart<td>startImpl<td>- <td>restartImpl<td>restartImpl
* <tr><td>stop <td>- <td>stopImpl<td>stopImpl <td>stopImpl
* <tr><td>alarm <td>- <td>- <td>stopImpl <td>stopImpl
* </table>
*/
@Module
public class StartLazyRedeployAutomaticStrategy
extends AbstractDeployControllerStrategy {
public final static StartLazyRedeployAutomaticStrategy STRATEGY
= new StartLazyRedeployAutomaticStrategy();
private StartLazyRedeployAutomaticStrategy()
{
}
/**
* Returns the start="lazy" redeploy="automatic" strategy
*
* @return the singleton strategy
*/
public static DeployControllerStrategy create()
{
return STRATEGY;
}
/**
* Called at initialization time for automatic start.
*
* @param controller the owning controller
*/
@Override
public<I extends DeployInstance>
void startOnInit(DeployController<I> controller)
{
controller.stopLazyImpl();
}
/**
* Checks for updates from an admin command. The target state will be the
* initial state, i.e. update will not start a lazy instance.
*
* @param controller the owning controller
*/
@Override
public<I extends DeployInstance>
void update(DeployController<I> controller)
{
LifecycleState state = controller.getState();
if (state.isIdle()) {
// server/1d08
}
else if (state.isStopped()) {
// server/1d05
controller.stopLazyImpl();
}
else if (state.isError()) {
controller.stopLazyImpl();
}
else if (controller.isModifiedNow()) {
// 1d0n, 1d0o
controller.stopLazyImpl();
}
else if (controller.isIdleTimeout()) {
controller.stopLazyImpl();
}
else { /* active */
// server/1d0h
}
}
/**
* Returns the current instance for a request, redeploying if necessary.
*
* @param controller the owning controller
* @return the current deploy instance
*/
@Override
public <I extends DeployInstance>
I request(DeployController<I> controller)
{
LifecycleState state = controller.getState();
if (state.isIdle()) {
// server/1d06
return controller.startImpl();
}
else if (state.isStopped()) {
// server/1d00
return controller.getDeployInstance();
}
else if (state.isError()) {
// server/1d13
return controller.restartImpl();
}
else if (controller.isModified()) {
// server/1d0i
return controller.restartImpl();
}
else { /* active */
// server/1d0c
return controller.getDeployInstance();
}
}
/**
* Returns the current instance for a subrequest like an include,
* starting if necessary.
*
* @param controller the owning controller
* @return the current deploy instance
*/
@Override
public <I extends DeployInstance>
I subrequest(DeployController<I> controller)
{
LifecycleState state = controller.getState();
if (state.isIdle()) {
// server/1d07
return controller.startImpl();
}
else if (state.isStopped()) {
// server/1d01
return controller.getDeployInstance();
}
else if (state.isError() && controller.isModified()) {
// server/1d0x
return controller.restartImpl();
}
else if (controller.isModified()) {
// server/1d0j
return controller.getDeployInstance();
}
else { /* active */
// server/1d0d
return controller.getDeployInstance();
}
}
/**
* Redeployment on a timeout alarm.
*
* @param controller the owning controller
*/
@Override
public <I extends DeployInstance>
void alarm(DeployController<I> controller)
{
LifecycleState state = controller.getState();
if (state.isIdle()) {
// server/1d08
}
else if (state.isStopped()) {
// server/1d02
}
else if (state.isError()) {
// server/1d0w
}
else if (controller.isModified()) {
// server/1d0k
controller.stopLazyImpl();
}
else if (controller.isIdleTimeout()) {
controller.stopLazyImpl();
}
else { /* active */
}
}
}