SSM框架，SpringMVC框架的学习（上）

​

SpringMVC介绍

Spring Web MVC是基于Servlet API构建的原始Web框架，从一开始就包含在Spring Framework中。正式名称"Spring Web MVC"来自其源模块的名称（ spring-webmvc ），但它通常被称为"Spring MVC"。

SpringMVC涉及组件

1. DispatcherServlet : SpringMVC提供，需要使用web.xml配置使其生效，它是整个流程处理的核心，所有请求都经过它的处理和分发
2. HandlerMapping : SpringMVC提供，需要进行IoC配置使其加入IoC容器方可生效，它内部缓存handler(controller方法)和handler访问路径数据，被DispatcherServlet调用，用于查找路径对应的handler
3. HandlerAdapter : SpringMVC提供，需要进行IoC配置使其加入IoC容器方可生效，它可以处理请求参数和处理响应数据数据，每次DispatcherServlet都是通过handlerAdapter间接调用handler，他是handler和DispatcherServlet之间的适配器
4. Handler : handler又称处理器，它是Controller类内部的方法简称，是由我们自己定义，用来接收参数，向后调用业务，最终返回响应结果
5. ViewResovler : SpringMVC提供，我们需要进行IoC配置使其加入IoC容器方可生效，视图解析器主要作用简化模版视图页面查找的，但是需要注意，前后端分离项目，后端只返回JSON数据，不返回页面，那就不需要视图解析器。所以，视图解析器，相对其他的组件不是必须的编辑

SpringMVC案例：

控制层：

@Controller
public class HelloController {
    @RequestMapping("spring/hello")//对外访问的地址 此注解也会进行在handlerMapping注册的操作
@ResponseBody//不用找视图解析器
public String hello(){
        System.out.println("hello,springmvc");
        return "hello springmvc";
    }
}

配置类：

/**
 *要配置的操作：
* 1.将controller配置到ioc容器
* 2.将handlerMapping和handlerAdapter加入到ioc容器
*
 */
@Configuration
@ComponentScan("com.ergou.controller")
public class MvcConfig {
    @Bean
    public RequestMappingHandlerMapping handlerMapping(){
        return new RequestMappingHandlerMapping();
    }
    @Bean
    public RequestMappingHandlerAdapter handlerAdapter(){
        return new RequestMappingHandlerAdapter();
    }
}

初始化的类：

/**
 *可以被web项目加载，会初始化容器，会设置dispatcherServlet的地址
*/
public class SpringMvcInit extends AbstractAnnotationConfigDispatcherServletInitializer {
    @Override
    protected Class<?>[] getRootConfigClasses() {
        return new Class[0];
    }

//设置我们项目对应的配置类
@Override
    protected Class<?>[] getServletConfigClasses() {
        return new Class[] {MvcConfig.class};
    }

//配置springmvc内部自带的servlet访问地址
@Override
    protected String[] getServletMappings() {
        return new String[]{"/"};
    }
}

SpringMVC接收数据

访问路径设置

@RequestMapping注解的作用就是将请求的 URL 地址和处理请求的方式（handler方法）关联起来，建立映射关系。

将地址写在RequestMapping注解的value属性中即可，同样只有value属性时，value=可以省略

@RequestMapping注解中的地址不是必须斜杆开头，可有可无

地址的表示方式

