Struts 2之HelloWorld(下)

七.完成程序的国际化 因为一个企业应用经常要面对多区域的用户,因此,程序国际化是一个企业应用必须实现的功能.Struts2提供了非常好的程序国际化的支持. (1) 定义国际化资源文件 程序国际化设计思想是非常简单的,其主要的思想就是:程序界面中需要输出国际化信息的地方,我们不要再页面中直接输出信息,而是输出一个key值,该key值在不同的语言下对应不同的字符串.当程序需要显示的时候,程序将根据不同的语言环境,加载该key对应语言环境下的字符串,这样就可以完成程序的国际化. 为了给本应用增加程序国际化支持(支持中文和英文),则应该提供两份语言资源文件,下面是本应用程序所使用的中文语言环境下的资源文件的代码: view plaincopy to clipboardprint? 1. loginPage=登录页面 2. errorPage=错误页面 3. succPage=成功页面 4. failTip=对不起,您不能够登录 5. viewLink=查看图书列表 6. bookPageTitle=所有图书列表 7. bookName=书名 8. user=用户名 9. pass=密码 10. login=登录 loginPage=登录页面 errorPage=错误页面 succPage=成功页面 failTip=对不起,您不能够登录 viewLink=查看图书列表 bookPageTitle=所有图书列表 bookName=书名 user=用户名 pass=密码 login=登录 因为资源文件中包含了非西欧字符,因此必须使用native2ascii命令来处理该文件,将上面的文件保存在WEB-INF/classes路径下,文件名称为”messageResource.properties”保存该文件后,使用native2ascii命令来处理该文件,处理该文件的命令格式为: view plaincopy to clipboardprint? 1. native2ascii messageResource.properties messageResources_zh_CN.properties native2ascii messageResource.properties messageResources_zh_CN.properties 上面命令将包含非西欧字符的资源文件处理成ASCII格式,处理完成后生成了一份新的文件:messageResource_zh_CN.properties文件.这个文件的文件名符合资源文件的命名格式,资源文件的文件名的命名格式为: view plaincopy to clipboardprint? 1. basename_语言代码_国家代码.properties basename_语言代码_国家代码.properties 当请求来自简体中文的语言环境的时候,系统将自动的使用这种资源文件的内容输出. 除此之外,还应该提供如下英文语言环境下的资源文件: view plaincopy to clipboardprint? 1. loginPage=Login Page 2. errorPage=Error Page 3. succPage=Welcome Page 4. failTip=Sorry,you can't log in! 5. viewLink=View Books 6. bookPageTitle=All Books List 7. bookName=Book Name 8. user=User Name 9. pass=Password 10. login=Login loginPage=Login Page errorPage=Error Page succPage=Welcome Page failTip=Sorry,you can't log in! viewLink=View Books bookPageTitle=All Books List bookName=Book Name user=User Name pass=Password login=Login 将上面的资源文件保存在/WEB-INF/classes路径下面,文件名字为”messageResource_cn_US.properties”.当请求来自美国的时候,系统自动使用这份资源文件内容输出. (2) 加载资源文件 Struts2支持在JSP页面当中临时加载资源文件,也支持通过全局属性来加载资源文件,通过全局属性加载资源文件更加简单,本应用使用全局属性加载Struts2国际化资源文件. 加载资源文件可以通过struts.properties文件来定义,本应用的struts.properties文件仅有一行代码: view plaincopy to clipboardprint? 1. //定义Struts 2的资源文件的baseName是messageResource 2. struts.custom.i18n.resources=messageResource //定义Struts 2的资源文件的baseName是messageResource struts.custom.i18n.resources=messageResource 在struts.properties文件中增加上面的代码定义之后,表明该应用使用的资源文件的baseName为”messageResource”这与我们的前面保存的资源文件的baseName是一直的. Struts2默认加载WEB-INF/classes下面的资源文件,如果将该资源文件放在/WEB-INF/classes中的子路径下面,则需要修改struts.properties中的定义如下: view plaincopy to clipboardprint? 1. struts.custom.i18n.resources=supermos.messageResource struts.custom.i18n.resources=supermos.messageResource (3) 输出国际化信息 为了让程序可以显示国际化信息,则需要在JSP页面中输出key,而不是直接输出字符串常量. Struts2中提供了如下两种方式来输出国际化信息 ①:使用s:text标签来输出国际化信息. ②使用表达式方式输出国际化信息. 因此,我们再次修改表现层的JSP页面,使用国际化标签输出国际化信息.修改后的showBook.jsp页面代码如下: view plaincopy to clipboardprint? 1. <%@ page language="java" import="java.util.*" pageEncoding="utf-8"%> 2. 3. <%@taglib uri="/struts-tags" prefix="s"%> 4. 5. 6. 7. <s:property value="%{getText('bookPageTitle')}"/> 8. 9. 10. 11. 12. 13.

14. 15. 16. 17. 18. 19. 20. 21. 22. 23. 24. 25. 26. 27. 28. 29. 30. 31.

