SSM学习笔记（SpringMVC篇 Day01）

一、SpringMVC入门案例

1. TomCat 的作用

(1) 先搞懂核心定位（通俗比喻）

把整个 Web 应用比作 "餐厅"

浏览器 = 顾客（发起点餐请求）；
Tomcat = 餐厅的「前台 + 传菜员 + 机房」：负责接待顾客、解析点餐需求、把需求传给后厨，再把做好的餐品送回顾客；
SpringMVC = 餐厅的「后厨（控制器 / 服务 / DAO）」：负责处理具体的 "点餐需求"（业务逻辑），但后厨不能直接面对顾客，必须通过前台（Tomcat）衔接。

(2) Tomcat 在 SpringMVC 中的核心作用

Tomcat 首先是一个轻量级 Web 服务器，负责处理最底层的网络通信：

监听指定端口（默认 8080），接收浏览器发来的 HTTP 请求（比如 GET/POST）；
解析 HTTP 请求的格式（比如请求头、请求参数、请求体），把杂乱的 HTTP 字节流转换成 Java 能识别的对象 ------HttpServletRequest（请求对象）和HttpServletResponse（响应对象）；
处理完请求后，把 SpringMVC 返回的响应数据（比如页面、JSON）重新封装成 HTTP 格式，发送回浏览器。

2. 代码实现

(1) 创建配置类

java 复制代码

@Configuration
@ComponentScan("com.itheima.controller")
public class SpringMvcConfig {
}

(2) 创建Controller类

java 复制代码

@Controller
public class UserController {
    
    @RequestMapping("/save")
    public void save(){
        System.out.println("user save ...");
    }
}

(3) 使用配置类替换web.xml

将web.xml删除，换成ServletContainersInitConfig

java 复制代码

public class ServletContainersInitConfig extends AbstractDispatcherServletInitializer {
    //加载springmvc配置类
    protected WebApplicationContext createServletApplicationContext() {
        //初始化WebApplicationContext对象
        AnnotationConfigWebApplicationContext ctx = new AnnotationConfigWebApplicationContext();
        //加载指定配置类
        ctx.register(SpringMvcConfig.class);
        return ctx;
    }

    //设置由springmvc控制器处理的请求映射路径
    protected String[] getServletMappings() {
        return new String[]{"/"};
    }

    //加载spring配置类
    protected WebApplicationContext createRootApplicationContext() {
        return null;
    }
}

核心逻辑：

① createServletApplicationContext ()：创建 SpringMVC 专属的 IOC 容器

作用：创建并返回一个Spring MVC 专属的 Web 应用上下文（IOC 容器）。
这个上下文专门用来加载 Spring MVC 相关的 Bean，比如控制器（@Controller）、视图解析器、处理器映射等。
AnnotationConfigWebApplicationContext 表示这个容器是基于Java 注解来配置的，而不是 XML。

② getServletMappings ()：指定 SpringMVC 处理哪些请求

作用：指定 DispatcherServlet 要处理哪些 URL 请求。
返回 "/" 意味着它会处理所有进入应用的请求。

3. bean加载控制

(1) 思路分析

加载Spring控制的bean的时候排除掉SpringMVC控制的bean，具体该如何排除

方式一：Spring加载的bean设定扫描范围为精准范围，例如service包、dao包等

方式二：Spring加载的bean设定扫描范围为com.itheima,排除掉controller包中的bean

(2) 代码实现

① 方式一：修改Spring配置类，设定扫描范围为精准范围

java 复制代码

@Configuration
@ComponentScan({"com.itheima.service","comitheima.dao"})
public class SpringConfig {
}

说明：

上述只是通过例子说明可以精确指定让Spring扫描对应的包结构，真正在做开发的时候，因为Dao最终是交给MapperScannerConfigurer对象来进行扫描处理的，我们只需要将其扫描到service包即可。

② 方式二：修改Spring配置类，设定扫描范围为com.itheima，排除掉controller包中的bean

java 复制代码

@Configuration
@ComponentScan(value="com.itheima",
    excludeFilters=@ComponentScan.Filter(
    	type = FilterType.ANNOTATION,
        classes = Controller.class
    )
)
public class SpringConfig {
}

excludeFilters属性：设置扫描加载bean时，排除的过滤规则
type属性：设置排除规则，当前使用按照bean定义时的注解类型进行排除
classes属性：设置排除的具体注解类，当前设置排除@Controller定义的bean

③ 测试类

java 复制代码

public class App{
	public static void main (String[] args){
        AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(SpringConfig.class);
        System.out.println(ctx.getBean(UserController.class));
    }
}

1). 注意：

