SpringMVC核心接口
简单配置SpringMVC
SpringMVC的实现原理是通过Servlet拦截所有URL达到控制目的,所以web.xml的配置是必须的
ContextLoaderListener的作用就是启动Web容器时,自动装配ApplicationContext的配置信息,它实现了ServletContextListener接口,在启动容器时,就会执行它实现的方法。
使用ServletContextListener接口,开发者能够在为客户端提供服务之前向ServletContext中添加任意对象。
- contextConfigLocation
Spring的核心就是配置文件,可以说配置文件是Spring中必不可少的东西。而这个参数就是使Web与Spring的配置文件相结合的一个关键配置
包含了SpringMVC的请求逻辑,Spring用此类拦截Web请求并进行相应的逻辑处理
<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:applicationContext-mvc.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>springmvc</servlet-name> <url-pattern>*.do</url-pattern> </servlet-mapping>
<!-- 通过listener 像Servlet容器注册 Web容器启动时 初始化context-param的配置信息。-->
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
在classPath下面建立一个applicationContext-mvc.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"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.1.xsd
http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.1.xsd">
<!--会自动注册DefaultAnnotationHandlerMapping与AnnotationMethodHandlerAdapter -->
<mvc:annotation-driven></mvc:annotation-driven>
<!-- 批量扫描 注册成Spring的bean -->
<context:component-scan base-package="com.sk.service"></context:component-scan>
<!-- 视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/page/"></property>
<property name="suffix" value=".html"></property>
</bean>
<!-- 全局的异常处理 -->
<bean class="com.sk.util.CustomExceptionResolver"></bean>
</beans>
ContextLoaderListener
因为ContextLoaderListener实现了 ServletContextListener接口。
在web.xml配置这个监听器,启动容器时就会默认执行contextInitialized()方法。通过初始化WebApplicationContext实例,装配ApplicationContext的配置信息。
DispatcherServlet
DispatcherServlet有点类似HttpServlet接口中用于转发的接口RequestDispatcher
DispatcherServlet的初始化过程主要是将当前的Servlet类型实例转换为BeanWrapper类型实例,以便使用Spring提供的注入功能进行对应属性的注入。
下面是API中对DispatcherServlet的解释
- 它可以使用任何HandlerMapping实现(预先构建或作为应用程序的一部分提供)来控制请求到处理程序对象的路由。默认是BeanNameUrlHandlerMapping和DefaultAnnotationHandlerMapping。HandlerMapping对象可以在servlet的应用程序上下文中定义为bean,实现HandlerMapping接口,在出现时覆盖默认的HandlerMapping。HandlerMappings可以提供任何bean名
- 它可以使用任何HandlerAdapter;这允许使用任何处理程序接口。默认适配器分别是HttpRequestHandlerAdapter、SimpleControllerHandlerAdapter,用于Spring的HttpRequestHandler和控制器接口。还将注册一个默认的AnnotationMethodHandlerAdapter。HandlerAdapter对象可以作为bean添加到应用程序上下文中,覆盖默认的HandlerAdapter。与HandlerMappings一样,handleradapter可以提供任何bean名称
- 可以通过HandlerExceptionResolver指定dispatcher的异常解析策略,例如将某些异常映射到错误页面(也可以以rest形式抛出一个JSON)。默认是annotationmethodhandlertionresolver、ResponseStatusExceptionResolver和DefaultHandlerExceptionResolver。可以通过应用程序上下文覆盖这些HandlerExceptionResolvers。HandlerExceptionResolver可以提供任何bean的名称
-
它的视图解析策略可以通过ViewResolver实现指定,将符号视图名称解析为视图对象。默认是InternalResourceViewResolver。可以将ViewResolver对象作为bean添加到应用程序上下文中,覆盖默认的ViewResolver。可以给ViewResolvers赋予任何bean名称
下面分别解释上面三个关键接口
HandlerMapping
当客户端发出Request时DispatcherServlet会将Request提交给HandlerMapping,然后HandlerMapping根据WebApplicationContext(applicationContext-mvc.xml)的配置传回来给相应的Controller(就是Handler)。(利用了HanderAdapter)
handlerMapping的作用就是帮助我们管理URL和处理类之间的映射关系,简单的理解就是将一个或多个URL映射到一个或多个Spring Bean中。 它初始化完成的最重要的两个工作就是:
- 将URL与handler对应的关系保存在handlerMap集合中
setUrlMap(Map<String,?> urlMap) Set a Map with URL paths as keys and handler beans (or handler bean names) as values. |
- 前端控制器(DispatcherSerlvet)根据Request中的url去查找Handler, 返回 HandlerExecutionChain对象,而且在这个HandlerExecutionChain对象中将包含用户自定义的多个HandlerInterceptor
接口中的preHandler和postHandler分别在当前Handler执行前和执行后执行。类似Servlet规范中的Fliter。
getHandler(HttpServletRequest request) Return a handler and any interceptors for this request. |
工作中常用RequestMappingHandlerMapping去查找Handler(通过Handler的适配器去查找)
HandlerInterceptor
用户自定义的Interceptor实现HandlerInterceptor,放在HandlerExecutionChain,HandlerExecutionChain中会有多个handlerInterceptor对象。采用的责任链的模式的规则
前端控制器(DispatcherSerlvet)根据Request中的url去查找Handler之前执行handlerExecutionChain中所有handlerInterceptor拦截器的preHandle()方法,请求之后执行postHandler()。
处理器前方法采用先注册先执行,处理器后方法采用先注册后执行
利用HandlerInterceptor我们可以实现简单的权限处理。
HandlerAdapter
- HandlerAdapter初始化时会将这个HandlerAdapter对象保存在Dispatcher的HandlerAdapters集合中。当SpringMVC将某个URL对应到某个Handler时,将对应的Handler返回。
作为总控制器的派遣器Servlet通过处理映射得到处理器后,会轮询处理器适配器模块,查找能够处理当前HTTP请求的处理器适配器的实现。
处理器适配器模块根据处理映射返回的处理器类型,列如简单的控制器类型,注解控制器类型,或者远程调用处理器类型,来选择一个适当的处理器适配器的实现,从而适配当前的HTTP请求。
SpringMVC HandlerAdapter机制可以让Handler的实现更加灵活 可以参考适配器的设计模式
HandlerAdaptor接口的handle方法
public ModelAndView handle(HttpServletRequest request, HttpServletResponse response, Object handler)throws Exception {
return ((Controller)handler).handleRequest(request, response);
}
handle(HttpServletRequest request, HttpServletResponse response, Object handler) Use the given handler to handle this request. |
对于获取适配器的逻辑无非是遍历所有的适配器,返回合适的适配器并返回它,而某个适配器是否适用当前的Handler逻辑被封装在具体的适配器当中。
工作中常用的SimpleControllerHandlerAdapter此适配器能执行实现Controller接口的handler。
Resolver
当后台捕捉到的业务异常时,可以自定义的异常,然后通过实现HandlerExceptionResolver(处理异常解析器)来抛出自定义异常的信息
- 自定义一个异常
public class CustomException extends Exception{ public String msg; public CustomException(String msg) { super(msg); this.msg=msg; } public String getMsg() { return msg; } public void setMsg(String msg) { this.msg = msg; } }
Spring的主要工作就是把逻辑引导至HandlerExceptionResolver的resolveException()方法。
如果方法返回了null,则Spring会继续寻找其他实现了HandlerExceptionResolver接口的Bean,直到所有Bean都执行完成,或者返回了一个ModelAndView对象。
public class CustomExceptionResolver implements HandlerExceptionResolver{
@Override
public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler,
Exception exception) {
//handler 就是处理器适配器执行的Handler对象
response.setContentType("application/json;charset=UTF-8");
try {
PrintWriter writer = response.getWriter();
Map<String, Object> map = new HashMap<String, Object>();
map.put("success", false);
// 为安全起见,只有业务异常我们对前端可见,否则统一归为系统异常
if (exception instanceof CustomException) {
map.put("errorMsg", exception.getMessage());
} else {
map.put("errorMsg", "系统异常!");
}
writer.write(JSON.toJSONString(map));
writer.flush();
writer.close();
} catch (IOException e) {
e.printStackTrace();
}
return null;
}
}
在这里,我们不想让错误跳转到一个错误页面,所以 return null。(以JSON的数据格式 通过response write到前端)接到错误信息想怎么去做,前端自行处理。
视图解析器 将把逻辑视图名解析为具体的View(我比较崇尚rest风格,和前端只是json交互 跳转页面交给前端控制而不是后台)
应用程序中,我们的页面经常统一放在某个包下(/WEB-INF/page/),而且统一以某个名字结尾(.jsp或者.html),会统 实现类UrlBasedViewResolver:其中有两个方法
setSuffix 设置在构建URL时附加到视图名称的后缀。
setPreffix 在构建URL时,设置前缀以查看名称。
通过这两个方法,我们在return一个字符串时,可以把页面的前缀和后缀省略,简化了编码。
注:MappingJackson2JsonView视图不是逻辑视图,不需要ViewResolver去定位视图,它会将数据模型渲染为Json数据集展示给用户查看。
将国际化的信息设置在Session中,这样就能读取Session中的信息去确定用户的国际化区域。
这是最常用让用户选择国际化的手段
MappingJacksonHttpMessageConverter
SpringMVC进入控制器方法前,当遇到@ResponseBody后,处理器就会记录这个方法的响应类型为JSON数据集。
当执行完控制器返回后,处理器就会启用结果解析器(ResultResolver)去解析这个结果。
它会轮询注册给SpringMVC的HttPMessageConverter接口的实现类。因为MappingJacksonHttpMessageConverter这个实现类已经被SpringMVC注册,
加上SpringMVC将控制器的结果类型标明为JSON。当然有时候会轮询不到匹配的HttpMessageConverter,那么它就会交由SpringMVC后续流程去处理。
如果控制器返回结果被MappingJacksonHttpMessageConverter进行了转换,那么后续的模型和视图(ModelAndView)就返回null,这样视图解析器和视图渲染就不在会被执行