Spring MVC请求参数类型转换


对于 Spring MVC 框架而言,它必须将请求参数转换成值对象类中各属性对应的数据类型。
类型转换是在视图与控制器相互传递数据时发生的。Spring MVC 框架对于基本类型(例如 int、long、float、double、boolean 以及 char 等)已经做好了基本类型转换
在 Web 应用中由 HTTP 发送的请求数据到控制器中都是以 String 类型获取,因此在 Web 应用中选择 Formatter<T> 比选择 Converter<S,T> 更加合理

Converter(类型转换器)详解

Spring MVC 框架的 Converter<S,T> 是一个可以将一种数据类型转换成另一种数据类型的接口,这里 S 表示源类型,T 表示目标类型。开发者在实际应用中使用框架内置的类型转换器基本上就够了,但有时需要编写具有特定功能的类型转换器。

内置的类型转换器

在 Spring MVC 框架中,对于常用的数据类型,开发者无须创建自己的类型转换器,因为 Spring MVC 框架有许多内置的类型转换器用于完成常用的类型转换。Spring MVC 框架提供的内置类型转换包括以下几种类型。
1)标量转换器
在这里插入图片描述
2)集合、数组相关转换器
在这里插入图片描述

如图 1 所示的添加商品页面用于收集用户输入的商品信息,商品信息包括商品名称(字符串类型 String)、商品价格(双精度浮点类型 double)、商品数量(整数类型 int)。
在这里插入图片描述
addGoods.jsp页面的代码如下:

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>添加商品信息</title>
</head>
<body>
    <form action="addGoods" method="post">
        <table border=1 bgcolor="lightblue" align="center">
            <tr>
                <td>商品名称:</td>
                <td><input class="textSize" type="text" name="goodsname" /></td>
            </tr>
            <tr>
                <td>商品价格:</td>
                <td><input class="textSize" type="text" name="goodsprice" /></td>
            </tr>
            <tr>
                <td>商品数量:</td>
                <td><input class="textSize" type="text" name="goodsnumber" /></td>
            </tr>
            <tr>
                <td colspan="2" align="center">
                    <input type="submit" value="提交" />
                </td>
            </tr>
        </tab1e>
    </form>
</body>
</html>

类型转换是在视图与控制器相互传递数据时发生的。Spring MVC 框架对于基本类型(例如 int、long、float、double、boolean 以及 char 等)已经做好了基本类型转换。例如,对于 addGoods.jsp 的提交请求,可以由以下处理方法来接收请求参数并处理:

package controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class Goodsontroller {
    @RequestMapping("/addGoods")
    public String add(String goodsname, double goodsprice, int goodsnumber) {
        double total = goodsprice * goodsnumber;
        System.out.println(total);
        return "success";
    }
}

注意:在使用内置类型转换器时,请求参数输入值与接收参数类型要兼容,否则会报 400 错误。请求参数类型与接收参数类型不兼容问题需要学习输入校验后才可解决。

自定义类型转换器

当 Spring MVC 框架内置的类型转换器不能满足需求时,开发者可以开发自己的类型转换器。

例如有一个应用 springMVCDemo03 希望用户在页面表单中输入信息来创建商品信息。当输入“apple,10.58,200”时表示在程序中自动创建一个 new Goods,并将“apple”值自动赋给 goodsname 属性,将“10.58”值自动赋给 goodsprice 属性,将“200”值自动赋给 goodsnumber 属性。
springMVCDemo03 应用与 springMVCDemo01 具有相同的 JAR 包、web.xml。

如果想实现上述应用,需要做以下 5 件事:

  • 创建实体类。
  • 创建控制器类。
  • 创建自定义类型转换器类。
  • 注册类型转换器。
  • 创建相关视图。

按照上述步骤采用自定义类型转换器完成需求。
1)创建实体类
在 springMVCDemo03 的 src 目录下创建 pojo 包,并在该包中创建名为 GoodsModel 的实体类,代码如下:

package pojo;
public class GoodsModel {
    private String goodsname;
    private double goodsprice;
    private int goodsnumber;
    // 省略setter和getter方法
}

2)创建控制器类
在 springMVCDemo03 的 src 目录下创建 controller 包,并在该包中创建名为 ConverterController 的控制器类,代码如下:

package controller;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import pojo.GoodsModel;
@Controller
@RequestMapping("/my")
public class ConverterController {
    @RequestMapping("/converter")
    /*
     * 使用@RequestParam
     * ("goods")接收请求参数,然后调用自定义类型转换器GoodsConverter将字符串值转换为GoodsModel的对象gm
     */
    public String myConverter(@RequestParam("goods") GoodsModel gm, Model model) {
        model.addAttribute("goods", gm);
        return "showGoods";
    }
}

3)创建自定义类型转换器类
自定义类型转换器类需要实现 Converter<S,T> 接口,重写 convert(S) 接口方法。

