jworksactionfactory.java

jworks program

/**
 * $RCSfile: JWorksActionFactory.java,v $
 * $Revision: 1.2 $
 * $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.assemblerbroker.util;

import org.apache.turbine.modules.Assembler;
import org.apache.turbine.services.assemblerbroker.util.java.JavaActionFactory;
import org.apache.turbine.util.Log;

/**
 * <code>JWorkActionFactoy</code> 用于替换 <code>Turbine</code> 默认的
 * <code>JavaActionFactory</code> 以便获取
 * {@link org.softme.jworks.assemblerbroker.util.JWorksActionAssemblerProxy}
 * 替换掉默认 的 Turbine Action。 需要修改 TurbineResources.properties 文件。
 * <ul>
 * <li>
 * services.AssemblerBrokerService.action=org.apache.turbine.services.assemblerbroker.util.java.JavaActionFactory
 * </li>
 * 为：
 * <li>
 * services.AssemblerBrokerService.action=org.softme.jworks.assemblerbroker.util.JWorksActionFactory
 * </li>
 * </ul>
 * <br>
 * 
 * @author <a href="mailto:[e-mail]">boon xiong </a>
 * @version CVS $Revision: 1.2 $ $Date: 2004/08/26 11:10:26 $
 */
public class JWorksActionFactory extends JavaActionFactory {

	/*
	 * (non-Javadoc)
	 * 
	 * @see org.apache.turbine.services.assemblerbroker.util.AssemblerFactory#getAssembler(java.lang.String)
	 */
	public Assembler getAssembler(String name) {

		// 如何判断是否使用xWork的Action框架？
		//
		// 通过对@param name 的判断来决定是否使用xWork:
		// xWork 的Action Name 约定为 namespace/name.action
		// Turbine Action Name 是通过 ParameterParser 对象从Request中分析出来的，
		// jworks通过JWorksParameterParser重载 ParameterParser分析ActionName。
		Log.debug("---JWorksActionFactory 调用-------------");
		if (isJWorksAction(name)) {
			// 这里使用xWork的Action支持框架
			Log.debug("使用 JWorks Action Proxy 处理Action: " + name);
			Log.debug("-----------------------------------------");
			return new JWorksActionAssemblerProxy();
		}

		Log.debug("使用 Turbine Action Assembler 处理Action: " + name);
		Log.debug("-----------------------------------------");

		// 使用Turbine的Action加载方式
		return super.getAssembler(name);
	}

	/**
	 * 判断是否为JWorks的Action
	 * 
	 * @param name
	 * @return
	 */
	public boolean isJWorksAction(String name) {
		// BUGFIXED null parameters
		if (name==null) return false;
		int idx = name.lastIndexOf(".action");
		return (idx == -1) ? false : true;
	}

}