移植Webflow 组件到 Struts下

    这一节描述了如何利用RAD，将一个简单的Webflow应用(ComputeDay)的独立的组件一步一步地移植到相应的Struts组件下。为了简化移植，我根据应用的视图、模型和控制器三个层面提供了移植步骤。

    步骤1：创建一个空的Struts工程(使用RAD，创建空的Struts工程) 

    1.在【菜单】工具栏，点击【新建】，选择【动态WEB工程】 

    2.指定该工程的名称为：ComputeDay 

    3.单击【下一步】 

    4.在【定制属性】页，确保勾选了Struts复选框 

    5.点击【完成】 

    6.在RAD中建立的Struts工程应该与图1相似

步骤2：确定应用程序组件 

    确定应用程序组件是一个简单但重要的移植步骤.这里，你必须先确定你的 Webflow 应用包结构。一个典型的Webflow应用包结构如下：

•JAVA代码：包含模型和控制器组件。

•Web组件：包含JSP，HTML，CSS，标签库，WebLogic.xml， Web.xml和图片等等。

•属性：包含webflow.properties和应用程序指定的属性文件。

•JAR包：JAVA归档文件，可能是特定的WebLogic库文件或者应用程序相关的库文件 。 


    注意，以上的包结构仅仅作为一个指导建议，对于不同的组织通常会有细微的区别。你应该完整地分析要移植的应用程序来确定以上提到的组件。

步骤3：导入应用程序组件 

    接下来，我们将步骤2中确定的Webflow 组件导入到我们在步骤一中建立的Struts工程结构中。RAD提供了拖放功能，因此你可以轻松地拖动组件，比如JAVA代码包、JSP、HTML、图片等等，然后将其放到相应的工程结构中。 

    默认情况下，RAD的自动编译属性是开启的，因此，它会尝试编译并列出任何缺少资源或者未引用的包错误。从我的经验来看，最好由缺少资源的错误开始，然后确保所有需要的应用程序组件已经被成功导入到RAD中。 

    注意，并不需要导入与Weblogic相关的库或者XML文件。

步骤4：创建web图表 

    创建web图表是移植过程中最重要的步骤。当创建一个启用Struts的动态Web工程时自动创建一个并未打开的web图表。这个图表是Struts工程的基础；第一步是分析webflow.properties文件和理解从一个节点到另一个节点的转移。注意在上下文中的节点可以是一个JSP页面也可以是一个InputProcessor类。 

    webflow.properties文件的分析显示第一个节点是index.jsp页面，下一个节点根据确认是否成功要么是computeDay action 要么是index.jsp。从computeDay节点开始，下一个节点是output.jsp。web图表中简单流程在图2中显示。

    这里不讨论如何画web图表,因为这超出本文讨论的范围. 请参阅指定的辅导资源。 

    使用Web图表的优势有二。第一，Web图表提供捕获Webflow 动作顺序的绘图能力。第二，它产生所有在项目Web图表中指定的组件，包括JSP页面和Java代码文件。在移植过程中，可以用这些来产生文件作为模板。例如，可以从Webflow应用中拷贝index.jsp的合适内容到Web图表产生的文件中。 

    项目结构基本就绪，在下面的步骤中将讨论如何移植项目的模型，视图和控制器。

步骤5：移植视图 

    移植Webflow应用的视图是相当简单的，首先，移植BEA特有的标签并且用标准的Struts库标签替代它们。

--列表1.移植JSP标签
Webflow: <%@ taglib uri = "WebFlow.tld" prefix="wf" %>
Struts: <%@ taglib uri="/WEB-INF/struts.tld" prefix="struts" %>

    其次，在开始的JSP页面替代(如果相应的Struts类可用)或者删除任何BEA特有的import语句。

--列表2.移植JSP include语句
Webflow: <%@ page import="com.beasys.commerce.webflow.WebflowJSPHelper" %>.

    在Struts中，import语句不是必需的.用action类的Struts form标签将替代上面的import语句。 

    最后,用Struts的标准form标签格式替代在Webflow JSP文件中的form标签。在索引JSP页面中，form标签用WebFlowJSPHelper API(应用程序接口)为下一页面创建URL。 

    具体来说，URL包括页面的名字以及匹配webflow.properties文件当前状态的事件。移植到Struts如下所示：

