系列文章目录
文章目录
一、SpringMVC开发步骤
1.首先添加所需jar包
org.springframework.web-4.x.x.RELEASE.jar、org.springframework.webmvc-4.x.x.RELEASE.jar
示例:
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context-support</artifactId>
<version>${spring.version}</version>
</dependency>
2. 配置自动装载的前端控制器
org.springframework.web.servlet.DispatcherServlet
示例:
<servlet>
<servlet-name>springM VC</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springM VC</servlet-name>
<url-pattern>*.htm</url-pattern>
</servlet-mapping>
3. 添加SpringMVC框架所需的配置文件
默认情况下:放置在WEB-INF目录下名为[DispatcherServlet-name]-servlet.xml
4. 在SpringMVC配置文件中启用自动扫描注解类(扫描MVC的控制器)
示例:
<context:component-scan base-package="cn.itvk.web"/>
5. 在SpringMVC配置文件中启用MVC基于注解方式的控制器映射
<mvc:annotation-driven />
6. 创建并映射控制器类
@Controller、@RequestMapping
示例:
@Controller
public class HelloController {
@RequestMapping("/hello.htm")
public ModelAndView sayHello() throws Exception{
ModelAndView mav = new ModelAndView();
mav.addObject("user", "SpringMVC"); //添加模型数据
mav.setViewName("result"); //设置视图逻辑名--视图解析器---> /result.jsp
return mav;
}
}
7. 在SpringMVC配置文件中配置视图解析器
InternetSourceViewResolver
示例:
<bean id="viewResolver"
class="org.springframework.web.servlet.view.InternalResourceViewR esolver">
<property name="viewClass" value="org.springframework.web.servlet.view.JstlView" />
<property name="prefix" value="/" />
<property name="suffix" value=".jsp" />
</bean>
8. 创建视图界面JSP
二、SpringMVC的核心组件
1. DispatcherServlet
前端控制器,负责接收所有要SpringMVC处理请求并负责分发给处理器。
- 更改自定义的SpringMVC配置文件
<servlet>
<servlet-name>springM VC</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>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springM VC</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
- 更改了它的URL匹配模式为/,所有的客户端的请求都交给DispatcherServlet来处理。
需要在springmvc配置文件中添加如下配置,来启用容器默认的DefaultServletHandler来处理所有静态内容
<mvc:default-servlet-handler/>
- 注意事项
- 原来的Dao层和service层等IOC装配和AOP配置应该继续放置在spring-bean.xml文件,并用ContextLoaderListener来加载,它创建出来的叫做根WebApplicationContext的实例。
- SpringMVC的DispatcherServlet会自动创建一个自己的WebApplicationContext实例,这个实例中应该只配置跟SpringMVC相关的Bean。这个Bean实例会继承根WebApplicationContext(由ContextLoaderListener创建的)中定义的Bean。
- SpringMVC配置文件中启用自动扫描收管Bean时,只扫描MVC的处理器
<!-- 启用自动扫描添加@Controller或@ControllerA dvice的处理器类 -->
<context:component-scan base-package="cn.itvk.web" use-default-filters="false">
<context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
<context:include-filter type="annotation" expression="org.springframework.web.bind.annotation.Controller Advice"/>
</context:component-scan>
2. 处理器映射
- 将web请求映射到正确的处理器上,在springmvc配置文件中添加```mvc:annotation-driven/标签
- 处理器类上要添加 @Controller注解
- 将请求路径映射到处理器的请求处理方法上:@RequestMapping。
3. 处理器
也叫(业务)控制器,负责请求处理流程的调度
-
用于请求映射的注解类型:
- @Controller:定义处理器(类级)。属性value用于指定本类的实例在Spring容器中的标识名。默认时为小写字母开头的类名。
@ControllerAdvice:(类级),3.2版本中新增了“控制器增强”注解。 - @RequestMapping:定义请求到控制器功能方法的映射规则(类型级、方法级),常用属性:
a) String[] value:指定要匹配的请求路径模式串(Ant风格和正则表达式风格)。如:"/prod/**/{id}"、“/prod/{cateId:\d+}”
String[] path:
b) RequestMethod[] method:指定请求方式。如:RequestMethod.GET、RequestMethod.POST
c) String[] params:指定请求中的参数规则。
如:“myParam=myValue”、“myParam!=myValue”、"!myParam"
d) String[] headers:指定请求中的头字段规则。
e) String[] consumes:指定请求中的Content-Type规则。
默认是“application/x-www-form-urlencoded”。上传文件时要改“multipart/form-data”
f) String[] produces:指定响应的Content-Type规则。会根据响应内容自动设置值。 - Spring4.3提供了几个新的请求映射注解类型:
<mvc:default-servlet-handler/> <!-- 启用自动扫描添加@Controller或@ControllerA dvice的处理器类 --> <context:component-scan base-package="cn.itvk.web" use-default-filters="false"> <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/> <context:include-filter type="annotation" expression="org.springframework.web.bind.annotation.Controller Advice"/> </context:component-scan>
a) @GetMapping、@PostMapping、 b) @PutMapping、@DeleteMapping、@PatchMapping
- @Controller:定义处理器(类级)。属性value用于指定本类的实例在Spring容器中的标识名。默认时为小写字母开头的类名。
-
请求处理方法的签名必须遵守约定
- 参数的可用类型:
a) ServletRequest/ServletResponse/HttpSession:Servlet常用对象。
b) Java基本数据类型(包装类类型)和String:会按名称匹配方式来绑定对应的请求参数值。
c) 任何标注了 @RequestParam 的参数:会绑定显式指定名称的请求参数的值。
d) 任何标注了 @PathVariable 的参数:会绑定请求URL中的路径参数值
e) 任何标了 @RequestHeader 或 @RequestBody 的参数:会绑定显示指定的值。
f) java.util.Map/Model/ModelMap/ModelAndView 对象:模型对象。
g) 命令/表单对象:把请求中的参数值以名称匹配方式绑定到命令/表单对象的属性中。 - 返回值的可用类型:
a) void:逻辑视图名由请求处理方法对应的URL确定(惯例优先)
示例:
@RequestMapping("/welcome") public void welcomeHandler() { }
则对应的逻辑视图名为"welcome",如果没有对应的视图则表示手动写出response响应
b) String:返回的字符串作为逻辑视图名。
c) java.util.Map/ui.Model/ui.ModelMap:和返回类型为void一样。返回的ModelMap将被作为请求对应的模型对象,可在Web视图中被访问到。
d) ModelAndView:传统的ModelAndView对象 - 参数的可用类型:
-
常用的请求数据绑定的注解类型
- @RequestParam:绑定请求参数到请求处理方法参数(参数级)。注意:基本类型参数必须有值,否则抛出异常。
a) String value:指定要绑定的请求参数的名称。默认为方法参数名。
b) boolean required:指定该参数是否为必须的。默认false
c) String defaultValue:指定该参数的默认值。缺省没有默认值 - @PathVariable:绑定请求URL中的模板变量到处理方法的参数(参数级)。从而支持RESTful架构风格
a) String value:指定要绑定的模板变量名。 - @RequestBody:绑定该请求的消息体内容(参数级)
- @RequestParam:绑定请求参数到请求处理方法参数(参数级)。注意:基本类型参数必须有值,否则抛出异常。
3. ModelAndView
模型视图对象, 封装了用于渲染页面的模型对象和视图逻辑名。成员属性有:
- ModelMap model:存放模型数据的Map结构。添加模型数据的方法有(相当于request.setAttribute(…))
- void addObject(String, Object) – 用显式名字添加
- void addObject(Object) – 用默认名添加 (惯例优先)
- View view:视图对象。用于设置逻辑视图名的方法:
- void mav.setView(View v);
- void mav.setViewName(String viewName);
视图解析器
完成逻辑视图名映射到视图对象的功能。(还支持视图解析链)。常用的内置视图解析器:
- InternalResourceViewResolver:将视图名直接解析成对应的视图文件。可指定前缀、后缀、生成视图时使用的视图类型。
- VelocityViewResolver/FreeMarkerViewResolver:使用模板引擎的视图解析器。
视图模板
SpringMVC支持多种视图技术,常用View子类:
- JSP视图:
- InternalResourceView(JSP) / JstlView(JSP + JSTL)
- RedirectView:通过给视图名加前缀方式"redirect:资源完全路径名"
- 模板视图:VelocityView (Velocity)、FreeMarkerView (FreeMarker)
- 其它视图:TilesView 、MappingJackson2JsonView、AbstractPdfView、AbstractExcelView
拦截器
SpringMVC的处理器映射支持拦截器。
- 类似于Servlet开发中的过滤器Filter,用于对处理器进行预处理和后处理。
- 本质也是AOP,即符合横切关注点的功能都可用拦截器实现。
- 拦截器接口:
public interface HandlerInterceptor {
//预处理回调方法,实现处理器的预处理(如登录检查),第3个参数为请求处理器(Controller);
//返回值:true表示继续流程;false表示流程中断
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception;
//后处理回调方法,实现处理器的后处理(但在渲染视图之前回调)。
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception;
//整个请求处理完毕回调方法,即在视图渲染完毕时回调。
public void afterCompletion(HttpServletRequest request, HttpS ervletR esponse response, Object handler, Exception ex) throws Exception;
}
- 在springmvc配置文件中进行注册
<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/**"/>
<bean class="cn.itvk.web.interceptor.LogInterceptor"/>
</mvc:interceptor>
</mvc:interceptors>
- 常见应用场景
- 日志记录:记录请求信息的日志。
- 权限检查:登录检测。<小心使用,因为它不拦截JSP>
- 性能监控:计算请求的处理时间。
- 通用行为:读取cookie信息、提取Locale、Theme信息等。
- OpenSessionInView。