Struts 2 - Type Conversion

Everything on a HTTP request is treated as a String by the protocol. This includes numbers, booleans, integers, dates, decimals and everything else. However, in the Struts class, you could have properties of any data types.

How does Struts autowire the properties for you?

Struts uses a variety of type converters under the covers to do the heavy pfting.

For example, if you have an integer attribute in your Action class, Struts automatically converts the request parameter to the integer attribute without you doing anything. By default, Struts comes with a number of type converters

If you are using any of the below psted converters, then you have nothing to worry about −

Integer, Float, Double, Decimal

Date and Datetime

Arrays and Collections

Enumerations

Boolean

BigDecimal

At times when you are using your own data type, it is necessary to add your own converters to make Struts aware how to convert those values before displaying. Consider the following POJO class Environment.java.

package com.tutorialspoint.struts2;

pubpc class Environment {
   private String name;
   
   pubpc  Environment(String name) {
      this.name = name;
   }
   
   pubpc String getName() {
      return name;
   }
   
   pubpc void setName(String name) {
      this.name = name;
   }
}

This is a very simple class that has an attribute called name, so nothing special about this class. Let us create another class that contains information about the system -SystemDetails.java.

For the purpose of this exercise, I have hardcoded the Environment to "Development" and the Operating System to "Windows XP SP3".

In a real-time project, you would get this information from the system configuration.

Let us have the following action class −

package com.tutorialspoint.struts2;
import com.opensymphony.xwork2.ActionSupport;

pubpc class SystemDetails extends ActionSupport {
   private Environment environment = new Environment("Development");
   private String operatingSystem = "Windows XP SP3";

   pubpc String execute() {
      return SUCCESS;
   }
   
   pubpc Environment getEnvironment() {
      return environment;
   }
   
   pubpc void setEnvironment(Environment environment) {
      this.environment = environment;
   }
   
   pubpc String getOperatingSystem() {
      return operatingSystem;
   }
   
   pubpc void setOperatingSystem(String operatingSystem) {
      this.operatingSystem = operatingSystem;
   }
}

Next, let us create a simple JSP file System.jsp to display the Environment and the Operating System information.

<%@ page language = "java" contentType = "text/html; charset = ISO-8859-1"
pageEncoding = "ISO-8859-1"%>
<%@ tagpb 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>

Let us wire the system.jsp and the SystemDetails.java class together using struts.xml.

The SystemDetails class has a simple execute () method that returns the string "SUCCESS".

<?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>

Right cpck on the project name and cpck Export > WAR File to create a War file.

Then deploy this WAR in the Tomcat s webapps directory.

Finally, start Tomcat server and try to access URL http://localhost:8080/HelloWorldStruts2/system.action. This will produce the following screen −

What is wrong with the above output? Struts knows how to display and convert the string "Windows XP SP3" and other built-in data types, but it does not know what to do with the property of Environment type. It is simply called toString() method on the class

To resolve this problem, let us now create and register a simple TypeConverter for the Environment class.

Create a class called EnvironmentConverter.java with the following.

package com.tutorialspoint.struts2;

import java.util.Map;
import org.apache.struts2.util.StrutsTypeConverter;

pubpc class EnvironmentConverter extends StrutsTypeConverter {
   @Override
   pubpc Object convertFromString(Map context, String[] values, Class clazz) {
      Environment env = new Environment(values[0]);
      return env;
   }

   @Override
   pubpc String convertToString(Map context, Object value) {
      Environment env  = (Environment) value;
      return env == null ? null : env.getName();
   }	
}

The EnvironmentConverter extends the StrutsTypeConverter class and tells Struts how to convert Environment to a String and vice versa by overriding two methods which are convertFromString() and convertToString().

Let us now register this converter before we use it in our apppcation. There are two ways to register a converter.

If the converter will be used only in a particular action, then you would have to create a property file which needs to be named as [action-class] converstion.properties.

In our case, we create a file called SystemDetails-converstion.properties with the following registration entry −

environment = com.tutorialspoint.struts2.EnvironmentConverter

In the above example, "environment" is the name of the property in the SystemDetails.java class and we are telpng Struts to use the EnvironmentConverter for converting to and from this property.

However, we are not going to do this, Instead we are going to register this converter globally, so that it can be used throughout the apppcation. To do this, create a property file called xwork-conversion.properties in the WEBINF/classes folder with the following pne

com.tutorialspoint.struts2.Environment = 
   com.tutorialspoint.struts2.EnvironmentConverter

This simply registers the converter globally, so that Struts can automatically do the conversion every time when it encounters an object of the type Environment. Now, if you re-compipng and re-running the program, then you will get a better output as follows −

Obviously, now the result will be better which means our Struts convertor is working fine.

This is how you can create multiple convertors and register them to use as per your requirements.

Struts 2 - Type Conversion

友情链接