32. 33. <%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>

<%@taglib uri="/struts-tags" prefix="s"%>

<s:property value="%{getText('bookPageTitle')}"/>

我们发现,上面的JSP页面不再包含任何直接字符串,而是全部通过来输出国际化信息. 我们可以通过调整系统语言环境来观看本系统的运行状况. 八.增加数据校验 在上面的应用中,即使浏览器输入任何的用户名,密码系统也会处理用户的请求,在我们的整个Helloworld应用中,这种空用户名,空密码的问题不会引起太大的问题,但是如果数据需要保存到数据库,或者需要根据用户输入的用户名,密码查询数据,这些数据就可能会引发异常. 为了避免用户的输入引起底层的异常,通常,我们会在进行业务逻辑的操作之前,先执行基本的数据校验. (1) 继承ActionSupport ActionSupport类是一个工具类,它已经实现了Action接口,除此之外,它还实现了Validateable接口,提供了数据的校验功能.通过继承该ActionSupport类,可以简化Struts2的Action开发. 在Validatable接口中定义了一个validate()方法,重写该方法,如果校验表单输入域出现错误,则将错误添加到ActionSupport类中的fieldErrors域中,然后通过OGNL表达式负责输出. 为了让Struts2增加输入数据校验功能,改写程序中的LoginAction,增加重写validate方法,修改后的LoginAction类代码如下: view plaincopy to clipboardprint? 1. package com.supermos.app; 2. 3. import com.opensymphony.xwork2.Action; 4. import com.opensymphony.xwork2.ActionContext; 5. import com.opensymphony.xwork2.ActionSupport; 6. 7. public class LoginAction extends ActionSupport implements Action { 8. private String username; 9. private String password; 10. 11. public String getUsername() { 12. return username; 13. } 14. 15. public void setUsername(String username) { 16. this.username = username; 17. } 18. 19. public String getPassword() { 20. return password; 21. } 22. 23. public void setPassword(String password) { 24. this.password = password; 25. } 26. 27. public String execute() throws Exception { 28. 29. if ("supermos".equalsIgnoreCase(username) 30. && "ziwen".equalsIgnoreCase(password)) { 31. // 通过ActionContext对象访问Web应用的Session 32. ActionContext.getContext().getSession().put("user", getUsername()); 33. return SUCCESS; 34. } else { 35. return ERROR; 36. } 37. } 38. 39. // 完成输入校验需要重写的validate方法 40. public void validate() { 41. // 如果用户名为空,或者用户名为空字符串 42. if (getUsername() == null || getUsername().trim().equals("")) { 43. // 添加表单校验错误 44. addFieldError("username", "user.required"); 45. } 46. // 如果密码为空,或者用户名为空字符串,添加表单校验错误 47. if (getPassword() == null || getPassword().trim().equals("")) { 48. // 添加表单校验错误 49. addFieldError("password", "password.required"); 50. } 51. } 52. } package com.supermos.app; import com.opensymphony.xwork2.Action; import com.opensymphony.xwork2.ActionContext; import com.opensymphony.xwork2.ActionSupport; public class LoginAction extends ActionSupport implements Action { private String username; private String password; public String getUsername() { return username; } public void setUsername(String username) { this.username = username; } public String getPassword() { return password; } public void setPassword(String password) { this.password = password; } public String execute() throws Exception { if ("supermos".equalsIgnoreCase(username) && "ziwen".equalsIgnoreCase(password)) { // 通过ActionContext对象访问Web应用的Session ActionContext.getContext().getSession().put("user", getUsername()); return SUCCESS; } else { return ERROR; } } // 完成输入校验需要重写的validate方法 public void validate() { // 如果用户名为空,或者用户名为空字符串 if (getUsername() == null || getUsername().trim().equals("")) { // 添加表单校验错误 addFieldError("username", "user.required"); } // 如果密码为空,或者用户名为空字符串,添加表单校验错误 if (getPassword() == null || getPassword().trim().equals("")) { // 添加表单校验错误 addFieldError("password", "password.required"); } } } 上面的Action重写了validate方法,该方法会在执行系统的execute方法之前执行,如果执行该方法之后,Action类的fieldErrors中已经包含了数据校验的错误,请求将被转发到input逻辑视图处. 为了在校验失败之后,系统能够将试图转入input处,必须在配置Action时候配置input属性,下面是修改之后的loginAction的配置片段: view plaincopy to clipboardprint? 1. 2. 5. 6. 7. 8. /login.jsp 9. /success.jsp 10. /fail.jsp 11. 12. 13. /login.jsp 14. /showBook.jsp 15. 16. 17. /login.jsp /success.jsp /fail.jsp /login.jsp /showBook.jsp 运行测试一下,我们发现我们并未在输入页面输出这些校验错误信息,但是页面上却自己输出了..这是因为struts2的标签,上面的JSP页面中表单使用的不是HTML表单,而是使用了标签,这种标签已经具备了输出校验错误的能力.(Struts 2的默认已经提供了输出校验错误的能力) 但是上面的程序还有一个问题:校验信息的国际化,查看上面的Action代码发现,重写validate方法的时候,如果发生校验失败的问题,校验错误的提示信息时以硬编码的形式写死了..这样就是去了国际化的能力. 实际上,ActionSupport类已经提供了国际化信息的能力,它提供了一个getText(String key)的方法,该方法用于从资源文件中获取国际化信息,为了让校验信息支持国际化,再次改写Action里的validate方法,修改之后的validate方法代码如下: view plaincopy to clipboardprint? 1. package com.supermos.app; 2. 3. import com.opensymphony.xwork2.Action; 4. import com.opensymphony.xwork2.ActionContext; 5. import com.opensymphony.xwork2.ActionSupport; 6. 7. public class LoginAction extends ActionSupport implements Action { 8. private String username; 9. private String password; 10. 11. public String getUsername() { 12. return username; 13. } 14. 15. public void setUsername(String username) { 16. this.username = username; 17. } 18. 19. public String getPassword() { 20. return password; 21. } 22. 23. public void setPassword(String password) { 24. this.password = password; 25. } 26. 27. public String execute() throws Exception { 28. 29. if ("supermos".equalsIgnoreCase(username) 30. && "ziwen".equalsIgnoreCase(password)) { 31. // 通过ActionContext对象访问Web应用的Session 32. ActionContext.getContext().getSession().put("user", getUsername()); 33. return SUCCESS; 34. } else { 35. return ERROR; 36. } 37. } 38. 39. // 完成输入校验需要重写的validate方法 40. public void validate() { 41. // 如果用户名为空,或者用户名为空字符串 42. if (getUsername() == null || getUsername().trim().equals("")) { 43. // 添加表单校验错误 44. addFieldError("username", getText("user.required")); 45. } 46. // 如果密码为空,或者用户名为空字符串,添加表单校验错误 47. if (getPassword() == null || getPassword().trim().equals("")) { 48. // 添加表单校验错误 49. addFieldError("password", getText("password.required")); 50. } 51. } 52. } package com.supermos.app; import com.opensymphony.xwork2.Action; import com.opensymphony.xwork2.ActionContext; import com.opensymphony.xwork2.ActionSupport; public class LoginAction extends ActionSupport implements Action { private String username; private String password; public String getUsername() { return username; } public void setUsername(String username) { this.username = username; } public String getPassword() { return password; } public void setPassword(String password) { this.password = password; } public String execute() throws Exception { if ("supermos".equalsIgnoreCase(username) && "ziwen".equalsIgnoreCase(password)) { // 通过ActionContext对象访问Web应用的Session ActionContext.getContext().getSession().put("user", getUsername()); return SUCCESS; } else { return ERROR; } } // 完成输入校验需要重写的validate方法 public void validate() { // 如果用户名为空,或者用户名为空字符串 if (getUsername() == null || getUsername().trim().equals("")) { // 添加表单校验错误 addFieldError("username", getText("user.required")); } // 如果密码为空,或者用户名为空字符串,添加表单校验错误 if (getPassword() == null || getPassword().trim().equals("")) { // 添加表单校验错误 addFieldError("password", getText("password.required")); } } } 在上面的validate方法中,添加校验错误提示的时候,并不是直接给出了错误的字符串,而是调用了getText方法来获取错误提示.在国际化资源文件中添加这两条提示信息.(ActionSupport增加了让提示信息国际化的能力,ActionSupport提供的getText方法可以根据资源文件加载获得国际化提示信息.) (2) 使用Struts2的校验框架 上面的方法是通过重写ActionSupport类的validate方法来实现的,这种方法虽然不错,但是需要大量重写validate方法,毕竟重复书写相同的代码不是一件吸引人的事情. 就像Struts1一样,Struts2也允许通过定义配置文件来完成数据的校验,Struts2的校验框架实际上是基于Xwork的validator框架: 下面还是使用原来的Action类(即不重写validate方法),却增加了一个校验配置文件,校验配置文件通过使用Struts2已有的校验器,完成对表单域的校验.Struts2提供了大量的数据校验器,包括表单域校验器和非表单域校验器两种. 本应用主要使用了requiredstring校验器,该校验器是一个必填校验器---指定某个表单域必须输入. 下面是校验规则的定义文件: view plaincopy to clipboardprint? 1. 2. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 定义完该校验规则文件之后,该文件的命名应该遵守如下规则: ActionName-validate.xml:其中ActionName就是需要校验的Action的类名 因此上面的校验规则文件就应该命名为”LoginAction-validate.xml”且,该文件应该与Action类的class文件位于同一个路径下. 当然,在struts.xml文件的Action定义中,一样需要定义input的逻辑视图名,并将input逻辑视图映射到login.jsp表单. 如果不输入用户名,密码而提交表单,将再次看到如图2.14所示的界面.在这种校验方式下,无需书写校验代码,只要通过配置文件配置指定的校验规则就可以了.因此提供了更好的可维护性.