[关闭]
@Otokaze 2018-12-16T10:13:57.000000Z 字数 135920 阅读 548

SpringMVC 笔记

Java

Spring MVC 介绍

Spring MVC 全称 Spring Web MVC,是 Struts2 的对标产品。Struts2 曾经是最流行的 MVC 框架,但由于存在过多安全漏洞,现在越来越多的开发团队选择了 Spring MVC,因为 Spring MVC 是 Spring Framework 家族中的一个,相比较 Struts2,Spring MVC 更容易与 Spring 框架相契合,上手难度也低于 Struts2。自从 Spring MVC 2.5 版本引入注解驱动功能后,Controller 已经不再需要继承任何接口,无需在 XML 配置文件中定义请求和 Controller 的映射关系,仅仅使用注解就可以让一个 POJO 具有 Controller 的全部功能,使得 Spring MVC 框架的易用性又得到了进一步的增强。在框架灵活性、易用性和扩展性上,Spring MVC 已经全面超越了其它的 MVC 框架,伴随着 Spring 一路高唱猛进,可以预见 Spring MVC 在 MVC 市场上的吸引力将越来越不可抗拒。

SSM 三大框架是目前主流的 Java Web 开发框架,即 Spring、SpringMVC、MyBatis。其中 Spring 我们前面已经学习过了,现在我们紧接着开始学习 Spring MVC,学完 Spring MVC 后就学习 MyBatis 持久化框架。最后将这三大框架进行整合,变成 SSM 框架组合,然后就是项目练手了。

Spring MVC 和 Spring 框架是紧密结合的,先学习 Spring 的 IoC 容器,对 SpringMVC 的学习非常有帮助,在 Spring MVC 中,我们依旧会使用 Spring 的 IoC 容器,而且是必不可少的,Spring MVC 是建立在 Spring 的 IoC 容器之上的(Spring 的 IoC 容器是 Spring 框架的核心概念,必须熟练掌握)。

关于 MVC,我们再来熟悉一下相关的处理流程。首先客户端请求到达 Controller 控制器,Controller 负责处理用户发来的请求,然后将处理结果包装为 Model(POJO 对象),最后将 Model 对象传递给用来渲染页面的 View;View 一般就是 JSP,在 JSP 中,可以通过 EL 表达式来获取 Model 对象中的数据,然后渲染页面,最后返回给请求用户。

可以发现,Controller 的职责就是用来处理用户请求的,处理完一般都会有一个结果,为了方便传递,我们一般都会将处理完得到的数据封装到一个对象中(Bean/POJO),然后将这个结果对象通过 setAttribute() 方法存放到 request 对象中,然后将 request 交给 view 处理。

view 通常就是 JSP 文件,所以我们可以通过 EL 表达式来获取 request 对象中的 model 数据,在需要的时候还可以通过 jstl 来进行简单的逻辑判断,循环处理等,最后将渲染得到的页面返回给请求客户端,这样,一个 request 就算完成了它的使命了。

view 中的逻辑一般都很轻松,就是从 request 中读取 model 数据,然后渲染页面。而 controller 是处理请求的地方,为了避免 controller 过于庞大,一般我们的应用程序都不会直接在 controller 处理业务逻辑,而是将业务逻辑放到一个叫做 service 的地方,在大多数简单的情况下,controller 内部仅仅是调用对应的 service 类而已。所以 service 是我们写业务逻辑的地方;而又因为 service 通常又会与数据库进行交互,为了解耦,我们又抽象出了一个 dao 层,dao 就是 data access object,封装常用的数据库操作,方便 service 层调用。即 controller -> service -> dao -> 数据库系统。

这样我们的 web 应用又分为了 3 层(由外到内排列):web 层业务层持久层

Spring MVC 处理流程

pom.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  4. <modelVersion>4.0.0</modelVersion>
  5. <groupId>com.zfl9</groupId>
  6. <artifactId>SpringMVC_Learn</artifactId>
  7. <version>1.0-SNAPSHOT</version>
  8. <packaging>war</packaging>
  9. <properties>
  10. <maven.compiler.source>1.8</maven.compiler.source>
  11. <maven.compiler.target>1.8</maven.compiler.target>
  12. <spring.version>4.3.20.RELEASE</spring.version>
  13. <mysql.version>8.0.13</mysql.version>
  14. <servlet.version>3.1.0</servlet.version>
  15. <jstl.version>1.2</jstl.version>
  16. <jackson.version>2.9.7</jackson.version>
  17. <fileupload.version>1.3.3</fileupload.version>
  18. </properties>
  19. <dependencies>
  20. <dependency>
  21. <groupId>org.springframework</groupId>
  22. <artifactId>spring-context</artifactId>
  23. <version>${spring.version}</version>
  24. </dependency>
  25. <dependency>
  26. <groupId>org.springframework</groupId>
  27. <artifactId>spring-webmvc</artifactId>
  28. <version>${spring.version}</version>
  29. </dependency>
  30. <dependency>
  31. <groupId>org.springframework</groupId>
  32. <artifactId>spring-jdbc</artifactId>
  33. <version>${spring.version}</version>
  34. </dependency>
  35. <dependency>
  36. <groupId>mysql</groupId>
  37. <artifactId>mysql-connector-java</artifactId>
  38. <version>${mysql.version}</version>
  39. <scope>runtime</scope>
  40. </dependency>
  41. <dependency>
  42. <groupId>javax.servlet</groupId>
  43. <artifactId>javax.servlet-api</artifactId>
  44. <version>${servlet.version}</version>
  45. <scope>provided</scope>
  46. </dependency>
  47. <dependency>
  48. <groupId>javax.servlet</groupId>
  49. <artifactId>jstl</artifactId>
  50. <version>${jstl.version}</version>
  51. <scope>runtime</scope>
  52. </dependency>
  53. <dependency>
  54. <groupId>com.fasterxml.jackson.core</groupId>
  55. <artifactId>jackson-databind</artifactId>
  56. <version>${jackson.version}</version>
  57. <scope>runtime</scope>
  58. </dependency>
  59. <dependency>
  60. <groupId>commons-fileupload</groupId>
  61. <artifactId>commons-fileupload</artifactId>
  62. <version>${fileupload.version}</version>
  63. <scope>runtime</scope>
  64. </dependency>
  65. </dependencies>
  66. </project>

Spring MVC HelloWorld

Spring MVC 测试环境:

创建项目目录
mvn -B archetype:generate -DarchetypeArtifactId=maven-archetype-webapp -DgroupId=com.zfl9 -DartifactId=springmvc-learn

编辑 pom.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project>
  3. <modelVersion>4.0.0</modelVersion>
  4. <groupId>com.zfl9</groupId>
  5. <artifactId>springmvc-learn</artifactId>
  6. <version>1.0.0</version>
  7. <packaging>war</packaging>
  8. <properties>
  9. <maven.test.skip>true</maven.test.skip>
  10. <maven.compiler.source>1.8</maven.compiler.source>
  11. <maven.compiler.target>1.8</maven.compiler.target>
  12. </properties>
  13. <dependencies>
  14. <dependency>
  15. <groupId>org.springframework</groupId>
  16. <artifactId>spring-webmvc</artifactId>
  17. <version>4.3.20.RELEASE</version>
  18. </dependency>
  19. </dependencies>
  20. <build>
  21. <plugins>
  22. <plugin>
  23. <groupId>org.apache.maven.plugins</groupId>
  24. <artifactId>maven-war-plugin</artifactId>
  25. <version>3.2.2</version>
  26. <configuration>
  27. <warName>ROOT</warName>
  28. <failOnMissingWebXml>false</failOnMissingWebXml>
  29. <outputDirectory>/usr/local/tomcat/apps</outputDirectory>
  30. </configuration>
  31. </plugin>
  32. </plugins>
  33. </build>
  34. </project>

简单解释一下:

上面的 pom.xml 是单纯使用 Maven 管理的,其实如果使用 Idea 等 IDE 工具的话,完全不需要配置什么 warName、outputDirectory,因为直接 Shift + F10 就能运行了(Idea 配合 IdeaVim 插件简直无敌)。spring-webmvc 模块会依赖 spring-context、spring-web,所以我们并不需要在 pom.xml 中配置它们。

项目目录结构

  1. $ tree
  2. .
  3. ├── pom.xml
  4. └── src
  5. └── main
  6. ├── java
  7.    └── com
  8.    └── zfl9
  9.    └── controller
  10.    └── HelloWorldController.java
  11. └── webapp
  12. ├── index.jsp
  13. └── WEB-INF
  14. ├── mvc.xml
  15. ├── views
  16.    └── helloworld.jsp
  17. └── web.xml

mvc.xml 其实就是我们前面学习 Spring 时候的 beans.xml、spring.xml,即 Spring 配置文件。注意 view 文件存放的路径,我们并没有放到 webapp 目录下,因为这样客户端就能直接访问我们的 jsp 了,而因为这些 view 里面的 jsp 一般都需要读取经 controller 处理得到的 model 数据,所以直接访问它们通常都会出现错误,甚至可能被黑客利用,所以我们一般都会把 view 放到 WEB-INF 目录下,WEB-INF 是说所谓的“安全目录”,这样外部就不能访问这些 jsp 了,只能访问我们暴露出去的 url,这些 url 通常都是映射到某个 controller,只有经过 controller 处理后,才访问这些 jsp(forward 过去),这样就安全多了。

web.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <web-app>
  3. <filter>
  4. <filter-name>encodingFilter</filter-name>
  5. <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
  6. <init-param>
  7. <param-name>encoding</param-name>
  8. <param-value>UTF-8</param-value>
  9. </init-param>
  10. <init-param>
  11. <param-name>forceEncoding</param-name>
  12. <param-value>true</param-value>
  13. </init-param>
  14. </filter>
  15. <filter-mapping>
  16. <filter-name>encodingFilter</filter-name>
  17. <url-pattern>/*</url-pattern>
  18. </filter-mapping>
  19. <servlet>
  20. <servlet-name>springmvc</servlet-name>
  21. <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  22. <load-on-startup>1</load-on-startup>
  23. <init-param>
  24. <param-name>contextConfigLocation</param-name>
  25. <param-value>/WEB-INF/mvc.xml</param-value>
  26. </init-param>
  27. </servlet>
  28. <servlet-mapping>
  29. <servlet-name>springmvc</servlet-name>
  30. <url-pattern>/</url-pattern>
  31. </servlet-mapping>
  32. </web-app>

mvc.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <beans xmlns="http://www.springframework.org/schema/beans"
  3. xmlns:mvc="http://www.springframework.org/schema/mvc"
  4. xmlns:context="http://www.springframework.org/schema/context"
  5. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  6. xsi:schemaLocation="http://www.springframework.org/schema/beans
  7. http://www.springframework.org/schema/beans/spring-beans.xsd
  8. http://www.springframework.org/schema/mvc
  9. http://www.springframework.org/schema/mvc/spring-mvc.xsd
  10. http://www.springframework.org/schema/context
  11. http://www.springframework.org/schema/context/spring-context.xsd">
  12. <context:component-scan base-package="com.zfl9"/>
  13. <mvc:annotation-driven/>
  14. <mvc:default-servlet-handler/>
  15. <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
  16. <property name="prefix" value="/WEB-INF/views/"/>
  17. <property name="suffix" value=".jsp"/>
  18. </bean>
  19. </beans>

通过前面的 web.xml 可以得知,Tomcat 收到的任何 HTTP 请求都将被路由给 springmvc,因为 springmvc 对应的 url-pattern 为 /。因为 springmvc 的 load-on-startup 值为 1,所以 springmvc 会在容器启动时进行初始化。springmvc 初始化过程中,会读取 mvc.xml 配置文件,初始化 IoC 容器,可以得知要扫描的 package 为 com.zfl9(包括所有子包)、对应的 View 视图路径为 /WEB-INF/views、视图后缀名为 .jsp。HTTP 请求到达 springmvc 后,springmvc 首先查询 Handler Mapping,获取 url 对应的 controller,然后将该 request 交给 controller 处理,controller 处理完后返回一个 ModelAndView 对象(携带 Model 数据的 View 对象),然后通过查询 View Resolver,获取 ModelAndView 对象对应的视图页面(通常为 JSP),接着将 model 数据传递给对应的 view 页面,在 view 页面渲染完成后,springmvc 将最终的响应结果传回给客户端。如下图所示:
Spring MVC 的工作流程

简单的说就是这几个步骤:

  1. 查询 Handler Mapping 得知处理此请求的 Controller;
  2. 将此请求交给对应的 Controller 处理,返回处理结果;
  3. 查询 View Resolver 得知生成响应结果的 View;
  4. 将此请求交给对应的 View 生成响应页面;
  5. Dispatcher 将响应结果返回给浏览器。

HelloWorldController

  1. package com.zfl9.controller;
  2. import org.springframework.stereotype.Controller;
  3. import org.springframework.web.servlet.ModelAndView;
  4. import org.springframework.web.bind.annotation.RequestParam;
  5. import org.springframework.web.bind.annotation.RequestMapping;
  6. @Controller
  7. public class HelloWorldController {
  8. @RequestMapping("/helloworld")
  9. public ModelAndView helloworld(@RequestParam(name = "name", required = false, defaultValue = "World") String name) {
  10. ModelAndView mav = new ModelAndView("helloworld");
  11. mav.addObject("name", name);
  12. return mav;
  13. }
  14. }

很容易知道,Controller 中被 @RequestMapping 标注的方法都是用来处理用户请求的,每个请求处理方法都有两个必要元素,一个是 @RequestMapping 里面指定的 uri,发送给该 uri 的请求都将被该方法处理;另一个就是请求处理方法中返回的 view 名/对象。在 ModelAndView 中,构造函数的参数就是 view 名,View Resolver 会结合 prefix 和 suffix 来确定 view 的绝对路径,然后将 request 转发给 view 处理。

@Controller 是 @Component 的子接口,还记得吗?@Component 有 3 个子接口:

这里我们提到了 控制层业务层持久层,注意不要和 MVC 模型搞混了,虽然它们都是所谓的“三层结构”。所谓控制层就是我们常说的 controller/action 层,而业务层就是 service 层,持久层就是 dao 层。此外我们还有一个 model 层(准确来说应该是包)。controller 层又被称为 web 层,web 层位于最外边,是与 web 服务器(tomcat)直接交互的一个层面,web 层除了 controller 外,还有 view。在 controller 中,不建议编写任何复杂的逻辑,基本上就是调用对应的 service 层,service 层才是我们编写具体业务代码的地方,通常我们的业务逻辑都需要与数据库进行交互,但我们并不会直接与数据库进行交互,而是通过 dao 层,dao 即 data access object(数据访问对象),所谓 dao 就是对数据库访问逻辑的封装。

调用层次为:controller -> service -> dao;controller 返回 model 给 view,最后返回浏览器。

再次强调,controller 不建议编写任何与业务相关的逻辑,大多数简单的情况下,controller 内部就是调用对应的 service 类,仅此而已。service 层才是编写业务逻辑的地方,而 dao 层就是编写数据库访问逻辑的地方,一定要记住它们的职责,不要搞混了。一般情况下,为了解耦,我们的 service 层会分为 service 接口和 service impl 实现,对应的,dao 层也会分为 dao 接口和 dao imple 实现。

典型的 web 应用程序结构为:

  1. $ tree springmvc
  2. springmvc
  3. ├── pom.xml
  4. └── src
  5. └── main
  6. ├── java
  7.    └── com
  8.    └── zfl9
  9.    ├── controller
  10.       └── EmployeeController.java
  11.    ├── dao
  12.       ├── EmployeeDao.java
  13.       └── impl
  14.       └── EmployeeDaoImpl.java
  15.    ├── model
  16.       └── EmployeeBean.java
  17.    └── service
  18.    ├── EmployeeService.java
  19.    └── impl
  20.    └── EmployeeServiceImpl.java
  21. └── webapp
  22. ├── index.jsp
  23. └── WEB-INF
  24. ├── mvc.xml
  25. ├── views
  26.    └── employee.jsp
  27. └── web.xml

helloworld.jsp

  1. <%@page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8"%>
  2. <!DOCTYPE html>
  3. <html>
  4. <head>
  5. <meta charset="UTF-8">
  6. <title>HelloWorld</title>
  7. </head>
  8. <body>
  9. <h1>Hello, ${name}!</h1>
  10. </body>
  11. </html>

index.jsp

  1. <%@page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8"%>
  2. <!DOCTYPE html>
  3. <html>
  4. <head>
  5. <meta charset="UTF-8">
  6. <title>index.jsp</title>
  7. </head>
  8. <body>
  9. <h1>Hello, World!</h1>
  10. </body>
  11. </html>

编译、运行

  1. # root @ arch in ~/maven-workspace/springmvc-learn [10:36:39]
  2. $ mvn clean package
  3. [INFO] Scanning for projects...
  4. [INFO]
  5. [INFO] ----------------------< com.zfl9:springmvc-learn >----------------------
  6. [INFO] Building springmvc-learn 1.0.0
  7. [INFO] --------------------------------[ war ]---------------------------------
  8. [INFO]
  9. [INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ springmvc-learn ---
  10. [INFO]
  11. [INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ springmvc-learn ---
  12. [INFO] Using 'UTF-8' encoding to copy filtered resources.
  13. [INFO] skip non existing resourceDirectory /root/maven-workspace/springmvc-learn/src/main/resources
  14. [INFO]
  15. [INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ springmvc-learn ---
  16. [INFO] Changes detected - recompiling the module!
  17. [INFO] Compiling 1 source file to /root/maven-workspace/springmvc-learn/target/classes
  18. [INFO]
  19. [INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ springmvc-learn ---
  20. [INFO] Not copying test resources
  21. [INFO]
  22. [INFO] --- maven-compiler-plugin:3.1:testCompile (default-testCompile) @ springmvc-learn ---
  23. [INFO] Not compiling test sources
  24. [INFO]
  25. [INFO] --- maven-surefire-plugin:2.12.4:test (default-test) @ springmvc-learn ---
  26. [INFO] Tests are skipped.
  27. [INFO]
  28. [INFO] --- maven-war-plugin:3.2.2:war (default-war) @ springmvc-learn ---
  29. [INFO] Packaging webapp
  30. [INFO] Assembling webapp [springmvc-learn] in [/root/maven-workspace/springmvc-learn/target/springmvc-learn-1.0.0]
  31. [INFO] Processing war project
  32. [INFO] Copying webapp resources [/root/maven-workspace/springmvc-learn/src/main/webapp]
  33. [INFO] Webapp assembled in [39 msecs]
  34. [INFO] Building war: /usr/local/tomcat/apps/ROOT.war
  35. [INFO] ------------------------------------------------------------------------
  36. [INFO] BUILD SUCCESS
  37. [INFO] ------------------------------------------------------------------------
  38. [INFO] Total time: 1.683 s
  39. [INFO] Finished at: 2018-11-25T10:36:48+08:00
  40. [INFO] ------------------------------------------------------------------------
  41. # root @ arch in ~/maven-workspace/springmvc-learn [10:36:48]
  42. $ tomcat start
  43. Using CATALINA_BASE: /usr/local/tomcat
  44. Using CATALINA_HOME: /usr/local/tomcat
  45. Using CATALINA_TMPDIR: /usr/local/tomcat/temp
  46. Using JRE_HOME: /usr/local/jdk/jdk1.8
  47. Using CLASSPATH: /usr/local/tomcat/bin/bootstrap.jar:/usr/local/tomcat/bin/tomcat-juli.jar
  48. Tomcat started.
  49. # root @ arch in ~/maven-workspace/springmvc-learn [10:36:52]
  50. $ curl 'http://127.0.0.1/'
  51. <!DOCTYPE html>
  52. <html>
  53. <head>
  54. <meta charset="UTF-8">
  55. <title>index.jsp</title>
  56. </head>
  57. <body>
  58. <h1>Hello, World!</h1>
  59. </body>
  60. </html>
  61. # root @ arch in ~/maven-workspace/springmvc-learn [10:37:03]
  62. $ curl 'http://127.0.0.1/helloworld'
  63. <!DOCTYPE html>
  64. <html>
  65. <head>
  66. <meta charset="UTF-8">
  67. <title>HelloWorld</title>
  68. </head>
  69. <body>
  70. <h1>Hello, World!</h1>
  71. </body>
  72. </html>
  73. # root @ arch in ~/maven-workspace/springmvc-learn [10:37:08]
  74. $ curl 'http://127.0.0.1/helloworld?name=Otokaze'
  75. <!DOCTYPE html>
  76. <html>
  77. <head>
  78. <meta charset="UTF-8">
  79. <title>HelloWorld</title>
  80. </head>
  81. <body>
  82. <h1>Hello, Otokaze!</h1>
  83. </body>
  84. </html>
  85. # root @ arch in ~/maven-workspace/springmvc-learn [10:37:21]
  86. $ curl 'http://127.0.0.1/helloworld' -d 'name=中国'
  87. <!DOCTYPE html>
  88. <html>
  89. <head>
  90. <meta charset="UTF-8">
  91. <title>HelloWorld</title>
  92. </head>
  93. <body>
  94. <h1>Hello, 中国!</h1>
  95. </body>
  96. </html>

applicationContext.xml vs dispatcher-servlet.xml

在有些 Spring MVC 教程中,会出现这两个配置文件,它们贴出来的 web.xml 像这样:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <web-app>
  3. <listener>
  4. <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  5. </listener>
  6. <context-param>
  7. <param-name>contextConfigLocation</param-name>
  8. <param-value>/WEB-INF/applicationContext.xml</param-value>
  9. </context-param>
  10. <servlet>
  11. <servlet-name>springmvc</servlet-name>
  12. <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  13. <load-on-startup>1</load-on-startup>
  14. <init-param>
  15. <param-name>contextConfigLocation</param-name>
  16. <param-value>/WEB-INF/mvc.xml</param-value>
  17. </init-param>
  18. </servlet>
  19. <servlet-mapping>
  20. <servlet-name>springmvc</servlet-name>
  21. <url-pattern>/</url-pattern>
  22. </servlet-mapping>
  23. </web-app>

对比 HelloWorld 里面的 web.xml,可以发现这里的 web.xml 多了个 ContextLoaderListener 上下文加载监听器,还有就是多了个 context-param 上下文初始化参数。ContextLoaderListener 会从 contexxt-param 中读取 Spring 的配置文件路径(如果省略 context-param,那么默认路径就是 /WEB-INF/applicationContext.xml),ContextLoaderListener 会初始化一个 IoC 容器。

那么问题来了,ContextLoaderListener 和 DispatcherServlet 都会初始化对应的 IoC 容器,也就意味这 web 应用中有两个 Spring IoC 容器,一个是由 ContextLoaderListener 管理的,一个是由 DispatcherServlet 管理的。这两个 IoC 容器有什么区别呢?来看官方的解答:

Spring 允许您在父子层次结构中定义多个 ApplicationContext 上下文。applicationContext.xml 是 web 应用的 root 上下文(根上下文);${servlet-name}-servlet.xml 是 DispatcherServlet 中的上下文,在同一个 web 应用中运行有多个 DispatcherServlet 实例,每个 DispatcherServlet 都有属于自己的上下文。有关 MVC 的配置需要放到对应的 DispatcherServlet 上下文配置文件中,而 ApplicationContext 中的 bean 可以被所有 DispatcherServlet 上下文所共享,但是 ApplicationContext 不能获取 DispatcherServlet 上下文中的 bean(这很好理解)。

在大多数简单的情况下,applicationContext.xml 上下文是不必要的。除非你需要在多个 servlet 上下文中共享相同的 bean 实例,否则你完全不需要配置 ContextLoaderListener 和 applicationContext.xml。在绝大多数情况下,我们只需要配置一个 DispatcherServlet 和对应的 mvc.xml 就行了。我们的 bean 可以配置在 mvc.xml 中,在程序中可以通过 context 来获取这些 bean。

Model、ModelMap、ModelAndView

我们来回顾一下 HelloWorld 中的 Controller 代码:

  1. package com.zfl9.controller;
  2. import org.springframework.stereotype.Controller;
  3. import org.springframework.web.servlet.ModelAndView;
  4. import org.springframework.web.bind.annotation.RequestParam;
  5. import org.springframework.web.bind.annotation.RequestMapping;
  6. @Controller
  7. public class HelloWorldController {
  8. @RequestMapping("/helloworld")
  9. public ModelAndView helloworld(@RequestParam(name = "name", required = false, defaultValue = "World") String name) {
  10. ModelAndView mav = new ModelAndView("helloworld");
  11. mav.addObject("name", name);
  12. return mav;
  13. }
  14. }

@Controller 是 @Component 的子注解,表示对应的 POJO 类是一个 Controller 控制器。
@RequestMapping 注解的作用则是用来告诉 Handler Mapping,当前方法对应的 uri 路径。
当 dispatcher 收到 uri 为 /helloworld 的请求时,将交给 helloworld() 方法去处理。
helloworld() 是自定义的 POJO 方法,返回值为 ModelAndView,接收一个 http 请求参数。
name 参数上使用了 @RequestParam 注解,SpringMVC 会自动注入对应的请求参数到此参数上。
@RequestParam 的 name 为请求参数名,required 为是否为请求的,defaultValue 为默认值。
ModelAndView 是 Model 模型和 View 页面的合体类型,传入的构造参数是对应的 view 页面名。
mav 对象和 request 对象一样,可以存入 name-value 对,它等同于 request.setAttribute()。
本质上,ModelAndView 中的 addObject() 方法内部就是调用 request.setAttribute() 方法而已。
也因为如此,我们可以在 view 页面中,如 JSP,使用 EL 表达式来获取在 ModelAndView 中设置的值。

在 HelloWorld 例子中,我们使用的是 ModelAndView 传递 model 数据,其实有三种常用方式来传递 model 数据,分别是 Model、ModelMap、ModelAndView,据说前两者在内部都会转换为 ModelAndView 形式:

Model 是一个接口,接口声明如下:

  1. public interface Model {
  2. Model addAttribute(String name, Object value); // 添加 name-value 对
  3. Model addAttribute(Object value); // name 为类名(首字母小写,非全限定类名)
  4. Model addAllAttributes(Collection<?> values); // name 为类名,转换规则同上
  5. Model addAllAttributes(Map<String, ?> attributes); // 合并 Map 上的键值对
  6. Model mergeAttributes(Map<String, ?> attributes); // 合并 Map 上的键值对
  7. Map<String, Object> asMap(); // 返回 java.util.Map 对象(Map 视图)
  8. boolean containsAttribute(String name); // 是否存在名为 name 的键值对
  9. }

ModelMap 是 LinkedHashMap<String, Object> 的子类,方法与 Model 相似,如下:

  1. public class ModelMap extends LinkedHashMap<String, Object> {
  2. /* 构造方法 */
  3. public ModelMap();
  4. public ModelMap(String name, Object value);
  5. public ModelMap(Object value); // 使用类名作为 name,首字母小写
  6. Model addAttribute(String name, Object value); // 添加 name-value 对
  7. Model addAttribute(Object value); // name 为类名(首字母小写,非全限定类名)
  8. Model addAllAttributes(Collection<?> values); // name 为类名,转换规则同上
  9. Model addAllAttributes(Map<String, ?> attributes); // 合并 Map 上的键值对
  10. Model mergeAttributes(Map<String, ?> attributes); // 合并 Map 上的键值对
  11. boolean containsAttribute(String name); // 是否存在名为 name 的键值对
  12. }

