← 返回学习路线

SYSTEM

请求处理

Java基础请求处理system
src/content/notes/system/请求处理.md

基本操作

请求处理

普通类型

SpringMVC 将传递的参数封装到处理器方法的形参中,达到快速访问参数的目的

  • 访问 URL:http://localhost/requestParam1?name=seazean&age=14

    @Controller
    public class UserController {
        @RequestMapping("/requestParam1")
        public String requestParam1(String name ,int age){
            System.out.println("name=" + name + ",age=" + age);
            return "page.jsp";
        }
    }
    <%@page pageEncoding="UTF-8" language="java" contentType="text/html;UTF-8" %>
    <html>
    <body>
    	<h1>请求参数测试页面</h1>
    </body>
    </html>

@RequestParam 的使用:

  • 类型:形参注解

  • 位置:处理器类中的方法形参前方

  • 作用:绑定请求参数与对应处理方法形参间的关系

  • 访问 URL:http://localhost/requestParam2?userName=Jock

    @RequestMapping("/requestParam2")
    public String requestParam2(@RequestParam(
                                name = "userName",
                                required = true,	//为true代表必须有参数
                                defaultValue = "s") String name){
        System.out.println("name=" + name);
        return "page.jsp";
    }

POJO类型

简单类型

当 POJO 中使用简单类型属性时, 参数名称与 POJO 类属性名保持一致

  • 访问 URL: http://localhost/requestParam3?name=seazean&age=14

    @RequestMapping("/requestParam3")
    public String requestParam3(User user){
        System.out.println("name=" + user.getName());
        return "page.jsp";
    }
    public class User {
        private String name;
        private Integer age;
        //......
    }

参数冲突

当 POJO 类型属性与其他形参出现同名问题时,将被同时赋值,建议使用 @RequestParam 注解进行区分

  • 访问 URL: http://localhost/requestParam4?name=seazean&age=14

    @RequestMapping("/requestParam4")
    public String requestParam4(User user, String age){
        System.out.println("user.age=" + user.getAge() + ",age=" + age);//14 14 
        return "page.jsp";
    }

复杂类型

当 POJO 中出现对象属性时,参数名称与对象层次结构名称保持一致

  • 访问 URL: http://localhost/requestParam5?address.province=beijing

    @RequestMapping("/requestParam5")
    public String requestParam5(User user){
        System.out.println("user.address=" + user.getAddress().getProvince());
        return "page.jsp";
    }
    public class User {
        private String name;
        private Integer age;
        private Address address; //....
    }
    public class Address {
        private String province;
        private String city;
        private String address;
    }

容器类型

POJO 中出现集合类型的处理方式

  • 通过 URL 地址中同名参数,可以为 POJO 中的集合属性进行赋值,集合属性要求保存简单数据

    访问 URL:http://localhost/requestParam6?nick=Jock1&nick=Jockme&nick=zahc

    @RequestMapping("/requestParam6")
    public String requestParam6(User user){
        System.out.println("user=" + user);
        //user = User{name='null',age=null,nick={Jock1,Jockme,zahc}}
        return "page.jsp";
    }
    public class User {
        private String name;
        private Integer age;
        private List<String> nick;
    }
  • POJO 中出现 List 保存对象数据,参数名称与对象层次结构名称保持一致,使用数组格式描述集合中对象的位置访问 URL:http://localhost/requestParam7?addresses[0].province=bj&addresses[1].province=tj

    @RequestMapping("/requestParam7")
    public String requestParam7(User user){
        System.out.println("user.addresses=" + user.getAddress());
        //{Address{provice=bj,city='null',address='null'}},{Address{....}}
        return "page.jsp";
    }
    public class User {
        private String name;
        private Integer age;
        private List<Address> addresses;
    }
  • POJO 中出现 Map 保存对象数据,参数名称与对象层次结构名称保持一致,使用映射格式描述集合中对象位置

    URL: http://localhost/requestParam8?addressMap[’home’].province=bj&addressMap[’job’].province=tj

    @RequestMapping("/requestParam8")
    public String requestParam8(User user){
        System.out.println("user.addressMap=" + user.getAddressMap());
        //user.addressMap={home=Address{p=,c=,a=},job=Address{....}}
        return "page.jsp";
    }
    public class User {
        private Map<String,Address> addressMap;
        //....
    }

数组集合

数组类型

请求参数名与处理器方法形参名保持一致,且请求参数数量> 1个


集合类型

保存简单类型数据,请求参数名与处理器方法形参名保持一致,且请求参数数量> 1个

  • 访问 URL: http://localhost/requestParam10?nick=Jockme&nick=zahc

    @RequestMapping("/requestParam10")
    public String requestParam10(@RequestParam("nick") List<String> nick){
        System.out.println(nick);
        return "page.jsp";
    }
  • 注意: SpringMVC 默认将 List 作为对象处理,赋值前先创建对象,然后将 nick 作为对象的属性进行处理。List 是接口无法创建对象,报无法找到构造方法异常;修复类型为可创建对象的 ArrayList 类型后,对象可以创建但没有 nick 属性,因此数据为空 解决方法:需要告知 SpringMVC 的处理器 nick 是一组数据,而不是一个单一属性。通过 @RequestParam 注解,将数量大于 1 个 names 参数打包成参数数组后, SpringMVC 才能识别该数据格式,并判定形参类型是否为数组或集合,并按数组或集合对象的形式操作数据


