Spring Web框架介绍
MVC思想
JavaBean、JSP、Servlet,减少耦合,提高可维护性。
Spring MVC
Servlet:Web 服务的模块,包含对 MVC 与 REST 的实现,Spring MVC。
Web:提供与 Web 的集成,基于 Web 应用程序上下文。
WebSocket:实现客户端与服务端主动通信。
Portlet:提供了在 Portlet 环境中实现 MVC。
它解决 Web 开发中常见的问题(参数接收、文件上传、表单验证、国际化等),而且使用简单,与 Spring 无缝集成。
Spring3.0 后全面超越 Struts2,成为最优秀的 MVC 框架 (更安全,性能更好,更简单)。
支持 RESTful 风格的 URL 请求 ,非常容易与其他视图技术集成,如 Velocity、FreeMarker、JSP 等。
采用了松散耦合可插拔组件结构,比其他 MVC 框架更具扩展性和灵活性。
其他框架
- Struts1 —> WebWork —> Struts2
- SpringMVC
- JSF
前端控制器
在MVC框架中都存在一个前端控制器,在WEB应用的前端(Front)设置一个入口控制器(Controller),是用来提供一个集中的请求处理机制,所有的请求都被发往该控制器统一处理,然后把请求分发给各自相应的处理程序。一般用来做一个共同的处理,如权限检查,授权,日志记录等。因为前端控制的集中处理请求的能力,因此提高了可重用性和可拓展性。
Spring MVC中的前端控制器
Spring MVC 已经提供了一个DispatcherServlet类作为前端控制器,所以要使用Spring MVC必须在 web.xml 中配置前端控制器。
把处理请求的对象称之为处理器或后端控制器,Spring MVC中习惯称之为Controller,如处理员工请求的就会命名为EmployeeController。
使用注解方式开发HelloWorld程序
-
添加依赖
<properties> <spring.version>5.0.8.RELEASE</spring.version> </properties> <dependencies> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>3.0.1</version> <scope>provided</scope> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.apache.tomcat.maven</groupId> <artifactId>tomcat7-maven-plugin</artifactId> <version>2.1</version> <configuration> <port>8080</port> <path>/</path> <uriEncoding>UTF-8</uriEncoding> </configuration> </plugin> <plugin> <artifactId>maven-compiler-plugin</artifactId> <configuration> <source>1.8</source> <target>1.8</target> <encoding>UTF-8</encoding> </configuration> </plugin> </plugins> </build>
-
配置前端控制器
<!--配置前端控制器--> <servlet> <servlet-name>dispatcherServlet</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <!--指定Spring MVC 配置文件的位置--> <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:mvc.xml</param-value> </init-param> <!--启动容器时就初始化--> <load-on-startup>1</load-on-startup> </servlet> <!--配置映射路径--> <servlet-mapping> <servlet-name>dispatcherServlet</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping>
-
编写处理器
@Controller public class HelloController { @RequestMapping("/hello") public ModelAndView hell(){ ModelAndView mv = new ModelAndView(); mv.setViewName("/WEB-INF/views/welcome.jsp"); mv.addObject("message","hello spring MVC"); return mv; } }
-
编写JSP文件
对应上面的代码路径建JSP文件,使用EL表达式取值即可。
-
编写Spring MVC配置文件
<!-- 配置 IoC DI 注解解析器,本质让 Spring 帮我们创建控制器对象 --> <context:component-scan base-package="cn.wolfcode.web.controller"/> <!-- MVC 注解解析器,这个养成习惯一定要配置 时间参数注解支持 JSON 注解支持 --> <mvc:annotation-driven/>
-
测试
HelloWorld程序释疑
<load-on-startup>标签
<load-on-startup> 元素是可选的:若值为 0 或者大于 0 时,表示容器在应用启动时就构建 Servlet 并调用其 init 方法做初始化操作(非负数的值越小,启动该 Servlet 的优先级越高);
若值为一个负数时或者没有指定时,则在第一次请求该Servlet才加载。
Spring MVC的配置文件的位置
DispatcherServlet默认会去WEB-INF目录下去按照 servletName-servlet.xml 方式去加载 Spring MVC 配置文件。如 servlet-name 元素文本内容是 hello,则去 WEB-INF 目录下寻找 hello-servlet.xml 文件。
一般地,我们从classpath路径,显示去加载 SpringMVC 的配置文件。
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:mvc.xml</param-value>
</init-param>
MVC注解
RequestMapping注解
RequestMapping注解是一个用来处理请求地址映射的注解,可用于类或方法上。用于类上,表示类中的所有响应请求的方法都是以该地址作为父路径。还可以限定请求类型和响应类型等。
<mvc:annotation-drivern>标签
会往容器中存入RequestMappingHandlerMapping、RequestMappingHandlerAdapter、ExceptionHandlerExceptionResolver等三个bean。除此之外,还支持:
支持使用 ConversionService 实例对表单参数进行类型转换。
支持使用 @NumberFormat、@DateTimeFormat 注解完成数据格式化操作。
支持使用 @Valid 注解对 JavaBean 实例进行 JSR303 验证。
支持使用 @RequestBody 和 @ResponseBody 注解读写 JSON。
前端控制器映射路径
映射路径
- 配置如*.do、*.htm 是最传统方式,可以访问静态文件(jpg、 js、 css),但不支持 RESTful 风格。
- 配置成 /,可以支持流行的 RESTful 风格,但会导致静态文件(jpg、 js、 css)被拦截后不能访问。
- 配置成 /*,是错误的方式,可以请求到 Controller 中,但跳转到调转到 JSP 时被拦截,不能渲染 JSP 视图,也会导致静资源访问不了。
访问静态资源和JSP被拦截
Tomcat 容器处理静态资源是交由内置 DefaultServlet 来处理的(拦截路径是 /),处理 JSP 资源是交由内置的 JspServlet 处理的(拦截路径是*.jsp | *.jspx)。
启动项目时,先加载容器的 web.xml,而后加载项目中的 web.xml。当拦截路径在两者文件中配置的一样,后面会覆盖掉前者。所以前端控制器配置拦截路径是 / 的所有静态资源都会交由前端控制器处理,而拦截路径配置 /*,所有静态资源和 JSP 都会交由前端控制器处理。
解决这个问题:
-
前端控制器映射路径改成*.do
<!--配置映射路径--> <servlet-mapping> <servlet-name>dispatcherServlet</servlet-name> <url-pattern>*.do</url-pattern> </servlet-mapping>
-
在 Spring MVC的配置文件中配置<mvc:default-servlet-handler/>即可。
上述配置会在Spring MVC上下文中定义一个DefaultServletHttpRequestHandler,它会对进入DispatcherServlet 的请求进行筛查,若不是映射的请求,就将该请求交由容器默认的Servlet处理。
处理响应
返回ModelAndView
-
方法中返回ModelAndView对象,对象中设置模型数据并指定视图
@Controller public class ResponseController { @RequestMapping("/resp1") public ModelAndView resp1() { ModelAndView mv = new ModelAndView(); mv.setViewName("/WEB-INF/views/welcome.jsp"); mv.addObject("msg", "你好"); return mv; } }
-
添加数据到模型方法对比
addObject(String key,Object value):设置共享数据的key和value。
addObject(Object value):设置共享数据的value,key为该value类型首字母小写。
-
消除视图前缀和后缀
因为视图会固定放在一个位置,且后缀名都是一样的,所以可通过配置消除重复。在Spring MVC配置文件中配置如下:
<!--配置视图解析器--> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/views/"/><!--视图前缀--> <property name="suffix" value=".jsp"/><!--视图后缀--> </bean>
配置这个,那么方法最后要找的视图就是:前缀+逻辑视图名+后缀名。
返回String
返回String类型和共享数据(使用广泛),此时和 Model 参数组合使用,用其往作用域中存入数据。
@RequestMapping("/resp2")
public String resp2(Model model) {
model.addAttribute("msg", "String");
return "welcome";
}
返回值为String,此时物理视图路径为:前缀+逻辑视图名+后缀。
请求转发及URL重定向
请求转发和URL重定向对比
地址栏 | WEB-INF | 共享请求数据 | 表达重复提交 | |
---|---|---|---|---|
请求转发 | 不变 | 可以访问 | 共享 | 有 |
URL重定向 | 变 | 不可访问 | 不共享 | 无 |
请求转发
加上forward前缀方式,表示请求转发,相当于 request.getRequestDispatcher().forward(request,response),转发后浏览器地址栏不变,共享之前请求中的数据。
@RequestMapping("/f")
public String forward() {
// 不会使用到视图解析器的前缀和后缀
return "forward:/WEB-INF/views/f_r.jsp";
}
URL重定向
redirect前缀方式,表示重定向,相当于response.sendRedirect(),重定向后浏览器地址栏变为重定向后的地址,不共享之前请求的数据。
@RequestMapping("/r")
public String redirect() {
// 不会使用到视图解析器的前缀和后缀
return "redirect:/static.html";
}
路径问题
加了/使用是绝对路径(推荐使用),从项目根路径找;没加/,使用是相对路径,相对于上一次访问上下文路径的上一级找。
/response/test6.do —> “redirect:/hello.html” —> localhost:/hello.html
/response/test6.do —> “redirect:hello.html” —> localhost:/response/hello.html
RequestParam注解
使用RequestParam注解贴在形参上,设置对应的请求参数名称。解决请求参数名和处理方法方法的形参不同名。
请求:/test2_2.do?username=zs&age=11
乱码处理
-
get方式传递中文参数乱码问题
Tomcat 7及之前手动修改配置文件,使用代码手动转;但若使用 Maven 的话,可以 pom.xml 中的 tomcat 插件配置一行这个也可以解决 <uriEncoding>UTF-8</uriEncoding>。Tomcat 8已处理这个问题,不需要额外配置。
-
post方法传递中文乱问题
直接使用Spring MVC内置的过滤器来处理。
处理日期格式参数
-
在Controller形参贴上@DateTimeFormat
-
在封装参数类的Date类型的字段上贴@DateTimeFormat
下面的代码省略了setter和getter方法。
-
ModelAttribute注解使用
可以贴在方法和形参上,这里重点讲贴在形参。形参前提是自定义类型,会存到模型里,可在视图中获取到。后期项目用于查询条件回显用。
文件上传
添加依赖
一种是基于Apache的上传。使用基于Apache的上传需要拷贝依赖:
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.2.2</version>
</dependency>
准备上传表单
注意请求的类型必须是:multipart/form-data,且是POST。
<form action="/upload.do" method="POST" enctype="multipart/form-data">
姓名:<input type="text" name="username"/><br/>
年龄:<input type="text" name="age"/><br/>
文件:<input type="file" name="pic"><br>
<input type="submit" value="提交"/>
</form>
配置上传解析器
注意上传解析器这个bean名称是固定的,必须为multipartResolver。
<!--配置上传解析器-->
<bean class="org.springframework.web.multipart.commons.CommonsMultipartResolver" id="multipartResolver">
<property name="maxUploadSize" value="102400"/>
</bean>
编写上传控制器
接收上传文件,并把上传的文件拷贝项目的根路径下指定目录,文件名随机(防止文件覆盖)。
拦截器
定义及作用
Spring MVC 提供的,若配置在Spring MVC配置文件中,则被Spring容器管理,主要用于对请求访问控制器的方法进行拦截,在后面的项目中用于登录与权限判断。
定义一个类实现HandlerInterceptor
public class MyInterceptor implements HandlerInterceptor {
// 处理方法之前
// 返回 false,就被拦截;返回 true 就放行
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
System.out.println("preHandle");
return true;
}
// 处理方法之后,渲染视图之前
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
System.out.println("postHandle");
}
// 渲染视图之后
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
System.out.println("afterCompletion");
}
}
配置拦截器
在Spring MVC配置文件中配置:
<mvc:interceptors>
<!-- 配置拦截器 -->
<mvc:interceptor>
<!-- 拦截的路径 -->
<mvc:mapping path="/**"/>
<!-- 被排除的路径 -->
<mvc:exclude-mapping path="/index.html"/>
<!-- 拦截处理器类 -->
<bean class="com.wolfcode.web.interceptor.MyInterceptor"/>
</mvc:interceptor>
</mvc:interceptors>
熟练使用注解的方式使用 Spring MVC 步骤
添加依赖
配置前端控制器(要指定加载 Spring 配置文件)
按照需求编写控制器及JSP
在 Spring 配置文件中配置扫描控制器,配置 MVC 注解解析器
控制器方法怎么写
列代码方法
// /req1.do?username=xx&age=11
@RequestMapping("/req1")
public ModelAndView req1(@RequestParam("username")String name, int age) {
System.out.println(name);
System.out.println(age);
return null;
}