一、SpringMVC 简介
1. MVC 设计模式
M:Model(模型)
- 模型负责业务逻辑。
- 包含两层:业务数据和业务处理逻辑。比如实体类、DAO、Service都属于模型层。
V:View(视图)
- 视图负责显示页面和用户交互(收集用户信息)。视图层的组件是不包含业务逻辑和控制逻辑的JSP。
C:Controller(控制层)
- 控制层是视图层和模型层之间的桥梁,用于控制流程。比如:Servlet、Action。
2. 什么是SpringMVC
SpringMVC在项目中拦截用户请求,它的核心Servlet即DispatcherServlet承担中介或是前台这样的职责,将用户请求通过HandlerMapping去匹配Controller,Controller就是具体对应请求所执行的操作。SpringMVC相当于SSH框架中struts。
SpringMVC是Spring框架一个非常重要的功能模块。
实现了MVC结构,便于简单、快速开发MVC结构的Web程序。
它提供的API封装了Web开发中常用的功能,简化Web过程。
3. SpringMVC 的核心组件和处理流程
Spring MVC 提供了 Model、View 和 Controller 相关的主要实现组件:
- DispatcherServlet(控制器,请求入口)
- HandlerMapping(控制器,请求派发)
- Controller(控制器,请求处理流程)
- ModelAndView(模型,封装业务处理结果和视图)
- ViewResolver(视图,视图显示处理器)
流程图如下:
1)浏览器向Spring发出请求,请求交给前端控制器DispatcherServlet处理。
2)前端控制器通过HandlerMapping找到相应的Controller组件处理请求。
3)执行Controller组件约定方法处理请求,在约定方法调用模型组件完成业务处理。约定方法可以返回一个ModelAndView对象,封装了业务处理结果的数据和视图名称信息。
4)控制器接收到ModelAndView之后,调用ViewResolve组件,定位View(JSP)并传递数据信息,生成响应界面结果。
二、基于XML配置的MVC应用
1. 搭建SpringMVC 环境
1)创建Web项目
2)导入支持jar包
commons-logging-1.1.3.jar
spring-beans-4.0.0.RELEASE.jar
spring-context-4.0.0.RELEASE.jar
spring-core-4.0.0.RELEASE.jar
spring-expression-4.0.0.RELEASE.jar
spring-web-4.0.0.RELEASE.jar
spring-webmvc-4.0.0.RELEASE.jar
3)添加Spring的xml配置文件
名称可以自定义,例如spring-mvc.xml
4)在web.xml中配置DispatcherServlet前端控制器组件
DispatherServlet组件在SpringMVC中以提供,只需配置即可。
2. 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:spring-mvc.xml</param-value>
</init-param>
<!-- 标记容器启动时加载当前 Servlet -->
<load-on-startup>1</load-on-startup>
<!--
标记容器是否在启动时加载这个 Servlet。
当值为 0 或者大于 0 时,表示容器在应用启动时就加载这个 Servlet。
当值是一个负数或者没有指定时,则指示容器在该 Servlet 被选择时才加载。
正数的值越小,启动该 Servlet 的优先级越高。
-->
</servlet>
<servlet-mapping>
<servlet-name>springmvc</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>
3. Controller 组件
public class HelloController implements Controller {
public ModelAndView handleRequest(HttpServletRequest req,HttpServletResponse res) throws Exception{
System.out.println("Hello,Spring MVC!");
return new ModelAndView("hello");
}
}
4. ModelAndView 组件
ModelAndView :该对象封装模型数据和视图名响应信息。
ModelAndView 构造器 :
ModelAndView(String viewName)
ModelAndView(String viewName, Map model)
// viewName 是 JSP 页面的名称。
// model 的数据存储到 request 的 attitude 中。
5. HandlerMapping 组件
通过 HandlerMapping 组件,DispatcherServlet 控制器可以将客户端的 HTTP 请求映射到Controller 组件上。
SimpleUrlHandlerMapping 维护一个 HTTP 请求和 Controller 映射关系表(Map),根据列表对应关系调用 Controller。
SimpleUrlHandlerMapping 的使用:
<bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
<property name="mappings">
<props>
<prop key="/login.do">loginController</prop>
<prop key="/hello.do">helloController</prop>
</props>
</property>
</bean>
<bean id="helloController" class="com.web.HelloController"/>
6. ViewResolver 组件
所有的 Controller 组件都返回 ModelAndView 对象,封装了视图名。Spring 中的视图以名字为标识,视图解析器 ViewResolver 通过名字来解析视图。
Spring 提供了多种视图解析器:
UrlBasedViewResolver:将视图名直接解析成对应的 URL,不需要显式的映射定义。
如果你的视图名和视图资源的名字,就可使用该解析器,而无需进行映射。
InternalResourceViewResolver:UrlBasedViewResolver 的子类,支持InternalResourceView(对 Servlet 和 JSP 的包装)以及其子类 JstlView 和 TilesView
响应类型。
XmlViewResolver:支持用 xml 文件定义具体的响应视图文件。
VelocityViewResolver/FreeMarkerViewResolver:UrlBasedViewResolver 的子类,它能
支持 Velocity 和 FreeMarker 等视图技术。
InternalResourceViewResolver 的使用:
<bean id="jspViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/jsp/"/>
<property name="suffix" value=".jsp"/>
</bean>
三、基于注解配置的 MVC 应用
1. @Controller 注解
推荐使用@Controller 注解声明 Controller 组件,这样可以使得 Controller 的定义更加灵活,可以不用实现 Controller 接口,请求处理的方法也可以灵活定义。
@Controller
public class HelloController{
public String execute() throws Excetion {
return "hello";
}
}
为了使@Controller 注解生效,需要在 Spring 的 xml 配置文件中开启组件扫描定义,并
指定 Controller 组件所在包。
<context:component-scan base-package="com.controller"/>
2. @RequestMapping 注解
@RequestMapping 可以用在类定义和方法定义之上。
@RequestMapping 表明这个类或方法与哪一个客户请求对应。
@Controller
@RequestMapping("/demo")
public class HelloController{
@RequestMapping("/hello.do")
public String execute() throws Exception{
return "hello";
}
}
开启@RequestMapping 注解映射时,需要在 Spring 的 xml 配置文件定义RequestMappingHandlerMapping(类定义前)和 RequestMappingHandlerAdapter(方法定义前)两个 Bean 组件。
//Spring3.1 版本之前需要定义DefaultAnnotationHandlerMapping和AnnotationMethodHandlerAdapter两个组件。
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandl
erMapping"/>
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandl
erAdapter"/>
注意:从 Spring3.2 版本之后开始使用简化的 xml 配置来定义RequestMappingHandlerMapping 和 RequestMappingHandlerAdapter。
<mvc:annotation-driven/>
四、SpringMVC 开发技巧
1. 接收请求参数值
1)使用 HttpServletRequest 获取
@RequestMapping("/login.do")
public String checkLogin1(HttpServletRequest req){
String name = req.getParameter("name");
String pwd = req.getParameter("pwd");
User user = userService.login(name, pwd);
//...处理过程省略
return "success";
}
2)使用@RequestParam 注解
Spring 会自动将表单参数注入到方法参数(名称一致)。
优点:参数类型自动转换,但是可能出现类型转换异常。
@RequestMapping("/login.do")
public String checkLogin2(String name,@RequestParam("pwd")String password,HttpServletRequest req){
User user = userService.login(name,password);
//...处理过程省略
return "success";
}
3)使用自动机制封装成 Bean 对象
定义 User 实体类,属性名与表单组件的 name 相同
<form action="login3.do">
用户名:<input type="text" name="name"/>
<br/>
密码:<input type="password" name="pwd"/>
<br/>
<input type="submit" value="登录"/>
</form>
public class User {
private String name;
private String pwd;
//省略 set 和 get 方法
}
//在 Controller 组件处理方法中定义 User 类型参数。
@RequestMappding("/login.do")
public String checkLogin3(User user) {
User user = userService.login(user.getName(),user.getPwd());
//...处理过程省略
return "success";
}
2. 向页面传值
1)直接使用 HttpServletRequest 和 Session
request.setAtttibute(); 和 session.setAttribute();
2)使用 ModelAndView 对象
@RequestMapping("/login4.do")
public ModelAndView checkLogin4(String name, String pwd) {
User user = userService.login(name.pwd);
Map<String,Object> data = new HashMap<String,Object>();
data.put("user",user);
return new ModelAndView("success",data);
}
3)使用 ModelMap 参数对象
在 Controller 处理方法中追加一个 ModelMap 类型参数。
ModelMap 数据会利用 HttpServletRequest 的 Attribute 传递到 JSP 页面中。
@RequestMapping("/login5.do")
public String checkLogin5(String name, String pws, ModelMap model) {
User user = userService.login(name,pwd);
model.setAttribute("user",user);
return "success";
}
4)使用@ModelAttribute 注解
@RequestMapping("/login6.do")
public String checkLogin6(@ModelAttribute("User") User user) {
//...处理过程省略
return "success";
}
@ModelAttribute("name")
public String getName(){
return name;
}
3. Session 存储
可以使用 HttpServletRequest 的 getSession()方法访问。
@RequestMapping("/login5.do")
public String checkLogin5(String name,String pwd,ModelMap model,HttpServletRequest
req){
User user = userService.login(name,pwd);
req.getSession().setAttribute("loginUser",user);
model.addAttribute("user",user);
return "success";
}
4. 重定向视图
使用 RedirectView:
如果 Controller 的请求处理方法返回的是 ModelAndView 对象,可以使用RedirectView 方法重定向。
public ModelAndView checkLogin() {
RedirectView view = new RedirectView("login.do");
return new ModelAndView(view);
}
使用 redirect:前缀:
如果 Controller 的请求处理方法返回的是 String 类型,可以使用"redirect:前缀"方法重定向。
public String checkLogin() {
return "redirect:login.do";
}
5. 中文乱码解决方案
在表单提交时,如果遇到中文字符会出现乱码现象,Spring 提供了一个CharacterEncodingFilter 过滤器,可以用于解决乱码问题。
CharacterEncodingFilter 注意事项:
①表单数据以 POST 方式提交。
②在 web.xml 中配置 CharacterEncodingFilter 过滤器。
③页面编码和过滤器指定编码要保持一致。
<filter>
<filter-name>encodingFilter</filter-name>
<filter-class>
org.springframework.web.filter.CharacterEncodingFilter
</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
6. 异常处理
1)在springmvc上配置全局异常
<bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
<property name="exceptionMappings">
<pros>
<prop key="java.lang.Exception">error</prop>
<prop key="com.web.TimeoutException">login</prop>
</props>
</property>
</bean>
web.xml中部分代码段
<!-- springmvc -->
<servlet>
<servlet-name>spring</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- 自定义spring mvc的配置文件名称和路径 -->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springMVC/spring-servlet.xml</param-value>
</init-param>
<!-- 自定义启动顺序,让这个Servlet随Servlet容器一起启动 -->
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>spring</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
<!-- 异常处理 -->
<!-- 接收空指针错误 -->
<error-page>
<exception-type>java.lang.NullPointerException</exception-type>
<location>/WEB-INF/views/commons/error/error_web_null.jsp</location>
</error-page>
<!-- 404 页面不存在错误 -->
<error-page>
<error-code>404</error-code>
<location>/WEB-INF/views/commons/error/error_web_404.jsp</location>
</error-page>
<!-- 接收405错误 -->
<error-page>
<error-code>405</error-code>
<location>/WEB-INF/views/commons/error/error405.jsp</location>
</error-page>
<!-- 500 服务器内部错误 -->
<error-page>
<error-code>500</error-code>
<location>/WEB-INF/views/commons/error/error500.jsp</location>
</error-page>
2)实现 HandlerExceptionResolver 接口自定义异常处理器
public class MyMappingExceptionResolver implements HandlerExceptionResolver{
public ModelAndView resolveException(HttpServletRequest
req,HttpServletResponse res,Object Handler, Exception ex) {
Map<String,Object> model = new HashMap<String,Object>();
model.put("ex", ex)
//根据不同异常类型返回不同视图
return new ModelAndView("error",model);
}
}
自定义的异常处理器需要在 Spring 的 xml 配置文件中定义。
<bean id="exceptionHandler"class="com.web.MyMappingExceptionResolver"/>
3)使用@ExceptionHandler 注解实现异常处理
首先编写一个 BaseController 类。
然后其他的 Controller 继承 BaseController 类即可
适合局部处理有“处理过程”的异常
public class BaseController {
@ExceptionHandler
public String execute(HttpServletRequest req,Exception ex) {
req.setAttribute("ex",ex);
//根据异常类型返回不同视图
return "error";
}
}