basejworksvelocityaction.java

jworks program

/**
 * $RCSfile: BaseJWorksVelocityAction.java,v $
 * $Revision: 1.1 $
 * $Date: 2004/08/26 11:10:26 $
 *
 * Copyright (C) 2002-2004 softme.org (Softme Studio). All rights reserved.
 * ===================================================================
 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED.  IN NO EVENT SHALL COOLSERVLETS INC. OR
 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 * ====================================================================
 */

package org.softme.jworks.modules;

import org.apache.turbine.modules.actions.VelocityAction;
import org.apache.turbine.util.RunData;
import org.apache.velocity.context.Context;
import org.softme.jworks.JWorksConstants;

import com.opensymphony.xwork.Action;
import com.opensymphony.xwork.ActionContext;

/**
 * JWorksVelocityAction 抽象基类，用于集成xWork扩展TurbineAction的支持
 * 
 * 原Turbine框架下的Action对象可以简单修改为继续此抽象类后，自动转为使用JWorksAction框架的对象
 * 
 * @author <a href="mailto:[e-mail]">boon xiong</a>
 * @version CVS $Revision: 1.1 $ $Date: 2004/08/26 11:10:26 $
 */
public abstract class BaseJWorksVelocityAction 
	extends VelocityAction 
	implements Action {

    /**
     * xWork 框架的Action 接口实现
     * 根据ActionContext设置获取调用Turbine Velocity Action所必须的数据。 
     *  
     * @see com.opensymphony.xwork.Action#execute()
     */
    public String execute() throws Exception {
    	
    	// 设置RunData和Context引用
    	RunData data = (RunData) ActionContext.getContext().getContextMap().get(JWorksConstants.JWORKS_RUNDATA);
		Context context = (Context) ActionContext.getContext().getContextMap().get(JWorksConstants.JWORKS_VELOCITY);
		
		// 设置返回消息
		data.setMessage(SUCCESS);
		
		// 调用 doPerform		
		doPerform(data, context);
		
		// 使用原Turbine框架的消息对象判断Action的结果
		return data.getMessage();	
        
    }

}