ModelAndView 是最原始的传值方式,但也是最强大的,因为 ModelAndView 不仅仅是传值,还有其它操作。

  1. public class ModelAndView {
  2. /* 构造函数 */
  3. public ModelAndView(); // for bean
  4. public ModelAndView(View view);
  5. public ModelAndView(String viewName);
  6. public ModelAndView(String viewName, HttpStatus status); // 4.3+
  7. /* model 即传递的数据 */
  8. public ModelAndView(View view, Map<String, ?> model);
  9. public ModelAndView(String viewName, Map<String, ?> model);
  10. public ModelAndView(String viewName, Map<String, ?> model, HttpStatus status); // 4.3+
  11. public ModelAndView(View view, String name, Object value);
  12. public ModelAndView(String viewName, String name, Object value);
  13. /* viewName */
  14. public void setViewName(String viewName);
  15. public String getViewName();
  16. /* view */
  17. public void setView(View view);
  18. public View getView()
  19. /* view 相关 */
  20. public boolean hasView(); // 是否设置了 view
  21. public boolean isReference(); // 是否为 view 引用
  22. /* model/modelMap */
  23. public ModelMap getModelMap();
  24. public Map<String, Object> getModel();
  25. /* status v4.3+ */
  26. public void setStatus(HttpStatus status);
  27. public HttpStatus getStatus();
  28. /* addObject */
  29. public ModelAndView addObject(String name, Object value);
  30. public ModelAndView addObject(Object value);
  31. public ModelAndView addAllObjects(Map<String, ?> modelMap);
  32. /* clear */
  33. public void clear(); // 清空 modelAndView 对象
  34. public boolean isEmpty();
  35. public boolean wasCleared();
  36. /* toString */
  37. public String toString();
  38. }

其中,Model 和 ModelMap 对象可以放在方法参数中,Spring MVC 会自动注入对应的实例,而 ModelAndView 需要自己 new 出来,我们改写一下前面的 HelloWorld 控制器,如下:

  1. package com.zfl9.controller;
  2. import org.springframework.stereotype.Controller;
  3. import org.springframework.ui.Model;
  4. import org.springframework.ui.ModelMap;
  5. import org.springframework.web.bind.annotation.RequestMapping;
  6. import org.springframework.web.bind.annotation.RequestParam;
  7. import org.springframework.web.servlet.ModelAndView;
  8. @Controller
  9. public class HelloWorldController {
  10. @RequestMapping("/helloA")
  11. public String helloA(@RequestParam(name = "name", required = false, defaultValue = "WorldA") String name, Model model) {
  12. model.addAttribute("name", name);
  13. return "helloworld";
  14. }
  15. @RequestMapping("/helloB")
  16. public String helloB(@RequestParam(name = "name", required = false, defaultValue = "WorldB") String name, ModelMap modelMap) {
  17. modelMap.addAttribute("name", name);
  18. return "helloworld";
  19. }
  20. @RequestMapping("/helloC")
  21. public ModelAndView helloC(@RequestParam(name = "name", required = false, defaultValue = "WorldC") String name) {
  22. ModelAndView mav = new ModelAndView("helloworld");
  23. mav.addObject("name", name);
  24. return mav;
  25. }
  26. }

注意,helloA()、helloB()、helloC() 方法返回的 view 页面都为 helloworld,结合 mvc.xml 中的 prefix 和 suffix,Spring MVC 就可以知道 view 页面的绝对路径为 /WEB-INF/views/helloworld.jsp:

  1. # Otokaze @ Otokaze-Win10 in ~ [19:50:44]
  2. $ curl localhost/helloA
  3. <!DOCTYPE html>
  4. <html>
  5. <head>
  6. <meta charset="UTF-8">
  7. <title>helloworld</title>
  8. </head>
  9. <body>
  10. <h1>Hello, WorldA!</h1>
  11. </body>
  12. </html>
  13. # Otokaze @ Otokaze-Win10 in ~ [19:50:55]
  14. $ curl localhost/helloB
  15. <!DOCTYPE html>
  16. <html>
  17. <head>
  18. <meta charset="UTF-8">
  19. <title>helloworld</title>
  20. </head>
  21. <body>
  22. <h1>Hello, WorldB!</h1>
  23. </body>
  24. </html>
  25. # Otokaze @ Otokaze-Win10 in ~ [19:50:57]
  26. $ curl localhost/helloC
  27. <!DOCTYPE html>
  28. <html>
  29. <head>
  30. <meta charset="UTF-8">
  31. <title>helloworld</title>
  32. </head>
  33. <body>
  34. <h1>Hello, WorldC!</h1>
  35. </body>
  36. </html>

测试没问题。分别返回 Hello, WorldAHello, WorldBHello, WorldC

更正,ModelAndView 对象其实也是可以让 Spring MVC 生成的,例子:
HelloController.java

  1. package com.zfl9.controller;
  2. import org.springframework.stereotype.Controller;
  3. import org.springframework.web.bind.annotation.GetMapping;
  4. import org.springframework.web.servlet.ModelAndView;
  5. @Controller
  6. public class HelloController {
  7. @GetMapping("/hello")
  8. public ModelAndView hello(ModelAndView mav) {
  9. mav.setViewName("hello");
  10. mav.addObject("message", "hello, world!");
  11. return mav;
  12. }
  13. }

hello.jsp

  1. <%@ page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %>
  2. <!DOCTYPE html>
  3. <html>
  4. <head>
  5. <meta charset="UTF-8">
  6. <title>hello</title>
  7. </head>
  8. <body>
  9. <h1>${message}</h1>
  10. </body>
  11. </html>

测试结果:

  1. $ curl localhost/hello
  2. <!DOCTYPE html>
  3. <html>
  4. <head>
  5. <meta charset="UTF-8">
  6. <title>hello</title>
  7. </head>
  8. <body>
  9. <h1>hello, world!</h1>
  10. </body>
  11. </html>

注意,我们前面说了,是通常情况下,有上面这三种返回模型数据的方法,但其实我们还有其它几个方法:

1、返回 java.util.Map,view 名为 @RequestMapping 中的名称(/WEB-INF/views/helloD.jsp):

  1. @RequestMapping("/helloD")
  2. public Map<String, Object> helloD(@RequestParam(name = "name", required = false, defaultValue = "WorldD") String name) {
  3. Map<String, Object> map = new HashMap<>();
  4. map.put("name", name);
  5. return map;
  6. }

2、返回 void,view 名为 @RequestMapping 中的名称(/WEB-INF/views/helloD.jsp):

  1. @RequestMapping("/helloD")
  2. public void helloD() {}

3、返回 String,其实就是前面 Model、ModelMap 的简化版,返回的 String 就是对应的 view 名:

  1. @RequestMapping("/helloD")
  2. public String helloD() {
  3. return "helloD";
  4. }

4、返回 String 作为响应体(不需要 view,直接返回字符串作为响应体),使用 @ResponseBody 注解:

  1. @RequestMapping("/helloD")
  2. @ResponseBody
  3. public String helloD() {
  4. return "helloD";
  5. }

5、返回 null,会发生什么结果呢?答案是得到 404 Not Found 响应!!!面试题哦!!!

@RequestMapping 详解

@RequestMapping 可以用在 Controller 上或者 Controller 中的方法上,如果用在 Controller 上,则相当于给所有方法上的 @RequestMapping 加上了父路径,比如在类上的 uri 为 /home,方法上的 uri 为 /list,则该方法实际映射到的 uri 为 /home/list,例子,访问地址为 /wmyskxz/hello

  1. @Controller
  2. @RequestMapping("/wmyskxz")
  3. public class HelloController {
  4. @RequestMapping("/hello")
  5. public ModelAndView handleRequest(....) throws Exception {
  6. ....
  7. }
  8. }

基本上我们可以认为,放在 Controller 上面的 @RequestMapping 要么是像上面那样提供一个父路径,要么就是给 Controller 中的方法提供默认值,这个默认值可以被方法中的 @RequestMapping 的注解所覆盖。

所谓 ant-style pattern 就是这三个通配符:

method 属性则是用来限定对应方法可以处理的 HTTP 请求方法的,默认是全部都可以处理,如果需要我们可以将限定为只处理 GET 请求。从 Spring 4.3 版本开始,提供了 4 个方便的注解,分别用来指定 GET、POST、PUT、DELETE 请求方法的 @RequestMapping(实际就是子注解,属性相同,除了没有 method),分别为:

params 属性表示只有符合指定条件的请求才会被对应方法处理,后面的 headers、consumes、produces 都是差不多的作用,用来进行条件限定的。如 param=value 表示请求必须带有 param 参数且值为 value,否则不会被当前方法处理;param!=value 则与它相反;param 表示请求必须带有 parm 参数,不限定它的值;而 !param 则与它相反。

headers 属性的作用和 params 属性的作用相似,只不过这是用来限定请求头字段的,语法为 header=valueheader!=valueheader!header,对于 MIME 类型,支持 * 通配符。