转换器

类型

开启转换配置:<mvc:annotation-driven /> 作用:提供 Controller 请求转发,Json 自动转换等功能

如果访问 URL:http://localhost/requestParam1?name=seazean&age=seazean,会出现报错,类型转化异常

@RequestMapping("/requestParam1")
public String requestParam1(String name ,int age){
    System.out.println("name=" + name + ",age=" + age);
    return "page.jsp";
}

SpringMVC 对接收的数据进行自动类型转换,该工作通过 Converter 接口实现:

  • 标量转换器

  • 集合、数组相关转换器

  • 默认转换器


日期

如果访问 URL:http://localhost/requestParam11?date=1999-09-09 会报错,所以需要日期类型转换

  • 声明自定义的转换格式并覆盖系统转换格式,配置 resources / spring-mvc.xml

    <!--5.启用自定义Converter-->
    <mvc:annotation-driven conversion-service="conversionService"/>
    <!--1.设定格式类型Converter,注册为Bean,受SpringMVC管理-->
    <bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
        <!--2.自定义Converter格式类型设定,该设定使用的是同类型覆盖的思想-->
        <property name="formatters">
            <!--3.使用set保障相同类型的转换器仅保留一个,避免冲突-->
            <set>
                <!--4.设置具体的格式类型-->
                <bean class="org.springframework.format.datetime.DateFormatter">
                    <!--5.类型规则-->
                    <property name="pattern" value="yyyy-MM-dd"/>
                </bean>
            </set>
        </property>
    </bean>
  • @DateTimeFormat 类型:形参注解、成员变量注解 位置:形参前面 或 成员变量上方 作用:为当前参数或变量指定类型转换规则

    public String requestParam12(@DateTimeFormat(pattern = "yyyy-MM-dd") Date date){
        System.out.println("date=" + date);
        return "page.jsp";
    }
    @DateTimeFormat(pattern = "yyyy-MM-dd")
    private Date date;

    依赖注解驱动支持,xml 开启配置:

    <mvc:annotation-driven />  

自定义

自定义类型转换器,实现 Converter 接口或者直接容器中注入:

  • 方式一:

    public class WebConfig implements WebMvcConfigurer {
        @Bean
        public WebMvcConfigurer webMvcConfigurer() {
            return new WebMvcConfigurer() {
                @Override
                public void addFormatters(FormatterRegistry registry) {
                    registry.addConverter(new Converter<String, Date>() {
                        @Override
                        public Pet convert(String source) {
                        	DateFormat df = new SimpleDateFormat("yyyy-MM-dd");
                            Date date = null;
                            //类型转换器无法预计使用过程中出现的异常,因此必须在类型转换器内部捕获,
                            //不允许抛出,框架无法预计此类异常如何处理
                            try {
                                date = df.parse(source);
                            } catch (ParseException e) {
                                e.printStackTrace();
                            }
                            return date;
                        }
                    });
            }
        }
    }
    
  • 方式二:

    //本例中的泛型填写的是String,Date,最终出现字符串转日期时,该类型转换器生效
    public class MyDateConverter implements Converter<String, Date> {
        //重写接口的抽象方法,参数由泛型决定
        public Date convert(String source) {
            DateFormat df = new SimpleDateFormat("yyyy-MM-dd");
            Date date = null;
            //类型转换器无法预计使用过程中出现的异常,因此必须在类型转换器内部捕获,
            //不允许抛出,框架无法预计此类异常如何处理
            try {
                date = df.parse(source);
            } catch (ParseException e) {
                e.printStackTrace();
            }
            return date;
        }
    }

    配置 resources / spring-mvc.xml,注册自定义转换器,将功能加入到 SpringMVC 转换服务 ConverterService 中

    <!--1.将自定义Converter注册为Bean,受SpringMVC管理-->
    <bean id="myDateConverter" class="converter.MyDateConverter"/>
    <!--2.设定自定义Converter服务bean-->
    <bean id="conversionService"
          class="org.springframework.context.support.ConversionServiceFactoryBean">
        <!--3.注入所有的自定义Converter,该设定使用的是同类型覆盖的思想-->
        <property name="converters">
            <!--4.set保障同类型转换器仅保留一个,去重规则以Converter<S,T>的泛型为准-->
            <set>
                <!--5.具体的类型转换器-->
                <ref bean="myDateConverter"/>
            </set>
        </property>
    </bean>
    
    <!--开启注解驱动,加载自定义格式化转换器对应的类型转换服务-->
    <mvc:annotation-driven conversion-service="conversionService"/>
  • 使用转换器

    @RequestMapping("/requestParam12")
    public String requestParam12(Date date){
        System.out.println(date);
        return "page.jsp";
    }