Java EE之第12章Spring MVC的核心类和注解

在Spring2.5之前，只能使用实现Controller接口的方式来开发一个控制器。在Spring2.5之后，新增加了基于注解的控制器以及其他一些常用注解，这些注解的使用极大地减少了程序员的开发工作

12.1DispatcherServlet

DispatcherServlet：在程序中充当着前端控制器的角色，全名是org.springframework.servlet.DispatcherServlet。在使用时，只需将其配置在项目的web.xml文件中，其配置代码如下：

<servlet>
	    <!-- 配置前端过滤器 -->
		<servlet-name>springmvc</servlet-name>
		<servlet-class>
              org.springframework.web.servlet.DispatcherServlet
         </servlet-class>
		<!-- 初始化时加载配置文件 -->
		<init-param>
			<param-name>contextConfigLocation</param-name>
			<param-value>classpath:springmvc-config.xml</param-value>
		</init-param>
		<!-- 表示容器在启动时立即加载Servlet -->
		<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
		<servlet-name>springmvc</servlet-name>
		<url-pattern>/</url-pattern>
</servlet-mapping>

在上述代码中，<load-on-startup>元素和<init-param>元素都是可选的。如果<load-on-startup>元素的值为1，则在应用程序启动时会立即加载该Servlet；如果<load-on-startup>元素不存在，则应用程序会在第一个Servlet请求时加载Servlet。如果<init-param>元素存在并且通过其子元素配置Spring MVC配置文件路径，则应用程序在启动时会加载配置路径下的配置文件；如果没有通过<init-param>元素配置，则应用程序会默认到WEB-INF目录下寻找如下方式命名的配置文件：

servletName-servlet.xml

其中，servletName指的是部署在web.xml中的DispatcherServlet的名称，在上面web.xml中的配置代码中即为springmvc，而-servlet.xml是配置文件名的固定写法，所有应用程序会在WEB-INF下寻找springmvc-servlet.xml

12.2Controller注解类型

Controller注解类型：用于指示Spring类的实例是一个控制器，其注解形式为@Controller。该注解在使用时不需要再实现Controller接口，只需要将@Controller注解加入到控制器类上，然后通过Spring的扫描机制找到标注了该注解的控制器即可

为了保证Spring能够找到控制器类，还需要在Spring MVC的配置文件中添加相应的扫描配置信息，具体如下：
（1）在配置文件的声明中引入spring-context
（2）使用<context:component-scan>元素指定需要扫描的类包

<!-- 指定需要扫描的包 -->
<context:component-scan base-package="类包位置"

<context:component-scan>元素的属性base-package指定了需要扫描的类包位置，在运行时，该类包及其子包下所有标注了注解的类都会被Spring所处理

Controller接口的实现类只能处理一个单一的请求动作，而基于注解的控制器可以同时处理多个请求动作，在使用上更加灵活

注意：在使用注解方式时，程序的运行需要依赖Sprng的AOP包，因而需要向lib目录中添加spring-aop-4.3.6.RELEASE.jar，否则程序运行时会报错

12.3RequestMapping注解类型

12.3.1RequestMapping注解的使用

Spring通过@Controller注解找到相应的控制器类后，还需要知道控制器内部对每一个请求是如何处理的，这就需要使用RequestMapping注解类型

RequestMapping注解类型：用于映射一个请求或一个方法，其注解形式为@RequestMapping，可以使用该注解标注在一个方法或一个类上

1.标注在方法上：
当标注在一个方法上时，该方法将成为一个请求处理方法，它会在程序接收到对应的URL请求时被调用

2.标注在类上：
当标注在一个类上时，该类中的所有方法都映射为相对于类级别的请求，表示该控制器所处理的所有请求都被映射到value属性值所知道的路径下

12.3.2RequestMapping注解的属性

RequestMapping注解类型：可以指定value属性外，还可以指定其他一些属性，这些属性如下：

在表12-1中，所有属性都是可选的，但其默认属性是value。当value是其唯一属性时，可以省略属性名，例如下面两种标注的含义相同：

@RequestMapping（value="/firstController"）
@RequestMapping（"/firstController"）

13.3.3组合注解

在Spring框架的4.3版本，引入了组合注解，来帮助简化常用的HTTP方法的映射，并更好地表达被注解方法的语义。其组合注解如下所示：

（1）@GetMapping：匹配GET方式的请求

（2）@PostMapping：匹配POST方式的请求

（3）@PutMapping：匹配PUT方式的请求

（4）@DeleteMapping：匹配DELETE方式的请求

（5）@PatchMapping：匹配PATCH方式的请求

以@GetMapping为例，该组合注解是@RequestMapping(method = RequestMethod.GET)的缩写，它会将HTTP GET映射到特定的处理方法上

13.3.4请求处理方法的参数类型和返回类型

例如：在请求方法中需要访问HttpSession对象，则可以添加HttpSession作为参数，Spring会将对象传递给方法：

@RequestMapping(value="/first")
public String login(HttpSession session){
    return "login";
}

在请求处理方法中，可以出现的参数类型如下：
javax.servlet.ServletRequest或javax.servlet.http.HttpServletRequest
javax.servlet.ServletResponse或java.servlet.http.HttpServletResponse
javax.servlet.http.HttpSession
org.springframework.web.context.request.WebRequest或org.springframework.web.context.request.NativeWebRequest
java.util.Locale
java.io.InputStream或java.io.Reader
java.io.OutputStream或java.io.Writer
java.security.Principal
HttpEntity<?>
java.util.Map
org.springframework.ui.Model
org.springframework.ui.ModelMap
org.springframework.web.servlet.mvc.support.RedirectAttributes
org.springframework.validation.Errors
org.springframework.validation.BindingResult
org.springframework.web.bind.support.SessionStatus
org.springframework.web.util.UriComponentsBuilder
@PathVariable、@@MatrixVariable注解
@RequestParam、@RequestHeader、@RequestBody、@RequestPart注解

Spring MVC所支持的常见方法返回类型如下：
ModelAndView
Model
Map
View
String
void
HttpEntity或ResponseEntity
Callable
DeferredResult

ModelAndView类型中可以添加Model数据，并指定视图；String类型的返回值可以跳转视图，但是不能携带数据；void类型主要在异步请求时使用，它只返回数据，而不会跳转视图

String类型可以返回视图页面，还可以返回重定向与请求转发：
（1）redirect重定向
（2）forward请求转发

12.4ViewResolver(视图解析器)

Spring MVC中的视图解析器负责解析视图，可以通过在配置文件中定义一个ViewResolver来配置视图解析器