SpringMVC学习01：请求路径映射和参数绑定

SpringMVC入门案例

环境搭建

创建Maven项目选择webapp骨架创建(需要手动创建java和resources文件夹)，在pom.xml中导入依赖的坐标

<properties>
    <!--版本锁定，指定spring的版本-->
    <spring.version>5.0.2.RELEASE</spring.version>
  </properties>

  <dependencies>
    <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context</artifactId>
    <version>${spring.version}</version>
  </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>servlet-api</artifactId>
      <version>2.5</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>jsp-api</artifactId>
      <version>2.0</version>
      <scope>provided</scope>
    </dependency>
  </dependencies>

配置SpringMVC组件

将SpringMVC组件注入到spring容器中，在resources目录下创建SpringMVC.xml配置文件

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd">

    <!--配置spring创建时要扫描的包-->
    <context:component-scan base-package="com.chenpeng.controller"/>

    <!--配置视图解析器-->
    <bean id="internalResourceViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!--配置前缀-->
        <property name="prefix" value="/WEB-INF/pages/"></property>
        <!--配置后缀-->
        <property name="suffix" value=".jsp"></property>
    </bean>
	
    <!--配置spring开启注解mvc的支持，自动加载处理器适配器和处理器映射器-->
    <mvc:annotation-driven conversion-service="conversionService"/>
</beans>

配置SpringMVC的核心控制器，在webapp/WEB-INF目录下配置web.xml

<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >

<web-app>
  <!--配置SpringMVC的前端控制器-->
  <servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!--配置Servlet的初始化参数，读取SpringMVC的配置文件，创建spring容器-->
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:SpringMVC.xml</param-value>
    </init-param>
    <!--配置Servlet启动时加载对象-->
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>
</web-app>

创建控制器和视图页面

在java目录下创建控制器类com.chenpeng.controller.HelloController

/**
 * 控制器
 */
@Controller
@RequestMapping(path = "/user")
public class HelloController {

    /**
     * 入门案例
     * @return
     */
    @RequestMapping(path = "/hello")//请求映射注解
    public String sayHello(){
    System.out.println("Hello SpringMVC");
        return "success";
    }
}

删除骨架生成的index.jsp重新创建主页视图index.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
    <h1>入门程序</h1>
    <a href="user/hello">hello SpringMVC</a>
</body>
</html>

在webapp/WEB-INF目录下创建目录pages，在其中创建success.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" isELIgnored="false"%>
<html>
<head>
    <title>Title</title>
</head>
<body>
    <h1>入门成功</h1>
</body>
</html>

请求路径映射

@RequestMapping注解

作用：建立请求URL和处理方法之间的对应关系
可以作用在方法和类上
1. 作用在类上：第一级的访问目录
2. 作用在方法上：第二级的访问目录
3. 细节：路径可以不编写 / 表示应用的根目录开始
4. 细节：${ pageContext.request.contextPath }也可以省略不写，但是路径上不能写 /
属性
1. path：指定请求路径的url（与value属性作用相同）
2. mthod：指定方法的请求方式，可选值：
  - RequestMethod.GET
  - RequestMethod.POST
  - RequestMethod.PUT
  - RequestMethod.HEAD
3. params：指定限制请求参数的条件
4. headers：发送的请求中必须包含的请求头

@PathVariable注解

作用：绑定url中的占位符
属性：
- value：指定url中占位符的名称
restful风格url
- 请求路径一样，可以根据不同的请求方式去执行后台的不同方法

例如

<a href="anno/chenyu">PathVariable注解</a>

/**
 * PathVariable注解
 * @param id
 * @return
 */
 @RequestMapping(path = "/{id}")
 public String testPathVariable(@PathVariable(value = "id")String id){
     System.out.println(id);
     return "success";
}

请求参数的绑定

请求参数的绑定说明

绑定机制：
1. 表单提交的数据都是键值对的格式
2. SpringMVC的参数绑定过程是把表单提交的请求参数，作为控制器中方法的参数进行绑定
3. 要求提交表单的name和参数的名称是相同的
支持的数据类型：
1. 基本数据类型和String类型
2. 实体类型（JavaBean）
3. 集合数据类型（List、map集合等）

基本数据类型和String类型的参数绑定

<a href="param/testParam?name=aaa&age=20">请求参数绑定</a>

	/**
     * 请求参数绑定入门
     * @param name
     * @param age
     * @return
     */
    @RequestMapping(path = "/testParam")
    public String testParam(String name,Integer age){
        System.out.println("执行了"+name+age);
        return "success";
    }

实体类型的参数绑定

如果实体类中只有基本数据类型和String类型的属性，则需要提交表单的name和实体类中的属性名称一致，例如

public class User implements Serializable {
    private String username;
    private String password;
    private Double money;

    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 Double getMoney() {
        return money;
    }