consumes 属性和 params/headers 属性差不多,但这是用来限定请求的 Context-Type 类型的,比如 text/html 表示只处理请求 MIME 为 text/html 的请求,其它类型的请求不进行处理,MIME 中可以出现通配符,如 text/*,也可以出现 ! 取反符号,如 !text/plain 表示出了 text/plain 外的都会处理。produces 属性和 consumes 属性相似,但 produces 是用来限定请求头中的 Accept 字段的。

例一:(实现效果同下,不推荐)

  1. @Controller
  2. public class EmployeeController
  3. {
  4. @RequestMapping("/employee-management/employees")
  5. public String getAllEmployees(Model model)
  6. {
  7. //application code
  8. return "employeesList";
  9. }
  10. @RequestMapping("/employee-management/employees/add")
  11. public String addEmployee(EmployeeVO employee)
  12. {
  13. //application code
  14. return "employeesDetail";
  15. }
  16. @RequestMapping("/employee-management/employees/update")
  17. public String updateEmployee(EmployeeVO employee)
  18. {
  19. //application code
  20. return "employeesDetail";
  21. }
  22. @RequestMapping(value={"/employee-management/employees/remove","/employee-management/employees/delete"})
  23. public String removeEmployee(@RequestParam("id") String employeeId)
  24. {
  25. //application code
  26. return "employeesList";
  27. }
  28. }

例二:(实现效果同上,推荐)

  1. @Controller
  2. @RequestMapping("/employee-management/employees")
  3. public class EmployeeController
  4. {
  5. @RequestMapping
  6. public String getAllEmployees(Model model)
  7. {
  8. //application code
  9. return "employeesList";
  10. }
  11. @RequestMapping("/add")
  12. public String addEmployee(EmployeeVO employee)
  13. {
  14. //application code
  15. return "employeesDetail";
  16. }
  17. @RequestMapping("/update")
  18. public String updateEmployee(EmployeeVO employee)
  19. {
  20. //application code
  21. return "employeesDetail";
  22. }
  23. @RequestMapping(value={"/remove","/delete"})
  24. public String removeEmployee(@RequestParam("id") String employeeId)
  25. {
  26. //application code
  27. return "employeesList";
  28. }
  29. }

例三:RESTFul API 风格:

  1. @Controller
  2. @RequestMapping("/employee-management/employees")
  3. public class EmployeeController
  4. {
  5. @RequestMapping (method = RequestMethod.GET)
  6. public String getAllEmployees(Model model)
  7. {
  8. //application code
  9. return "employeesList";
  10. }
  11. @RequestMapping (method = RequestMethod.POST)
  12. public String addEmployee(EmployeeVO employee)
  13. {
  14. //application code
  15. return "employeesDetail";
  16. }
  17. @RequestMapping (method = RequestMethod.PUT)
  18. public String updateEmployee(EmployeeVO employee)
  19. {
  20. //application code
  21. return "employeesDetail";
  22. }
  23. @RequestMapping (method = RequestMethod.DELETE)
  24. public String removeEmployee(@RequestParam("id") String employeeId)
  25. {
  26. //application code
  27. return "employeesList";
  28. }
  29. }

@RequestParam 详解

用在方法参数上,表示该参数将接受对应的 HTTP 请求参数(查询参数、表单数据、文件上传等),属性有:

例子,我们可以将上面的 HelloWorld 改为这样(效果一样):

  1. package com.zfl9.controller;
  2. import org.springframework.stereotype.Controller;
  3. import org.springframework.ui.Model;
  4. import org.springframework.ui.ModelMap;
  5. import org.springframework.web.bind.annotation.RequestMapping;
  6. import org.springframework.web.bind.annotation.RequestParam;
  7. import org.springframework.web.servlet.ModelAndView;
  8. @Controller
  9. public class HelloWorldController {
  10. @RequestMapping("/helloA")
  11. public String helloA(@RequestParam(defaultValue = "WorldA") String name, Model model) {
  12. model.addAttribute("name", name);
  13. return "helloworld";
  14. }
  15. @RequestMapping("/helloB")
  16. public String helloB(@RequestParam(defaultValue = "WorldB") String name, ModelMap modelMap) {
  17. modelMap.addAttribute("name", name);
  18. return "helloworld";
  19. }
  20. @RequestMapping("/helloC")
  21. public ModelAndView helloC(@RequestParam(defaultValue = "WorldC") String name) {
  22. ModelAndView mav = new ModelAndView("helloworld");
  23. mav.addObject("name", name);
  24. return mav;
  25. }
  26. }

扩展:如果处理方法的参数与查询参数同名,那么即使没有 @RequestParam 注解也会被注入对应的值:

  1. @RequestMapping("/helloD")
  2. @ResponseBody
  3. public String helloD(String name) {
  4. if (name == null) {
  5. return "<h1>Hello, WorldD!</h1>";
  6. } else {
  7. return "<h1>Hello, " + name + "!</h1>";
  8. }
  9. }

测试一下,没带参数就是打印 Hello, WorldD!,带参数就是打印 Hello, ${name}!

  1. # Otokaze @ Otokaze-Win10 in ~ [13:56:36]
  2. $ curl 'localhost/helloD'
  3. <h1>Hello, WorldD!</h1>
  4. # Otokaze @ Otokaze-Win10 in ~ [13:56:39]
  5. $ curl 'localhost/helloD?name=Otokaze'
  6. <h1>Hello, Otokaze!</h1>

虽然可行,但最好还是使用 @RequestParam 注解标明一下,就如同少了 @Override 注解一样能工作一样。

@ModelAttribute 注解

上一节提到了 @RequestParam 注解,它的作用是将请求参数注入到方法参数中;而 @ModelAttribute 注解的作用就如同它的名字一样,将请求参数直接注入到 Model 对象中(addAttribute 方法),什么意思呢?

前面我们说了,ModelAndView 是最古老的传值方式,而 Model 是较新的传值方式(ModelMap 和 Model 很相似,暂时忽略,一般用的最多的就是 Model 和 ModelAndView 两种),ModelAndView 需要自己手动在方法中 new 出来,而 Model 对象则是 Spring 自动注入的,不需要我们 new 出来。

现在假设这么一个情形,/queryUser 接收两个参数,username 和 password,分别表示用户的用户名和密码,为了方便,我们使用一个 User 类来表示一个用户,这个 User 类有两个私有成员,username 和 password,且这两个私有成员都有自己对应的公共 getter/setter 方法,如下:

  1. public class User {
  2. private String username;
  3. private String password;
  4. public String getUsername() {
  5. return username;
  6. }
  7. public void setUsername(String username) {
  8. this.username = username;
  9. }
  10. public String getPassword() {
  11. return password;
  12. }
  13. public void setPassword(String password) {
  14. this.password = password;
  15. }
  16. }

用我们上面学的知识,我们可以这样写一个控制器方法:

  1. package com.zfl9.controller;
  2. import org.springframework.stereotype.Controller;
  3. import org.springframework.ui.Model;
  4. import org.springframework.web.bind.annotation.RequestMapping;
  5. import org.springframework.web.bind.annotation.RequestParam;
  6. @Controller
  7. public class HelloWorldController {
  8. @RequestMapping("/queryUser")
  9. public String queryUser(Model model, @RequestParam String username, @RequestParam String password) {
  10. User user = new User();
  11. user.setUsername(username);
  12. user.setPassword(password);
  13. model.addAttribute("user", user);
  14. return "queryUser";
  15. }
  16. }

queryUser.jsp 内容:

  1. <%@ page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %>
  2. <!DOCTYPE html>
  3. <html>
  4. <head>
  5. <meta charset="UTF-8">
  6. <title>queryUser</title>
  7. </head>
  8. <body>
  9. <h1>username: ${user.username}</h1>
  10. <h1>password: ${user.password}</h1>
  11. </body>
  12. </html>

执行结果,没问题:

  1. $ curl 'http://localhost/queryUser?username=Otokaze&password=123456'
  2. <!DOCTYPE html>
  3. <html>
  4. <head>
  5. <meta charset="UTF-8">
  6. <title>queryUser</title>
  7. </head>
  8. <body>
  9. <h1>username: Otokaze</h1>
  10. <h1>password: 123456</h1>
  11. </body>
  12. </html>

但我们其实可以让 Spring 自动将与 User 类的属性同名的查询参数注入到 User 类的 setter 方法,并且将 User 类的实例注入到 Model 对象中(调用 addAttribute() 方法),如下(@ModelAttribute 注解):

  1. package com.zfl9.controller;
  2. import org.springframework.stereotype.Controller;
  3. import org.springframework.web.bind.annotation.ModelAttribute;
  4. import org.springframework.web.bind.annotation.RequestMapping;
  5. @Controller
  6. public class HelloWorldController {
  7. @RequestMapping("/queryUser")
  8. public String queryUser(@ModelAttribute User user) {
  9. return "queryUser";
  10. }
  11. }

注意到我们的 @ModelAttribute 注解,它的作用就是自动将 User 实例注入到 Model 对象中,name 即使 User 类的首字母小写格式,value 就是 user 实例,User 实例会被 Spring 自动创建(无参构造函数),然后会根据同名查询参数,将参数值存放到对应的 setter 方法。与我们前面的代码是一样的。测试结果相同。

当然,你会发现去掉 @ModelAttribute 注解也能正常工作,如下,但是这不建议,可读性不如上面的这种:

  1. package com.zfl9.controller;
  2. import org.springframework.stereotype.Controller;
  3. import org.springframework.web.bind.annotation.RequestMapping;
  4. @Controller
  5. public class HelloWorldController {
  6. @RequestMapping("/queryUser")
  7. public String queryUser(User user) {
  8. return "queryUser";
  9. }
  10. }

当然,我们还可以改写一下这个例子,将 User 实例的注入放到一个单独的方法中:

  1. package com.zfl9.controller;
  2. import org.springframework.stereotype.Controller;
  3. import org.springframework.web.bind.annotation.ModelAttribute;
  4. import org.springframework.web.bind.annotation.RequestMapping;
  5. @Controller
  6. public class HelloWorldController {
  7. @ModelAttribute
  8. public void receiveUser(@ModelAttribute User user) {}
  9. @RequestMapping("/queryUser")
  10. public String queryUser() {
  11. return "queryUser";
  12. }
  13. }

需要注意的是,被 @ModelAttribute 注解的方法会在每个控制器方法前执行,要慎用。

发送 302 跳转

其实就是一个特殊的 view name 而已,即 redirect:/path/to/target/url

  1. package com.zfl9.controller;
  2. import org.springframework.stereotype.Controller;
  3. import org.springframework.web.bind.annotation.RequestMapping;
  4. @Controller
  5. public class HelloWorldController {
  6. @RequestMapping("/www.zfl9.com")
  7. public String redirectToZfl9() {
  8. return "redirect:https://www.zfl9.com";
  9. }
  10. @RequestMapping("/www.baidu.com")
  11. public String redirectToBaidu() {
  12. return "redirect:https://www.baidu.com";
  13. }
  14. @RequestMapping("/www.google.com")
  15. public String redirectToGoogle() {
  16. return "redirect:https://www.google.com";
  17. }
  18. }

访问静态资源

注意我们前面的 web.xml 配置:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <web-app>
  3. <filter>
  4. <filter-name>encodingFilter</filter-name>
  5. <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
  6. <init-param>
  7. <param-name>encoding</param-name>
  8. <param-value>UTF-8</param-value>
  9. </init-param>
  10. <init-param>
  11. <param-name>forceEncoding</param-name>
  12. <param-value>true</param-value>
  13. </init-param>
  14. </filter>
  15. <filter-mapping>
  16. <filter-name>encodingFilter</filter-name>
  17. <url-pattern>/*</url-pattern>
  18. </filter-mapping>
  19. <servlet>
  20. <servlet-name>springmvc</servlet-name>
  21. <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  22. <load-on-startup>1</load-on-startup>
  23. <init-param>
  24. <param-name>contextConfigLocation</param-name>
  25. <param-value>/WEB-INF/mvc.xml</param-value>
  26. </init-param>
  27. </servlet>
  28. <servlet-mapping>
  29. <servlet-name>springmvc</servlet-name>
  30. <url-pattern>/</url-pattern>
  31. </servlet-mapping>
  32. </web-app>

我们将所有 url 都映射到了 springmvc 这个 servlet。springmvc 基本上是这样工作的,当 springmvc 收到一个请求时,都会向 Handler Mapping 查询对应的 Controller 处理器(所谓请求处理器就是 Controller 里面的处理方法),如果找到了对应的请求处理器,就将请求交给它处理,如果没找到那就返回 404 错误。

但是如果我们要访问静态资源,就会出现问题了,比如我们在根目录下下有一个 /images/site.png 图片资源,通常我们想直接通过 http://localhost/$contextPath/images/site.png 来访问它,而不是先定义一个 Controller 处理器来访问,怎么办呢?如果不进行任何配置,当你访问这个 url 的时候就会得到一个 404 Not Found 错误。

这时候你就会感到奇怪了,为什么我们的 Hello World 例子中的根目录下的 index.jsp 能直接访问呢?是因为 jsp 有什么特殊待遇么?是的,经过我测试,Spring MVC 不认为 JSP 是静态资源,所以能直接访问(当然是除了 WEB-INF 目录下的文件)。

那么对于其他静态资源,如果想要直接访问,该怎么处理呢?别慌,Spring MVC 提供两个解决办法:

第一种方式最简单,即将静态资源交给 default 这个 Servlet 去处理,动态资源(包括 JSP)则交给 SpringMVC 这个 Servlet 去处理,配置如下:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <beans xmlns="http://www.springframework.org/schema/beans"
  3. xmlns:mvc="http://www.springframework.org/schema/mvc"
  4. xmlns:context="http://www.springframework.org/schema/context"
  5. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  6. xsi:schemaLocation="http://www.springframework.org/schema/beans
  7. http://www.springframework.org/schema/beans/spring-beans.xsd
  8. http://www.springframework.org/schema/mvc
  9. http://www.springframework.org/schema/mvc/spring-mvc.xsd
  10. http://www.springframework.org/schema/context
  11. http://www.springframework.org/schema/context/spring-context.xsd">
  12. <context:component-scan base-package="com.zfl9"/>
  13. <mvc:annotation-driven/>
  14. <mvc:default-servlet-handler/>
  15. <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
  16. <property name="prefix" value="/WEB-INF/views/"/>
  17. <property name="suffix" value=".jsp"/>
  18. </bean>
  19. </beans>

第二种方式也很好理解,mapping 表示映射出去的 uri 路径,而 location 表示实际对应的目录:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <beans xmlns="http://www.springframework.org/schema/beans"
  3. xmlns:mvc="http://www.springframework.org/schema/mvc"
  4. xmlns:context="http://www.springframework.org/schema/context"
  5. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  6. xsi:schemaLocation="http://www.springframework.org/schema/beans
  7. http://www.springframework.org/schema/beans/spring-beans.xsd
  8. http://www.springframework.org/schema/mvc
  9. http://www.springframework.org/schema/mvc/spring-mvc.xsd
  10. http://www.springframework.org/schema/context
  11. http://www.springframework.org/schema/context/spring-context.xsd">
  12. <context:component-scan base-package="com.zfl9"/>
  13. <mvc:annotation-driven/>
  14. <!-- 将 Web 根路径 "/" 及类路径下 /META-INF/publicResources/ 的目录映射为 /resources 路径(uri)。假设 Web 根路径下拥有 images、js 这两个资源目录,在 images 下面有 bg.gif 图片,在 js 下面有 test.js 文件,则可以通过 /resources/images/bg.gif 和 /resources/js/test.js 访问这二个静态资源。-->
  15. <mvc:resources location="/,classpath:/META-INF/publicResources/" mapping="/resources/**"/>
  16. <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
  17. <property name="prefix" value="/WEB-INF/views/"/>
  18. <property name="suffix" value=".jsp"/>
  19. </bean>
  20. </beans>

项目上下文问题

注意,如果你喜欢使用绝对路径,你可以在 jsp 页面中这样做:

  1. <%@ page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %>
  2. <%@ taglib prefix="core" uri="http://java.sun.com/jsp/jstl/core" %>
  3. <core:set var="ctx" value="${pageContext.request.contextPath}"/>
  4. <!DOCTYPE html>
  5. <html>
  6. <head>
  7. <meta charset="UTF-8">
  8. <title>test</title>
  9. </head>
  10. <body>
  11. <div align="center">
  12. <h3><a href="${ctx}/">ctx</a></h3>
  13. <h3><a href="${ctx}/test">test</a></h3>
  14. <h3><a href="${ctx}/dir/test">dir/test</a></h3>
  15. <h3><a href="${ctx}/dir/dir/test">dir/dir/test</a></h3>
  16. </div>
  17. </body>
  18. </html>

其中 ctx 变量就是我们的上下文路径,注意即使是根路径,也要记得加上 /,否则会变成空字符串!!!

进阶版 HelloWorld

目录结构:

  1. ├─java
  2. └─com
  3. └─zfl9
  4. ├─controller
  5. EmployeeController.java
  6. ├─dao
  7. EmployeeDao.java
  8. EmployeeDaoImpl.java
  9. ├─model
  10. Employee.java
  11. └─service
  12. EmployeeService.java
  13. EmployeeServiceImpl.java
  14. └─webapp
  15. index.html
  16. └─WEB-INF
  17. mvc.xml
  18. web.xml
  19. └─views
  20. Employee_ListAll.jsp

一个员工管理系统,目前只有一个功能,那就是列出所有员工的信息。

Employee.java

  1. package com.zfl9.model;
  2. public class Employee {
  3. private int id;
  4. private String firstName;
  5. private String lastName;
  6. public int getId() {
  7. return id;
  8. }
  9. public void setId(int id) {
  10. this.id = id;
  11. }
  12. public String getFirstName() {
  13. return firstName;
  14. }
  15. public void setFirstName(String firstName) {
  16. this.firstName = firstName;
  17. }
  18. public String getLastName() {
  19. return lastName;
  20. }
  21. public void setLastName(String lastName) {
  22. this.lastName = lastName;
  23. }
  24. @Override
  25. public String toString() {
  26. return String.format("[ id = %d, firstName: %s, lastName: %s ]", id, firstName, lastName);
  27. }
  28. }

EmployeeDao.java

  1. package com.zfl9.dao;
  2. import java.util.List;
  3. import com.zfl9.model.Employee;
  4. public interface EmployeeDao {
  5. List<Employee> getAllEmployee();
  6. }

EmployeeDaoImpl.java

  1. package com.zfl9.dao;
  2. import java.util.ArrayList;
  3. import java.util.List;
  4. import org.springframework.stereotype.Repository;
  5. import com.zfl9.model.Employee;
  6. @Repository
  7. public class EmployeeDaoImpl implements EmployeeDao {
  8. @Override
  9. public List<Employee> getAllEmployee() {
  10. List<Employee> employees = new ArrayList<>(3);
  11. Employee employeeA = new Employee();
  12. employeeA.setId(1);
  13. employeeA.setFirstName("张");
  14. employeeA.setLastName("小明");
  15. employees.add(employeeA);
  16. Employee employeeB = new Employee();
  17. employeeB.setId(2);
  18. employeeB.setFirstName("王");
  19. employeeB.setLastName("老五");
  20. employees.add(employeeB);
  21. Employee employeeC = new Employee();
  22. employeeC.setId(3);
  23. employeeC.setFirstName("李");
  24. employeeC.setLastName("小胖");
  25. employees.add(employeeC);
  26. return employees;
  27. }
  28. }

EmployeeService.java

  1. package com.zfl9.service;
  2. import java.util.List;
  3. import com.zfl9.model.Employee;
  4. public interface EmployeeService {
  5. List<Employee> listAllEmployee();
  6. }

EmployeeServiceImpl.java

  1. package com.zfl9.service;
  2. import java.util.List;
  3. import org.springframework.beans.factory.annotation.Autowired;
  4. import org.springframework.stereotype.Service;
  5. import com.zfl9.dao.EmployeeDao;
  6. import com.zfl9.model.Employee;
  7. @Service
  8. public class EmployeeServiceImpl implements EmployeeService {
  9. @Autowired
  10. private EmployeeDao employeeDao;
  11. @Override
  12. public List<Employee> listAllEmployee() {
  13. return employeeDao.getAllEmployee();
  14. }
  15. }

EmployeeController.java

  1. package com.zfl9.controller;
  2. import org.springframework.beans.factory.annotation.Autowired;
  3. import org.springframework.stereotype.Controller;
  4. import org.springframework.ui.Model;
  5. import org.springframework.web.bind.annotation.GetMapping;
  6. import org.springframework.web.bind.annotation.RequestMapping;
  7. import com.zfl9.service.EmployeeService;
  8. @Controller
  9. @RequestMapping("/employee")
  10. public class EmployeeController {
  11. @Autowired
  12. private EmployeeService employeeService;
  13. @GetMapping("/listAll")
  14. public String listAllEmployee(Model model) {
  15. model.addAttribute("employees", employeeService.listAllEmployee());
  16. return "Employee_ListAll";
  17. }
  18. }

Employee_ListAll.jsp

  1. <%@ page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %>
  2. <%@ taglib prefix="core" uri="http://java.sun.com/jsp/jstl/core" %>
  3. <!DOCTYPE html>
  4. <html>
  5. <head>
  6. <meta charset="UTF-8">
  7. <title>listAll</title>
  8. </head>
  9. <body>
  10. <table border="1">
  11. <tr>
  12. <th>ID</td>
  13. <th>First Name</td>
  14. <th>Last Name</td>
  15. </tr>
  16. <core:forEach items="${employees}" var="employee">
  17. <tr>
  18. <td>${employee.id}</td>
  19. <td>${employee.firstName}</td>
  20. <td>${employee.lastName}</td>
  21. </tr>
  22. </core:forEach>
  23. </table>
  24. </body>
  25. </html>

index.html

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="UTF-8">
  5. <title>index.html</title>
  6. </head>
  7. <body>
  8. <h1><a href="employee/listAll">listAllEmployee</a></h1>
  9. </body>
  10. </html>

测试结果:Spring MVC Hello World 进阶版

简单解析:我们采用了文章开头的 web层、业务层、控制层这样的三层结构,其中 Service 和 Dao 层都采用了面向接口编程的方式,注意几个特殊的注解,我们在 Controller 类上使用了 @Controller 注解,在 ServiceImpl 类上使用了 @Service 注解,在 DaoImpl 类上使用了 @Repository 注解,然后我们再 ServiceImpl 类中使用 @Autowired 来自动装配 DaoImpl 实现类,同理,我们在 Controller 类中使用 @Autowired 来自动装配 ServiceImpl 实现类,所以我们的控制处理器方法就是直接调用 serviceImpl 的 getAllEmployee 方法,然后将得到的 list 存放到 request 域中。在 jsp 文件中,我们使用 jstl 的 forEach 标签来遍历 List 中的元素,打印一个表格,最终效果如上。

一个忠告:在 WEBAPP 中,尽量使用相对路径,不要使用绝对路径,不要使用绝对路径,不要使用绝对路径,就如同上面的 HTML 文件中的 employee/listAll 路径一样,相对路径是兼容性最好的,如果使用绝对路径,那么当你将 webapp 放到非 ROOT 目录时就会出现 404 错误,因为它不会自动加上 context 的路径前缀!!!

数据绑定相关的注解

在这之前,我们先来学习几个常用的 数据绑定 相关的注解。
根据处理的 Request 的不同部分,将它们分为四类(常用的):

注意,html 表单的编码方式为 application/x-www-form-urlencoded,可以使用 GET 和 POST 两种提交方式,编码方式是一样的,只不过 GET 方式是将 param 附着在 uri 的查询参数上,而 POST 则是作为请求体发送到服务端;但是无论如何,Servlet-API 解析 application/x-www-form-urlencoded 数据的方式是一致的,与 GET 还是 POST 无关。所以上面的分类其实还可以细分为 5 类,即处理 queryString 的注解为 @RequestParam,不过其实 @RequestParam 可以解析 quertString、get/post 提交的表单数据、multipart 文件上传等类型的请求数据,大家理解就行。

说到 @PathVariable 注解,就不得不先提一下 @RequestMapping(衍生的 @GetMapping、@PostMapping、@PutMapping、@PatchMapping、@DeleteMapping 同理,这个就不用多说了吧),@RequestMapping 里面有一个 path 属性,指定对应的处理器映射到的 uri 路径,这个 uri 有一个特殊模式。@RequestMapping 是一个用来处理请求地址映射的注解,可用于类或方法上。用于类上,表示类中的所有响应请求的方法都是以该地址作为父路径。@RequestMapping 有 6 个属性,我们先来详细了解 path/value 属性,分为 3 种:

@PathVariable 注解关心的就是后两种 uri 类型,说是说两种,其实就是一种,包含变量的 path 而已,只不过我们可以接一个 : 然后写上 regex 匹配模式而已。id 就是匹配到的字符串的变量名,待会有用。

那么 @PathVariable 怎么使用呢?当然是用在方法参数上了,接收匹配到的字符串啦,注解有一个常用属性 value,表示对应参数要绑定到的 path variable 变量名,当参数名和变量名相同时可以省略,建议这么做。

  1. @GetMapping("/employees/{id}")
  2. @ResponseBody
  3. public String testForPathVar(@PathVariable String id) {
  4. return "request employee id is " + id;
  5. }
  6. @GetMapping("/students/{page:\\d++\\.\\w++}")
  7. @ResponseBody
  8. public String testForPathRegex(@PathVariable String page) {
  9. return "request students page is " + page;
  10. }

@RequestHeader 注解用来从 http request 中绑定对应的 header 头部值。@CookieValue 注解用来绑定 http request 中对应的 cookie 键值对,使用例子:

  1. @GetMapping("/testForHeader")
  2. @ResponseBody
  3. public String testForRequestHeaderAndCookie(@RequestHeader("User-Agent") String userAgent, @CookieValue("SessionId") String sessionId) {
  4. return "User-Agent: " + userAgent + "\nSessionId: " + sessionId + "\n";
  5. }
  1. $ curl localhost/testForHeader -H 'Cookie: SessionId=www.zfl9.com'
  2. User-Agent: curl/7.41.0
  3. SessionId: www.zfl9.com

@RequestParam 注解可以用来解析 query parameters(get), form data(post), and parts in multipart requests. 简单的说就是用来解析表单数据和文件上传相关的(解析文件上传需要一些额外的工作),我们暂且不关心 multipart 请求(即文件上传),@RequestParam 通常用来绑定简单类型的数据(或者说标量数据),即从 String 转换为目标类型,如 String、整数、小数、日期等。所以对于 MIME 为 application/jsonapplication/xml 的请求时(通常是 RESTful 请求),那么就不能使用 @RequestParam 来解析,而是要用 @RequestBody 来解析(很好理解,其实)。

  1. @PostMapping("/uploadJson")
  2. @ResponseBody
  3. public String uploadJson(@RequestBody String json) {
  4. return json;
  5. }
  1. $ curl -X POST -H 'Content-Type: application/json' -d $'{ "id": 0, "username": "root", "password": "www.zfl9.com" }\n' localhost/uploadJson
  2. { "id": 0, "username": "root", "password": "www.zfl9.com" }

@RequestParam 还有一个用法没有提到,如果对应的参数是 Map<String, String>MultiValueMap<String, String>,并且注解属性 value 没有指定,那么 Spring 会将所有 parameters 放到 map 中;如果指定了 value 属性,则只存放指定的那个 param,例子:

  1. @ResponseBody
  2. @PostMapping("/params")
  3. public String params(@RequestParam Map<String, String> map) {
  4. return map.toString();
  5. }
  1. $ curl -d 'name=Otoakze' -d 'site=www.zfl9.com' localhost/params
  2. {name=Otoakze, site=www.zfl9.com}

@RequestPart@RequestParam 都可以处理 multipart 请求(即文件上传),但是 @RequestPart 是专门为了处理 multipart 请求而生的,而 @RequestParam 可以处理表单数据、查询字符串、multipart,基本上两者没差别,可以互换,一般情况下,使用 @RequestParam 就行了,所以 @RequestPart 基本可忽略。

@ModelAttribute 可以注解控制器方法,也可以注解控制器方法的参数。

如果用在方法上,则这个方法会在所有 @RequestMapping 方法前执行,这个方法可以拥有与 @RequestMapping 相同的方法参数(自动注入),该方法如果返回一个对象,则这个对象会存储到 Model 作用域中(其实就是 request 作用域),name 默认是类名的首字母小写形式,当然也可以在注解上指定 name。

如果用在方法参数上,则 @ModelAttribute 会先解析 quertString、form-data 中的 params 参数,然后 new 一个参数对象,然后与 setter 方法同名的 param 将会被自动注入到该对象中,最后将这个对象存储到 model/request 作用域中。所以我们可以直接在 jsp 中使用 ${name.attr} 来访问被 @ModelAttribute 注解的参数对象。默认 name 的规则同上,也可手动指定。

@SessionAttributes 注解用来注释 Controller 类,用来将 model/request 作用域中的对象存储到 session 作用域中,可以指定多个 name,这些 name 对应的对象都会被存储到 session 作用域中。

@SessionAttribute 注解用来注释控制器方法的参数,用来将 session 作用域中的对象绑定到参数对象上。注意,@ModelAttribute 和 @SessionAttribute 都可以注解方法参数,而且都是将 request/session 作用域中的对象绑定到参数对象上,但是它们有一个区别,@ModelAttribute 是先从请求中读取参数,然后 new 出参数对象,然后使用 setter 注入 params,最后才是将对象存放到 request 作用域,但是 @SessionAttribute 仅仅是从 session 作用域中读取对应 name 的对象而已。不要搞错了。

@ModelAttribute 注解就不用多说了,已经演示过很多次,我们只要了解 @SessionAttritebute 和 @SessionAttributes 两个注解(虽然就差一个字符,但是区别还是很大的),@SessionAttributes 注解用在 Type 上,@SessionAttribute 注解用在 Parameter 上!前者是将 request 中的指定对象存储到 session 作用域,后者是从 session 作用域读取指定对象然后绑定到参数上。

不过我测试的时候 @SessionAttributes 注解貌似不能处理方法参数中的 @ModelAttribute 注解,只能识别方法级别上的 @ModelAttribute,不过官方 javadoc 貌似建议 HttpSession 对象好一点,暂时就这样吧。

再次说明:ModelAttribute 用来绑定 request 作用域上的对象,SessionAttribute 用来绑定 session 作用域上的对象,请牢记在 Spring MVC 中,Model 和 Request 基本上是同义词(这个词混淆度太高了)。

在不给定注解的情况下,参数是怎样绑定的?

这里的简单类型指 ConversionService 可以直接 String 转换成目标对象的类型。如 int、String、Date。虽然可以省略注解,但是强烈建议加上注解,这样可读性强,也更不容易出错!!在此说明一下,Spring 很聪明,我们可以在处理方法的参数中放入很多与 Servlet 相关的参数,比如 HttpServletRequest、HttpServletResponse、HttpSession,Spring MVC 会自动注入合适的对象!

更新,在 Controller 方法中,可以使用 @Autowired 来自动装配 ServletContext 等组件,其实原理很简单,就是从 IoC 容器中注入而已。不过要注意,因为 Controller 是单例模式(默认就是这样,IoC 容器),所以成员变量中设置的 Autowired 属性应该是符合单例模式条件的,比如 ServletContext,这是安全的。

@RestController 注解

@RestController 注解等价于 @ResponseBody + @Controller 注解一起使用,将当前 Controller 作为 RESTful 服务时很有用,这样就不需要在每个 RESTful 方法中打上 @ResponseBody 注解了。在 Spring MVC 4.0 的时候引入的,方便用于 RESTful 的控制器:

  1. @Controller
  2. public class HelloController {
  3. @ResponseBody
  4. @GetMapping("/employees/{id}")
  5. public Employee getEmployee(...) {
  6. ...
  7. }
  8. @ResponseBody
  9. @DeleteMapping("/employees/{id}")
  10. public Employee deleteEmployee(...) {
  11. ...
  12. }
  13. }

等价于:

  1. @Controller
  2. @ResponseBody
  3. public class HelloController {
  4. @GetMapping("/employees/{id}")
  5. public Employee getEmployee(...) {
  6. ...
  7. }
  8. @DeleteMapping("/employees/{id}")
  9. public Employee deleteEmployee(...) {
  10. ...
  11. }
  12. }

等价于:

  1. @RestController
  2. public class HelloController {
  3. @GetMapping("/employees/{id}")
  4. public Employee getEmployee(...) {
  5. ...
  6. }
  7. @DeleteMapping("/employees/{id}")
  8. public Employee deleteEmployee(...) {
  9. ...
  10. }
  11. }

员工管理 CRUD

我们再来写一个简单程序,但是要让它实用一点,用到 MySQL 数据库,之前我们什么都没用到。所谓员工管理系统就是四个操作:CRUD,创建,读取,更新,删除,我们使用 Spring MVC 来实现它,巩固前面学的知识。

项目结构

  1. ├─java
  2. └─com
  3. └─zfl9
  4. ├─controller
  5. EmployeeController.java
  6. ├─dao
  7. EmployeeDao.java
  8. EmployeeDaoImpl.java
  9. ├─model
  10. Employee.java
  11. └─service
  12. EmployeeService.java
  13. EmployeeServiceImpl.java
  14. └─webapp
  15. └─WEB-INF
  16. mvc.xml
  17. web.xml
  18. └─views
  19. employee-edit.jsp
  20. employee-list.jsp

pom.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  4. <modelVersion>4.0.0</modelVersion>
  5. <groupId>com.zfl9</groupId>
  6. <artifactId>SpringMVC_Learn</artifactId>
  7. <version>1.0-SNAPSHOT</version>
  8. <packaging>war</packaging>
  9. <properties>
  10. <maven.compiler.source>1.8</maven.compiler.source>
  11. <maven.compiler.target>1.8</maven.compiler.target>
  12. <spring.version>4.3.20.RELEASE</spring.version>
  13. <mysql.version>8.0.13</mysql.version>
  14. <servlet.version>3.1.0</servlet.version>
  15. <jstl.version>1.2</jstl.version>
  16. <jackson.version>2.9.7</jackson.version>
  17. </properties>
  18. <dependencies>
  19. <dependency>
  20. <groupId>org.springframework</groupId>
  21. <artifactId>spring-context</artifactId>
  22. <version>${spring.version}</version>
  23. </dependency>
  24. <dependency>
  25. <groupId>org.springframework</groupId>
  26. <artifactId>spring-webmvc</artifactId>
  27. <version>${spring.version}</version>
  28. </dependency>
  29. <dependency>
  30. <groupId>org.springframework</groupId>
  31. <artifactId>spring-jdbc</artifactId>
  32. <version>${spring.version}</version>
  33. </dependency>
  34. <dependency>
  35. <groupId>mysql</groupId>
  36. <artifactId>mysql-connector-java</artifactId>
  37. <version>${mysql.version}</version>
  38. <scope>runtime</scope>
  39. </dependency>
  40. <dependency>
  41. <groupId>javax.servlet</groupId>
  42. <artifactId>javax.servlet-api</artifactId>
  43. <version>${servlet.version}</version>
  44. <scope>provided</scope>
  45. </dependency>
  46. <dependency>
  47. <groupId>javax.servlet</groupId>
  48. <artifactId>jstl</artifactId>
  49. <version>${jstl.version}</version>
  50. </dependency>
  51. <!-- Object2Json 的库 -->
  52. <dependency>
  53. <groupId>com.fasterxml.jackson.core</groupId>
  54. <artifactId>jackson-databind</artifactId>
  55. <version>${jackson.version}</version>
  56. </dependency>
  57. </dependencies>
  58. </project>

web.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <web-app>
  3. <filter>
  4. <filter-name>encodingFilter</filter-name>
  5. <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
  6. <init-param>
  7. <param-name>encoding</param-name>
  8. <param-value>UTF-8</param-value>
  9. </init-param>
  10. <init-param>
  11. <param-name>forceEncoding</param-name>
  12. <param-value>true</param-value>
  13. </init-param>
  14. </filter>
  15. <filter-mapping>
  16. <filter-name>encodingFilter</filter-name>
  17. <url-pattern>/*</url-pattern>
  18. </filter-mapping>
  19. <servlet>
  20. <servlet-name>springmvc</servlet-name>
  21. <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  22. <load-on-startup>1</load-on-startup>
  23. <init-param>
  24. <param-name>contextConfigLocation</param-name>
  25. <param-value>/WEB-INF/mvc.xml</param-value>
  26. </init-param>
  27. </servlet>
  28. <servlet-mapping>
  29. <servlet-name>springmvc</servlet-name>
  30. <url-pattern>/</url-pattern>
  31. </servlet-mapping>
  32. </web-app>

mvc.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <beans xmlns="http://www.springframework.org/schema/beans"
  3. xmlns:mvc="http://www.springframework.org/schema/mvc"
  4. xmlns:context="http://www.springframework.org/schema/context"
  5. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  6. xsi:schemaLocation="http://www.springframework.org/schema/beans
  7. http://www.springframework.org/schema/beans/spring-beans.xsd
  8. http://www.springframework.org/schema/mvc
  9. http://www.springframework.org/schema/mvc/spring-mvc.xsd
  10. http://www.springframework.org/schema/context
  11. http://www.springframework.org/schema/context/spring-context.xsd">
  12. <context:component-scan base-package="com.zfl9"/>
  13. <mvc:annotation-driven/>
  14. <mvc:default-servlet-handler/>
  15. <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
  16. <property name="prefix" value="/WEB-INF/views/"/>
  17. <property name="suffix" value=".jsp"/>
  18. </bean>
  19. <bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
  20. <property name="driverClassName" value="com.mysql.cj.jdbc.Driver"/>
  21. <property name="url" value="jdbc:mysql://localhost/test?serverTimezone=UTC"/>
  22. <property name="username" value="root"/>
  23. <property name="password" value="123456"/>
  24. </bean>
  25. <bean id="jdbcTemplate" class="org.springframework.jdbc.core.JdbcTemplate">
  26. <property name="dataSource" ref="dataSource"/>
  27. </bean>
  28. </beans>

Employee

  1. package com.zfl9.model;
  2. public class Employee implements java.io.Serializable {
  3. private static final long serialVersionUID = 6782234751084760161L;
  4. private Integer id;
  5. private String name;
  6. private String email;
  7. private String address;
  8. private String telephone;
  9. public Integer getId() {
  10. return id;
  11. }
  12. public void setId(Integer id) {
  13. this.id = id;
  14. }
  15. public String getName() {
  16. return name;
  17. }
  18. public void setName(String name) {
  19. this.name = name;
  20. }
  21. public String getEmail() {
  22. return email;
  23. }
  24. public void setEmail(String email) {
  25. this.email = email;
  26. }
  27. public String getAddress() {
  28. return address;
  29. }
  30. public void setAddress(String address) {
  31. this.address = address;
  32. }
  33. public String getTelephone() {
  34. return telephone;
  35. }
  36. public void setTelephone(String telephone) {
  37. this.telephone = telephone;
  38. }
  39. @Override
  40. public String toString() {
  41. return String.format("Employee { id = %d, name = %s, email = %s, address = %s, telephone = %s }", id, name, email, address, telephone);
  42. }
  43. }

EmployeeDao

  1. package com.zfl9.dao;
  2. import java.util.List;
  3. import com.zfl9.model.Employee;
  4. public interface EmployeeDao {
  5. Employee getEmployee(int id);
  6. List<Employee> getAllEmployee();
  7. void addEmployee(Employee employee);
  8. void updateEmployee(Employee employee);
  9. void deleteEmployee(int id);
  10. void deleteAllEmployee();
  11. }

EmployeeDaoImpl

  1. package com.zfl9.dao;
  2. import java.util.List;
  3. import org.springframework.beans.factory.annotation.Autowired;
  4. import org.springframework.jdbc.core.JdbcTemplate;
  5. import org.springframework.jdbc.core.RowMapper;
  6. import org.springframework.stereotype.Repository;
  7. import com.zfl9.model.Employee;
  8. @Repository
  9. public class EmployeeDaoImpl implements EmployeeDao {
  10. @Autowired
  11. private JdbcTemplate jdbcTemplate;
  12. private RowMapper<Employee> rowMapper = (resultSet, rowNum) -> {
  13. Employee employee = new Employee();
  14. employee.setId(resultSet.getInt("id"));
  15. employee.setName(resultSet.getString("name"));
  16. employee.setEmail(resultSet.getString("email"));
  17. employee.setAddress(resultSet.getString("address"));
  18. employee.setTelephone(resultSet.getString("telephone"));
  19. return employee;
  20. };
  21. @Override
  22. public Employee getEmployee(int id) {
  23. String sql = "select * from employee where id = ?";
  24. return jdbcTemplate.queryForObject(sql, rowMapper, id);
  25. }
  26. @Override
  27. public List<Employee> getAllEmployee() {
  28. String sql = "select * from employee";
  29. return jdbcTemplate.query(sql, rowMapper);
  30. }
  31. @Override
  32. public void addEmployee(Employee employee) {
  33. String sql = "insert into employee (name, email, address, telephone) values (?, ?, ?, ?)";
  34. jdbcTemplate.update(sql, employee.getName(), employee.getEmail(), employee.getAddress(), employee.getTelephone());
  35. }
  36. @Override
  37. public void updateEmployee(Employee employee) {
  38. String sql = "update employee set name = ?, email = ?, address = ?, telephone = ? where id = ?";
  39. jdbcTemplate.update(sql, employee.getName(), employee.getEmail(), employee.getAddress(), employee.getTelephone(), employee.getId());
  40. }
  41. @Override
  42. public void deleteEmployee(int id) {
  43. String sql = "delete from employee where id = ?";
  44. jdbcTemplate.update(sql, id);
  45. }
  46. @Override
  47. public void deleteAllEmployee() {
  48. String sql = "truncate table employee";
  49. jdbcTemplate.update(sql);
  50. }
  51. }

EmployeeService

  1. package com.zfl9.service;
  2. import java.util.List;
  3. import com.zfl9.model.Employee;
  4. public interface EmployeeService {
  5. Employee getEmployee(int id);
  6. List<Employee> getAllEmployee();
  7. void addEmployee(Employee employee);
  8. void updateEmployee(Employee employee);
  9. void deleteEmployee(int id);
  10. void deleteAllEmployee();
  11. }

EmployeeServiceImpl

  1. package com.zfl9.service;
  2. import java.util.List;
  3. import org.springframework.beans.factory.annotation.Autowired;
  4. import org.springframework.stereotype.Service;
  5. import com.zfl9.dao.EmployeeDao;
  6. import com.zfl9.model.Employee;
  7. @Service
  8. public class EmployeeServiceImpl implements EmployeeService {
  9. @Autowired
  10. private EmployeeDao employeeDao;
  11. @Override
  12. public Employee getEmployee(int id) {
  13. return employeeDao.getEmployee(id);
  14. }
  15. @Override
  16. public List<Employee> getAllEmployee() {
  17. return employeeDao.getAllEmployee();
  18. }
  19. @Override
  20. public void addEmployee(Employee employee) {
  21. employeeDao.addEmployee(employee);
  22. }
  23. @Override
  24. public void updateEmployee(Employee employee) {
  25. employeeDao.updateEmployee(employee);
  26. }
  27. @Override
  28. public void deleteEmployee(int id) {
  29. employeeDao.deleteEmployee(id);
  30. }
  31. @Override
  32. public void deleteAllEmployee() {
  33. employeeDao.deleteAllEmployee();
  34. }
  35. }

EmployeeController

  1. package com.zfl9.controller;
  2. import org.springframework.beans.factory.annotation.Autowired;
  3. import org.springframework.stereotype.Controller;
  4. import org.springframework.ui.Model;
  5. import org.springframework.web.bind.annotation.GetMapping;
  6. import org.springframework.web.bind.annotation.ModelAttribute;
  7. import org.springframework.web.bind.annotation.PathVariable;
  8. import org.springframework.web.bind.annotation.PostMapping;
  9. import com.zfl9.model.Employee;
  10. import com.zfl9.service.EmployeeService;
  11. @Controller
  12. public class EmployeeController {
  13. @Autowired
  14. private EmployeeService employeeService;
  15. @GetMapping("/")
  16. public String index() {
  17. return "redirect:/employees";
  18. }
  19. @GetMapping("/employees")
  20. public String listEmployee(Model model) {
  21. model.addAttribute("employees", employeeService.getAllEmployee());
  22. return "employee-list";
  23. }
  24. @GetMapping("/employees/new")
  25. public String newEmployee(Model model) {
  26. model.addAttribute("title", "Create Employee");
  27. return "employee-edit";
  28. }
  29. @GetMapping("/employees/edit/{id}")
  30. public String editEmployee(Model model, @PathVariable int id) {
  31. model.addAttribute("title", "Update Employee");
  32. model.addAttribute("employee", employeeService.getEmployee(id));
  33. return "employee-edit";
  34. }
  35. @PostMapping("/employees/save")
  36. public String saveEmployee(@ModelAttribute Employee employee) {
  37. if (employee.getId() == null) {
  38. employeeService.addEmployee(employee);
  39. } else {
  40. employeeService.updateEmployee(employee);
  41. }
  42. return "redirect:/employees";
  43. }
  44. @GetMapping("/employees/delete/{id}")
  45. public String deleteEmployee(@PathVariable String id) {
  46. if ("all".equals(id)) {
  47. employeeService.deleteAllEmployee();
  48. } else {
  49. employeeService.deleteEmployee(Integer.valueOf(id));
  50. }
  51. return "redirect:/employees";
  52. }
  53. }

employee-list.jsp

  1. <%@ page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %>
  2. <%@ taglib prefix="core" uri="http://java.sun.com/jsp/jstl/core" %>
  3. <!DOCTYPE html>
  4. <html>
  5. <head>
  6. <meta charset="UTF-8">
  7. <title>Employee Management System</title>
  8. </head>
  9. <body>
  10. <div align="center">
  11. <h1>Employee List</h1>
  12. <table border="1">
  13. <tr>
  14. <th>ID</th>
  15. <th>Name</th>
  16. <th>Email</th>
  17. <th>Address</th>
  18. <th>Telephone</th>
  19. <th>Action</th>
  20. </tr>
  21. <core:forEach items="${employees}" var="employee">
  22. <tr>
  23. <td>${employee.id}</td>
  24. <td>${employee.name}</td>
  25. <td>${employee.email}</td>
  26. <td>${employee.address}</td>
  27. <td>${employee.telephone}</td>
  28. <td>
  29. <a href="employees/edit/${employee.id}">Edit</a>
  30. <a href="employees/delete/${employee.id}">Delete</a>
  31. </td>
  32. </tr>
  33. </core:forEach>
  34. </table>
  35. <h3><a href="employees/new">Create Employee</a></h3>
  36. <h3><a href="employees/delete/all">Delete All Employee</a></h3>
  37. </div>
  38. </body>
  39. </html>

employee-edit.jsp

  1. <%@ page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %>
  2. <%@ taglib prefix="core" uri="http://java.sun.com/jsp/jstl/core" %>
  3. <!DOCTYPE html>
  4. <html>
  5. <head>
  6. <meta charset="UTF-8">
  7. <title>${title}</title>
  8. </head>
  9. <body>
  10. <div align="center">
  11. <h1>${title}</h1>
  12. <core:url var="save" value="/employees/save"/>
  13. <form action="${save}" method="post">
  14. <input type="hidden" name="id" value="${employee.id}">
  15. <table>
  16. <tr>
  17. <td>Name:</td>
  18. <td><input type="text" name="name" value="${employee.name}"></td>
  19. </tr>
  20. <tr>
  21. <td>Email:</td>
  22. <td><input type="text" name="email" value="${employee.email}"></td>
  23. </tr>
  24. <tr>
  25. <td>Address:</td>
  26. <td><input type="text" name="address" value="${employee.address}"></td>
  27. </tr>
  28. <tr>
  29. <td>Telephone:</td>
  30. <td><input type="text" name="telephone" value="${employee.telephone}"></td>
  31. </tr>
  32. </table>
  33. <input type="submit" value="Save">
  34. </form>
  35. </div>
  36. </body>
  37. </html>

Select Employee
Create Employee
Update Employee

有两个值得注意的地方:

1、Employee 这个 Value Object 对象中,id 字段我用的是 Integer 类型而不是 int 类型,这是有原因的,主要问题在于 employee-edit.jsp 视图上面,里面有一个隐藏字段,即 id,设置的 value 是 ${employee.id},这个视图会有两个 Controller forword 过来,一个是 /employees/new,一个是 /employees/edit/id,其中只有 edit 有 employee 对象,new 是没有这个对象的,所以这个 value 会变成 "" 空字符串值,而当 save 这个处理器解析时,无法将空字符串转换为 int 类型(报错),而将它改为 Integer 类型就没问题了,空串默认转换为 null 空指针。

2、employee-edit.jsp 视图里面的 <core:url var="save" value="/employees/save"/> 元素,这个标签唯一的作用就是会根据上下文路径的不同,转换出正确的 /employees/save 路径,因为 new 和 edit 两个视图的 url 是不一样的,所以不能直接通过“相对路径”来完成,只能这样做,当然也可以使用 jstl 的 if 来做判断,但还是这种方法最方便。var 属性就是对应的变量名,value 就是 url 路径。

其实 Spring MVC 和 Struts2 一样,提供了自己的 taglib 库,方便 jsp 视图的开发(如自动转换为正确的 url 路径,加上 context-path 路径),待会我们会学习它,别急。

Spring 标签库

Spring MVC 提供两套标签库,一套是 spring,一套是 form,因为 spring 这套标签库不太常用也不太实用,所以本文重点讲述 spring 提供的表单 taglib 库。jsp 文件头声明如下,前缀一般设为 form:

  1. <%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>

input 标签
例一:注意我们使用 path 变量来自动绑定 model 里面的数据(当然可以没有 command 这个 model)

  1. <form:form action="formTag/form.do" method="post">
  2. <table>
  3. <tr>
  4. <td>Name:</td><td><form:input path="name"/></td>
  5. </tr>
  6. <tr>
  7. <td>Age:</td><td><form:input path="age"/></td>
  8. </tr>
  9. <tr>
  10. <td colspan="2"><input type="submit" value="提交"/></td>
  11. </tr>
  12. </table>
  13. </form:form>

如果 Model 中存在一个属性名称为 command 的 javaBean,而且该 javaBean 拥有属性 name 和 age 的时候,在渲染上面的代码时就会取 command 的对应属性值赋给对应标签的值。假设 Model 中存在一个属性名称为 command 的 javaBean,且它的 name 和 age 属性分别为 Zhangsan36 时,生成的代码如下:

  1. <form id="command" action="formTag/form.do" method="post">
  2. <table>
  3. <tr>
  4. <td>Name:</td><td><input id="name" name="name" type="text" value="ZhangSan"/></td>
  5. </tr>
  6. <tr>
  7. <td>Age:</td><td><input id="age" name="age" type="text" value="36"/></td>
  8. </tr>
  9. <tr>
  10. <td colspan="2"><input type="submit" value="提交"/></td>
  11. </tr>
  12. </table>
  13. </form>

form 标签会自动绑定 Model(其实就是 request)中的 command 属性(getAttribute("command")),那么如果我们要绑定的对象不是 command 怎么办呢?对于这种情况,Spring 给我们提供了一个 commandName 属性,我们可以通过该属性来指定要绑定的对象名称,除了 commandName 属性外,modelAttribute 属性也可以达到相同的效果(这两个属性是等价的)。

  1. <form:form action="formTag/form.do" method="post" commandName="user">
  2. <table>
  3. <tr>
  4. <td>Name:</td><td><form:input path="name"/></td>
  5. </tr>
  6. <tr>
  7. <td>Age:</td><td><form:input path="age"/></td>
  8. </tr>
  9. <tr>
  10. <td colspan="2"><input type="submit" value="提交"/></td>
  11. </tr>
  12. </table>
  13. </form:form>

除 input 标签外,支持所有 html form 里面的标签,举几个常用的,passwordhiddentextarea

支持 get/post/put/patch/delete 方法(RESTful)

  1. <form:form action="formTag/form.do" method="delete" modelAttribute="user">
  2. <table>
  3. <tr>
  4. <td>Name:</td><td><form:input path="name"/></td>
  5. </tr>
  6. <tr>
  7. <td>Age:</td><td><form:input path="age"/></td>
  8. </tr>
  9. <tr>
  10. <td colspan="2"><input type="submit" value="提交"/></td>
  11. </tr>
  12. </table>
  13. </form:form>

但是我们知道,html 的 form 明确指定了,只支持 get 和 post 两种请求方法,难道 spring form 还有什么黑科技?我们来看看生成的 html 是什么样子的:

  1. <form id="user" action="formTag/form.do" method="post">
  2. <input type="hidden" name="_method" value="delete"/>
  3. <table>
  4. <tr>
  5. <td>Name:</td><td><input id="name" name="name" type="text" value="ZhangSan"/></td>
  6. </tr>
  7. <tr>
  8. <td>Age:</td><td><input id="age" name="age" type="text" value="36"/></td>
  9. </tr>
  10. <tr>
  11. <td colspan="2"><input type="submit" value="提交"/></td>
  12. </tr>
  13. </table>
  14. </form>

原来只是多了一个 hidden 标签,name 为 _method,value 为 delete(请求方法名),另外 form 的 method 为 post,这不就是增加了一个请求属性吗,这有什么作用,又和其他 restful 方法有什么关联呢?

是不是按照上面这样做就能直接使用 PUT、PATCH、DELETE 方法呢?当然不是的,因为实际请求方法为 POST,所以 Spring 提供了一个 Filter,这个 Filter 会处理带有 _method 隐藏字段的请求,怎么处理呢?转换 HTTP 请求报文吗?并不是,Spring 采用了一个巧方法,使用一个 RequestWrapper 对象替换了原来的 Request 对象,并且在 RequestWrapper 对象的 getMethod() 方法中,重写了它,返回 _method 指定的方法名。所以在处理 Controller 处理器的时候,获取到的就是 PUT、PATCH、DELETE 这些方法了。

所以我们还需要配置 web.xml,添加一个 filter,用来处理这种情况:

  1. <filter>
  2. <filter-name>hiddenHttpMethodFilter</filter-name>
  3. <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
  4. </filter>
  5. <filter-mapping>
  6. <filter-name>hiddenHttpMethodFilter</filter-name>
  7. <servlet-name>springmvc</servlet-name>
  8. </filter-mapping>

另外需要注意的是在有 Multipart 请求处理的时候,HiddenHttpMethodFilter 需要在 Multipart 处理之后执行,因为在处理 Multipart 时需要从 POST 请求体中获取参数。所以我们通常会在 HiddenHttpMethodFilter 之前设立一个 MultipartFilter。MultipartFilter 默认会去寻找一个名称为 filterMultipartResolver 的 MultipartResolver bean 对象来对当前的请求进行封装。所以当你定义的MultipartResolver的名称不为filterMultipartResolver 的时候就需要在定义 MultipartFilter 的时候通过参数 multipartResolverBeanName 来指定。

  1. <filter>
  2. <filter-name>multipartFilter</filter-name>
  3. <filter-class>org.springframework.web.multipart.support.MultipartFilter</filter-class>
  4. <init-param>
  5. <param-name>multipartResolverBeanName</param-name>
  6. <param-value>multipartResolver</param-value>
  7. </init-param>
  8. </filter>
  9. <filter-mapping>
  10. <filter-name>multipartFilter</filter-name>
  11. <url-pattern>/*</url-pattern>
  12. </filter-mapping>
  13. <filter>
  14. <filter-name>hiddenHttpMethodFilter</filter-name>
  15. <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
  16. <init-param>
  17. <param-name>methodParam</param-name>
  18. <param-value>requestMethod</param-value>
  19. </init-param>
  20. </filter>
  21. <filter-mapping>
  22. <filter-name>hiddenHttpMethodFilter</filter-name>
  23. <url-pattern>/*</url-pattern>
  24. </filter-mapping>

现在我们来使用 spring-form 标签改写 CRUD 例子中的 jsp 视图,如下:

EmployeeController.java

  1. package com.zfl9.controller;
  2. import org.springframework.beans.factory.annotation.Autowired;
  3. import org.springframework.stereotype.Controller;
  4. import org.springframework.ui.Model;
  5. import org.springframework.web.bind.annotation.GetMapping;
  6. import org.springframework.web.bind.annotation.ModelAttribute;
  7. import org.springframework.web.bind.annotation.PathVariable;
  8. import org.springframework.web.bind.annotation.PostMapping;
  9. import com.zfl9.model.Employee;
  10. import com.zfl9.service.EmployeeService;
  11. @Controller
  12. public class EmployeeController {
  13. @Autowired
  14. private EmployeeService employeeService;
  15. @GetMapping("/")
  16. public String index() {
  17. return "redirect:/employees";
  18. }
  19. @GetMapping("/employees")
  20. public String listEmployee(Model model) {
  21. model.addAttribute("employees", employeeService.getAllEmployee());
  22. return "employee-list";
  23. }
  24. @GetMapping("/employees/new")
  25. public String newEmployee(Model model) {
  26. model.addAttribute("title", "Create Employee");
  27. model.addAttribute("employee", new Employee());
  28. return "employee-edit";
  29. }
  30. @GetMapping("/employees/edit/{id}")
  31. public String editEmployee(Model model, @PathVariable int id) {
  32. model.addAttribute("title", "Update Employee");
  33. model.addAttribute("employee", employeeService.getEmployee(id));
  34. return "employee-edit";
  35. }
  36. @PostMapping("/employees/save")
  37. public String saveEmployee(@ModelAttribute Employee employee) {
  38. if (employee.getId() == null) {
  39. employeeService.addEmployee(employee);
  40. } else {
  41. employeeService.updateEmployee(employee);
  42. }
  43. return "redirect:/employees";
  44. }
  45. @GetMapping("/employees/delete/{id}")
  46. public String deleteEmployee(@PathVariable String id) {
  47. if ("all".equals(id)) {
  48. employeeService.deleteAllEmployee();
  49. } else {
  50. employeeService.deleteEmployee(Integer.valueOf(id));
  51. }
  52. return "redirect:/employees";
  53. }
  54. }

employee-edit.jsp

  1. <%@ page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %>
  2. <%@ taglib prefix="core" uri="http://java.sun.com/jsp/jstl/core" %>
  3. <%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>
  4. <!DOCTYPE html>
  5. <html>
  6. <head>
  7. <meta charset="UTF-8">
  8. <title>${title}</title>
  9. </head>
  10. <body>
  11. <div align="center">
  12. <h1>${title}</h1>
  13. <core:url var="saveAction" value="/employees/save"/>
  14. <form:form action="${saveAction}" method="post" modelAttribute="employee">
  15. <form:hidden path="id"/>
  16. <table>
  17. <tr>
  18. <td>Name:</td><td><form:input path="name"/></td>
  19. </tr>
  20. <tr>
  21. <td>Email:</td><td><form:input path="email"/></td>
  22. </tr>
  23. <tr>
  24. <td>Address:</td><td><form:input path="address"/></td>
  25. </tr>
  26. <tr>
  27. <td>Telephone:</td><td><form:input path="telephone"/></td>
  28. </tr>
  29. </table>
  30. <input type="submit" value="Save">
  31. </form:form>
  32. </div>
  33. </body>
  34. </html>

不同于 EL,Spring 的 form 标签中的 model 属性必须存在,否则报 500 错误,而 EL 表达式则不会。

注意,其实我们可以不用 jstl 的 url 标签,也能输出 contextPath 的路径,那就是使用 EL 表达式:

  1. <%@ page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %>
  2. <%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>
  3. <!DOCTYPE html>
  4. <html>
  5. <head>
  6. <meta charset="UTF-8">
  7. <title>${title}</title>
  8. </head>
  9. <body>
  10. <div align="center">
  11. <h1>${title}</h1>
  12. <form:form action="${pageContext.request.contextPath}/employees/save" method="post" modelAttribute="employee">
  13. <form:hidden path="id"/>
  14. <table>
  15. <tr>
  16. <td>Name:</td><td><form:input path="name"/></td>
  17. </tr>
  18. <tr>
  19. <td>Email:</td><td><form:input path="email"/></td>
  20. </tr>
  21. <tr>
  22. <td>Address:</td><td><form:input path="address"/></td>
  23. </tr>
  24. <tr>
  25. <td>Telephone:</td><td><form:input path="telephone"/></td>
  26. </tr>
  27. </table>
  28. <input type="submit" value="Save">
  29. </form:form>
  30. </div>
  31. </body>
  32. </html>

JSON 支持

第一种方式是使用 JSON 工具将对象序列化成 json 字符串,常用工具有 Jackson,fastjson,gson。

第二种方式,在 mvc.xml 中配置 <mvc:annotation-driven/>,添加 jackson-databind.jar 依赖:

  1. <dependency>
  2. <groupId>com.fasterxml.jackson.core</groupId>
  3. <artifactId>jackson-databind</artifactId>
  4. <version>${jackson.version}</version>
  5. </dependency>

借助 @ResponseBody,我们可以直接返回一个 Bean/Pojo 对象,Spring 会自动序列化为 json 字符串:

  1. @ResponseBody
  2. @GetMapping("/getJson")
  3. public Employee getJson() {
  4. Employee employee = new Employee();
  5. employee.setId(1);
  6. employee.setName("Otokaze");
  7. employee.setEmail("zfl9.com@gmail.com");
  8. employee.setAddress("xxx xxx xxx xxx");
  9. employee.setTelephone("1234567890");
  10. return employee;
  11. }
  1. $ curl localhost/getJson
  2. {"id":1,"name":"Otokaze","email":"zfl9.com@gmail.com","address":"xxx xxx xxx xxx","telephone":"1234567890"}

文件上传

Spring MVC 支持文件上传(multipart 请求),需要在 pom.xml 中引入 commons-fileupload 依赖:

  1. <dependency>
  2. <groupId>commons-fileupload</groupId>
  3. <artifactId>commons-fileupload</artifactId>
  4. <version>${fileupload.version}</version>
  5. </dependency>

然后配置 mvc.xml,注册 MultiPart 请求的解析处理器,web.xml 配置如下:

  1. <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
  2. <!-- postMaxSize: 30M -->
  3. <property name="maxUploadSize" value="31457280"/>
  4. <!-- fileMaxSize: 10M -->
  5. <property name="maxUploadSizePerFile" value="10485760"/>
  6. </bean>

然后编写我们的上传表单,以及上传成功的消息页面:
fileUpload.jsp

  1. <%@ page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %>
  2. <!DOCTYPE html>
  3. <html>
  4. <head>
  5. <meta charset="UTF-8">
  6. <title>fileUpload</title>
  7. </head>
  8. <body>
  9. <div align="center">
  10. <form action="fileUpload" method="post" enctype="multipart/form-data">
  11. <input type="file" name="file" multiple>
  12. <input type="submit" value="Upload">
  13. </form>
  14. </div>
  15. </body>
  16. </html>

uploadSuccess.jsp

  1. <%@ page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %>
  2. <%@ taglib prefix="core" uri="http://java.sun.com/jsp/jstl/core" %>
  3. <!DOCTYPE html>
  4. <html>
  5. <head>
  6. <meta charset="UTF-8">
  7. <title>uploadSuccess</title>
  8. </head>
  9. <body>
  10. <div align="center">
  11. <table border="1">
  12. <tr>
  13. <th>FileName</th>
  14. <th>FileSize</th>
  15. </tr>
  16. <core:forEach items="${files}" var="file">
  17. <tr>
  18. <td>${file.originalFilename}</td>
  19. <td>${file.size}</td>
  20. </tr>
  21. </core:forEach>
  22. </table>
  23. </div>
  24. </body>
  25. </html>

FileUploadController.java

  1. package com.zfl9.controller;
  2. import java.io.File;
  3. import java.io.IOException;
  4. import javax.servlet.http.HttpServletRequest;
  5. import org.springframework.stereotype.Controller;
  6. import org.springframework.web.bind.annotation.GetMapping;
  7. import org.springframework.web.bind.annotation.PostMapping;
  8. import org.springframework.web.bind.annotation.RequestParam;
  9. import org.springframework.web.multipart.MultipartFile;
  10. @Controller
  11. public class FileUploadController {
  12. @GetMapping("/fileUpload")
  13. public String fileUploadForm() {
  14. return "fileUpload";
  15. }
  16. @PostMapping("/fileUpload")
  17. public String fileUploadSave(@RequestParam("file") MultipartFile[] files, HttpServletRequest request) throws IOException {
  18. File saveDir = new File(request.getServletContext().getRealPath("/WEB-INF/files"));
  19. if (!saveDir.exists()) {
  20. saveDir.mkdirs();
  21. }
  22. for (MultipartFile file : files) {
  23. String filename = file.getOriginalFilename();
  24. if (filename == null || filename.isEmpty()) {
  25. continue;
  26. }
  27. file.transferTo(new File(saveDir, filename));
  28. }
  29. request.setAttribute("files", files);
  30. return "uploadSuccess";
  31. }
  32. }

再议重定向

在处理器方法中,我们可以返回 "redirect:/path/to/redirect" 来发送 302 临时重定向,其实还有一个特殊用法,那就是 "forward:/path/to/forward" 来触发 Servlet 的 forward 机制(注意它和直接返回 view 名的不同,forward 会触发 uri 对应的 controller 方法)。

forward 会保留 request 里面的对象,因为这只是发生在 servlet context 内部,对外部是透明的,所以浏览器地址栏也不会有变化。而 redirect 是发送 HTTP 协议定义的重定向响应,浏览器会发起新的请求。

但是,在实际应用中,我们常常有这样一个需求,我需要发送 redirect 重定向给浏览器,但是我又希望能够传递数据给重定向后的处理器方法。该怎么做呢?其实 Spring MVC 提供了相应的解决办法。不过在这之前,我们先自己思考一下,如果要我们自己来实现,该如何做?

因为 redirect 是 HTTP 协议层面的事情,浏览器收到 redirect 响应后,会发起一个全新的 HTTP 请求到目标服务器,所以,如果要携带数据,只能将数据作为 queryString 加到 url 中来传递。但是又因为 queryString 会直接暴露在浏览器地址栏,不安全,所以这种方式不太建议。

虽然不建议使用,不过难免会有用到的时候,我们来看下如何实现这种方式的 redirect 数据携带:

RedirectAttributes 接口提供两个常用的传值方式:

  1. addAttribute(name, value)
  2. addFlashAttribute(name, value)

其中,addAttribute 是利用普通的 url 传参方式进行传递,而 addFlashAttribute 不同于前者,它是将 value 存放到 session 中,然后我们可以在目标处理器方法上,使用 @ModelAttribute 来读取这个 value,从而完成优雅的数据传递。注意,之所以称为 flash attribute,是因为这些 value 在使用 @ModelAttribute 接收后就会被删除,即闪存的本意。

纠错:addFlashAttribute 方法会将属性暂存到 session 中,我们可以在目标方法上通过 Model、ModelMap、@ModelAttribute 等方式来接收,本质都是从 request 作用域 中读取 flash 属性,注意,这些属性只在 redirect 后的第一次请求中有效,只要你刷新一下页面,属性就没了,这就是易失属性的特性,也是其名字的由来。

测试例子:

  1. package com.zfl9.controller;
  2. import org.springframework.stereotype.Controller;
  3. import org.springframework.ui.Model;
  4. import org.springframework.web.bind.annotation.GetMapping;
  5. import org.springframework.web.bind.annotation.ResponseBody;
  6. import org.springframework.web.servlet.mvc.support.RedirectAttributes;
  7. @Controller
  8. public class ForTestController {
  9. @GetMapping("/test01")
  10. public String test01(RedirectAttributes redirectAttributes) {
  11. redirectAttributes.addAttribute("name1", "value1");
  12. redirectAttributes.addAttribute("name2", "value2");
  13. redirectAttributes.addAttribute("name3", "value3");
  14. return "redirect:https://www.zfl9.com";
  15. }
  16. @GetMapping("/test02")
  17. public String test02(RedirectAttributes redirectAttributes) {
  18. redirectAttributes.addFlashAttribute("name1", "value1");
  19. redirectAttributes.addFlashAttribute("name2", "value2");
  20. redirectAttributes.addFlashAttribute("name3", "value3");
  21. return "redirect:/test03";
  22. }
  23. @ResponseBody
  24. @GetMapping("/test03")
  25. public String test03(Model model) {
  26. return model.toString();
  27. }
  28. }

测试结果:

  1. # Otokaze @ Otokaze-Win10 in ~ [14:54:45]
  2. $ \curl -i localhost/test01
  3. HTTP/1.1 302
  4. Location: https://www.zfl9.com?name1=value1&name2=value2&name3=value3
  5. Content-Language: zh-CN
  6. Content-Length: 0
  7. Date: Wed, 12 Dec 2018 07:01:39 GMT
  8. # Otokaze @ Otokaze-Win10 in ~ [15:01:39]
  9. $ \curl -i localhost/test02
  10. HTTP/1.1 302
  11. Set-Cookie: SessionID=D9A909AB34202893DD182A602E14F16C; Path=/; HttpOnly
  12. Location: /test03;SessionID=D9A909AB34202893DD182A602E14F16C
  13. Content-Language: zh-CN
  14. Content-Length: 0
  15. Date: Wed, 12 Dec 2018 07:01:44 GMT
  16. # Otokaze @ Otokaze-Win10 in ~ [15:01:44]
  17. $ \curl -iL localhost/test02
  18. HTTP/1.1 302
  19. Set-Cookie: SessionID=1C1616E83C1A34209AA5FA93BBB39CAE; Path=/; HttpOnly
  20. Location: /test03;SessionID=1C1616E83C1A34209AA5FA93BBB39CAE
  21. Content-Language: zh-CN
  22. Content-Length: 0
  23. Date: Wed, 12 Dec 2018 07:01:49 GMT
  24. HTTP/1.1 200
  25. Content-Type: text/plain;charset=ISO-8859-1
  26. Content-Length: 42
  27. Date: Wed, 12 Dec 2018 07:01:49 GMT
  28. {name3=value3, name2=value2, name1=value1}

注意,如果使用浏览器测试,是没有 ;SessionID 的,因为浏览器支持 Cookie。另外,如果你被重定向到 test03 页面后,刷新一下浏览器,会发现数据是空的,说明确实是 flash attribute。另外,通过这种方式传递过来的数据只能通过 Model、ModelMap、@ModelAttribute 来读取!

拦截器

Spring MVC 和 Struts2 一样,支持“拦截器”概念,拦截器的英文是:Interceptor。Interceptor 和 Filter 很相似,都可以用来定义 预处理后处理 操作,不同的是,Filter 的实现原理是 函数调用链,而 Interceptor 的实现原理是 JDK 动态代理,虽然实现原理不同,但是它们之间却有很多相似的地方,甚至我们可以说,拦截器就是 SpringMVC/Struts2 提供的“过滤器”在框架中的实现!Filter 和 Interceptor 都可以有多个,它们之间的执行顺序由 web.xml、mvc.xml 的出现顺序定义,并且先定义的 Filter/Interceptor 的预处理方法先执行,而后处理方法则与定义顺序相反,先定义的后执行,后定义的先执行。可以说,除了实现原理不同,其他的特征都是一样的。

在 Spring MVC 中,如果要定义拦截器,有两种常见方式:

我们先来看看 HandlerInterceptor 接口的三个方法定义:

  1. /* 预处理方法,在 Controller 方法调用前执行 */
  2. boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
  3. /* 后处理方法,在 Controller 方法返回后执行 */
  4. void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView)
  5. /* 最终处理方法,在 View 视图渲染完成后执行 */
  6. void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)

