WebLogic Workshop 验证用户输入
2008-07-24 13:57
369 查看
验证用户输入
在大多数情况下,当用户通过表单输入数据时,我们要确保输入的值有效,然后才能进行其他操作,例如将数据储存到数据库中或用于确定下一步操作。表单验证经常使用客户端 JavaScript 来完成。此方法在 WebLogic Workshop 中也适用。此外,服务器端的验证可在服务器端检查用户输入。后一方法的优点有:不必依赖对其没有控制权的浏览器功能。
可以使用控制器文件中的其他业务逻辑封装验证逻辑。
可以就在受影响表单字段旁的表单中显示错误消息,而无需弹出对话框。
客户端的验证
WebLogic Workshop 为 netui:form 标记及其表单字段提供了许多特性,例如,可以用来调用 JavaScript 的 onClick 和 onBlur。例如,可以有 netui:textBox 标记,用户在其中输入他们的年龄:<netui:textBox dataSource="{actionForm.age}" onBlur="isValidAge()"/>
这是 JavaScript 函数 isValidAge 的示例,该函数在 onBlur 特性中提到:
function isValidAge() { if(document.forms[0].elements[1].value <= 0) alert('Wrong Age'); }
当用户输入值并转到下一个表单字段后,onBlur 特性会调用 JavaScript 函数 isValidForm,当输入的年龄认为无效时,该函数将显示对话框。
请注意,在示例中是使用 JavaScript forms 和 elements 数组访问表单及其字段的。如果想使用各种字段的正确名称,需要使用 tagID 特性以及 WebLogic Workshop JavaScript 函数 getNetuiTagName。还需要用 <netui:html> 替换 <html> 标记。重写上一示例,代码将如下所示:
<netui:html> ... <netui:textBox tagId="age" dataSource="{actionForm.age}" onBlur="isValidAge();"/> ... </netui:html>
而且这将是 JavaScript 函数 isValidAge:
function isValidAge() { if(document[getNetuiTagName("myForm")][getNetuiTagName("age")].value <= 0) alert('Wrong Age'); }
请注意,我们使用 getNetuiTagName(而不是 elements[1])来引用元素的 tagID。也可以推导出,在整个样例中,netui:form 标记包含 tagID="myForm"(netui:form 标记并没有实际显示在上述样例代码中)。
这些方法也可以与表单的提交操作一起使用。对于 netui:button 和 netui:imageButton 标记,可以通过标记的 onClick 特性调用 JavaScript 函数,如下例所示:
<netui:button value="submit" onClick="return isValidForm();" />
当用户单击按钮时,如果验证成功,JavaScript 函数 isValidForm 会检查表单字段并返回 true。或者,如果不是所有的输入值都正确,isValidForm 函数显示带有错误消息的对话框,并返回 false。(此功能的实现并没有实际显示在样例代码中。)
对于 netui:anchor 和 netui:imageAnchor 标记(两者的实现依赖于 JavaScript 提交表单),如果验证成功,JavaScript 验证函数必须包含其他代码以设置 JavaScript Form 对象的 method 和 action 属性,并调用其 submit 方法。下列示例(使用与上一示例相同的 tagID 和 JavaScript 函数 isValidForm)说明,当表单验证成功时如何设置各种属性并调用 submit 方法:
function submitFromAnchor() { document[getNetuiTagName("myForm")].method="POST"; document[getNetuiTagName("myForm")].action="/ClientSideValidation/thankYou.do"; if(isValidForm()) document[getNetuiTagName("myForm")].submit(); }
如示例所示,表单的 method 属性必须设置为 POST。action 属性必须设置为当用户单击定位点并提交表单时要调用的操作的全名。此操作名与 Web 应用程序名(后接 JPF 文件中的操作方法名)相对应,后接 DO 扩展名。在示例中,Web 应用程序 ClientSideValidation 的页面流 JPF 文件包含操作方法 thank You。
不使用 getNetuiTagName 也可以编写相同的函数,如下例所示:
function submitFromAnchor() { document.forms[0].method="POST"; document.forms[0].action="/ClientSideValidation/thankYou.do"; if(isValidForm()) document.forms[0].submit(); }
最后,netui:anchor 或 netui:imageAnchor 标记必须调用 onClick 特性中的 JavaScript 函数并添加“return false;”,如下例所示:
<netui:anchor onClick="submitFromAnchor(); return false;" action="thankYou">Submit</netui:anchor>
如果没有添加表达式“return false;”,将始终提交表单,且数据不会发布到表单 Bean。
服务器端的验证
WebLogic Workshop 提供两种完成服务端验证的方法,一种是在表单 Bean 中使用 Java 来实现 validate 方法,另一种是使用 Struts ValidatorPlugIn 进行基于 XML 的验证。这些示例会在 WebLogic Workshop 样例应用程序中显示,并在此处对其进行描述。要获得样例代码,请在下列安装位置开始:<WEBLOGIC_HOME>/samples/workshop/SamplesApp/WebApp/validation/...
基于 Java 的验证
要使用表单 Bean 的 validate 方法验证用户输入,请按照此列表中概述的步骤进行操作。请注意,这些示例来自下列样例页面流和相关文件:<WEBLOGIC_HOME>/samples/workshop/SamplesApp/WebApp/validation/basic
将 message-resources 标记添加到 JPF 文件中的控制器类,例如:
/** * @jpf:controller nested="true" * @jpf:message-resources resources="validation.basic.Messages" * */ public class Controller extends PageFlowController { ...
资源文件位于 Web 项目的 /WEB-INF/classes/... 文件夹下,并具有 properties 扩展名。在上例中,Messages.properties 文件位于 /WEB-INF/classes/validation/basic。下文将描述此文件的内容。
注意:在示例中,请注意此处使用的对应命名要求。如果消息资源文件是 <project-root>/WEB-INF/classes/validation/basic/Messages.properties,则在 <project-root>/validation/basic/*.jpf 页面流批注中引用此文件的方法是 @jpf:message-resources resources="validation.basic.Messages"。
将 @jpf:validation-error-forward 批注添加到使用验证的操作。例如:
/** * @jpf:action * @jpf:forward name="success" path="success.jsp" * @jpf:validation-error-forward name="failure" return-to="currentPage" */ public Forward submitForm( Form form ) { return new Forward( "success" ); }
此批注提供灵活的机制,如果由于运行了批注的操作而出现表单验证错误,它可以指明应装载哪个页面或应运行哪个操作。有关详细信息,请参阅 @jpf:validation-error-forward 批注主题。
下列流视图屏幕说明了此样例页面流中的操作和页面之间的关系。
将 validate 方法添加到表单 Bean 类。此方法必须具有示例中给出的确切签名:
public ActionErrors validate( ActionMapping mapping, HttpServletRequest request ) { ActionErrors errs = new ActionErrors();
int at = _email.indexOf( '@' ); int dot = _email.lastIndexOf( '.' );
if ( at == -1 || at == 0 || dot == -1 || at > dot ) { errs.add( "email", new ActionError( "badEmail" ) ); }
if ( _zipCode.length() != 5 ) { errs.add( "zipCode", new ActionError( "badZip", new Integer( 5 ) ) ); }
return errs; }
在 validate 方法中,实现各种表单字段的验证逻辑。如果出现错误,请添加新的操作错误。在示例中,zipCode 引用了 JSP (<netui:error value="zipCode"/>) 中的 netui:error 标记,badZip 引用了 Messages.properties 文件中的消息密钥。请注意,new Integer(5) 是错误字符串中的第一个替换对象。例如,在以后的描述中可以看到一个消息字符串: “The zip code has to be exactly {0} characters.”。这种情况下,Integer(5) 对象将替换 {0}。ActionErrors 支持最多带有四个附加替换对象的构造方法。
有关完整示例,请参阅<WEBLOGIC_HOME>/samples/workshop/SamplesApp/WebApp/validation/basic/Controller.jpf 中的页面流控制器类。
在显示错误(通常是表单页面)的 JSP 文件中,添加 netui:error 标记以显示错误消息。例如:
<netui:form action="submitForm"> <table> <tr> <td><p>Enter E-mail Address:</p></td> <td> <netui:textBox dataSource="{actionForm.email}"/> </td> <td> <netui:error value="email"/> </td> </tr> <tr> <td><p>Enter 5-digit Zip Code:</p></td> <td> <netui:textBox dataSource="{actionForm.zipCode}"/> </td> <td> <netui:error value="zipCode"/> </td> </tr> </table>
<netui:button>Submit</netui:button> <netui:button action="exit">Exit</netui:button> </netui:form>
在示例中,将在相关表单字段旁显示错误。有关完整示例,请参阅<WEBLOGIC_HOME>/samples/workshop/SamplesApp/WebApp/validation/basic/formPage.jsp。
另外(或作为替代方法),可以将 netui:errors 标记添加到 JSP (<netui:errors/>),例如在 JSP 底部。此标记将显示所有找到的错误概要。
当在 JSP 中显示错误时,资源文件包含实际的错误消息和要应用的任何专用 HTML 格式。请记住,此文件位于 /WEB-INF/classes/... 下,并具有 properties 扩展名。在此示例中,Messages.properties 文件位于 /WEB-INF/classes/validation/basic中。
badEmail=Bad email address. badZip=The zip code has to be exactly {0} characters.
errors.header=<br><hr><font color="Blue">List of errors, using the <netui:error> tag:<ul> errors.prefix=<li> errors.suffix= errors.footer=</ul></font>
error.prefix=<font color="Red"> error.suffix=</font>
请注意,在示例中,当输入不正确的 zipCode 时,badZip 是需要显示的错误消息的消息密钥。文件中的其他行创建 netui:error 和 netui:errors 标记的格式,以便单个错误消息用红色显示,错误概要用蓝色显示为一个列表,前加标头“List of errors, using the <netui:error> tag:”。
基于 XML 的验证
要使用 Struts ValidatorPlugIn 验证用户输入,请按照此列表中概述的步骤进行操作。请注意,这些示例来自下列样例页面流和相关文件:<WEBLOGIC_HOME>/samples/workshop/SamplesApp/WebApp/validation/validator
将 message-resources 和 struts-merge 批注添加到 JPF 文件中的控制器类。例如:
/** * @jpf:controller nested="true" struts-merge="/WEB-INF/strutsValidator-merge-config.xml" * @jpf:message-resources resources="validation.validator.Messages" * */ public class Controller extends PageFlowController { ...
@jpf:controller 批注的 struts-merge 特性会标识将使用的 Struts 合并文件。此 Struts 合并文件将指向 Struts ValidatorPlugIn 及其规则。以后会在此列表中对合并文件进行描述。
资源文件也位于 Web 项目的 /WEB-INF/classes/... 文件夹下,并具有 properties 扩展名。在上例中,Messages.properties 文件位于 /WEB-INF/classes/validation/validator。请注意此处使用的对应命名要求。如果消息资源文件是 <project-root>/WEB-INF/classes/validation/validator/Messages.properties,则在 <project-root>/validation/validaor/*.jpf 页面流批注中引用此文件的方法是 @jpf:message-resources resources="validation.basic.Messages"。
将 @jpf:validation-error-forward 批注添加到使用验证的操作。例如:
/** * @jpf:action * @jpf:validation-error-forward name="failure" return-to="currentPage" * @jpf:forward name="success" path="success.jsp" */ public Forward submitForm( MyForm form ) { return new Forward( "success" ); }
此批注提供灵活的机制,如果由于运行了批注的操作而出现表单验证错误,它可以指明应装载哪个页面或应运行哪个操作。有关详细信息,请参阅 @jpf:validation-error-forward 批注主题。
在页面流中,修改表单 Bean 定义以扩展 Struts 的 ValidatorForm 界面:
public static class MyForm extends org.apache.struts.validator.ValidatorForm { ...有关此表单 Bean 类的完整示例,请参阅 <WEBLOGIC_HOME>/samples/workshop/SamplesApp/WebApp/validation/validator/Controller.jpf。
在显示错误(通常是表单页面)的 JSP 文件中,添加 netui:error 标记以显示错误消息:
<netui:form action="submitForm"> <table> <tr> <td><p>Enter E-mail Address:</p></td> <td> <netui:textBox dataSource="{actionForm.email}"/> </td> <td> <netui:error value="email"/> </td> </tr> <tr> <td><p>Enter Age:</p></td> <td> <netui:textBox dataSource="{actionForm.age}"/> </td> <td> <netui:error value="age"/> </td> </tr> </table>
<netui:button>Submit</netui:button> <netui:button action="exit">Exit</netui:button> </netui:form>
在示例中,将在相关表单字段旁显示错误。有关完整示例,请参阅<WEBLOGIC_HOME>/samples/workshop/SamplesApp/WebApp/validation/validaor/formPage.jsp。
另外(或作为替代方法),可以将 netui:errors 标记添加到 JSP (<netui:errors/>),例如在 JSP 底部。此标记将显示所有找到的错误列表。
定义 struts-merge 文件以指向 Struts 的默认可插接验证器定义文件 validator-rules.xml,以及包含此特定表单的实际验证规则的 XML 文件。在示例中,合并文件 strutsValidator-merge-config.xml 定义如下。可以在下列位置找到此合并文件:
<WEBLOGIC_HOME>/samples/workshop/SamplesApp/WebApp/WEB-INF
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE struts-config PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 1.1//EN" "http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd">
<struts-config> <form-bean/> <global-exceptions/> <global-forwards/> <action-mappings> </action-mappings>
<plug-in className="org.apache.struts.validator.ValidatorPlugIn"> <set-property property="pathnames" value="/WEB-INF/validator-rules.xml,/WEB-INF/strutsValidator-validation.xml"/> </plug-in>
</struts-config>
默认可插接验证器定义包含在 validator-rules.xml 文件中,该文件位于 WEB-INF 中。实际的表单验证规则应在单独的文件中定义。在示例中,该文件称为 strutsValidator-validation.xml,它也位于 /WEB-INF 中。下面将描述此文件。
在 strutsValidator-validation.xml 文件中,使用默认验证器定义实现实际的表单验证。例如:
<form-validation> <formset> <form name="myForm"> <field property="email" depends="required"> <arg0 key="email.displayName"/> </field> <field property="age" depends="required,integer"> <arg0 key="age.displayName"/> </field> </form> </formset> </form-validation>
当在 JSP 文件中显示错误时,资源文件包含实际的错误消息和要应用的任何专用 HTML 格式。请记住,此文件位于 WEB-INF/classes/... 下,并具有 properties 扩展名。在此示例中,Messages.properties 文件位于 /WEB-INF/classes/validation/validator 中。
errors.header=<br><hr><font color="Blue">List of errors, using the <netui:error> tag:<ul> errors.prefix=<li> errors.suffix= errors.footer=</ul></font>
error.prefix=<font color="Red"> error.suffix=</font>
errors.required={0} is required. errors.integer={0} must be an integer.
email.displayName=The email address age.displayName=The age
请注意,在示例中,email.displayName 描述表单字段名,而 errors.required 描述用于缺少(但必需)表单字段项的错误消息。如果用户没有键入电子邮件地址,则出现的错误消息将是“The email address is required”。文件中的其他行创建 netui:error 和 netui:errors 标记的格式,以便单个错误消息用红色显示,错误概要用蓝色显示为一个列表,前加标头“List of errors, using <netui:error> tag:”。
相关文章推荐
- Thinkphp+AJAX动态验证用户输入是否合法
- Core Data浅谈系列之六 : 验证用户输入
- 使用AT SELECTION-SCREEN事件验证用户输入条件的反思
- Javascript验证用户输入URL地址是否为空及格式是否正确
- Javascript与PHP验证用户输入URL地址是否正确
- <java EE 项目:petstore> 从一个简单项目看 java web 如何在本jsp页面上对用户输入的格式进行限制与验证
- 使用AT SELECTION-SCREEN事件验证用户输入条件的反思
- ASP.NET学习手记:验证用户表单输入
- 使用JSP标签库验证用户的输入(1)
- 一步步学习SPD2010--第十四章节--在Web页面使用控件(3)--验证用户数据输入
- Ajax 验证用户输入的验证码是否与随机生成的一致
- PHP中进行日期用户输入生日有效性验证
- nginx 用户访问站点输入用户名密码验证
- 个人收藏使用javascript 做用户输入验证
- (3)验证用户的输入
- 用户输入验证
- WPF入门(五):简单绑定 - 用户输入合法性验证
- ASP.NET学习手记:验证用户表单输入
- 订餐系统总结(一)验证用户输入
- ASP.NET学习手记:验证用户表单输入