    public void setMoney(Double money) {
        this.money = money;
    }

    @Override
    public String toString() {
        return "User{" +
                "username='" + username + '\'' +
                ", password='" + password + '\'' +
                ", money=" + money+
                '}';
    }
}

<form action="param/saveUser">
    用户名：<input type="text" name="username"><br>
    密码：<input type="text" name="password"><br>
    金额：<input type="text" name="money"><br>
    <input type="submit" value="提交">
</form>

	/**
     * 请求参数绑定把数据封装到实体类中
     * @param user
     * @return
     */
    @RequestMapping(path = "/saveUser")
    public String saveUser(User user){
        System.out.println("执行了");
        System.out.println(user);
        return "success";
    }

如果实体类中包含其他的实体类对象，那么表单的name属性需要写成对象.属性名，例如

public class Account implements Serializable {
    private String name;
    private Integer age;
    private Date birthday;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    public Date getBirthday() {
        return birthday;
    }

    public void setBirthday(Date birthday) {
        this.birthday = birthday;
    }

    @Override
    public String toString() {
        return "Account{" +
                "name='" + name + '\'' +
                ", age=" + age +
                ", birthday=" + birthday +
                '}';
    }
}

public class User implements Serializable {
    private String username;
    private String password;
    private Double money;
	private Account account;
    
    ...

    public Account getAccount() {
        return account;
    }

    public void setAccount(Account account) {
        this.account = account;
    }

    @Override
    public String toString() {
        return "User{" +
                "username='" + username + '\'' +
                ", password='" + password + '\'' +
                ", money=" + money +
                ", account=" + account +
                '}';
    }
}

<form action="param/saveUser">
    用户名：<input type="text" name="username"><br>
    密码：<input type="text" name="password"><br>
    金额：<input type="text" name="money"><br>
    姓名：<input type="text" name="account.name"><br>
    年龄：<input type="text" name="account.age"><br>
    <input type="submit" value="提交">
</form>

	/**
     * 实体类中包含其他实体类对象
     * @param account
     * @return
     */
    @RequestMapping(path = "/saveAccount")
    public String saveAccount(Account account){
        System.out.println("执行了");
        System.out.println(account);
        return "success";
    }

集合类型的参数绑定

对于list类型集合，表单的name属性需要写成list[下标].属性名

对于map类型集合，表单的name属性需要写成map[键].属性名

public class User implements Serializable {
    private String username;
    private String password;
    private Double money;
    private List<Account> list;
    private Map<String,Account> map;
    
    ...

    public List<Account> getList() {
        return list;
    }

    public void setList(List<Account> list) {
        this.list = list;
    }

    public Map<String, Account> getMap() {
        return map;
    }

    public void setMap(Map<String, Account> map) {
        this.map = map;
    }

    @Override
    public String toString() {
        return "User{" +
                "username='" + username + '\'' +
                ", password='" + password + '\'' +
                ", money=" + money +
                ", list=" + list +
                ", map=" + map +
                '}';
    }
}

<form action="param/saveUser" method="post">
    用户名：<input type="text" name="username"><br>
    密码：<input type="text" name="password"><br>
    金额：<input type="text" name="money"><br>
    姓名：<input type="text" name="list[0].name"><br>
    年龄：<input type="text" name="list[0].age"><br>
    姓名：<input type="text" name="map['cy'].name"><br>
    年龄：<input type="text" name="map['cy'].age"><br>
    <input type="submit" value="提交">
</form>

自定义类型转换器

表单提交的数据都是String类型，SpringMVC框架内部为我们进行了数据类型转换得到我们想要的数据类型，我们也可以自定义数据类型转换，自定义类型转换器需要实现Converter接口

在java目录下创建类com.chenpeng.utils.StringToDateConverter

//把字符串转换成日期格式
public class StringToDateConverter implements Converter<String, Date> {
    @Override
    public Date convert(String s) {
        if(s == null){
            throw new RuntimeException("请您输入生日");
        }else{
            SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
            try {
                return sdf.parse(s);
            } catch (ParseException e) {
                throw new RuntimeException("自定义转换出错");
            }
        }
    }
}

注册自定义类型转换器，在SpringMVC.xml中添加配置

<!--配置自定义转换器-->
    <bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">
        <property name="converters">
            <set>
                <bean class="com.chenpeng.utils.StringToDateConverter"></bean>
            </set>
        </property>
    </bean>

在控制器中使用原生ServletAPI对象

SpringMVC支持使用原生ServletAPI对象作为控制器的参数

	/**
     * Servlet的原生API对象
     * @param request,response
     * @return
     */
    @RequestMapping(path = "/testServlet")
    public String testServlet(HttpServletRequest request, HttpServletResponse response){
        System.out.println("执行了");
        System.out.println(request);
        System.out.println(response);
        return "success";
    }

解决请求参数中文乱码的问题

在webapp/WEB-INF目录下的web.xml中添加配置