convert(S) 方法的功能是将源数据类型 S 转换成目标数据类型 T。在 springMVCDemo03 的 src 目录下创建 converter 包,并在该包中创建名为 GoodsConverter 的自定义类型转换器类,代码如下:

package converter;
import org.springframework.core.convert.converter.Converter;
import pojo.GoodsModel;
public class GoodsConverter implements Converter<String, GoodsModel> {
    public GoodsModel convert(String source) {
        // 创建一个Goods实例
        GoodsModel goods = new GoodsModel();
        // 以“,”分隔
        String stringvalues[] = source.split(",");
        if (stringvalues != null && stringvalues.length == 3) {
            // 为Goods实例赋值
            goods.setGoodsname(stringvalues[0]);
            goods.setGoodsprice(Double.parseDouble(stringvalues[1]));
            goods.setGoodsnumber(Integer.parseInt(stringvalues[2]));
            return goods;
        } else {
            throw new IllegalArgumentException(String.format(
                    "类型转换失败, 需要格式'apple, 10.58,200 ',但格式是[% s ] ", source));
        }
    }
}

4)注册类型转换器
在 springMVCDemo03 的 WEB-INF 目录下创建配置文件 springmvc-servlet.xml,并在配置文件中注册自定义类型转换器,配置文件代码如下:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:mvc="http://www.springframework.org/schema/mvc"
    xmlns:p="http://www.springframework.org/schema/p" xmlns:context="http://www.springframework.org/schema/context"
    xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd">
    <!-- 使用扫描机制扫描控制器类,控制器类都在controller包及其子包下 -->
    <context:component-scan base-package="controller" />
    <!--注册类型转换器GoodsConverter-->
    <bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">
        <property name="converters">
            <list>
                <bean class="converter.GoodsConverter"/>
            </list>
        </property>
    </bean>
    <bean
        class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/jsp/" />
        <property name="suffix" value=".jsp" />
    </bean>
</beans>

5)创建相关视图
在 springMVCDemo03 应用的 WebContent 目录下创建信息采集页面 input.jsp,核心代码如下:

<form action="${pageContext.request.contextPath}/my/converter" method= "post">
    请输入商品信息(格式为apple, 10.58,200:
    <input type="text" name="goods" /><br>
    <input type="submit" value="提交" />
</form>

在 springMVCDemo03 应用的 /WEB-INF/jsp 目录下创建信息显示页面 showGoods.jsp,核心代码如下:

<body>
    您创建的商品信息如下:
    <!-- 使用EL表达式取出model中的goods信息 -->
    商品名称为:${goods.goodsname }
    商品价格为:${goods.goodsprice }
    商品名称为:${goods.goodsnumber }
</body>

最后,使用地址“ http://localhost:8080/springMVCDemo03 /input.jsp ”测试应用。

Formatter(数据格式化)详解

Spring MVC 框架的 Formatter 与 Converter<S,T> 一样,也是一个可以将一种数据类型转换成另一种数据类型的接口。不同的是,Formatter 的源数据类型必须是 String 类型,而 Converter<S,T> 的源数据类型是任意数据类型。

在 Web 应用中由 HTTP 发送的请求数据到控制器中都是以 String 类型获取,因此在 Web 应用中选择 Formatter<T> 比选择 Converter<S,T> 更加合理

内置的格式化转换器

Spring MVC 提供了几个内置的格式化转换器,具体如下。

  • NumberFormatter:实现 Number 与 String 之间的解析与格式化。
  • CurrencyFormatter:实现 Number 与 String 之间的解析与格式化(带货币符号)。
  • PercentFormatter:实现 Number 与 String 之间的解析与格式化(带百分数符号)。
  • DateFormatter:实现 Date 与 String 之间的解析与格式化。

自定义格式化转换器

自定义格式化转换器就是编写一个实现 org.springframework.format.Formatter 接口的 Java 类。该接口声明如下:

public interface Formatter<T>

这里的 T 表示由字符串转换的目标数据类型。该接口有 parse 和 print 两个接口方法,自定义格式化转换器类必须覆盖它们。

public T parse(String s,java.util.Locale locale)
public String print(T object,java.util.Locale locale)

parse 方法的功能是利用指定的 Locale 将一个 String 类型转换成目标类型,print 方法与之相反,用于返回目标对象的字符串表示。

下面通过具体应用 springMVCDemo04 讲解自定义格式化转换器的用法,springMVCDemo04 应用与 springMVCDemo03 应用具有相同的 JAR 包、web.xml。

应用的具体要求如下:

1)用户在页面表单中输入信息来创建商品,输入页面效果如图 1 所示。
在这里插入图片描述
2)控制器使用实体 bean 类 GoodsModelb 接收页面提交的请求参数,GoodsModelb 类的属性如下。

private String goodsname;
private double goodsprice;
private int goodsnumber;
private Date goodsdate;