--列表3.移植JSP form标签Webflow:
FORM method="post" action="<%=WebflowJSPHelper.createWebflowURL
 (pageContext, "index.jsp", button(submit)", false)%>">
--Struts:
<html:form method="post" action="/computeDay"  >
在struts-config.xml 中的<action-mapping>元素必须有<action>元素如下所示：
<action-mapping>
<action path="/computeDay"
<type="com.ibm.migration.struts.ComputeDay"
name="dateData"
scope="request"
input="/index.jsp"
<forward name="success" path="/output.jsp"/>
</action-mapping>

    接下来,在JSP页面中输入验证和相应Java字节码到标准的Struts输入验证和错误处理. Webflow框架利用validatedform API以及Webflow标签库验证用户输入. Struts提供了标准输入验证和错误处理机制,通过使用ActionErrors和validate()方法在验证在form bean。考虑这个例子:

--列表4.移植JSP验证
--WebFlow JSP 代码：
<%@ taglib uri = "WebFlow.tld" prefix="wf" %>
在JSP验证表单的样子：
<wf:validatedForm event="submit" namespace="Example">
Year <wf:text name="year"/><br>
Month <wf:text name="month"/><br>
Day<wf:text name="day"/>< br>
<input type="submit" value="Submit" name="submit"/>
<wf:validatedForm>
--相应的Java代码：
ComputeRequest compRequest = new ComputeRequest();
Request.setAttribute("computeRequest", compRequest);
ValidatedForm vFrom = ValidatedFormFActory.getValidatedForm();
ValidatedValues vValus = ValidatedValuesFactory.getValidatedValues(request);
vForm.validate(vValues, compRequest);
vForm.validate(vValues, STRING_VALIDATOR, "year", newMaxExpression(4),
"The Year must be four digit"
if(vValues.getInvalidFieldCount() > 0) {
throw new InvalidFormDataException("Please correct the invalid fields");
}
--Struts:
public ActionErrors validate(ActionMapping mapping, HttpServletRequest request) {
ActionErrors errors = new ActionErrors();
If (!year.length() = 3) {
errors.add ("year", new ActionError("year-format");
}
}

    说明Struts如何使用form bean和外在属性文件来处理输入验证和误差，相对于webflow应用误差处理，是捆绑在应用代码上。 

    步骤6：移植控制器
 
    像这段讨论的，描述一个简单的Webflow应用,输入处理器,或IPs、形成一个典型的Webflow应用的控制器. Struts在actions表单中规定了相当的输入处理器. 

    下面列示一个简单移植：

--列表6.移植 InputProcessor
--Webflow:
public class ComputeDayIP extends InPutProcessorSupport
Struts:
public class ComputeDay extends org.apache.strtus.action.Action

    简单说明用Struts的Action类如何取代它的输入处理器.

步骤7：移植模型

    Webflow移植应用模型主要包含PipelineSession对象，该对象包括成对的指定值。一旦理解了PipelineSession在特定的文件中是怎样使用的，移植模型就比较容易理解了。 

    值得注意的是, 通常，Webflow预先的执行程序会将PipelineSession对象存储在HTTPSession中，而不是HTTPRequest中。在Struts里，form bean为等价模型提供了Webflow PipelineSession。

--列表7.移植PipelineSession对象
--Webflow:
PipelineSession pSession = null;
String namespace = null;
pSession = getPipelineSession(req);
String year = pSession.getYear();
--Struts:
DateData dateData = (DateData) form;
year = dateData.getYear();

应用程序的编译和测试

    现在，可以使用RAD编译应用程序了。在可用的测试环境中，可以使用工具创建并配置WAR（web 存档文件）。通常，在一个典型的移植项目中，迭代周期需要改变和编译源代码。

    RAD版本6提供了用于WebSphere应用服务器6的内置测试环境。在一个真正的移植项目中，一旦使用了RAD单位测试应用程序，就可以在系统移植测试环境（可以将应用程序与外部系统元件整合）做端到端的测试。


结论

    这篇文章对使用RAD的开源struts提供了一种逐步的方法来移植BEA Webflow应用。了解了不同组件研发的Webflow应用以及他们是如何影射struts组件的。也了解了怎样创建一个简单的Web图表（利用RAD）以帮助在Webflow应用程序中将导航应用定位到Struts.