测试的时候，需要把SpringMvcConfig配置类上的@ComponentScan注解注释掉，否则不会报错。因为按照上述的要求，应该是SpringMvcConfig加载Controller，而现在注释掉了@ComponentScan，就会导致SpringMvcConfig无法指定Bean的扫描路径，导致Controller类无法被加载到IoC容器中。

2). 流程如下：

如果不注释 SpringMvcConfig 上的 @ComponentScan： Spring 容器加载 SpringConfig → 扫描到 SpringMvcConfig → 执行 SpringMvcConfig 的扫描 → Controller 被加载到根容器 → ctx.getBean(UserController.class) 能找到 Bean → 测试失败，看不到 "被排除" 的效果。
如果注释掉 SpringMvcConfig 上的 @ComponentScan： Spring 容器加载 SpringConfig → 扫描到 SpringMvcConfig，但它没有扫描动作 → Controller 没有被加载 → ctx.getBean(UserController.class) 抛出 NoSuchBeanDefinitionException → 测试成功，演示了 "被排除" 的效果。

(3) 代码优化

ServletContainerInitConfig

java 复制代码

public class ServletContainersInitConfig extends AbstractAnnotationConfigDispatcherServletInitializer {

    protected Class<?>[] getRootConfigClasses() {
        return new Class[]{SpringConfig.class};
    }

    protected Class<?>[] getServletConfigClasses() {
        return new Class[]{SpringMvcConfig.class};
    }

    protected String[] getServletMappings() {
        return new String[]{"/"};
    }
}

二、请求与响应

1. 请求参数

(1) 参数传递

① GET请求中文乱码

如果我们传递的参数中有中文，你会发现接收到的参数会出现中文乱码问题。

② 解决方案：配置过滤器

java 复制代码

public class ServletContainersInitConfig extends AbstractAnnotationConfigDispatcherServletInitializer {
    protected Class<?>[] getRootConfigClasses() {
        return new Class[0];
    }

    protected Class<?>[] getServletConfigClasses() {
        return new Class[]{SpringMvcConfig.class};
    }

    protected String[] getServletMappings() {
        return new String[]{"/"};
    }

    //乱码处理
    @Override
    protected Filter[] getServletFilters() {
        CharacterEncodingFilter filter = new CharacterEncodingFilter();
        filter.setEncoding("UTF-8");
        return new Filter[]{filter};
    }
}

getServletFilters() ：这是 AbstractAnnotationConfigDispatcherServletInitializer 提供的扩展点，用来注册 Servlet 过滤器。
CharacterEncodingFilter：Spring 内置的过滤器，专门处理字符编码问题。
setEncoding("UTF-8")：明确告诉过滤器，所有请求和响应都用 UTF-8 编码。

(2) 五种类型参数传递

① 如果形参与地址参数名不一致该如何解决?

1). 发送请求与参数：

java 复制代码

http://localhost/commonParamDifferentName?name=张三&age=18

2). 解决方案:使用@RequestParam注解

java 复制代码

@RequestMapping("/commonParamDifferentName")
    @ResponseBody
    public String commonParamDifferentName(@RequestPaam("name") String userName , int age){
        System.out.println("普通参数传递 userName > "+userName);
        System.out.println("普通参数传递 age > "+age);
        return "{'module':'common param different name'}";
    }

② POJO数据类型

1). POJO参数：请求参数名与形参对象属性名相同，定义POJO类型形参即可接收参数

java 复制代码

public class User {
    private String name;
    private int age;
    //setter...getter...略
}

2). 后台接收参数：

java 复制代码

//POJO参数：请求参数与形参对象中的属性对应即可完成参数传递
@RequestMapping("/pojoParam")
@ResponseBody
public String pojoParam(User user){
    System.out.println("pojo参数传递 user > "+user);
    return "{'module':'pojo param'}";
}

③ 嵌套POJO类型参数

1). 如果POJO对象中嵌套了其他的POJO类，如

java 复制代码

public class Address {
    private String province;
    private String city;
    //setter...getter...略
}
public class User {
    private String name;
    private int age;
    private Address address;
    //setter...getter...略
}

嵌套POJO参数：请求参数名与形参对象属性名相同，按照对象层次结构关系即可接收嵌套POJO属性参数

2). 发送请求和参数

④ 集合类型参数

1). 存在的问题

java 复制代码

//集合参数：同名请求参数可以使用@RequestParam注解映射到对应名称的集合对象中作为数据
@RequestMapping("/listParam")
@ResponseBody
public String listParam(List<String> likes){
    System.out.println("集合参数传递 likes > "+ likes);
    return "{'module':'list param'}";
}

错误的原因是：SpringMVC将List看做是一个POJO对象来处理，将其创建一个对象并准备把前端的数据封装到对象中，但是List是一个接口无法创建对象，所以报错。

2). 解决方案是使用@RequestParam注解

java 复制代码