3)GoodsModelb 实体类接收请求参数时,商品名称、价格和数量使用内置的类型转换器完成转换;商品日期需要用自定义的格式化转换器完成。
4)用格式化转换器转换之后的数据显示在 showGoodsb.jsp 页面,效果如图 2 所示。
在这里插入图片描述
由图 2 可以看出,日期由字符串值“2018-02-22”格式化成 Date 类型。

如果想实现上述 springMVCDemo04 应用的需求,需要做以下 5 件事:

  • 创建实体类;
  • 创建控制器类;
  • 创建自定义格式化转换器类;
  • 注册格式化转换器;
  • 创建相关视图。

按照上述步骤采用自定义格式化转换器完成需求。
1)创建实体类
在 springMVCDemo04 的 src 目录下创建 pojo 包,并在该包中创建名为 GoodsModelb 的实体类,代码如下:

package pojo;
import java.util.Date;
public class GoodsModel {
    private String goodsname;
    private double goodsprice;
    private int goodsnumber;
    private Date goodsdate;
    //省略setter和getter方法
}

2)创建控制器类
在 springMVCDemo04 的 src 目录下创建 controller 包,并在该包中创建名为 FormatterController 的控制器类,代码如下:

package controller;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import pojo.GoodsModelb;
@Controller
public class FormatterController {
    @RequestMapping("/formatter")
    public String myConverter(GoodsModelb gm, Model model) {
        model.addAttribute("goods", gm);
        return "showGoodsb";
    }
}

3)创建自定义格式化转换器类
在 springMVCDemo04 的 src 目录下创建 formatter 包,并在该包中创建名为 MyFormatter 的自定义格式化转换器类,代码如下:

package controller;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Locale;
import org.springframework.format.Formatter;
public class MyFormatter implements Formatter<Date> {
    SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd");
    public String print(Date object, Locale arg1) {
        return dateFormat.format(object);
    }
    public Date parse(String source, Locale arg1) throws ParseException {
        return dateFormat.parse(source); // Formatter只能对字符串转换
    }
}

4)注册格式化转换器
在 springMVCDemo04 的 WEB-INF 目录下创建配置文件 springmvc-servlet.xml,并在配置文件中注册格式化转换器,具体代码如下:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:mvc="http://www.springframework.org/schema/mvc"
    xmlns:p="http://www.springframework.org/schema/p" xmlns:context="http://www.springframework.org/schema/context"
    xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd">
    <!-- 使用扫描机制扫描controller包 -->
    <context:component-scan base-package="controller" />
    <!--注册MyFormatter-->
    <bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">
        <property name="formatters">
            <list>
                <bean class="formatter.MyFormatter"/>
            </list>
        </property>
    </bean>
    <mvc:annotation-driven conversion-service="conversionService"/>
    <bean
        class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/jsp/" />
        <property name="suffix" value=".jsp" />
    </bean>
</beans>

5)创建相关视图
在 springMVCDemo04 应用的 WebContent 目录下创建信息输入页面 inputb.jsp,核心代码如下:

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>添加商品信息</title>
</head>
<body>
    <form action="addGoods" method="post">
        <table border=1 bgcolor="lightblue" align="center">
            <tr>
                <td>商品名称:</td>
                <td><input class="textSize" type="text" name="goodsname" /></td>
            </tr>
            <tr>
                <td>商品价格:</td>
                <td><input class="textSize" type="text" name="goodsprice" /></td>
            </tr>
            <tr>
                <td>商品数量:</td>
                <td><input class="textSize" type="text" name="goodsnumber" /></td>
            </tr>
            <tr>
                <td>商品日期:</td>
                <td><input class="textSize" type="text" name="goodsdata" />(yyyy-MM-dd)</td>
            </tr>
            <tr>
                <td colspan="2" align="center">
                    <input type="submit" value="提交" />
                </td>
            </tr>
        </tab1e>
    </form>
</body>
</html>

在 springMVCDemo04 应用的 /WEB-INF/jsp 目录下创建信息显示页面 showGoodsb.jsp,核心代码如下:

<body>
    您创建的商品信息如下:
    <!-- 使用EL表达式取出Action类的属性goods的值 -->
    商品名称为:${goods.goodsname }<br/>
    商品价格为:${goods.goodsprice }<br/>
    商品名称为:${goods.goodsnumber }<br/>
    商品日期为:${goods.goodsdate}
</body>

最后通过地址“http://localhost:8080/springMVCDemo04/inputb.jsp”测试应用。

JSON 数据转换

JSON 数据转换:https://blog.csdn.net/Bonport/article/details/105144586

内容出处:http://c.biancheng.net/spring_mvc/

发布了96 篇原创文章 · 获赞 396 · 访问量 6225

猜你喜欢

转载自blog.csdn.net/Bonport/article/details/105118051