注意 preHandle 方法,它返回的是一个 boolean 值,其他方法没有返回值。这个 boolean 值的意义是这样的,如果返回 true,则继续调用下一个拦截器的 preHandle 方法,或者调用 Controller 的处理方法(如果是最后一个拦截器的话),如果返回 false,则表示当前请求就到此为止了,preHandle 方法会返回一个响应结果给请求客户端(一般是检测到异常或者权限不足或者是其他请求时,会这么做)。

来实现一个简单的日志记录拦截器,分别在 preHandle、postHandle、afterCompletion 位置记录日志:

  1. package com.zfl9.interceptor;
  2. import javax.servlet.http.HttpServletRequest;
  3. import javax.servlet.http.HttpServletResponse;
  4. import org.springframework.web.servlet.ModelAndView;
  5. import org.springframework.web.servlet.handler.HandlerInterceptorAdapter;
  6. public class LogInterceptor extends HandlerInterceptorAdapter {
  7. @Override
  8. public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
  9. System.out.println("[pre handle] handler: " + handler);
  10. return true;
  11. }
  12. @Override
  13. public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
  14. System.out.println("[post handle] handler: " + handler);
  15. }
  16. @Override
  17. public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
  18. System.out.println("[after completion] handler: " + handler);
  19. }
  20. }