//集合参数：同名请求参数可以使用@RequestParam注解映射到对应名称的集合对象中作为数据
@RequestMapping("/listParam")
@ResponseBody
public String listParam(@RequestParam List<String> likes){
    System.out.println("集合参数传递 likes > "+ likes);
    return "{'module':'list param'}";
}

集合保存普通参数：请求参数名与形参集合对象名相同且请求参数为多个，@RequestParam绑定参数关系

2. JSON数据传输参数

(1) JSON普通数组

① 开启SpringMVC注解支持

在SpringMVC的配置类中开启SpringMVC的注解支持，这里面就包含了将JSON转换成对象的功能。

java 复制代码

@Configuration
@ComponentScan("com.itheima.controller")
//开启json数据类型自动转换
@EnableWebMvc
public class SpringMvcConfig {
}

② 参数前添加@RequestBody

java 复制代码

//使用@RequestBody注解将外部传递的json数组数据映射到形参的集合对象中作为数据
@RequestMapping("/listParamForJson")
@ResponseBody
public String listParamForJson(@RequestBody List<String> likes){
    System.out.println("list common(json)参数传递 list > "+likes);
    return "{'module':'list common for json param'}";
}

(2) 知识点

① @EnableWebMvc

名称	@EnableWebMvc
类型	配置类注解
位置	SpringMVC配置类定义上方
作用	开启SpringMVC多项辅助功能

② @RequestBody

名称	@RequestBody
类型	形参注解
位置	SpringMVC控制器方法形参定义前面
作用	将请求中请求体所包含的数据传递给请求参数，此注解一个处理器方法只能使用一次

3. 日期类型参数传递

(1) 携带时间的日期

java 复制代码

@RequestMapping("/dataParam")
@ResponseBody
public String dataParam(Date date,
                        @DateTimeFormat(pattern="yyyy-MM-dd") Date date1,
                        @DateTimeFormat(pattern="yyyy/MM/dd HH:mm:ss") Date date2)
    System.out.println("参数传递 date > "+date);
	System.out.println("参数传递 date1(yyyy-MM-dd) > "+date1);
	System.out.println("参数传递 date2(yyyy/MM/dd HH:mm:ss) > "+date2);
    return "{'module':'data param'}";
}

(2) 知识点

① @DateTimeFormat

名称	@DateTimeFormat
类型	形参注解
位置	SpringMVC控制器方法形参前面
作用	设定日期时间型数据格式
相关属性	pattern：指定日期时间格式字符串

4. 响应

(1) 响应JSON数据

① 响应POJO对象

java 复制代码

@Controller
public class UserController {
    
    @RequestMapping("/toJsonPOJO")
    @ResponseBody
    public User toJsonPOJO(){
        System.out.println("返回json对象数据");
        User user = new User();
        user.setName("itcast");
        user.setAge(15);
        return user;
    }
    
}

返回值为实体类对象，设置返回值为实体类类型，即可实现返回对应对象的json数据，需要依赖@ResponseBody注解和@EnableWebMvc注解

② 响应POJO集合对象

java 复制代码

@Controller
public class UserController {
    
    @RequestMapping("/toJsonList")
    @ResponseBody
    public List<User> toJsonList(){
        System.out.println("返回json集合数据");
        User user1 = new User();
        user1.setName("传智播客");
        user1.setAge(15);

        User user2 = new User();
        user2.setName("黑马程序员");
        user2.setAge(12);

        List<User> userList = new ArrayList<User>();
        userList.add(user1);
        userList.add(user2);

        return userList;
    }
    
}

(2) 知识点

名称	@ResponseBody
类型	方法\类注解
位置	SpringMVC控制器方法定义上方和控制类上
作用	设置当前控制器返回值作为响应体, 写在类上，该类的所有方法都有该注解功能
相关属性	pattern：指定日期时间格式字符串

说明：

当方法上有@ReponseBody注解后

方法的返回值为字符串，会将其作为文本内容直接响应给前端
方法的返回值为对象，会将对象转换成JSON响应给前端

五、Rest 风格

1. 请求方式

按照不同的请求方式代表不同的操作类型：

发送GET请求是用来做查询
发送POST请求是用来做新增
发送PUT请求是用来做修改
发送DELETE请求是用来做删除

2. RESTful 快速开发

(1) 知识点

① @PathVariable

名称	@PathVariable
类型	形参注解
位置	SpringMVC控制器方法形参定义前面
作用	绑定路径参数与处理器方法形参间的关系，要求路径参数名与形参名一一对应

② @RestController

名称	@RestController
类型	类注解
位置	基于SpringMVC的RESTful开发控制器类定义上方
作用	设置当前控制器类为RESTful风格，等同于@Controller与@ResponseBody两个注解组合功能

③ @GetMapping @PostMapping @PutMapping @DeleteMapping