1. 精准地址

   1. 例：/user/login
   2. 如果有多个地址，就用{}括号括起来，多个地址之间用逗号隔开，例如：@RequestMapping({"地址一","地址二",......}

2. 模糊地址

   1. *表示一层的任意字符串，**表示任意层的任意字符串
   2. 例：/user/* *处的一层的字符串可以是任何字符串
   3. 例：/user/** **处可以有多层字符串，每层的字符串任意

添加@RequestMapping的位置

@RequestMapping注解可以加在方法上，比如一个方法上的RequestMapping注解的地址为/user/login，则通过user/login地址就可以访问到此方法

@RequestMapping注解也可以加在类上，若一个类上的RequestMapping注解的地址为/user，该类的一个方法上的RequestMapping注解的地址为/login，则通过user/login地址就可以先访问地址为/user的类，在访问该类中地址为login的方法

请求方式指定

在@RequestMapping注解的method属性中写指定请求方式的枚举对象即可，如果要指定多个请求方式，也是用{}括起来即可

例：

@Controller
@RequestMapping("/user")
public class UserController {
    @RequestMapping(value = "/login",method = RequestMethod.POST)//只允许使用post方式的请求
public String login(){
        return null;
    }
    @RequestMapping(value = "/register",method = {RequestMethod.GET,RequestMethod.POST})//可以使用get方式的请求，也可以使用post方式的请求
public String register(){
        return null;
    }
}

注解进阶：

• @GetMapping
• @PostMapping
• @PutMapping
• @DeleteMapping

作用是这些注解比起RequestMapping，直接指定了请求的方式

只能使用在方法上

以@GetMapping为例：

@GetMapping(value = "/exit")

等同于

@RequestMapping(value = "exit",method = RequestMethod.GET)

接收参数

json和param参数

param参数：由key-value形式传递参数，key和value之间用=连接，多个key-value数据之间用&连接，只支持简单数据类型的数据，不支持数据的嵌套，形式：key=value&key=value&......

json参数：也是由key-value形式传递参数，key和value之间用:连接，多个key-value数据之间使用逗号隔开，整体是由一个{}括起来，如果一个value中又包括其他key-value数据，可以使用{}表示此value，{}中写其中的key-value数据，即json参数支持数据的嵌套，json支持复杂数据类型，比如数组、集合、对象等。形式：{key:value,key:{key:value,key,value},key:......}

param参数接收

• 直接接收

在handler方法的形参列表中，形参的命名和请求的参数名一致，相应的请求参数即会直接传给其同名的形参

@Controller
@RequestMapping("param")
public class ParamController {
    @RequestMapping("data")
		@ResponseBody
    public String data(String name,int age){
        System.out.println("name = " + name + ", age = " + age);
        return "name = " + name + ", age = " + age;
    }
}

• 注解指定

@RequestParam注解加在形参前，可以指定任意的请求参数名，可以要求参数必须传递或非必须传递，还可以指定不必须传递时设置形参的默认值

@RequestParam注解的属性：

• value：指定形参要接收的参数的参数名
• required：指定形参是否必须传递，true为必须传递，false为非必须传递，默认为true
• defaultValue：非必须传递时设置，当没有请求参数传递过来时，形参的值默认为该属性值

非必须传递时要用defaultValue属性设置默认值，如果形参没有接收到请求参数的数据，会报400异常

例：

@RequestMapping(value = "data1",method = RequestMethod.GET)
@ResponseBody
public String data1(@RequestParam(value = "account") String username,
                    @RequestParam(required = false,defaultValue = "1") int age){
    System.out.println("username = " + username + ", age = " + age);
    return "username = " + username + ", age = " + age;
}

• 特殊参数值

  • 一个key值有多个value

    • 若param参数中有两个key值相同value值不相同的参数，可以直接使用集合来接收其参数值
    • 设置集合类型的形参时，要在此形参前加上@RequestParam注解，如果不加，会将字符串直接赋值给集合，加了此注解后，才会将多个参数依次加入集合中

    @RequestMapping(value = "data2",method = RequestMethod.GET)
    @ResponseBody
    //若要传递的参数为：hbs=singing&hbs=dancing&hbs=rap&hbs=basketball
    public String data2(@RequestParam List<String> hbs){
        System.out.println(hbs);
        return hbs.toString();
    }
    //客户端收到的结果为[singing, dancing, rap, basketball]

  • 使用实体对象接收参数值

    • 准备一个用来接收请求参数的有对应属性和其get、set方法的实体类，要保证请求参数名和实体类的属性名对应一致，如果要默认值，直接在实体类中给要设默认值的属性赋值即可
    • 形参列表中写一个此实体类类型的形参即可

    @RequestMapping(value = "data3",method = RequestMethod.GET)
    @ResponseBody
    public String data3(User user){
        System.out.println("user = " + user);
        return user.toString();
    }

• 路径参数接收

  • 路径传参指的是直接将要传递的值写在路径中，即直接将value写在路径中，例如，要将用户名为ergou，密码为1234的数据传递给handler，可以写作：user/login/ergou/1234

  • 路径参数接收步骤：

    • 设置动态路径：

    在@RequestMapping注解的value属性中，在要用来接收参数的路径处写上{}，在{}中写上该参数的参数名（以方便handler方法调用）即可，例： @GetMapping("login/{username}/{password}")

    • 接收动态路径参数

    在handler方法的形参列表中写上相应的形参，形参名要和动态路径的{}中的参数名对应一致，且要在形参前加上@PathVariable注解

    • @PathVariable，如果形参名和动态路径中的参数名不一致，可以用value的属性值指定形参要接收的动态路径中的参数（写入要接收的动态参数的参数名）

    例：

    @Controller
    @RequestMapping("path")
    public class PathController {
        @GetMapping("login/{username}/{password}")
        @ResponseBody
        public String login(@PathVariable String username,@PathVariable int password){
            System.out.println("username = " + username + ", password = " + password);
            return "username = " + username + ", password = " + password;
        }
    }

json参数接收

接收json参数时，首先要准备一个接收json参数的实体类，其中的属性和参数一一对应。在形参列表中，写一个此实体类类型的形参，并在此形参前加上@RequestBody注解（加上此注解后就可以接收json参数）

@Controller
@RequestMapping("json")
@ResponseBody
public class JsonController {
    @PostMapping("data")
    public String data(@RequestBody Person person){
        System.out.println("person = " + person);
        return person.toString();
    }
}

除此之外，还要项目导入json处理的依赖，以及给handlerAdapter配置json转化器

导入json处理依赖：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.0</version>
</dependency>

给handlerAdapter配置json转化器：

在配置类上加上@EnableWebMvc注解即可

@EnableWebMvc//此注解会给handlerAdapter配置json转化器
@Configuration
@ComponentScan({"com.ergou.param","com.ergou.path","com.ergou.json"})
public class MvcConfig {
    @Bean
    public RequestMappingHandlerMapping handlerMapping(){
        return new RequestMappingHandlerMapping();
    }
    @Bean
    public RequestMappingHandlerAdapter handlerAdapter(){
        return new RequestMappingHandlerAdapter();
    }
}

@EnableWebMvc注解的作用：

此注解会自动将RequestMappingHandlerMapping和RequestMappingHandlerAdapter加入ioc容器中，除此之外还会配置json转化器。

所以在配置类上写好@EnableWebMvc注解后，可以省略RequestMappingHandlerMapping和RequestMappingHandlerAdapter的使用@Bean注解进行ioc配置的操作。

@EnableWebMvc//此注解会给handlerAdapter配置json转化器
@Configuration
@ComponentScan({"com.ergou.param","com.ergou.path","com.ergou.json"})
public class MvcConfig {
 new RequestMappingHandlerAdapter();
}

接收cookie数据

在handler方法参数列表中的要接收cookie数据的形参前加上@CookieValue注解，可以在其中的value属性中指定要接收的cookie数据的名称

@Controller
@RequestMapping("cookie")
@ResponseBody
public class CookieController {
    @RequestMapping(value = "data",method = RequestMethod.GET)
    public String data(@CookieValue("cookie") String value){
        System.out.println("value = " + value);
        return value;
    }
    @GetMapping("save")
    public String save(HttpServletResponse response){
        Cookie cookie = new Cookie("cookie","root");
        response.addCookie(cookie);
        return cookie.toString();
    }
}

原生对象获取

在形参中加上相应的注解或直接使用某些实体类的形参，可以获取对应的一些原生对象

Controller method argument 控制器方法参数	Description
jakarta.servlet.ServletRequest, jakarta.servlet.ServletResponse	请求/响应对象
jakarta.servlet.http.HttpSession	强制存在会话。因此，这样的参数永远不会为 null 。
java.io.InputStream, java.io.Reader	用于访问由 Servlet API 公开的原始请求正文。
java.io.OutputStream, java.io.Writer	用于访问由 Servlet API 公开的原始响应正文。
@PathVariable	接收路径参数注解
@RequestParam	用于访问 Servlet 请求参数，包括多部分文件。参数值将转换为声明的方法参数类型。
@RequestHeader	用于访问请求标头。标头值将转换为声明的方法参数类型。
@CookieValue	用于访问Cookie。Cookie 值将转换为声明的方法参数类型。
@RequestBody	用于访问 HTTP 请求正文。正文内容通过使用 HttpMessageConverter 实现转换为声明的方法参数类型。
java.util.Map, org.springframework.ui.Model, org.springframework.ui.ModelMap	共享域对象，并在视图呈现过程中向模板公开。
Errors, BindingResult	验证和数据绑定中的错误信息获取对象！

共享域对象操作

获取共享域对象：

获取request共享域对象和session共享域对象：在形参列表处声明HttpServletRequest类型的对象和HttpSession类型的对象即可

获取ServletContext共享域对象：在Controller层的类中声明ServletContext类型的属性，在其上方加上@Autowired注解即可

​