当前页面位置: » 丰搜网 » 文档中心 » 详细内容
使用webflow组件创建web应用(二)
简单的webflow应用
在此章节中,我们将通过使用webflow创建一个简单的应用来模拟跟踪装船出货信息的流程.这个简单的应用包括向用户发送mail传递跟踪信息的过程.在现实中,实际工作还应包括接受邮递跟踪信息,但我们在此省略以保持应用例子的简洁.
提示:pipelines是线形的,所以很难得到建立在pipeline上的分支结果,循环更是难上加难.所以,pipelines应该建立在具有线形属性的流上,且没有分支或循环发生.除非你需要事务处理,pipelines的使用一般有条件限制.
ebcc中的webflow
创建一个基于webflow的应用首先要将其在概念上加以分解.本文将提供一些良好的实践.将验证从业务逻辑分离是个不错的主意.在webflow的世界里,这意味着将验证逻辑放置在自身的inputprocessor中.
另外一个实践将引入pipelines和pipelinecomponts的选择. pipelines适用于商业逻辑组织在一起且没有分支和循环的情形.如果执行中的流是在许多不同的流发生后到达某固定的节点,你应该选择使用inputprocessors.同样的,如果你需要重复执行某相同的流,你应该选择inputprocessors.尽管如此,在这两种预先考虑的条件都不太适合的情形下,pipelines可能会更适合些.
最后,考虑流是否需要事务.比如,如果一个流包括2个步骤,而且这两步都必须执行成功并提交否则回滚,你应该将pipelinecomponents作为可支持事务的ejb组件.
在我们的应用中, 不管用户是否选择接受出货信息的email.都出现了分支的情形,所以,我们将我们的逻辑放入inputprocessors.在应用中有3个inputprocessors分别作为应用的3个逻辑步骤.分别为:
1.接受用户的输入并验证.
2.从系统后台接受出货信息.
3.选择出货信息的电子邮件给用户
隐含的第四个步骤为向用户展示出货的信息.这并不是业务逻辑的一部分,而应属于视图逻辑,所以被放到了jsp页面中.
此webflow，有下列inputprocessors和建立的jsp页面，如图1所示：
图1. 完整的webflow
你可以看到开始节点是一个索引视图节点。这个节点包含一个名为submit的单独事件（如图2所示），此事件使流导向examplevalidationip.
图2. webflow 事件
在这个节点上，有2个事件。第一个，如图3所示，是由com.bea.p13n.appflow.webflow.forms.invalidformdataexception的异常引发的事件。如果examplevalidationip类抛出异常的实例，webflow会根据此异常事件返回到索引视图节点。
图3. webflow 异常
图2和图3的有关资料相应见图4和图5
图4. webflow 事件信息
图 5. webflow 异常信息l
jsp页面
我们现在要开始编写执行验证和抛出异常的代码了。在此之前，我们首先要创建我们的jsp页面，或至少在我们的脑子里知道jsp页面要包括什么。我们需要一个单独的电子表单，让用户用来提供要跟踪的有关信息，比如要跟踪的号码等。用户将可以选择电子邮件和填写自己邮箱的地方。
作为webflow的一部分，bea提供了便于表单验证的自定义标签库。这些标签和相应的api被验证表但所调用。验证表单是webflow的保留特色.一般而言，一个验证表单可以使开发人员很容易通过name(httpservletrequest parameter的name)和简单的javabean属性进行验证。此api不支持复杂的javabean操作。
首先我们在jsp页面中插入标签库，例如：
<%@ taglib uri=”webflow.tld” prefix=”wf” %>
jsp页面的验证表单如下：
<wf:validatedform event="submit" namespace="example" applystyle="field" invalidstyle="color: red;">
tracking number <wf:text name="trackingnumber"/><br>
email? <wf:checkbox name="email" value="true"/><br>
email address <wf:text name="emailaddress"/><br>
<input type="submit" value="submit" name="submit"/>
</wf:validatedform>
验证节点 现在我们开始创建
jsp页面，我们可以从一个验证节点开始。我们将使用validatedform的一些api：validatedformfactory创建validatedform类，validatedvaluesfactory创建validatedvalues类。validatedform类和validatedvalues类联合处理用户提供的每个表单的信息并判断每个电子表单项是否正确。这样，当验证错误发生时，我们的
webflow将导向用户返回到输入页面，validatedform api将使表单域填入原来的输入值，而且有一些错误消息提示。
验证表单的代码如下：
//创建request javabean并保存至request中
trackingrequest trackingrequest = new trackingrequest();
request.setattribute("trackingrequest", trackingrequest);
validatedform vform = validatedformfactory.getvalidatedform();
validatedvalues vvalues = validatedvaluesfactory.getvalidatedvalues(request);
//设置
javabean值，但我们要将check box自动设置，因为bea的
//validated api并不对它处理
vform.validate(vvalues, trackingrequest);
...
// 验证要跟踪的号码
vform.validate(vvalues, string_validator, "trackingnumber", new minmaxexpression(10, 15),"the tracking number must be between 10 and 15 characters");
//如果选择了电子邮件，验证邮箱地址
if (trackingrequest.isemail()) {
vform.validate(vvalues, string_validator, "emailaddress",
new minmaxexpression(10, 100),
"the email address must be between 10 and 100 characters");
}
if (vvalues.getinvalidfieldcount() > 0) {
throw new invalidformdataexception("please correct the invalid fields");
} 代码片段用到了validate()方法。此方法通过request parameter进行验证，使用到了validator的名字(这里我们使用bea提供的string_validator)，在验证过程中也使用了表达式来作辅助。
另外一项验证的特色是validated form是
javabean的入口。我们在代码中使用到了validate()方法，使用了validatedvalues类和
javabean类。
javabean的值被自动设置。
如果有验证错误发生，我们抛出了一个invalidformdateexception，正如我们上面所述，引导用户返回输入页面。如果用户没有输入合适的要跟踪的号码，他将受到错误的消息，”要输入的号码的字符数必须在10到15个之间”。
如果验证通过，examplevalidationip返回一个字符串”success”，标志着
webflow讲引导flow指向examplebackendip（如图1,2和4所示）。
inputprocessor的分支 作为inputprocessor的examplebackendip代码在此故意省去。要知道，理解
webflow如何作为一个流系统比深入了解复杂的商业逻辑更为重要。如图1
webflow所示，inputprocessor包含两个分叉事件：一个指向
视图节点的结果，另一个指向了exampleemailip。下面是examplebackendip选择返回事件的代码：
//从request中接受trackingrequest
trackingrequest trackingrequest = (trackingrequest) request.getattribute("trackingrequest");
...
// 选择走向何处
return trackingrequest.isemail() ? "email" : "complete";
这里返回经过选择值到
webflow系统，并由系统决定执行那条路径。在我们的例子里，如果用户选择接受email，则返回字符串”email”。否则返回字符串”complete”。图1没有向你展示哪种事件指向
webflow的那一部分，但很容易想到examplebackendip到exampleemailip的事件是”email”，从examplebackednip到result.
jsp 的事件是”complete” 。
通常，
webflow系统的事件为简单的字符串。回想一下，inputprocessor的process()方法返回的是一个典型的对象。
webflow系统会执行这个对象的tostring()方法，然后继续执行。
在图1中，exampleemailip同样由一个到result.
jsp的链接。这个链接同样被叫做”complete”（在图中并没有显示）,此命名可以在任意地方使用。这个是exampleemailip的process()方法的返回值。这个流并不是
webflow唯一的流。系统有足够的可扩展性允许分支到其他的inputprocessors，同样包括
视图节点。你可以分支或链接到任何
webflow允许的各种节点，包括自定义节点。
我们省去了exampleemailip的代码。同样页省去了商业逻辑，这不致于使代码变得繁乱。你可以更轻松入门
webflow技术。你可以下载完整的源代码，看一下程序的其他部分。
结局 在我们的例子中，
jsp的最终页面包含了非常简单的逻辑，我们用examplebackendip收集信息并贮存到http
servletrequest的跟踪信息在此进行了展示。
<jsp:usebean id="trackingdata" scope="request" type="com.inversoft.javaworld.trackingdata"/>
<jsp:usebean id="trackingrequest" scope="request" type="com.inversoft.javaworld.trackingrequest"/>
<p>
the value of your shipment:
<jsp:getproperty name="trackingdata" property="value"/>
</p>
<p>
the description of your shipment:
<jsp:getproperty name="trackingdata" property="description"/>
</p>
<%
if (trackingrequest.isemail()) {
%>
your shipment information has been emailed to:
<jsp:getproperty name="trackingrequest" property="emailaddress"/>
<%
}
%>
扩展 webflow是使用bea
weblogic和bea
weblogic portal开发基于
web引用的得力
框架。象各种processor的通信，pipelines和事件分支是
webflow的独特之处。我们希望此文是你更好的理解给一个
webflow是什么和能作什么。你可以在bea’s的官方站点查找到更多
webflow的信息，包括各种
框架组件，比如通配节点和异常事件等。
关于作者 原创作者:
brian pontarelli是一名
java认证程序员和认证开发员，之前就职于bea的
weblogic portal
框架的开发。brian在
java网络应用
框架领域非常活跃，在software reality曾经写过一篇关于
javaserver faces的文章。他现在在usfreightways工作。业余时间，他正在为他的inversoft公司开发一种新的
java portal
框架。
gr
ant zemont是一名
java认证程序员，具有5年的
web应用开发经验。他现在在depaul大学攻读计算机软件工程理科硕士，同时在usfreightways开发设计
java2企业级平台（
j2ee）应用。
翻译作者:
kunmao ,
java 爱好者,matrix
jsp翻译小组成员,可以通过catflame@msn.com 与他联系.也可以点击http://www.matrix.org.cn/user_view.
asp?username=kunmao查看他的个人信息
资源：
下载本文的源代码：http://www.
javaworld.com/
javaworld/jw-02-2003/
webflow/jw-0214-
webflow.zip
bea官方站点：
http://www.bea.com
bea
webflow文档：
http://edocs.bea.com/wlp/docs40/wflopipe/index.htm
bea
weblogic portal 和 bea
webflow 的
javadoc:
http://edocs.bea.com/wlp/docs70/
javadoc/index.
html bea
weblogic portal and bea
webflow 的新闻组
webflow 白皮书：
ftp://edownload:buy_me@ftpna2.bea.com/pub/downloads/portalwfwhitepaper.zip
"开发
java portlets," carl vieregger (
javaworld, 2003年2月):
http://www.
javaworld.com/
javaworld/jw-02-2003/jw-0207-iviews.
html "使用jetspeed创建portal," jeff linwood (
javaworld, 2001年7月):
http://www.
javaworld.com/
javaworld/jw-07-2001/jw-0727-jetspeed.
html javaworld的
javaserver pages部分的首页http://www.
javaworld.com/channel_content/jw-
jsp-index.s
html javaworld的
java and
web services 部分的首页http://www.
javaworld.com/channel_content/jw-
webserv-index.s
html 访问
javaworld's enterprise
java 的讨论:
http://forums.devworld.com/
webx?50@@.ee6b80a
免费注册
javaworld每周的 enterprise
java 最新消息:
http://www.
javaworld.com/subscribe
你可以在idg
.net查找我们的姊妹出版物的更多有关it的讯息。