名称	@GetMapping @PostMapping @PutMapping @DeleteMapping
类型	方法注解
位置	基于SpringMVC的RESTful开发控制器方法定义上方
作用	设置当前控制器方法请求访问路径与请求动作，每种对应一个请求动作，例如@GetMapping对应GET请求
相关属性	value（默认）：请求访问路径

(2) 代码实现

java 复制代码

@RestController //@Controller + ReponseBody
@RequestMapping("/books")
public class BookController {
    
	//@RequestMapping(method = RequestMethod.POST)
    @PostMapping
    public String save(@RequestBody Book book){
        System.out.println("book save..." + book);
        return "{'module':'book save'}";
    }

    //@RequestMapping(value = "/{id}",method = RequestMethod.DELETE)
    @DeleteMapping("/{id}")
    public String delete(@PathVariable Integer id){
        System.out.println("book delete..." + id);
        return "{'module':'book delete'}";
    }

    //@RequestMapping(method = RequestMethod.PUT)
    @PutMapping
    public String update(@RequestBody Book book){
        System.out.println("book update..." + book);
        return "{'module':'book update'}";
    }

    //@RequestMapping(value = "/{id}",method = RequestMethod.GET)
    @GetMapping("/{id}")
    public String getById(@PathVariable Integer id){
        System.out.println("book getById..." + id);
        return "{'module':'book getById'}";
    }

    //@RequestMapping(method = RequestMethod.GET)
    @GetMapping
    public String getAll(){
        System.out.println("book getAll...");
        return "{'module':'book getAll'}";
    }
    
}

3. RESTful案例

(1) 代码实现

① 编写Controller类并使用RESTful进行配置

java 复制代码

@RestController
@RequestMapping("/books")
public class BookController {

    @PostMapping
    public String save(@RequestBody Book book){
        System.out.println("book save > "+ book);
        return "{'module':'book save success'}";
    }

 	@GetMapping
    public List<Book> getAll(){
        System.out.println("book getAll is running ...");
        List<Book> bookList = new ArrayList<Book>();

        Book book1 = new Book();
        book1.setType("计算机");
        book1.setName("SpringMVC入门教程");
        book1.setDescription("小试牛刀");
        bookList.add(book1);

        Book book2 = new Book();
        book2.setType("计算机");
        book2.setName("SpringMVC实战教程");
        book2.setDescription("一代宗师");
        bookList.add(book2);

        Book book3 = new Book();
        book3.setType("计算机丛书");
        book3.setName("SpringMVC实战教程进阶");
        book3.setDescription("一代宗师呕心创作");
        bookList.add(book3);

        return bookList;
    }

}

(2) 页面访问处理

① 存在的问题

打开浏览器输入http://localhost/pages/books.html

② 解决方案

1). 出现错误的原因

2). 代码实现

SpringMVC需要将静态资源进行放行。

java 复制代码

@Configuration
public class SpringMvcSupport extends WebMvcConfigurationSupport {
    //设置静态资源访问过滤，当前类需要设置为配置类，并被扫描加载
    @Override
    protected void addResourceHandlers(ResourceHandlerRegistry registry) {
        //当访问/pages/????时候，从/pages目录下查找内容
        registry.addResourceHandler("/pages/**").addResourceLocations("/pages/");
        registry.addResourceHandler("/js/**").addResourceLocations("/js/");
        registry.addResourceHandler("/css/**").addResourceLocations("/css/");
        registry.addResourceHandler("/plugins/**").addResourceLocations("/plugins/");
    }
}

该配置类是在config目录下，SpringMVC扫描的是controller包，所以该配置类还未生效，要想生效需要将SpringMvcConfig配置类进行修改

java 复制代码

@Configuration
@ComponentScan({"com.itheima.controller","com.itheima.config"})
@EnableWebMvc
public class SpringMvcConfig {
}

或者

@Configuration
@ComponentScan("com.itheima")
@EnableWebMvc
public class SpringMvcConfig {
}

修改books.html页面

java 复制代码

                //添加
                saveBook () {
                    axios.post("/books",this.formData).then((res)=>{

                    });
                },

                //主页列表查询
                getAll() {
                    axios.get("/books").then((res)=>{
                        this.dataList = res.data;
                    });
                },

            }
        })

核心逻辑：

① axios.post("/books", this.formData)：

用 POST 方法向后端的 /books 接口发送请求。
把表单数据 this.formData（比如用户输入的书名、作者、价格等）作为请求体发送给后端。
对应后端的 @PostMapping("/books") 接口，用于 "创建新资源"。

② this.dataList = res.data：

请求成功后，后端会返回所有书籍的 JSON 数据（res.data）。
把这些数据赋值给前端的 dataList 数组，页面就会自动渲染出书籍列表。