这个 handler 对象其实是 org.springframework.web.method.HandlerMethod 的一个实例,打印出来的结果就是 Controller 方法的签名而已,一般情况下没什么很大的作用。接下来我们来看看如何配置拦截器。很显然,因为拦截器的执行顺序与定义顺序有关系,所以只能使用 mvc.xml 配置文件来配置(不过好像也可以使用 Java-Based 形式来配置),拦截器配置在 <mvc:interceptors> 元素中,如下:

  1. <mvc:interceptors>
  2. <bean class="com.zfl9.interceptor.LogInterceptor"/>
  3. </mvc:interceptors>

放在 interceptors 元素下的拦截器,会匹配所有请求。如果只想拦截指定路径下的请求,可以这么做:

  1. <mvc:interceptors>
  2. <!-- 拦截所有请求 -->
  3. <bean class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor" />
  4. <!-- 拦截 /secure/ 的请求(不包括子目录) -->
  5. <mvc:interceptor>
  6. <mvc:mapping path="/secure/*"/>
  7. <bean class="org.example.SecurityInterceptor"/>
  8. </mvc:interceptor>
  9. <!-- 拦截除 /admin/ 下的所有请求(包括子目录) -->
  10. <mvc:interceptor>
  11. <mvc:mapping path="/**"/>
  12. <mvc:exclude-mapping path="/admin/**"/>
  13. <bean class="org.springframework.web.servlet.theme.ThemeChangeInterceptor"/>
  14. </mvc:interceptor>
  15. <mvc:interceptors>

拦截器的执行顺序与他们在 xml 中定义的先后顺序相同,先定义的先执行,这一点和 Filter 是一样的。

输出结果如下:

  1. [pre handle] handler: public java.lang.String com.zfl9.controller.EmployeeController.index()
  2. [post handle] handler: public java.lang.String com.zfl9.controller.EmployeeController.index()
  3. [after completion] handler: public java.lang.String com.zfl9.controller.EmployeeController.index()
  4. [pre handle] handler: public java.lang.String com.zfl9.controller.EmployeeController.listEmployee(org.springframework.ui.Model)
  5. [post handle] handler: public java.lang.String com.zfl9.controller.EmployeeController.listEmployee(org.springframework.ui.Model)
  6. [after completion] handler: public java.lang.String com.zfl9.controller.EmployeeController.listEmployee(org.springframework.ui.Model)

数据校验

所谓数据校验就是对客户端提供的数据进行有效性校验,有两个作用,一是防止无效数据或非法数据存储到我们的系统中,二是避免攻击者利用非法数据攻击我们的系统,所以数据校验的重要性不言而喻。通常我们的 Web 应用会进行两重校验,首先是浏览器端的 JavaScript 校验,然后是后台系统(controller)的数据校验。你可能会问,服务端的校验是不是多余的呢?其实不是的,虽然 JavaScript 校验能够避免大部分无效数据传入后台系统,但是浏览器的 JS 是可以被禁用的,而且非法分子可能直接利用 curl 等客户端来绕开 JS 校验,所以服务端上的校验也是必不可少的。

Spring MVC 提供了一个简单实用的机制来帮助我们校验提交过来的数据,Spring MVC Framework 默认支持 JSR-303 规范,我们只需要在 Spring MVC 应用程序中添加 JSR-303 规范接口及其 JSR-303 实现类依赖项就行(JSR-303 只是定义了一些规范,提供对应的注解,但是并没有提供对应的实现,hibernate validation 提供了 JSR-303 的实现,并且还提供了一些额外的校验注解)。Spring MVC 还提供了 @Validator 注解和 BindingResult 类,通过 BindingResult,我们可以在请求处理方法中获取 Validator 实现引发的错误。

对于任何一个应用而言在客户端做的数据有效性验证都不是安全有效的,这时候就要求我们在开发的时候在服务端也对数据的有效性进行验证。Spring MVC 自身对数据在服务端的校验有一个比较好的支持,它能将我们提交到服务端的数据按照我们事先的约定进行数据有效性验证,对于不合格的数据信息 Spring MVC 会把它保存在错误对象中,这些错误信息我们也可以通过 Spring MVC 提供的标签在前端 JSP 页面上进行展示。

Spring MVC 提供两种数据校验方式,一种是基于 Validator 接口,另一种是使用 JSR-303 注解。Validator 接口需要我们自己去实现,而 JSR-303 注解是可以开箱即用的(添加对应依赖即可)。

基于 Validator 接口进行数据验证
Validator 接口是 Spring 提供的,方便我们定义验证类来对实体类进行数据验证。假设我们存在这样一个 User 类,我们需要对其中的 username 和 password 字段进行验证,避免非法数据进入我们的系统:

  1. package com.zfl9.model;
  2. public class User {
  3. private String username;
  4. private String password;
  5. public String getUsername() {
  6. return username;
  7. }
  8. public void setUsername(String username) {
  9. this.username = username;
  10. }
  11. public String getPassword() {
  12. return password;
  13. }
  14. public void setPassword(String password) {
  15. this.password = password;
  16. }
  17. }

那么当我们需要使用 Spring MVC 提供的 Validator 接口来对该实体类进行校验的时候该如何做呢?这个时候我们应该提供一个 Validator 实现类,实现 Validator 接口的 supports() 方法和 validate() 方法。supports() 方法用于判断当前的 Validator 实现类是否支持校验对应的实体类,只有当 supports() 方法的返回结果为 true 的时候,该 Validator 接口实现类的 validate() 方法才会被调用,来对当前需要校验的实体类进行校验。

首先创建一个 package,存储我们的 Validator 验证器,然后编写 User 类对应的 UserValidator 类:

  1. package com.zfl9.validator;
  2. import org.springframework.stereotype.Component;
  3. import org.springframework.validation.Errors;
  4. import org.springframework.validation.ValidationUtils;
  5. import org.springframework.validation.Validator;
  6. import com.zfl9.model.User;
  7. @Component
  8. public class UserValidator implements Validator {
  9. @Override
  10. public boolean supports(Class<?> aClass) {
  11. // 如果目标类为 User 类或其子类则返回 true
  12. return User.class.isAssignableFrom(aClass);
  13. }
  14. @Override
  15. public void validate(Object o, Errors errors) {
  16. // 验证 username 字段 (使用 ValidationUtils 实用类)
  17. ValidationUtils.rejectIfEmptyOrWhitespace(errors, "username", null, "username is empty");
  18. // 验证 password 字段 (手动进行校验,使用 errors 对象)
  19. User user = (User) o;
  20. if (user.getPassword() == null || user.getPassword().matches("^\\s*+$")) {
  21. errors.rejectValue("password", null, "password is empty");
  22. }
  23. }
  24. }

注意我在 validate 方法中使用了两种不同的方式来进行字段的验证,这样做的目的仅仅是为了举例子而已。

我们已经定义了一个对 User 类进行校验的 UserValidator 了,但是这个时候 UserValidator 还不能对 User 对象进行校验,因为我们还没有告诉 Spring 应该使用 UserValidator 来校验 User 对象。在 SpringMVC 中我们可以使用 DataBinder 来设定当前 Controller 需要使用的 Validator。对应的方法需要使用 @InitBinder 注解进行标注,如下:

  1. package com.zfl9.controller;
  2. import org.springframework.beans.factory.annotation.Autowired;
  3. import org.springframework.beans.factory.annotation.Qualifier;
  4. import org.springframework.stereotype.Controller;
  5. import org.springframework.ui.Model;
  6. import org.springframework.validation.BindingResult;
  7. import org.springframework.validation.DataBinder;
  8. import org.springframework.validation.Validator;
  9. import org.springframework.validation.annotation.Validated;
  10. import org.springframework.web.bind.annotation.GetMapping;
  11. import org.springframework.web.bind.annotation.InitBinder;
  12. import org.springframework.web.bind.annotation.ModelAttribute;
  13. import org.springframework.web.bind.annotation.PostMapping;
  14. import org.springframework.web.servlet.mvc.support.RedirectAttributes;
  15. import com.zfl9.model.User;
  16. @Controller
  17. public class UserController {
  18. @Autowired
  19. @Qualifier("userValidator")
  20. private Validator userValidator;
  21. @InitBinder
  22. public void initBinder(DataBinder databinder) {
  23. databinder.setValidator(userValidator);
  24. }
  25. @GetMapping("/login")
  26. public String loginForm(Model model) {
  27. if (!model.containsAttribute("user")) {
  28. model.addAttribute("user", new User());
  29. }
  30. return "login-form";
  31. }
  32. @PostMapping("/login")
  33. public String loginProc(@Validated @ModelAttribute User user, BindingResult result, RedirectAttributes redirectAttributes) {
  34. if (result.hasErrors()) {
  35. redirectAttributes.addFlashAttribute("user", user);
  36. redirectAttributes.addFlashAttribute("org.springframework.validation.BindingResult.user", result);
  37. return "redirect:/login";
  38. }
  39. return "login-success";
  40. }
  41. }

@Validated 注解的对象会被 Spring MVC 执行数据校验,@Validated 注解和 BindingResult 是成对出现的,如果有多个对象需要被校验,请成对放在 Controller 方法的参数列表中。BindingResult 是对应对象的校验结果,我们可以通过它的 hasErrors() 方法来判断是否校验成功,如果出现校验不正确的情况,则返回 true,因为我们是使用 redirect 来重定向到 login 登录表单,所以需要使用 RedirectAttribtues 的 flashAttribute 来添加易失属性,然后 login 表单才会正确显示 model 对象和 error 对象(使用 spring 的 form 标签库),如果不是 redirect,那么是不需要添加什么 flashAttribute 的,直接 return "login-failure" 就行了。注意错误对象的 name,最后一个字符串 user 是对应的 model 对象的名称(BindingResult 是 Errors 的子类,所以可以使用 result 对象替代 errors 对象)。

注意,你可能会从别的教程中看到,使用 @Valid 注解替代 @Validated 注解的情况,不要惊讶,@Valid 注解是 JSR-303 中定义的,而 @Validated 注解是 Spring 定义的,后者对前者进行了扩展,后者支持分组校验的特性,而前者不支持,它们基本上是可以互换的。之所以我没有使用 @Valid 注解,是因为我没有添加 JSR-303 的依赖项,所以就使用 @validated 注解了。

我们知道在 Controller类中通过 @InitBinder 标记的方法只有在请求当前 Controller 的时候才会被执行,所以其中定义的 Validator 也只能在当前 Controller 中使用,如果我们希望一个 Validator 对所有的 Controller 都起作用的话,我们可以在 SpringMVC 的配置文件中通过 mvc:annotation-driven 的 validator 属性指定全局的 Validator。代码如下所示:

  1. <mvc:annotation-driven validator="userValidator"/>
  2. <bean id="userValidator" class="com.xxx.xxx.UserValidator"/>

那么我们该如何在 JSP 页面中展示验证错误的信息呢?很简单,Spring 提供了一个 form 标签库,里面有一个 errors 标签,该标签会读取我们上面指定的 errors/result 对象,该标签有一个 path 属性,属性值如果为 * 则用来显示所有的错误信息,如果是对应的字段名,则显示对应的字段的错误信息。

login-form.jsp

  1. <%@ page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %>
  2. <%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>
  3. <%@ taglib prefix="core" uri="http://java.sun.com/jsp/jstl/core" %>
  4. <core:set var="ctx" value="${pageContext.request.contextPath}"/>
  5. <!DOCTYPE html>
  6. <html>
  7. <head>
  8. <meta charset="UTF-8">
  9. <title>login-form</title>
  10. </head>
  11. <body>
  12. <div align="center">
  13. <form:form action="${ctx}/login" methpd="post" modelAttribute="user">
  14. <table>
  15. <tr>
  16. <td>Username:</td>
  17. <td><form:input path="username"/></td>
  18. <td><form:errors path="username" cssStyle="color:red"/></td>
  19. </tr>
  20. <tr>
  21. <td>Password:</td>
  22. <td><form:password path="password"/></td>
  23. <td><form:errors path="password" cssStyle="color:red"/></td>
  24. </tr>
  25. </table>
  26. <input type="submit" value="Login">
  27. </form:form>
  28. </div>
  29. </body>
  30. </html>

login-success.jsp

  1. <%@ page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %>
  2. <%@ taglib prefix="core" uri="http://java.sun.com/jsp/jstl/core" %>
  3. <core:set var="ctx" value="${pageContext.request.contextPath}"/>
  4. <!DOCTYPE html>
  5. <html>
  6. <head>
  7. <meta charset="UTF-8">
  8. <title>login-success</title>
  9. </head>
  10. <body>
  11. <div align="center">
  12. <h1>Welcome: ${user.username}</h1>
  13. <table>
  14. <tr>
  15. <td>Username: </td>
  16. <td>${user.username}</td>
  17. </tr>
  18. <tr>
  19. <td>Password: </td>
  20. <td>${user.password}</td>
  21. </tr>
  22. </table>
  23. </div>
  24. </body>
  25. </html>

基于 JSR-303 Validation 的数据验证
JSR-303 是一个数据验证的规范,JSR-303 只是一个规范,而 Spring 也没有对这一规范进行实现,那么当我们在 SpringMVC 中需要使用到 JSR-303 的时候就需要我们提供一个对 JSR-303 规范的实现,Hibernate Validator 是实现了这一规范的,这里将它作为 JSR-303 的实现来讲解 SpringMVC 对 JSR-303 的支持。

  1. <dependency>
  2. <groupId>javax.validation</groupId>
  3. <artifactId>validation-api</artifactId>
  4. <version>${validatorapi.version}</version>
  5. </dependency>
  6. <dependency>
  7. <groupId>org.hibernate.validator</groupId>
  8. <artifactId>hibernate-validator</artifactId>
  9. <version>${validatorimpl.version}</version>
  10. </dependency>