<!--配置解决中文乱码的问题-->
  <filter>
    <filter-name>characterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
      <param-name>encoding</param-name>
      <param-value>UTF-8</param-value>
    </init-param>
  </filter>
  <filter-mapping>
    <filter-name>characterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>

常用注解

@RequestParam注解

作用：把请求中的指定名称的参数传递给控制器中的形参赋值
属性：
- value：请求参数中的名称
- required：请求参数中是否必须提供此参数，默认值是true，必须提供

	/**
     * RequestParam注解
     * @param username
     * @return
     */
    @RequestMapping(path = "/testRequestParam")
    public String testRequestParam(@RequestParam(name = "name")String username){//name属性和value属性可以替换使用
        System.out.println("执行了");
        System.out.println(username);
        return "success";
    }

@RequestBody注解

作用：用于获取请求体的内容（不适用与get方式请求）
属性：
- required：是否必须有请求体，默认值是true

	/**
     * RequestBody注解
     * @param body
     * @return
     */
    @RequestMapping(path = "/testRequestBody")
    public String testRequestBody(@RequestBody String body){
        System.out.println("执行了");
        System.out.println(body);
        return "success";
    }

@RequestHeader注解

作用：获取指定请求头的值
属性：
- value：请求头的名称

	/**
     * RequestHeader注解
     * @param header
     * @return
     */
    @RequestMapping(path = "/testRequestHeader")
    public String testRequestHeader(@RequestHeader(value = "Accept")String header){
        System.out.println(header);
        return "success";
    }

@CookieValue注解

作用：用于获取指定cookie的名称的值
属性：
- value：cookie的名称

	/**
     * CookieValue注解
     * @param cookieValue
     * @return
     */
    @RequestMapping(path = "/testCookieValue")
    public String testCookieValue(@CookieValue(value = "JSESSIONID")String cookieValue){
        System.out.println(cookieValue);
        return "success";
    }

@ModelAttribute注解

作用：
- 出现在方法上：表示当前方法会在控制器方法执行前线执行
- 出现在参数上：获取指定的数据给参数赋值
属性：
- value：出现在参数上时，指定数据的名称
应用场景：
- 当提交表单数据不是完整的实体数据时，保证没有提交的字段使用数据库原来的数据

	/**
     * ModelAttribute注解，作用在方法上，当前方法会在控制器方法执行钱执行
     * @return
     */
    @ModelAttribute
    public User showUser(){
        System.out.println("showUser执行了");
        User user = new User();
        user.setUsername("chenyu");
        user.setPassword("123456");
        user.setMoney(500.0);
        return user;
    }

    @RequestMapping(path = "/updateUser")
    public String updateUser(User user){
        System.out.println(user);
        return "success";
    }

@ModelAttribute
    public void showUser(Map<String,User> map){
        System.out.println("showUser执行了");
        User user = new User();
        user.setUsername("chenyuyu");
        user.setPassword("123456");
        user.setMoney(500.0);
        map.put("cy",user);
    }

    /**
     * ModelAttribute注解，作用在参数上，表示获取指定的数据给参数赋值
     * @param user
     * @return
     */
    @RequestMapping(path = "/displayUser")
    public String displayUser(@ModelAttribute(value = "cy") User user){
        System.out.println(user);
        return "success";
    }

@SessionAttributes注解

作用：用于多次执行控制器方法间的参数共享
属性：
- value：指定存入属性的名称

@SessionAttributes(value = {"username","password","age"},types = {String.class,Integer.class})
public class AnnoController {
	/**
     * 向session域中保存数据
     * @param model
     * @return
     */
    @RequestMapping(path = "/saveSession")
    public String saveSession(Model model){
        System.out.println("向session域中保存数据");
        model.addAttribute("username","chenyu");
        model.addAttribute("password","666");
        model.addAttribute("age",123456);
        return "success";
    }

    /**
     * 从session域中取出数据
     * @param modelMap
     * @return
     */
    @RequestMapping(path = "/getSession")
    public String getSession(ModelMap modelMap){
        System.out.println("从session域中取出数据");
        String username = (String) modelMap.get("username");
        String password = (String) modelMap.get("password");
        Integer age = (Integer) modelMap.get("age");
        System.out.println(username+password+age);
        return "success";
    }
    
    /**
     * 清除session域中的数据
     * @return
     */
    @RequestMapping(path = "/deleteSession")
    public String deleteSession(SessionStatus sessionStatus){
        System.out.println("清除session域中的数据");
        sessionStatus.setComplete();
        return "success";
    }
}

posted @ 2020-04-14 16:53 codeDD 阅读(374) 评论(0) 编辑收藏举报

刷新页面返回顶部

codeDD

SpringMVC学习01：请求路径映射和参数绑定

SpringMVC入门案例

请求路径映射

请求参数的绑定

常用注解

公告