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

学习目标

● 了解Spring MVC核心类的作用

● 掌握Spring MVC常用注解的使用

Spring 2.5之前，Controller，Spring 2.5之后，注解

12.1 DispatcherServlet

<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>元素不存在，则应用程序会在第一个Servlet请求时加载该Servlet。

如果没有通过<init-param>元素配置Spring MVC配置文件的路径，则应用程序会默认到WEB-INF目录下寻找如下方式命名的配置文件。

servletName-servlet.xml

其中，servletName指的是部署在web.xml中的DispatcherServlet的名称

12.2 Controller注解类型

org.springframework.stereotype.Controller@Controller

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

<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://www.springframework.org/schema/beans"

       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

       xmlns:context="http://www.springframework.org/schema/context"

       xsi:schemaLocation="http://www.springframework.org/schema/beans

http://www.springframework.org/schema/beans/spring-beans-4.3.xsd

http://www.springframework.org/schema/context

http://www.springframework.org/schema/context/spring-context-4.3.xsd">

<!--    指定需要扫描的包-->

    <context:component-scan base-package="com.itheima.controller"/>

</beans>

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

12.3 RequestMapping注解类型

12.3.1 @RequestMapping注解的使用

org.springframework.web.bind.annotation.RequestMapping注解类型@RequestMapping

1．标注在方法上

@Controller

public class FirstController {

    @RequestMapping(value="/firstController")

    public ModelAndView handleRequest(HttpServletRequest request,HttpServletResponse response){

        return  new ModelAndView();

    }

}

http://localhost:8080/chapter12/firstController

2．标注在类上

@Controller

@RequestMapping(value = "/hello")

public class FirstController {

    @RequestMapping(value="/firstController")

    public ModelAndView handleRequest(HttpServletRequest request,HttpServletResponse response){

        return  new ModelAndView();

    }

}

http://localhost:8080/chapter12/hello/firstController

12.3.2 @RequestMapping注解的属性

只有value属性可以省略value=

12.3.3 组合注解

Spring框架的4.3版本中，引入了组合注解。

· @GetMapping：匹配GET方式的请求。@RequestMapping(method = RequestMethod.GET)的缩写。

@RequestMapping(value="/user/{id}", method=RequestMethod.GET) 

public String selectUserById(String id){ 

    ... 

}

 

@GetMapping(value="/user/{id}") 

public String selectUserById(String id){ 

    ... 

}

· @PostMapping：匹配POST方式的请求。

· @PutMapping：匹配PUT方式的请求。

· @DeleteMapping：匹配DELETE方式的请求。

· @PatchMapping：匹配PATCH方式的请求。

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

参数类型：

· javax.servlet.ServletRequest /javax.servlet.http.HttpServletRequest

· javax.servlet.ServletResponse /javax.servlet.http.HttpServletResponse

· javax.servlet.http.HttpSession

·org.springframework.web.context.request.WebRequest或org.springframework.web.context.request.NativeWebRequest

· java.util.Locale

· java.util.TimeZone (Java 6+) / java.time.ZoneId (on Java 8）

· java.io.InputStream / java.io.Reader

· java.io.OutputStream / java.io.Writer

· org.springframework.http.HttpMethod

· java.security.Principal

· @PathVariable、@MatrixVariable、@RequestParam、@RequestHeader、@RequestBody、@RequestPart、@SessionAttribute、@RequestAttribute注解

· 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.ui.Model类型不是一个Servlet API类型，而是一个包含了Map对象的Spring MVC类型。如果方法中添加了Model参数，则每次调用该请求处理方法时，Spring MVC都会创建Model对象，并将其作为参数传递给方法。

 /org.springframework.validation.BindingResult·org.springframework.web.bind.support.SessionStatus

· org.springframework.web.util.UriComponentsBuilder

返回类型：

· ModelAndView：可以添加Model数据，并指定视图

· Model

· Map

· View

· String：可以跳转视图，但不能携带数据

· void：主要在异步请求时使用，它只返回数据，而不会跳转视图。

· HttpEntity<? >或ResponseEntity<? >

· Callable<? >

· DeferredResult<? >

由于ModelAndView类型未能实现数据与视图之间的解耦，所以在企业开发时，方法的返回类型通常都会使用String。

@RequestMapping(value="/firstController") 

public String handleRequest(HttpServletRequest request, HttpServletResponse response, Model model) {     // 向模型对象中添加数据 

    model.addAttribute("msg", "这是我的第一个Spring MVC程序");

    // 返回视图页面 

    return "/WEB-INF/jsp/first.jsp"; 

}

1.redirect重定向

@RequestMapping(value="/update")

public String update(HttpServletRequest request, HttpServletResponse response, Model model){ 

    ...

     // 重定向请求路径 

    return "redirect:queryUser"; 

}

2.forward请求转发

@RequestMapping(value="/toEdit") 

public String update(HttpServletRequest request, HttpServletResponse response, Model model){ 

    ... 

    // 请求转发 

    return "forward:editUser";

 }

12.4 ViewResolver（视图解析器）

<!-- 定义视图解析器 -->

<bean id="viewResolver" class= "org.springframework.web.servlet.view.InternalResourceViewResolver">

    <!-- 设置前缀 -->

    <property name="prefix" value="/WEB-INF/jsp/" />

    <!-- 设置后缀 -->

    <property name="suffix" value=".jsp" />

</bean>

设置好视图解析器后，在访问时视图解析器会自动地增加前缀和后缀。

12.5 应用案例——基于注解的Spring MVC应用

1．搭建项目环境

spring-aop-4.3.6.RELEASE.jar

2．修改配置文件

springmvc-config.xml

<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://www.springframework.org/schema/beans"

       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

       xmlns:context="http://www.springframework.org/schema/context"

       xsi:schemaLocation="http://www.springframework.org/schema/beans

http://www.springframework.org/schema/beans/spring-beans-4.3.xsd

http://www.springframework.org/schema/context

http://www.springframework.org/schema/context/spring-context-4.3.xsd">

<!--    指定需要扫描的包-->

 

 

    <context:component-scan base-package="com.itheima.controller"/>

    <!-- 定义视图解析器 -->

    <bean id="viewResolver" class= "org.springframework.web.servlet.view.InternalResourceViewResolver">

        <!-- 设置前缀 -->

        <property name="prefix" value="/WEB-INF/jsp/" />

        <!-- 设置后缀 -->

        <property name="suffix" value=".jsp" />

    </bean>

</beans>

3．修改Controller类

@Controller

@RequestMapping(value = "/hello")

public class FirstController {

    @RequestMapping(value="/firstController")

    public String handleRequest(HttpServletRequest request,

                                HttpServletResponse response,

                                Model model)throws Exception{

        model.addAttribute("msg","first springmvc");

        return  "first";

    }

}

String类型的返回值无法携带数据，所以需要通过参数Model对象的addAttribute()方法来添加数据信息。

出现问题：SpringMVC项目配置没问题但是运行时404

解决方法：

项目结构

创建出一个lib文件夹，把所有小的jar包导入到文件夹里

其他：耗时三天，狠狠无语

【思考题】

1．请简述@Controller注解的使用步骤。

导入aop的jar包使注解生效

在controller类上添加@Controller

在springmvc-config上添加context上下文命名空间

添加包扫描标签<context:component-scan:>扫描controller所在的包

 

2．请列举请求处理方法的参数类型和返回类型（至少5个）。

参数类型

httpservletrequest

httpservleteresponse

model

modelandview

sqlsession×【httpsession】

 

返回类型

modelandview

string

void

model

map