JSR-303 的校验是基于注解的,它内部已经定义好了一系列的验证注解,我们只需要把这些注解标记在需要验证的实体类的属性上或是其对应的 getter 方法上。看下需要验证的实体类 User 的代码(一般用在属性上):

  1. package com.zfl9.model;
  2. import javax.validation.constraints.NotBlank;
  3. public class User {
  4. @NotBlank(message = "username is empty")
  5. private String username;
  6. @NotBlank(message = "password is empty")
  7. private String password;
  8. public String getUsername() {
  9. return username;
  10. }
  11. public void setUsername(String username) {
  12. this.username = username;
  13. }
  14. public String getPassword() {
  15. return password;
  16. }
  17. public void setPassword(String password) {
  18. this.password = password;
  19. }
  20. }

其中 message 是错误提示,然后去掉 UserController.java 里面的 @InitBinder 方法,结果是一样的:

  1. package com.zfl9.controller;
  2. import org.springframework.stereotype.Controller;
  3. import org.springframework.ui.Model;
  4. import org.springframework.validation.BindingResult;
  5. import org.springframework.validation.annotation.Validated;
  6. import org.springframework.web.bind.annotation.GetMapping;
  7. import org.springframework.web.bind.annotation.ModelAttribute;
  8. import org.springframework.web.bind.annotation.PostMapping;
  9. import org.springframework.web.servlet.mvc.support.RedirectAttributes;
  10. import com.zfl9.model.User;
  11. @Controller
  12. public class UserController {
  13. @GetMapping("/login")
  14. public String loginForm(Model model) {
  15. if (!model.containsAttribute("user")) {
  16. model.addAttribute("user", new User());
  17. }
  18. return "login-form";
  19. }
  20. @PostMapping("/login")
  21. public String loginProc(@Validated @ModelAttribute User user, BindingResult result, RedirectAttributes redirectAttributes) {
  22. if (result.hasErrors()) {
  23. redirectAttributes.addFlashAttribute("user", user);
  24. redirectAttributes.addFlashAttribute("org.springframework.validation.BindingResult.user", result);
  25. return "redirect:/login";
  26. }
  27. return "login-success";
  28. }
  29. }

常用注解有这些:

自定义数据验证的注解
除了 JSR-303 原生支持的验证注解外,我们也可以定义自己的验证注解(并且用法完全一致)。定义自己的验证注解有两个步骤,第一步是定义一个注解,第二步是定义一个 ConstraintValidator 的实现类。注解和注解处理类,它们是一对的,单单定义一个注解是不行的,因为注解仅仅是存放了元数据,我们必须定义一个注解处理程序,而数据验证注解的处理程序就是一个实现了 javax.validation.ConstraintValidator 接口的类。

定义一个数据验证注解,@Username,规定 username 的正确格式:

  1. package com.zfl9.constraint;
  2. import java.lang.annotation.ElementType;
  3. import java.lang.annotation.Retention;
  4. import java.lang.annotation.RetentionPolicy;
  5. import java.lang.annotation.Target;
  6. import javax.validation.Constraint;
  7. import javax.validation.Payload;
  8. @Retention(RetentionPolicy.RUNTIME)
  9. @Target({ElementType.METHOD, ElementType.FIELD})
  10. @Constraint(validatedBy = UsernameValidator.class)
  11. public @interface Username {
  12. String message() default "invalid username";
  13. Class<?>[] groups() default {};
  14. Class<? extends Payload>[] payload() default {};
  15. }

定义一个数据验证注解,@Password,规定 password 的正确格式:

  1. package com.zfl9.constraint;
  2. import java.lang.annotation.ElementType;
  3. import java.lang.annotation.Retention;
  4. import java.lang.annotation.RetentionPolicy;
  5. import java.lang.annotation.Target;
  6. import javax.validation.Constraint;
  7. import javax.validation.Payload;
  8. @Retention(RetentionPolicy.RUNTIME)
  9. @Target({ElementType.METHOD, ElementType.FIELD})
  10. @Constraint(validatedBy = PasswordValidator.class)
  11. public @interface Password {
  12. String message() default "invalid password";
  13. Class<?>[] groups() default {};
  14. Class<? extends Payload>[] payload() default {};
  15. }

注意 @Constraint(validatedBy = UsernameValidator.class) 元注解,它用来指定处理当前验证注解的实现类,然后就是 message 属性,我们为它设置一个默认的错误提示信息,其它两个属性我们可以暂时不管。注意,无论何时,Constraint 注解的元素必须有上面三个,即 message、groups、payload。除此之外我们还可以定义其他属性,比如 value、min、max、pattern 等等。如果我们在属性上设置了默认值,而又想在实现类上引用它,直接在 initialize 方法中使用 annotationObj.value() 方法获取就行(其他的同理)。

UsernameValidator.java

  1. package com.zfl9.constraint;
  2. import javax.validation.ConstraintValidator;
  3. import javax.validation.ConstraintValidatorContext;
  4. public class UsernameValidator implements ConstraintValidator<Username, String> {
  5. @Override
  6. public void initialize(Username constraintAnnotation) {
  7. }
  8. @Override
  9. public boolean isValid(String value, ConstraintValidatorContext constraintValidatorContext) {
  10. return value != null && value.matches("^\\w++$");
  11. }
  12. }

PasswordValidator.java

  1. package com.zfl9.constraint;
  2. import javax.validation.ConstraintValidator;
  3. import javax.validation.ConstraintValidatorContext;
  4. public class PasswordValidator implements ConstraintValidator<Password, String> {
  5. @Override
  6. public void initialize(Password constraintAnnotation) {
  7. }
  8. @Override
  9. public boolean isValid(String value, ConstraintValidatorContext constraintValidatorContext) {
  10. return value != null && value.matches("^[0-9a-zA-Z._-]++$");
  11. }
  12. }

Controller 和 View 都不用动,我们重载一下应用程序,测试 username 和 password 的验证是否正常。

Spring 的 @Validated 注解的分组验证
所谓分组验证就是,有些时候,我们需要对同一个实体类进行多种验证,比如 id 字段,创建时是不需要验证的,默认为 null,而更新时则是需要验证的,不能为 null。那么我们该怎么办呢?别慌,我们前面说了,JSR 自带的 @Valid 不支持分组验证功能,但是 Spring 提供的 @Validated 注解扩展了 JSR 的注解,支持分组验证功能。所以一般情况下,我们使用 @Validated 注解会比使用 @Valid 注解更好一些。

分组验证听起来很复杂,其实不然,很简单,只是定义两个接口而已,它们都是空接口(标记接口),我们会利用它们的 Class 对象来进行分组,一般情况下,我们会把这些注解放到实体类内部,即作为静态内部接口。

Student.java

  1. package com.zfl9.model;
  2. import javax.validation.constraints.Email;
  3. import javax.validation.constraints.Min;
  4. import javax.validation.constraints.NotNull;
  5. import javax.validation.constraints.Pattern;
  6. public class Student {
  7. public interface Create {}
  8. public interface Update {}
  9. @NotNull(message = "invalid id", groups = Update.class)
  10. @Min(value = 1, message = "invalid id", groups = Update.class)
  11. private Integer id;
  12. @NotNull(message = "invalid name", groups = {Create.class, Update.class})
  13. @Pattern(regexp = "^\\w++$", message = "invalid name", groups = {Create.class, Update.class})
  14. private String name;
  15. @NotNull(message = "invalid email", groups = {Create.class, Update.class})
  16. @Email(message = "invalid email", groups = {Create.class, Update.class})
  17. private String email;
  18. public Integer getId() {
  19. return id;
  20. }
  21. public void setId(Integer id) {
  22. this.id = id;
  23. }
  24. public String getName() {
  25. return name;
  26. }
  27. public void setName(String name) {
  28. this.name = name;
  29. }
  30. public String getEmail() {
  31. return email;
  32. }
  33. public void setEmail(String email) {
  34. this.email = email;
  35. }
  36. }

StudentController.java

  1. package com.zfl9.controller;
  2. import org.springframework.validation.BindingResult;
  3. import org.springframework.validation.annotation.Validated;
  4. import org.springframework.web.bind.annotation.PostMapping;
  5. import org.springframework.web.bind.annotation.PutMapping;
  6. import org.springframework.web.bind.annotation.RequestBody;
  7. import org.springframework.web.bind.annotation.RestController;
  8. import com.zfl9.model.Student;
  9. @RestController
  10. public class StudentController {
  11. @PostMapping("/students")
  12. public String create(@Validated(Student.Create.class) @RequestBody Student student, BindingResult result) {
  13. if (result.hasErrors()) return "failure";
  14. return "success";
  15. }
  16. @PutMapping("/students")
  17. public String update(@Validated(Student.Update.class) @RequestBody Student student, BindingResult result) {
  18. if (result.hasErrors()) return "failure";
  19. return "success";
  20. }
  21. }

测试结果

  1. # Otokaze @ Otokaze-Win10 in ~ [19:58:55]
  2. $ curl localhost/students -X POST -H 'Content-Type: application/json' -d '{ "id": 0, "name": "Otokaze", "email": "root@zfl9.com" }'
  3. success
  4. # Otokaze @ Otokaze-Win10 in ~ [20:00:04]
  5. $ curl localhost/students -X PUT -H 'Content-Type: application/json' -d '{ "id": 0, "name": "Otokaze", "email": "root@zfl9.com" }'
  6. failure
  7. # Otokaze @ Otokaze-Win10 in ~ [20:00:09]
  8. $ curl localhost/students -X PUT -H 'Content-Type: application/json' -d '{ "id": 11, "name": "Otokaze", "email": "root@zfl9.com" }'
  9. success

相关注解复习

web 应用的三层结构

被这些注解标注的类会被 Spring 的 IoC 容器实例化,放到 bean 容器中进行管理。我们可以使用 @Autowired@Resource 注解来自动装配这些 bean。目的是为了“控制反转”,降低类与类之间的依赖度。

JSP 页面中的绝对 url

  1. <%@ page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %>
  2. <%@ taglib prefix="core" uri="http://java.sun.com/jsp/jstl/core" %>
  3. <core:set var="ctx" value="${pageContext.request.contextPath}"/>
  4. <!DOCTYPE html>
  5. <html>
  6. <head>
  7. <meta charset="UTF-8">
  8. <title>test</title>
  9. </head>
  10. <body>
  11. <div align="center">
  12. <h3><a href="${ctx}/">ctx</a></h3>
  13. <h3><a href="${ctx}/test">test</a></h3>
  14. <h3><a href="${ctx}/dir/test">dir/test</a></h3>
  15. <h3><a href="${ctx}/dir/dir/test">dir/dir/test</a></h3>
  16. </div>
  17. </body>
  18. </html>

建议将开头三行代码放入 jsp 的文件模版中,这样就不用每次编写 jsp 文件都重复编写这些内容了。

Model、ModelMap、ModelAndView
虽然它们都叫做 Model*,但其实我们可以认为它们都是 request 对象的封装类,ModelAndView 是最原始的传值方式(这里说的传值就是传统意义上的 request.setAttribute()),基本上现在已经可以不用 ModelAndView 对象了。通常,我们都是使用 Model 或者 ModelMap 对象,这三个对象都可以用来向 view 页面传递 request 属性(注意,Model* 对象不同于 HttpServletRequest 对象!!!)。

Model 是一个接口,定义了一些 addAttribute() 方法,而 ModelMap 则是 LinkedHashMap 的子类,ModelMap 暴露的方法和 Model 是一样的,基本上没区别,可以根据自己的喜好,使用任意一个对象来进行 request 传值,我个人的话,比较喜欢使用 Model 对象。

注意,虽然 ModelAndView 是最原始的传值方式,但是在 Spring MVC 实现层面,Model 和 ModelMap 依旧会被封装成 ModelAndView 对象来进行处理,我们可以认为 Model/ModelMap 是 ModelAndView 的封装。

@RequestMapping、@GetMapping、@PostMapping、@PutMapping、@PatchMapping、@DeleteMapping
这些注解都是用来将 Controller 方法映射到指定 url 的,最开始只有 @RequestMapping,不过后来为了方便开发 RESTful 风格的服务,Spring 又提供了 @RequestMapping 的 GET、POST、PUT、PATCH、DELETE 方法的特定注解,这些注解除了没有 method 属性,其他的特征与 @RequestMapping 注解是完全一样的(当然还有一点区别就是,@RequestMapping 可以用在 Controller 类上,而 @GetMapping、@PostMapping、@PutMapping、@PatchMapping、@DeleteMapping 这些只能用来标注 Controller 方法)。

@RequestMapping 如果用在 Controller 类上,则该 Controller 中的所有方法映射到的 uri 都是以类上的 uri 为上下文的(即父路径),这在做 RESTful API 服务的时候很有用。如果不指定 value/path 属性,则默认为 "" 空字符串。比如 Controller 上使用 @RequestMapping("/employees") 标注,而 Get 方法上使用 @GetMapping 标注,则表示该 Get 方法的 url 为 /employees,没有 / 分隔符哦。

有必要强调一下,@RequestMapping 可以用在 Controller 类上,此时表示,该 Controller 类中的所有处理方法都将继承该 @RequestMapping 上的属性值(所有属性都是这样,方法上的注解会继承这些属性值)。

@RequestMapping 的 6 个属性:

请求路径、请求方法

请求参数、请求头部

提交的 MIME 类型、期望的 MIME 类型:

注意 produces 属性,该属性还有一个副作用,那就是它会将匹配到的 MIME 类型写入到 response 头中,组合起来,该属性的作用就是:只会响应与 request 的 Accept 头部相匹配的 MIME 请求,并且还会修改 response 中的 Content-Type 头部,将其设为当前生效的 Content-Type。什么意思呢?举个栗子:

  1. @ResponseBody
  2. @GetMapping(path = "/test", produces = {"text/html; charset=UTF-8", "application/json; charset=UTF-8"})
  3. public String test() {
  4. return "hello, world\n世界,你好\n";
  5. }
  1. PS C:\Windows\system32> curl.exe localhost/test -H 'Accept: text/*' -i
  2. HTTP/1.1 200
  3. Content-Type: text/html;charset=UTF-8
  4. Content-Length: 29
  5. Date: Fri, 14 Dec 2018 11:40:15 GMT
  6. hello, world
  7. 世界,你好
  8. PS C:\Windows\system32> curl.exe localhost/test -H 'Accept: application/*' -i
  9. HTTP/1.1 200
  10. Content-Type: application/json;charset=UTF-8
  11. Content-Length: 29
  12. Date: Fri, 14 Dec 2018 11:40:18 GMT
  13. hello, world
  14. 世界,你好

如果不指定 charset=UTF-8 编码,那么默认会变为 Latin-1 编码,虽然我们设置了 CharsetFilter!

@RequestParam、@RequestBody、@RequestPart,解析请求数据

@RequestParam 注解的参数应该为基本类型、基本类型的包装类、String、Date 等简单类型,或者叫原语。而 @RequestPart 注解的参数应该为一个 bean/pojo 对象,spring 会自动根据 bean/pojo 对象的 setter 方法和 json 的同名字段来进行 json 到 object 之间的转换(object 到 json 的转换原理也是类似的)。

虽然 @RequestParam 也支持 multipart/form-data 请求,但尽量使用 @RequestPart 来替代,符合语意。对于 @RequestParam 注解,如果对应的方法参数为 Map 类型,则所有的请求参数都会存入到这个 Map 中。@RequestPart 和 @RequestParam 如果是用来处理 multipart 请求,则参数类型一般为 MultipartFile。

@PathVariable、@RequestHeader、@CookieValue,解析请求元数据

@ModelAttribute、@RequestAttribute、@SessionAttribute、@SessionAttributes

@RequestAttribute 和 @SessionAttribute 很好理解,就是字面意思,将 request 和 session 作用域中的指定 attribute 绑定到被注解的方法参数中,如果没有找到对应的则会报错,当然可以将它们的 required 属性设为 false 来避免这种情况。

@SessionAttributes 注解是用在 Controller 类上,用来同步 Model、ModelMap、ModelAndView 中设置的 model 属性,同步到 session 作用域,所以我们可以在 jsp 页面中,通过 request 和 session 都能访问这些 attribute 对象。

@ModelAttribute 的工作原理是这样的,首先它会对参数对象执行 new 操作,创建一个对象出来,然后查找 request params(@RequestParam)中的与 setter 方法同名的 param,然后将其注入到 setter 方法,最后,@ModelAttribute 注解还会将这个 bean/pojo 保存到 Model* 中,而 Spring MVC 会自动将 Model* 中的数据同步到 httpServletRequest 对象中,所以可以在 jsp 中通过 request 作用域访问这些对象。

@ModelAttribute 用在方法上时(实际是用在方法返回值上),这个方法会在所有 @RequestMapping 方法之前执行(包括 Get/Post/Put/Patch/Delete 子注解),并且这个方法可以有 @RequestMapping 中的所有参数类型(Spring 会自动注入),作用是将方法返回值存入到 Model* 作用域中,因为会在所有请求处理方法之前执行,所以在这里处理一些所有方法共享的 Model 对象是一个最佳实践。

@ModelAttribute、@RequestBody 注解的 bean/pojo 类,里面如果有 short/int/long 等基本类型,请改为对应的 Short/Integer/Long 包装类,否则,如果 request params 中的 param 的 value 为空字符串,那么 Spring MVC 会报告转换错误,因为空字符串无法转换为 short/int/long 等类型,而将它们改为对应的包装类后,传递空字符串的 value 和不传递这个 param 的效果是一样的,即对应的字段会被设为 null 值。但是要注意,如果字段类型为 String,那么传递空字符串就是空字符串,不传递的时候才会被设为 null 值。

异常处理

不管是在 dao 层、service 层、controller 层,都有可能抛出异常,默认情况下,Spring MVC 会给客户端返回一个 500 响应,并且附带一个错误页面(通常是异常对象的堆栈跟踪信息),在开发环境中,这种默认处理方式或许还能够接受,因为堆栈跟踪信息中通常有很多有用的信息,帮助我们排错。但是在实际生产环境中,如果用户收到这样一个丑陋难懂的错误页,大概都会觉得系统很 low,而且这些堆栈跟踪信息还可能被攻击者研究,然后入侵我们的系统。

所以我们很有必要学习一下 Spring MVC 中的异常处理机制,Spring 提供三种异常处理方式,分别是:

虽然有 3 大方法可以用来处理异常,不过第二种方法貌似有点过时了,所以我们一般情况下,只要合理利用 @ResponseStatus + 自定义异常类@ExceptionHandler + @ControllerAdvice 两种方式就行了?你可能会想了,这两种方式有没有冲突呢?比如一个异常已经被 @ResponseStatus 标注了,我们在 Controller 方法中抛出了这个异常,那么它究竟会被转换为对应的 status + reason 还是被 @ExceptionHandler 异常处理方法给处理呢?经过测试,如果定义了 @ExceptionHandler 异常处理方法,并且与指定异常相匹配,那么会被该异常处理方法给处理,而不会转换为对应的响应状态码。所以推荐用 @ControllerAdvice 和 @ExceptionHandler 方式来统一处理系统抛出的所有异常。

不过,虽然建议使用最后一种方式来统一处理异常,但是前两种异常处理方法我们还是要接触一下的。

@ResponseStatus + 自定义异常

  1. @ResponseStatus(code = HttpStatus.NOT_FOUND, reason = "Resource Not Found")
  2. public static class ResourceNotFoundException extends RuntimeException {
  3. }
  4. @GetMapping("/test")
  5. public String test() {
  6. throw new ResourceNotFoundException();
  7. }

当我们访问 /test 时,将会得到 404 响应,错误提示 message 为 Resource Not Found,很简单。

SimpleMappingExceptionResolver 简单异常处理器
前面说了,只要在 bean 容器中注册了 HandlerExceptionResolver 接口的实现类的实例,那么 Spring MVC 就会将这个异常处理器作为全局异常处理器,现在我们来配置一下 SimpleMappingExceptionResolver:

  1. <bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
  2. <property name="defaultErrorView" value="error-system"/>
  3. <property name="exceptionMappings">
  4. <props>
  5. <prop key="com.zfl9.exception.ClientException">error-client</prop>
  6. <prop key="com.zfl9.exception.ServerException">error-server</prop>
  7. </props>
  8. </property>
  9. </bean>

defaultErrorView 是默认错误页面,这里我设为了 error-system(会结合 view 的 prefix 和 suffix)
exceptionMappings 里面可以设置多个自定义的异常错误页面,对应异常将会被 forward 到指定的错误页面

ExceptionController.java

  1. package com.zfl9.controller;
  2. import javax.servlet.http.HttpServletRequest;
  3. import org.springframework.stereotype.Controller;
  4. import org.springframework.web.bind.annotation.GetMapping;
  5. import org.springframework.web.bind.annotation.RequestMapping;
  6. import com.zfl9.exception.ClientException;
  7. import com.zfl9.exception.ServerException;
  8. @Controller
  9. @RequestMapping("/exception")
  10. public class ExceptionController {
  11. @GetMapping("/system")
  12. public String systemException(HttpServletRequest request) {
  13. request.setAttribute("url", request.getRequestURI());
  14. throw new RuntimeException("system exception");
  15. }
  16. @GetMapping("/client")
  17. public String clientException(HttpServletRequest request) {
  18. request.setAttribute("url", request.getRequestURI());
  19. throw new ClientException("client exception");
  20. }
  21. @GetMapping("/server")
  22. public String ServerException(HttpServletRequest request) {
  23. request.setAttribute("url", request.getRequestURI());
  24. throw new ServerException("server exception");
  25. }
  26. }

error-system.jsp 错误页,其他的两个差不多,没什么新意:

  1. <%@ page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %>
  2. <%@ taglib prefix="core" uri="http://java.sun.com/jsp/jstl/core" %>
  3. <core:set var="ctx" value="${pageContext.request.contextPath}"/>
  4. <!DOCTYPE html>
  5. <html>
  6. <head>
  7. <meta charset="UTF-8">
  8. <title>System Exception</title>
  9. </head>
  10. <body>
  11. <h3>URL: ${url}</h3>
  12. <h3>Exception: ${exception.message}</h3>
  13. <pre>
  14. <core:forEach items="${exception.stackTrace}" var="ste">${ste}
  15. </core:forEach>
  16. </pre>
  17. </body>
  18. </html>

自定义异常处理器,太无聊,就照搬别人的吧

  1. @Component
  2. public class CustomExceptionResolver implements HandlerExceptionResolver {
  3. @Override
  4. public ModelAndView resolveException(
  5. HttpServletRequest request,
  6. HttpServletResponse response,
  7. Object handler, Exception ex)
  8. {
  9. ex.printStackTrace();
  10. CustomException customException = null;
  11. if(ex instanceof CustomException) {
  12. customException = (CustomException) ex;
  13. } else {
  14. customException = new CustomException("系统未知错误");
  15. }
  16. ModelAndView modelAndView = new ModelAndView();
  17. modelAndView.addObject("message", customException.getMessage());
  18. modelAndView.setViewName("error");
  19. return modelAndView;
  20. }
  21. }

使用 @ExceptionHandler 异常处理方法

  1. @Controller
  2. public class ExceptionHandlingController {
  3. // Convert a predefined exception to an HTTP Status code
  4. @ResponseStatus(value=HttpStatus.CONFLICT, reason="Data integrity violation")
  5. @ExceptionHandler(DataIntegrityViolationException.class)
  6. public void conflict() {}
  7. // Specify the name of a specific view that will be used to display the error:
  8. @ExceptionHandler({SQLException.class,DataAccessException.class})
  9. public String databaseError() {
  10. return "databaseError";
  11. }
  12. // Total control - setup a model and return the view name yourself. Or consider
  13. // subclassing ExceptionHandlerExceptionResolver (see below).
  14. @ExceptionHandler(Exception.class)
  15. public ModelAndView handleError(HttpServletRequest req, Exception exception) {
  16. logger.error("Request: " + req.getRequestURL() + " raised " + exception);
  17. ModelAndView mav = new ModelAndView();
  18. mav.addObject("exception", exception);
  19. mav.addObject("url", req.getRequestURL());
  20. mav.setViewName("error");
  21. return mav;
  22. }
  23. }

