(十六)Struts2 类型转换
HTTP请求上的所有内容都按协议处理为字符串,包括数字,布尔值,整数,日期,小数和其他。对HTTP来说,每个事件都是一个字符串。但是,在Struts类中,你可以具有任意数据类型的属性。我们如何让Struts自动匹配属性呢?
Struts使用各种类型的转换器在幕后做了许多繁重的工作。例如,如果你的Action类中有一个integer属性,你不需要执行任何操作,Struts会自动将请求参数转换为integer属性。默认情况下,Struts提供了多个类型的转换器。其中一些列出如下,如果你使用其中一个,那你就不用担心什么了:
-
Integer,Float,Double,Decimal
-
Date,Datetime
-
Arrays,Collections
-
Enumerations
-
Boolean
-
BigDecimal
有时,当你使用自己的数据类型时,有必要添加自己的转换器,以使Struts知道如何在显示之前转换这些值。可以考虑使用下面的POJO类Environment.java。
package cn.w3cschool.struts2; public class Environment { private String name; public Environment(String name) { this.name = name; } public String getName() { return name; } public void setName(String name) { this.name = name; } }
这是一个非常简单的类,它有一个name属性,除此之外没有什么特别的。让我们接下来创建另一个包含系统信息的类:SystemDetails.java。 出于练习的目的,我们是将环境硬编码为“开发”,操作系统为“Windows XP SP3”。而在实际项目中,你会从系统配置中获取这些信息。那么让我们先创建以下action类:
package cn.w3cschool.struts2; import com.opensymphony.xwork2.ActionSupport; public class SystemDetails extends ActionSupport { private Environment environment = new Environment("Development"); private String operatingSystem = "Windows XP SP3"; public String execute() { return SUCCESS; } public Environment getEnvironment() { return environment; } public void setEnvironment(Environment environment) { this.environment = environment; } public String getOperatingSystem() { return operatingSystem; } public void setOperatingSystem(String operatingSystem) { this.operatingSystem = operatingSystem; } }
接着让我们创建一个简单的JSP文件System.jsp来显示环境和操作系统信息。
<%@ page language="java" contentType="text/html; charset=ISO-8859-1" pageEncoding="ISO-8859-1"%> <%@ taglib prefix="s" uri="/struts-tags"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <title>System Details</title> </head> <body> Environment: <s:property value="environment"/><br/> Operating System:<s:property value="operatingSystem"/> </body> </html>
让我们使用struts.xml连接system.jsp和SystemDetails.java类。 SystemDetails类有一个简单的可返回字符串“SUCCESS”的execute()方法。
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> <struts> <constant name="struts.devMode" value="true" /> <package name="helloworld" extends="struts-default"> <action name="system" class="com.tutorialspoint.struts2.SystemDetails" method="execute"> <result name="success">/System.jsp</result> </action> </package> </struts>
现在,右键单击项目名称,然后单击“Export”> “WAR File”以创建WAR文件。然后在Tomcat的webapps目录中部署WAR文件。最后,启动Tomcat服务器并尝试访问URL http://localhost:8080/HelloWorldStruts2/system.action,将显示以下界面:
上面的输出有什么问题? Struts知道如何显示和转换“Windows XP SP3”字符串和其他内置数据类型,但它不知道如何处理Environment类型的属性。所以,它只是简单地在类上调用了toString()方法。为了解决这个问题,让我们现在为Environment类创建和注册一个简单的TypeConverter。创建一个名为EnvironmentConverter.java的类,包含有以下内容:
package cn.w3cschool.struts2; import java.util.Map; import org.apache.struts2.util.StrutsTypeConverter; public class EnvironmentConverter extends StrutsTypeConverter { @Override public Object convertFromString(Map context, String[] values, Class clazz) { Environment env = new Environment(values[0]); return env; } @Override public String convertToString(Map context, Object value) { Environment env = (Environment) value; return env == null ? null : env.getName(); } }
EnvironmentConverter扩展了StrutsTypeConverter类,并告诉Struts如何通过覆盖convertFromString()和convertToString()两个方法将Environment转换为String,反之亦然。 现在,让我们在使用前先在应用程序中注册这个转换器,有两种方式注册转换器。如果转换器将只在特定的操作中使用,那么你必须创建一个命名为'[action-class]'-converstion.properties的属性文件,所以,在我们的例子中,创建了一个包含以下注册表的名为SystemDetails-converstion.properties文件:
environment=cn.w3cschool.struts2.EnvironmentConverter
在上面的例子中,“environment”是SystemDetails.java类中属性的名称,用以告诉Struts使用EnvironmentConverter来转换这个属性。但是,我们的做法将会相反,我们会全局注册这个转换器,以便它可以在整个应用程序中使用。因此,需要在WEB-INF/classes文件夹中创建一个名为xwork-conversion.properties的属性文件,使用以下内容:
cn.w3cschool.struts2.Environment = cn.w3cschool.struts2.EnvironmentConverter
这简单地将转换器进行了全局注册,使得Struts可以在每次遇到类型为Environment的对象时自动执行转换。现在,如果你重新编译并重新运行程序,你会得到一个更好的输出结果,如下所示:
显然,现在的结果是更好的,这意味着我们的Struts转换器工作正常。这就是如何根据你的要求创建多个转换器和注册使用它们。