如果要处理全部异常,可以将这些异常处理方法放到 @ControllerAdvice 注解的类中:

  1. @ControllerAdvice
  2. class GlobalDefaultExceptionHandler {
  3. public static final String DEFAULT_ERROR_VIEW = "error";
  4. @ExceptionHandler(value = Exception.class)
  5. public ModelAndView defaultErrorHandler(HttpServletRequest req, Exception e) throws Exception {
  6. // 如果异常类被 @ResponseStatus 注解,则直接抛出这个异常,不用管
  7. if (AnnotationUtils.findAnnotation(e.getClass(), ResponseStatus.class) != null)
  8. throw e;
  9. // Otherwise setup and send the user to a default error-view.
  10. ModelAndView mav = new ModelAndView();
  11. mav.addObject("exception", e);
  12. mav.addObject("url", req.getRequestURL());
  13. mav.setViewName(DEFAULT_ERROR_VIEW);
  14. return mav;
  15. }
  16. }

Spring 在异常处理方面提供了一如既往的强大特性和支持,那么在应用开发中我们应该如何使用这些方法呢?以下提供一些经验性的准则:

国际化/本地化

国际化又叫做 I18N,本地化又叫做 L10N,所谓 18 和 10 都是对应的英文单词的长度而已。Spring MVC 对国际化提供了很好的支持,通过几个简单的配置就能直接使用。Spring MVC 中有 3 种实现国际化的方式:

Spring MVC 的国际化是建立在 Java 的国际化的基础上的,我们来回顾一下 Java 国际化的配置步骤:

首先定义 properties 资源文件
messages_en.properties

  1. message.name = Name
  2. message.email = Email
  3. message.address = Address
  4. message.telephone = Telephone
  5. message.showMessage = name: {0} \t age: {1} \t sex: {2}

messages_zh.properties

  1. message.name = 名字
  2. message.email = 电子邮件
  3. message.address = 家庭住址
  4. message.telephone = 手机号码
  5. message.showMessage = 名字:{0},\t 年龄:{1},\t 性别:{2}

然后配置 mvc.xml,添加资源束:

  1. <bean id="messageSource" class="org.springframework.context.support.ResourceBundleMessageSource">
  2. <property name="basename" value="message"/>
  3. <property name="defaultEncoding" value="UTF-8"/>
  4. <property name="useCodeAsDefaultMessage" value="true"/>
  5. </bean>

因为默认 Locale 实现方式为 Accept-Language 头部,所以不需要其他额外的设置了,直接编写 jsp:

  1. <%@ page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %>
  2. <%@ taglib prefix="spring" uri="http://www.springframework.org/tags" %>
  3. <%@ taglib prefix="core" uri="http://java.sun.com/jsp/jstl/core" %>
  4. <core:set var="ctx" value="${pageContext.request.contextPath}"/>
  5. <!DOCTYPE html>
  6. <html>
  7. <head>
  8. <meta charset="UTF-8">
  9. <title>i18n-test</title>
  10. </head>
  11. <body>
  12. <pre>
  13. <spring:message code="message.name"/>: Otokaze
  14. <spring:message code="message.email"/>: root@zfl9.com
  15. <spring:message code="message.address"/>: unknown area
  16. <spring:message code="message.telephone"/>: 1234567890
  17. <spring:message code="message.showMessage" arguments="Otokaze,20,男性"/>
  18. </pre>
  19. </body>
  20. </html>

使用 spring 提供的 message 标签,code 就是 key,arguments 为参数,默认分隔符为 , 即英文分号。

cookie 实现方式
配置 mvc.xml,具体如下:

  1. <bean id="messageSource" class="org.springframework.context.support.ResourceBundleMessageSource">
  2. <property name="basename" value="message"/>
  3. <property name="defaultEncoding" value="UTF-8"/>
  4. <property name="useCodeAsDefaultMessage" value="true"/>
  5. </bean>
  6. <bean id="localeResolver" class="org.springframework.web.servlet.i18n.CookieLocaleResolver">
  7. <property name="defaultLocale" value="en"/>
  8. <property name="cookieName" value="language"/>
  9. <property name="cookieMaxAge" value="2592000"/>
  10. </bean>
  11. <mvc:interceptors>
  12. <bean class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor">
  13. <property name="paramName" value="language"/>
  14. </bean>
  15. </mvc:interceptors>

cookie 和 session 形式需要配置 localeChangeInterceptor 拦截器,该拦截器可以实现通过 queryString 参数改变 locale 设置,默认参数名为 locale,这里我们将它改为了 language。

第一次访问时因为没有设置 language 这个 cookie,所以使用默认的 locale,即 en,当我们传递 ?language=zh 后,发现 locale 已经转换为了 zh,然后去掉这个参数,刷新页面依旧是 zh 简体中文,然后传递 ?language=en 可以将其转换为 en 英文,刷新后依旧是英文,使用调试工具可以看到 Spring MVC 设置了一个名为 language 的 cookie,value 就是 zh 或 en,这也是为什么可以记忆 locale 的原因了。

session 实现方式

  1. <bean id="messageSource" class="org.springframework.context.support.ResourceBundleMessageSource">
  2. <property name="basename" value="message"/>
  3. <property name="defaultEncoding" value="UTF-8"/>
  4. <property name="useCodeAsDefaultMessage" value="true"/>
  5. </bean>
  6. <bean id="localeResolver" class="org.springframework.web.servlet.i18n.SessionLocaleResolver">
  7. <property name="defaultLocale" value="en"/>
  8. <property name="localeAttributeName" value="language"/>
  9. </bean>
  10. <mvc:interceptors>
  11. <bean class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor">
  12. <property name="paramName" value="language"/>
  13. </bean>
  14. </mvc:interceptors>

总体上和 cookie 实现方式没多大区别,只不过是将 language 属性放到了服务器上,而不是 cookie 上。

Cookie/Session

读取 Cookie
读取 Cookie 很简单,使用 @CookieValue 注解来标注我们的 Controller 方法参数就可以了,Spring 会自动将对应的 Cookie 值绑定到参数上,@CookieValue 注解支持的属性有这么几个:

可以看到,@CookieValue 注解的属性和 @RequestParam 注解的属性时完全一模一样的。测试:

  1. package com.zfl9.controller;
  2. import org.springframework.web.bind.annotation.CookieValue;
  3. import org.springframework.web.bind.annotation.GetMapping;
  4. import org.springframework.web.bind.annotation.RestController;
  5. @RestController
  6. public class TestController {
  7. @GetMapping("/cookie/test")
  8. public String cookieTest(@CookieValue(defaultValue = "Otokaze") String name, @CookieValue(defaultValue = "root@zfl9.com") String email) {
  9. return String.format("name: %s, email: %s\n", name, email);
  10. }
  11. }
  1. # Otokaze @ Otokaze-Win10 in ~ [19:31:24]
  2. $ curl localhost/cookie/test --cookie 'name=Otokaze; email=zfl9.com@gmail.com'
  3. name: Otokaze, email: zfl9.com@gmail.com
  4. # Otokaze @ Otokaze-Win10 in ~ [19:31:31]
  5. $ curl localhost/cookie/test
  6. name: Otokaze, email: root@zfl9.com

设置 Cookie
Spring MVC 没有提供什么神奇的设置 Cookie 的注解或方法,因为 Servlet-API 中的 response.addCookie 已经很好用了,我们知道,在 Servlet 编程中,使用一个 javax.servlet.http.Cookie 对象表示一个 cookie,cookie 的两个基本属性就是 name 和 value,分别表示 cookie 的名称和 cookie 的值,注意,为了符合 cookie name 和 value 的字符规范,建议对 name 和 value 做 base64 或 url 编码处理。一个好的方法是,name 使用正常的英文字母,这样就不需要编码处理,而 value 则进行编码处理,比如 base64 编码或 url 编码。

  1. package com.zfl9.controller;
  2. import java.io.UnsupportedEncodingException;
  3. import java.net.URLDecoder;
  4. import java.net.URLEncoder;
  5. import javax.servlet.http.Cookie;
  6. import javax.servlet.http.HttpServletResponse;
  7. import org.springframework.web.bind.annotation.CookieValue;
  8. import org.springframework.web.bind.annotation.GetMapping;
  9. import org.springframework.web.bind.annotation.RequestMapping;
  10. import org.springframework.web.bind.annotation.RequestParam;
  11. import org.springframework.web.bind.annotation.RestController;
  12. @RestController
  13. @RequestMapping(produces = "text/plain; charset=UTF-8")
  14. public class TestController {
  15. @GetMapping("/cookie/get")
  16. public String getCookie(@CookieValue String name, @CookieValue String email) throws UnsupportedEncodingException {
  17. name = URLDecoder.decode(name, "UTF-8");
  18. email = URLDecoder.decode(email, "UTF-8");
  19. return String.format("name: %s, email: %s\n", name, email);
  20. }
  21. @GetMapping("/cookie/add")
  22. public String setCookie(@RequestParam String name, @RequestParam String email, HttpServletResponse response) throws UnsupportedEncodingException {
  23. Cookie cookieForName = new Cookie("name", URLEncoder.encode(name, "UTF-8"));
  24. Cookie cookieForEmail = new Cookie("email", URLEncoder.encode(email, "UTF-8"));
  25. response.addCookie(cookieForName);
  26. response.addCookie(cookieForEmail);
  27. return "cookie is add";
  28. }
  29. }

删除 Cookie
Cookie 的删除很简单,发送一个 maxAge 为 0 的同名 cookie 给浏览器就行了,value 可以设为 null:

  1. package com.zfl9.controller;
  2. import java.io.UnsupportedEncodingException;
  3. import java.net.URLDecoder;
  4. import java.net.URLEncoder;
  5. import javax.servlet.http.Cookie;
  6. import javax.servlet.http.HttpServletResponse;
  7. import org.springframework.web.bind.annotation.CookieValue;
  8. import org.springframework.web.bind.annotation.GetMapping;
  9. import org.springframework.web.bind.annotation.RequestMapping;
  10. import org.springframework.web.bind.annotation.RequestParam;
  11. import org.springframework.web.bind.annotation.RestController;
  12. @RestController
  13. @RequestMapping(path = "/cookie", produces = "text/plain; charset=UTF-8")
  14. public class TestController {
  15. @GetMapping("/get")
  16. public String getCookie(@CookieValue String name, @CookieValue String email) throws UnsupportedEncodingException {
  17. name = URLDecoder.decode(name, "UTF-8");
  18. email = URLDecoder.decode(email, "UTF-8");
  19. return String.format("name: %s, email: %s\n", name, email);
  20. }
  21. @GetMapping("/add")
  22. public String setCookie(@RequestParam String name, @RequestParam String email, HttpServletResponse response) throws UnsupportedEncodingException {
  23. Cookie cookieForName = new Cookie("name", URLEncoder.encode(name, "UTF-8"));
  24. Cookie cookieForEmail = new Cookie("email", URLEncoder.encode(email, "UTF-8"));
  25. response.addCookie(cookieForName);
  26. response.addCookie(cookieForEmail);
  27. return "cookie is add";
  28. }
  29. @GetMapping("/del")
  30. public String delCookie(HttpServletResponse response) {
  31. Cookie cookieForName = new Cookie("name", null);
  32. cookieForName.setMaxAge(0);
  33. Cookie cookieForEmail = new Cookie("email", null);
  34. cookieForEmail.setMaxAge(0);
  35. response.addCookie(cookieForName);
  36. response.addCookie(cookieForEmail);
  37. return "cookie is del";
  38. }
  39. }

读取/添加/删除 session
读取 session 也很简单,使用 @SessionAttribute 注解标注方法参数,该参数就会自动绑定到对应的 session attribute 了。@SessionAttribute 注解有两个属性,即 name/value,表示 session 属性的名称,而 required 属性表示该属性是否是请求的,默认为 true,即如果没有对应的 session 属性,Spring 会抛出异常。可以设置为 false,这样,当该属性不存在时,参数将指向 null。

  1. package com.zfl9.controller;
  2. import javax.servlet.http.HttpSession;
  3. import org.springframework.web.bind.annotation.GetMapping;
  4. import org.springframework.web.bind.annotation.RequestMapping;
  5. import org.springframework.web.bind.annotation.RequestParam;
  6. import org.springframework.web.bind.annotation.RestController;
  7. import org.springframework.web.bind.annotation.SessionAttribute;
  8. @RestController
  9. @RequestMapping(path = "/session", produces = "text/plain; charset=UTF-8")
  10. public class SessionController {
  11. @GetMapping("/get")
  12. public String getSession(@SessionAttribute String name, @SessionAttribute String email) {
  13. return String.format("name: %s, email: %s\n", name, email);
  14. }
  15. @GetMapping("/add")
  16. public String addSession(@RequestParam String name, @RequestParam String email, HttpSession session) {
  17. session.setAttribute("name", name);
  18. session.setAttribute("email", email);
  19. return "session is add";
  20. }
  21. @GetMapping("/del")
  22. public String delSession(HttpSession session) {
  23. session.removeAttribute("name");
  24. session.removeAttribute("email");
  25. return "session is del";
  26. }
  27. }

@SessionAttributes 注解的作用以及用法
根据前面的学习,SessionAttributes 注解是用来同步 Model 中的 attribute 到 Session 中的,@SessionAttributes 注解用在 Controller 类上,有两个属性,names/value,字符串数组,同名的 model 属性会被自动存储到 session 中,而 types 属性时 Class 数组,对应类型的 model 属性也会被自动存储到 session 中,两个参数可以同时指定,它们是一个并集关系。官方 javadoc 文档是这样说的,这个注解是用来临时存储 model 数据到 session 中用的,一旦 Controller 方法指定 session 会话完成(调用 SessionStatus 的 setComplete 方法可将会话标记为已完成,这时候这些 session 属性就会被清除),Spring 将会自动删除这些属性,所以对于持久性的 session,请使用 HttpSession.setAttribute 方法。

  1. package com.zfl9.controller;
  2. import org.springframework.ui.Model;
  3. import org.springframework.web.bind.annotation.GetMapping;
  4. import org.springframework.web.bind.annotation.RequestMapping;
  5. import org.springframework.web.bind.annotation.RequestParam;
  6. import org.springframework.web.bind.annotation.RestController;
  7. import org.springframework.web.bind.annotation.SessionAttribute;
  8. import org.springframework.web.bind.annotation.SessionAttributes;
  9. import org.springframework.web.bind.support.SessionStatus;
  10. @RestController
  11. @SessionAttributes({"name", "email", "profile"})
  12. @RequestMapping(path = "/session", produces = "text/plain; charset=UTF-8")
  13. public class SessionController {
  14. @GetMapping("/add")
  15. public String addSession(@RequestParam String name, @RequestParam String email, @RequestParam String profile, Model model) {
  16. model.addAttribute("name", name);
  17. model.addAttribute("email", email);
  18. model.addAttribute("profile", profile);
  19. return "session is add";
  20. }
  21. @GetMapping("/get")
  22. public String getSession(@SessionAttribute String name, @SessionAttribute String email, @SessionAttribute String profile) {
  23. return String.format("name: %s, email: %s, profile: %s\n", name, email, profile);
  24. }
  25. @GetMapping("/del")
  26. public String delSession(SessionStatus sessionStatus) {
  27. sessionStatus.setComplete();
  28. return "session is del";
  29. }
  30. }

RESTful API

所谓 RESTful API 就是:使用 URL 定位资源,使用 Method 描述操作。典型的 CRUD 操作:

  1. POST /employees # 创建一个员工
  2. GET /employees # 获取所有员工
  3. GET /employees/${id} # 获取指定员工
  4. PUT /employees/${id} # 更新员工信息(完整更新)
  5. PATCH /employees/${id} # 更新员工信息(部分更新)
  6. DELETE /employees/${id} # 删除指定员工
  7. DELETE /employees # 删除所有员工

如果想要了解有关 RESTful API 的更多信息,可参考之前的 RESTful API 感想 一文。

Spring MVC 对 RESTful API 提供了非常良好的支持,不仅有编写 RESTful API 服务端的类库,还提供了一个 RestTemplate 客户端帮助类,便于我们编写 Java 代码,测试我们编写的 RESTful API 是否工作正常。

不过,本文暂时不介绍 RestTemplate 类的使用,再说 RestTemplate 的使用其实很简单,没什么可讲的,直接看几个官方的 case 就行了,就如同 JdbcTemplate 模板类一样,简单易用,容易上手。这里我就使用 Postman 来进行 RESTful API 的 CRUD 测试,当然也可以使用 curl 命令行工具进行测试。

前面说了,RESTful API 通常情况下,都是使用 JSON 作为数据交互格式,因为 JSON 和 Java 对象之间的转换非常简单,兼容性非常强,而且 JSON 的两大数据类型:数组和对象,和 Java 中的 Bean/POJO、集合对象基本上都可以进行很好的互相转换操作,我们来回顾一下 JSON 是什么,以及 JSON 的数据类型:

JSON(JavaScript Object Notation,JS 对象表示法),是一种由 道格拉斯·克罗克福特 构想设计、轻量级的数据交换格式,以文本为基础,且易于让人阅读。尽管 JSON 是 Javascript 的一个子集,但 JSON 是独立于语言的文本格式,并且采用了类似于 C 语言家族的一些习惯。

JSON 数据格式与语言无关,脱胎于 JavaScript,但目前很多编程语言都支持 JSON 格式数据的生成和解析。JSON 的官方 MIME 类型是 application/json,文件扩展名是 .json

JSON 建构于两种结构:

这两种结构分别对应 JavaScript 中的 对象数组。注意,JSON 只是一个字符串!是一个纯文本!

值(即对象中的 value、数组中的 element)可以是以下类型:

number 只支持十进制的整数、浮点数。其中浮点数支持科学记数法,即 1.3E4 表示 13000(E 大小写不敏感)。

string 必须使用双引号包围,包括 object 中的 key,这是为了适应 C/C++、Java 中的"单引号为字符,双引号为字符串"语法。此外,还支持一些转义序列:

编写 RESTful API 的一个关键点就是,Controller 方法接收 json 数据,同时,Controller 方法返回的也是 json 数据,我们知道 json 其实就是一个字符串,那么在 Spring 中,我们如何接收 json 请求体,并且又如何返回 json 响应呢?别慌,Spring MVC 提供了一系列机制,来方便我们编写 RESTful API 应用。

回顾前面的 JSON 支持一节,我们只需要在 pom.xml 中添加 jackson-databind 依赖,然后配置 spring mvc 的 annotation-driven 注解驱动元素,Spring MVC 就会自动检测到 jackson-databind 的存在,然后使用 jackson 来进行 bean/pojo/集合对象/数组对象 到 json 字符串之间的转换(称之为序列化),当然 jackson 也可以将 json 字符串反序列化为 bean/pojo/集合对象/数组对象,总之就是无缝的转换。

我们已经知道 JSON 的两大底层数据类型,数组和对象,而 Java 中常见的数据类型就是:Array/List、HashMap 两种,List 和 Array 基本上可以看作一种类型,即 JSON 口中的数组,而 HashMap 就是对象,因为 JSON 中的对象其实就是键值对,也就是 Java 中的 Map;那么 Bean/Pojo 呢?bean 和 pojo 也都可以映射到 JSON 的对象,即键值对,key 就是对象的数据成员名称,value 就是对象的数据成员值,比如一个 Student 类,有 name 和 age 两个 private 属性,同时我们定义了它们的 getter、setter 方法,那么该 student 对象就可以序列化为 { "name": "Otokaze", "age": 20 },怎么样,是不是很形象。

Spring MVC 中接收 JSON 请求
在前面的注解复习一节中,我们接触了 @RequestParam@RequestBody@RequestPart 三个与请求数据绑定的注解,@RequestParam 是用来绑定表单数据的,@RequestBody 是用来绑定 json/xml 数据的,@RequestPart 是用来绑定文件上传的。所以很显然,在 RESTful 中,如果要绑定 json 数据(自动序列化为 Java 对象),那么就要使用 @RequestBody 注解,被注解的参数类型应该是一个 bean/pojo、list/map,这样 jackson-databind 才能将 json 字符串正确的序列化为 java 对象。

Spring MVC 中返回 JSON 数据
现在我们已经知道如何接收 JSON 请求数据了,接下来我们来看看如何响应 JSON 数据给客户端,因为之前的 Spring MVC example 中,我们返回的都是一个 String 或 ModelAndView,表示这个请求将被 forward 给对应的 view 视图进行进一步处理,处理完之后,http 响应才会被发往客户端,请求结束。不过在 RESTful 中,根本不需要什么 view 视图,我们需要的是直接在 Controller 方法中返回响应结果给客户端,而不经过 forward to view 这个步骤,这时候我们就需要使用 @ResponseBody 注解标注我们的 Controller 方法,这个注解的意思非常明了,意思就是说这个方法的返回值就是响应的结果。在 Spring MVC 4.0 之后,我们可以直接在 Controller 类上使用这个注解,此时表示 Controller 里面的所有方法都是 REST 方法,相当于给每个处理方法都标上了 @ResponseBody 注解,不过,Spring MVC 之后又提供了一个 @RestController 注解,它和 @Controller + @ResponseBody 注解一起使用的效果是等价的,可看作 @Controller 的子注解。

此外,我们也可以不使用任何 @ResponseBody、@RestController 注解,而是依旧使用原先的 @Controller 注解,然后我们的控制器方法返回值改为 ResponseEntity<T> 类,ResponseEntity 中文意思就是“响应实体”,它就是一个完整的 HTTP response 的抽象表示,由 method、url、header、body 四个部分表示,所以我们不需要 @ResponseBody 标注这些方法或控制器类,因为这个返回值就表示一个完整的 HTTP 响应。

大家可以自由的选择使用 @RestController注解 + 返回Object@Controller注解 + 返回ResponseEntity 两种形式,它们都可以用来编写 RESTful API 服务,不论哪种方式,Spring 都会使用 jackson-databind 对 Object/ResponseEntity 里面的 Object 进行序列化操作,转换为 JSON 字符串。一般情况下,使用前者就可以了,不过如果你需要设置 HTTP 响应头,那么使用 ResponseEntity 可能会方便一点。虽然 ResponseEntity 很灵活和很强大,但是不应该过度使用 ResponseEntity,而是应该更简单的传统方式,这样可读性更强。当然也不是说不能使用 ResponseEntity,如果有足够的理由使用,那就大胆的使用吧。

pom.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  4. <modelVersion>4.0.0</modelVersion>
  5. <groupId>com.zfl9</groupId>
  6. <artifactId>SpringMVC_Learn</artifactId>
  7. <version>1.0-SNAPSHOT</version>
  8. <packaging>war</packaging>
  9. <properties>
  10. <maven.compiler.source>1.8</maven.compiler.source>
  11. <maven.compiler.target>1.8</maven.compiler.target>
  12. <spring.version>4.3.20.RELEASE</spring.version>
  13. <mysql.version>8.0.13</mysql.version>
  14. <servlet.version>3.1.0</servlet.version>
  15. <jstl.version>1.2</jstl.version>
  16. <jackson.version>2.9.7</jackson.version>
  17. <fileupload.version>1.3.3</fileupload.version>
  18. <validatorapi.version>2.0.1.Final</validatorapi.version>
  19. <validatorimpl.version>6.0.13.Final</validatorimpl.version>
  20. </properties>
  21. <dependencies>
  22. <dependency>
  23. <groupId>org.springframework</groupId>
  24. <artifactId>spring-context</artifactId>
  25. <version>${spring.version}</version>
  26. </dependency>
  27. <dependency>
  28. <groupId>org.springframework</groupId>
  29. <artifactId>spring-webmvc</artifactId>
  30. <version>${spring.version}</version>
  31. </dependency>
  32. <dependency>
  33. <groupId>org.springframework</groupId>
  34. <artifactId>spring-jdbc</artifactId>
  35. <version>${spring.version}</version>
  36. </dependency>
  37. <dependency>
  38. <groupId>mysql</groupId>
  39. <artifactId>mysql-connector-java</artifactId>
  40. <version>${mysql.version}</version>
  41. <scope>runtime</scope>
  42. </dependency>
  43. <dependency>
  44. <groupId>javax.servlet</groupId>
  45. <artifactId>javax.servlet-api</artifactId>
  46. <version>${servlet.version}</version>
  47. <scope>provided</scope>
  48. </dependency>
  49. <dependency>
  50. <groupId>javax.servlet</groupId>
  51. <artifactId>jstl</artifactId>
  52. <version>${jstl.version}</version>
  53. <scope>runtime</scope>
  54. </dependency>
  55. <dependency>
  56. <groupId>com.fasterxml.jackson.core</groupId>
  57. <artifactId>jackson-databind</artifactId>
  58. <version>${jackson.version}</version>
  59. <scope>runtime</scope>
  60. </dependency>
  61. <dependency>
  62. <groupId>commons-fileupload</groupId>
  63. <artifactId>commons-fileupload</artifactId>
  64. <version>${fileupload.version}</version>
  65. <scope>runtime</scope>
  66. </dependency>
  67. <dependency>
  68. <groupId>javax.validation</groupId>
  69. <artifactId>validation-api</artifactId>
  70. <version>${validatorapi.version}</version>
  71. </dependency>
  72. <dependency>
  73. <groupId>org.hibernate.validator</groupId>
  74. <artifactId>hibernate-validator</artifactId>
  75. <version>${validatorimpl.version}</version>
  76. </dependency>
  77. </dependencies>
  78. </project>

web.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <web-app>
  3. <filter>
  4. <filter-name>encodingFilter</filter-name>
  5. <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
  6. <init-param>
  7. <param-name>encoding</param-name>
  8. <param-value>UTF-8</param-value>
  9. </init-param>
  10. <init-param>
  11. <param-name>forceEncoding</param-name>
  12. <param-value>true</param-value>
  13. </init-param>
  14. </filter>
  15. <filter-mapping>
  16. <filter-name>encodingFilter</filter-name>
  17. <servlet-name>springmvc</servlet-name>
  18. </filter-mapping>
  19. <filter>
  20. <filter-name>hiddenHttpMethodFilter</filter-name>
  21. <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
  22. </filter>
  23. <filter-mapping>
  24. <filter-name>hiddenHttpMethodFilter</filter-name>
  25. <servlet-name>springmvc</servlet-name>
  26. </filter-mapping>
  27. <servlet>
  28. <servlet-name>springmvc</servlet-name>
  29. <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  30. <load-on-startup>1</load-on-startup>
  31. <init-param>
  32. <param-name>contextConfigLocation</param-name>
  33. <param-value>/WEB-INF/mvc.xml</param-value>
  34. </init-param>
  35. </servlet>
  36. <servlet-mapping>
  37. <servlet-name>springmvc</servlet-name>
  38. <url-pattern>/</url-pattern>
  39. </servlet-mapping>
  40. </web-app>

mvc.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <beans xmlns="http://www.springframework.org/schema/beans"
  3. xmlns:mvc="http://www.springframework.org/schema/mvc"
  4. xmlns:context="http://www.springframework.org/schema/context"
  5. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  6. xsi:schemaLocation="http://www.springframework.org/schema/beans
  7. http://www.springframework.org/schema/beans/spring-beans.xsd
  8. http://www.springframework.org/schema/mvc
  9. http://www.springframework.org/schema/mvc/spring-mvc.xsd
  10. http://www.springframework.org/schema/context
  11. http://www.springframework.org/schema/context/spring-context.xsd">
  12. <context:component-scan base-package="com.zfl9"/>
  13. <mvc:annotation-driven/>
  14. <mvc:default-servlet-handler/>
  15. <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
  16. <property name="prefix" value="/WEB-INF/views/"/>
  17. <property name="suffix" value=".jsp"/>
  18. </bean>
  19. <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
  20. <property name="maxUploadSize" value="31457280"/> <!-- postMaxSize: 30M -->
  21. <property name="maxUploadSizePerFile" value="10485760"/> <!-- fileMaxSize: 10M -->
  22. </bean>
  23. <bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
  24. <property name="driverClassName" value="com.mysql.cj.jdbc.Driver"/>
  25. <property name="url" value="jdbc:mysql://localhost/test?serverTimezone=UTC"/>
  26. <property name="username" value="root"/>
  27. <property name="password" value="123456"/>
  28. </bean>
  29. <bean id="jdbcTemplate" class="org.springframework.jdbc.core.JdbcTemplate">
  30. <property name="dataSource" ref="dataSource"/>
  31. </bean>
  32. </beans>

@RestController 方式
EmployeeRestController.java

  1. package com.zfl9.controller;
  2. import java.util.List;
  3. import org.springframework.beans.factory.annotation.Autowired;
  4. import org.springframework.web.bind.annotation.GetMapping;
  5. import org.springframework.web.bind.annotation.RequestMapping;
  6. import org.springframework.web.bind.annotation.RestController;
  7. import com.zfl9.model.Employee;
  8. import com.zfl9.service.EmployeeService;
  9. @RestController
  10. @RequestMapping("/api/employees")
  11. public class EmployeeRestController {
  12. @Autowired
  13. private EmployeeService employeeService;
  14. @GetMapping
  15. public List<Employee> getAllEmployees() {
  16. return employeeService.getAllEmployee();
  17. }
  18. }

使用 Postman 进行 API 接口测试,得到以下结果:

  1. [
  2. {
  3. "id": 2,
  4. "name": "Justine ",
  5. "email": "Nikita_Koch93@yahoo.com",
  6. "address": "9838 Treutel Loaf",
  7. "telephone": "1-077-812-5934 x9878"
  8. },
  9. {
  10. "id": 3,
  11. "name": "Eldridge ",
  12. "email": "Eldridge.Flatley13@gmail.com",
  13. "address": "4810 Bosco Views",
  14. "telephone": "1-344-711-8794"
  15. },
  16. {
  17. "id": 4,
  18. "name": "Kirk ",
  19. "email": "Kirk_Franecki13@hotmail.com",
  20. "address": "183 Buckridge Street",
  21. "telephone": "349.586.6572"
  22. },
  23. {
  24. "id": 5,
  25. "name": "Donny ",
  26. "email": "Donny15@gmail.com",
  27. "address": "49378 Nathanial Mountain",
  28. "telephone": "1-244-325-0932 x750"
  29. },
  30. {
  31. "id": 6,
  32. "name": "Roslyn ",
  33. "email": "Roslyn.Heidenreich@gmail.com",
  34. "address": "83699 Cummerata Orchard",
  35. "telephone": "530-781-8206"
  36. },
  37. {
  38. "id": 7,
  39. "name": "美咲 佐々木",
  40. "email": "Gerard_Crona1@hotmail.com",
  41. "address": "91855 愛菜 Village",
  42. "telephone": "608.588.5885 x57195"
  43. },
  44. {
  45. "id": 8,
  46. "name": "梁 鹏涛",
  47. "email": "liang.peng.tao@hotmail.com",
  48. "address": "富裕省贫穷市土豪村",
  49. "telephone": "85449355157"
  50. },
  51. {
  52. "id": 9,
  53. "name": "Kennedi ",
  54. "email": "Nigel61@hotmail.com",
  55. "address": "837 LeQuesne Station St",
  56. "telephone": "0468 699 235"
  57. },
  58. {
  59. "id": 10,
  60. "name": "Johannes ",
  61. "email": "Johannes_Breuer82@yahoo.com",
  62. "address": "7510 Janne Shores",
  63. "telephone": "08641 5000"
  64. },
  65. {
  66. "id": 11,
  67. "name": "Tyshawn ",
  68. "email": "Tyshawn3@yahoo.com",
  69. "address": "824 Marie Path",
  70. "telephone": "(930) 300-1584 x0236"
  71. },
  72. {
  73. "id": 12,
  74. "name": "شیرزاد لنکرانی",
  75. "email": "Nadia30@gmail.com",
  76. "address": "96290 فریاد Isle",
  77. "telephone": "553-204-7203 x7653"
  78. },
  79. {
  80. "id": 13,
  81. "name": "Hohnheiser",
  82. "email": "Jessy_Hohnheiser14@gmail.com",
  83. "address": "26051 Romeo Lodge",
  84. "telephone": "(0235) 816647440"
  85. },
  86. {
  87. "id": 14,
  88. "name": "Nathan ",
  89. "email": "Nathan_Allgeyer@yahoo.com",
  90. "address": "98684 Otte Ramp",
  91. "telephone": "(0963) 130796580"
  92. },
  93. {
  94. "id": 15,
  95. "name": "Maxime ",
  96. "email": "Maxime72@gmail.com",
  97. "address": "270 Sterling Corner",
  98. "telephone": "014995 26191"
  99. },
  100. {
  101. "id": 16,
  102. "name": "陽翔 佐々木",
  103. "email": "Novella76@hotmail.com",
  104. "address": "452 陽菜 Lock",
  105. "telephone": "+96 63 0510448"
  106. },
  107. {
  108. "id": 17,
  109. "name": "結愛 木村",
  110. "email": "Otha_Dare@hotmail.com",
  111. "address": "214 高橋 Mills",
  112. "telephone": "(246)726-1911 x221"
  113. },
  114. {
  115. "id": 18,
  116. "name": "蒼空 斎藤",
  117. "email": "Giordano.Farin@yahoo.com",
  118. "address": "16996 小林 Springs",
  119. "telephone": "1-140-787-4492"
  120. },
  121. {
  122. "id": 21,
  123. "name": "Kiara ",
  124. "email": "Kiara.Clarke@gmail.com",
  125. "address": "5294 Lara Mews",
  126. "telephone": "05 2185 0888"
  127. },
  128. {
  129. "id": 23,
  130. "name": "Otokaze",
  131. "email": "zfl9.com@gmail.com",
  132. "address": "jiangxi.ganzhou",
  133. "telephone": "15307973676"
  134. }
  135. ]

可以看到,List 被转换为了 JSON 数组,Employee 实体类被转换为了 JSON 对象。

ResponseEntity 方式
EmployeeRestController.java

  1. package com.zfl9.controller;
  2. import java.util.List;
  3. import org.springframework.beans.factory.annotation.Autowired;
  4. import org.springframework.http.ResponseEntity;
  5. import org.springframework.stereotype.Controller;
  6. import org.springframework.web.bind.annotation.GetMapping;
  7. import org.springframework.web.bind.annotation.RequestMapping;
  8. import com.zfl9.model.Employee;
  9. import com.zfl9.service.EmployeeService;
  10. @Controller
  11. @RequestMapping("/api/employees")
  12. public class EmployeeRestController {
  13. @Autowired
  14. private EmployeeService employeeService;
  15. @GetMapping
  16. public ResponseEntity<List<Employee>> getAllEmployees() {
  17. return ResponseEntity.ok(employeeService.getAllEmployee());
  18. }
  19. }

使用 Postman 测试,结果是一样的,就不贴出来了。一般还是建议使用 @RestController + Pojo 形式。

题外话,因为提到了 @ResponseBody,那就再提一下 @ResponseStatus 注解吧,该注解有两个属性:

@ResponseStatus 可以用来标记三个东西,它们的意思分别是:

ResponseEntity 使用详解
虽然不建议使用 ResponseEntity,不过有时候使用 ResponseEntity 是真的方便,可以完全脱离 Servlet-API,比如设置 HTTP 响应状态码,虽然可以使用 @ResponseStatus 注解处理器方法,但是我们不能在方法内部动态的设置 Status Code,可能你会说可以通过 @ResponseStatus + 自定义异常类来完成这个需求,但是我并不想通过这种别扭的方式来返回指定响应状态,你可能又会说,可以使用 HttpServletResponse 来设置啊,暂时不争论这个,我们来学习一下 ResponseEntity 的常见用法吧。

ResponseEntity 的类签名

  1. public class ResponseEntity<T> extends HttpEntity<T> {
  2. ...
  3. }

可以看到,这是一个泛型类,其中 T 是响应体的类型,比如 String、Employee、List<Employee>

我们来看一下 ResponseEntity 的构造方法:

  1. public ResponseEntity(HttpStatus status)
  2. public ResponseEntity(T body, HttpStatus status)
  3. public ResponseEntity(MultiValueMap<String, String> headers, HttpStatus status)
  4. public ResponseEntity(T body, MultiValueMap<String, String> headers, HttpStatus status)

关心一下 MultiValueMap<String, String> 类型,根据 javadoc 描述,这是一个可以存储多个 value 的 key-values 键值对数据结构,它是 java.util.Map<K, List<V>> 的子接口,我们来看一下它的签名:

  1. public interface MultiValueMap<K, V> extends Map<K, List<V>>

MultiValueMap 的常用实现类就是 HttpHeaders,它的 K 和 V 都是字符串类型,表示 HTTP 头部。

ResponseEntity 的静态方法 since v4.1+

  1. // 设置指定 body,status 为 200 OK
  2. public static <T> ResponseEntity<T> ok(T body)
  3. // 设置 404/204 状态码,因为没有 body,所以返回 header builder
  4. public static ResponseEntity.HeadersBuilder<?> notFound()
  5. public static ResponseEntity.HeadersBuilder<?> noContent()
  6. // 设置对应的 status 状态码,然后返回 body builder
  7. public static ResponseEntity.BodyBuilder ok()
  8. public static ResponseEntity.BodyBuilder accepted()
  9. public static ResponseEntity.BodyBuilder badRequest()
  10. public static ResponseEntity.BodyBuilder created(java.net.URI location)
  11. public static ResponseEntity.BodyBuilder status(int status)
  12. public static ResponseEntity.BodyBuilder status(HttpStatus status)

我们来看看 HeadersBuilder 内部接口(返回的是 HeadersBuilder):

  1. B headers(HttpHeaders headers) // 包含指定 headers
  2. B header(String headerName, String... headerValues) // 设置指定 header
  3. B location(java.net.URI location) // 设置 Location 重定向响应头部
  4. <T> ResponseEntity<T> build() // 完成构造,返回 ResponseEntity

来看看 BodyBuilder 内部接口(返回的是 BodyBuilder,BodyBuilder 是 HeadersBuilder 的子接口):

  1. ResponseEntity.BodyBuilder contentLength(long contentLength) // Content-Length 头
  2. ResponseEntity.BodyBuilder contentType(MediaType contentType) // Content-Type 头
  3. <T> ResponseEntity<T> body(body) // 设置 body,响应体,返回 ResponseEntity

好了,我们来看几个 ResponseEntity 的用法,熟悉一下怎么用:

  1. @GetMapping("/hello")
  2. ResponseEntity<String> hello() {
  3. return new ResponseEntity<>("Hello World!", HttpStatus.OK);
  4. }
  5. @GetMapping("/age")
  6. ResponseEntity<String> age(
  7. @RequestParam("yearOfBirth") int yearOfBirth) {
  8. if (isInFuture(yearOfBirth)) {
  9. return new ResponseEntity<>(
  10. "Year of birth cannot be in the future",
  11. HttpStatus.BAD_REQUEST);
  12. }
  13. return new ResponseEntity<>(
  14. "Your age is " + calculateAge(yearOfBirth),
  15. HttpStatus.OK);
  16. }
  17. @GetMapping("/customHeader")
  18. ResponseEntity<String> customHeader() {
  19. HttpHeaders headers = new HttpHeaders();
  20. headers.add("Custom-Header", "foo");
  21. return new ResponseEntity<>(
  22. "Custom header set", headers, HttpStatus.OK);
  23. }
  24. @GetMapping("/hello")
  25. ResponseEntity<String> hello() {
  26. return ResponseEntity.ok("Hello World!");
  27. }
  28. @GetMapping("/age")
  29. ResponseEntity<String> age(@RequestParam("yearOfBirth") int yearOfBirth) {
  30. if (isInFuture(yearOfBirth)) {
  31. return ResponseEntity.badRequest()
  32. .body("Year of birth cannot be in the future");
  33. }
  34. return ResponseEntity.status(HttpStatus.OK)
  35. .body("Your age is " + calculateAge(yearOfBirth));
  36. }
  37. @GetMapping("/customHeader")
  38. ResponseEntity<String> customHeader() {
  39. return ResponseEntity.ok()
  40. .header("Custom-Header", "foo")
  41. .body("Custom header set");
  42. }

Employee RESTful API CRUD 例子
Employee.java

  1. package com.zfl9.model;
  2. import javax.validation.constraints.Email;
  3. import javax.validation.constraints.Min;
  4. import javax.validation.constraints.NotBlank;
  5. import javax.validation.constraints.NotNull;
  6. import javax.validation.constraints.Pattern;
  7. public class Employee implements java.io.Serializable {
  8. private static final long serialVersionUID = 6782234751084760161L;
  9. public interface Create {}
  10. public interface Update {}
  11. @NotNull(message = "id is null", groups = Update.class)
  12. @Min(value = 1, message = "id is invalid", groups = Update.class)
  13. private Integer id;
  14. @NotNull(message = "name is null", groups = {Create.class, Update.class})
  15. @NotBlank(message = "name is invalid", groups = {Create.class, Update.class})
  16. private String name;
  17. @NotNull(message = "email is null", groups = {Create.class, Update.class})
  18. @Email(message = "email is invalid", groups = {Create.class, Update.class})
  19. private String email;
  20. @NotNull(message = "address is null", groups = {Create.class, Update.class})
  21. @NotBlank(message = "address is invalid", groups = {Create.class, Update.class})
  22. private String address;
  23. @NotNull(message = "telephone is null", groups = {Create.class, Update.class})
  24. @Pattern(regexp = "^[0-9 -]++$", message ="telephone is invalid", groups = {Create.class, Update.class})
  25. private String telephone;
  26. public Integer getId() {
  27. return id;
  28. }
  29. public void setId(Integer id) {
  30. this.id = id;
  31. }
  32. public String getName() {
  33. return name;
  34. }
  35. public void setName(String name) {
  36. this.name = name;
  37. }
  38. public String getEmail() {
  39. return email;
  40. }
  41. public void setEmail(String email) {
  42. this.email = email;
  43. }
  44. public String getAddress() {
  45. return address;
  46. }
  47. public void setAddress(String address) {
  48. this.address = address;
  49. }
  50. public String getTelephone() {
  51. return telephone;
  52. }
  53. public void setTelephone(String telephone) {
  54. this.telephone = telephone;
  55. }
  56. @Override
  57. public String toString() {
  58. return String.format("Employee { id = %d, name = %s, email = %s, address = %s, telephone = %s }", id, name, email, address, telephone);
  59. }
  60. }

EmployeeDao.java

  1. package com.zfl9.dao;
  2. import java.util.List;
  3. import com.zfl9.model.Employee;
  4. public interface EmployeeDao {
  5. Employee getEmployee(int id);
  6. List<Employee> getAllEmployee();
  7. void addEmployee(Employee employee);
  8. void updateEmployee(Employee employee);
  9. void deleteEmployee(int id);
  10. void deleteAllEmployee();
  11. }

EmployeeDaoImpl.java

  1. package com.zfl9.dao;
  2. import java.util.List;
  3. import org.springframework.beans.factory.annotation.Autowired;
  4. import org.springframework.jdbc.core.JdbcTemplate;
  5. import org.springframework.jdbc.core.RowMapper;
  6. import org.springframework.stereotype.Repository;
  7. import com.zfl9.model.Employee;
  8. @Repository
  9. public class EmployeeDaoImpl implements EmployeeDao {
  10. @Autowired
  11. private JdbcTemplate jdbcTemplate;
  12. private RowMapper<Employee> rowMapper = (resultSet, rowNum) -> {
  13. Employee employee = new Employee();
  14. employee.setId(resultSet.getInt("id"));
  15. employee.setName(resultSet.getString("name"));
  16. employee.setEmail(resultSet.getString("email"));
  17. employee.setAddress(resultSet.getString("address"));
  18. employee.setTelephone(resultSet.getString("telephone"));
  19. return employee;
  20. };
  21. @Override
  22. public Employee getEmployee(int id) {
  23. String sql = "select * from employee where id = ?";
  24. return jdbcTemplate.queryForObject(sql, rowMapper, id);
  25. }
  26. @Override
  27. public List<Employee> getAllEmployee() {
  28. String sql = "select * from employee";
  29. return jdbcTemplate.query(sql, rowMapper);
  30. }
  31. @Override
  32. public void addEmployee(Employee employee) {
  33. String sql = "insert into employee (name, email, address, telephone) values (?, ?, ?, ?)";
  34. jdbcTemplate.update(sql, employee.getName(), employee.getEmail(), employee.getAddress(), employee.getTelephone());
  35. }
  36. @Override
  37. public void updateEmployee(Employee employee) {
  38. String sql = "update employee set name = ?, email = ?, address = ?, telephone = ? where id = ?";
  39. jdbcTemplate.update(sql, employee.getName(), employee.getEmail(), employee.getAddress(), employee.getTelephone(), employee.getId());
  40. }
  41. @Override
  42. public void deleteEmployee(int id) {
  43. String sql = "delete from employee where id = ?";
  44. jdbcTemplate.update(sql, id);
  45. }
  46. @Override
  47. public void deleteAllEmployee() {
  48. String sql = "truncate table employee";
  49. jdbcTemplate.update(sql);
  50. }
  51. }

EmployeeService.java

  1. package com.zfl9.service;
  2. import java.util.List;
  3. import com.zfl9.model.Employee;
  4. public interface EmployeeService {
  5. Employee getEmployee(int id);
  6. List<Employee> getAllEmployee();
  7. void addEmployee(Employee employee);
  8. void updateEmployee(Employee employee);
  9. void deleteEmployee(int id);
  10. void deleteAllEmployee();
  11. }

EmployeeServiceImpl.java

  1. package com.zfl9.service;
  2. import java.util.List;
  3. import org.springframework.beans.factory.annotation.Autowired;
  4. import org.springframework.stereotype.Service;
  5. import com.zfl9.dao.EmployeeDao;
  6. import com.zfl9.model.Employee;
  7. @Service
  8. public class EmployeeServiceImpl implements EmployeeService {
  9. @Autowired
  10. private EmployeeDao employeeDao;
  11. @Override
  12. public Employee getEmployee(int id) {
  13. return employeeDao.getEmployee(id);
  14. }
  15. @Override
  16. public List<Employee> getAllEmployee() {
  17. return employeeDao.getAllEmployee();
  18. }
  19. @Override
  20. public void addEmployee(Employee employee) {
  21. employeeDao.addEmployee(employee);
  22. }
  23. @Override
  24. public void updateEmployee(Employee employee) {
  25. employeeDao.updateEmployee(employee);
  26. }
  27. @Override
  28. public void deleteEmployee(int id) {
  29. employeeDao.deleteEmployee(id);
  30. }
  31. @Override
  32. public void deleteAllEmployee() {
  33. employeeDao.deleteAllEmployee();
  34. }
  35. }

EmployeeRestController.java

  1. package com.zfl9.controller;
  2. import java.util.List;
  3. import org.springframework.beans.factory.annotation.Autowired;
  4. import org.springframework.http.MediaType;
  5. import org.springframework.http.ResponseEntity;
  6. import org.springframework.stereotype.Controller;
  7. import org.springframework.validation.BindingResult;
  8. import org.springframework.validation.annotation.Validated;
  9. import org.springframework.web.bind.annotation.DeleteMapping;
  10. import org.springframework.web.bind.annotation.GetMapping;
  11. import org.springframework.web.bind.annotation.PathVariable;
  12. import org.springframework.web.bind.annotation.PostMapping;
  13. import org.springframework.web.bind.annotation.PutMapping;
  14. import org.springframework.web.bind.annotation.RequestBody;
  15. import org.springframework.web.bind.annotation.RequestMapping;
  16. import com.zfl9.model.Employee;
  17. import com.zfl9.service.EmployeeService;
  18. @Controller
  19. @RequestMapping(path = "/api/employees", produces = MediaType.APPLICATION_JSON_UTF8_VALUE)
  20. public class EmployeeRestController {
  21. @Autowired
  22. private EmployeeService employeeService;
  23. @GetMapping
  24. public ResponseEntity getAllEmployee() {
  25. List<Employee> employees = employeeService.getAllEmployee();
  26. if (employees.isEmpty())
  27. return ResponseEntity.noContent().build();
  28. return ResponseEntity.ok(employees);
  29. }
  30. @GetMapping("/{id}")
  31. public ResponseEntity getEmployee(@PathVariable int id) {
  32. return ResponseEntity.ok(employeeService.getEmployee(id));
  33. }
  34. @PostMapping
  35. public ResponseEntity createEmployee(@Validated(Employee.Create.class) @RequestBody Employee employee, BindingResult result) {
  36. if (result.hasErrors())
  37. return ResponseEntity.badRequest().body(result.getFieldErrors());
  38. employeeService.addEmployee(employee);
  39. return ResponseEntity.noContent().build();
  40. }
  41. @PutMapping("/{id}")
  42. public ResponseEntity updateEmployee(@PathVariable int id, @Validated(Employee.Update.class) @RequestBody Employee employee, BindingResult result) {
  43. if (result.hasErrors())
  44. return ResponseEntity.badRequest().body(result.getFieldErrors());
  45. employeeService.updateEmployee(employee);
  46. return ResponseEntity.ok(employee);
  47. }
  48. @DeleteMapping("/{id}")
  49. public ResponseEntity deleteEmployee(@PathVariable int id) {
  50. employeeService.deleteEmployee(id);
  51. return ResponseEntity.noContent().build();
  52. }
  53. @DeleteMapping
  54. public ResponseEntity deleteAllEmployee() {
  55. employeeService.deleteAllEmployee();
  56. return ResponseEntity.noContent().build();
  57. }
  58. }

然后使用 Postman 或 curl 测试吧。

添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注