1 Spring集成web环境
1.1 ApplicationContext应用上下文获取方式
应用上下文对象是通过new ClasspathXmlApplicationContext(spring配置文件)方式获取的,但是每次从容器中获得Bean时都要编写new ClasspathXmlApplicationContext(spring配置文件),这样的弊端时配置文件加载多次,应用上下文对象创建多次。
在Web项目中,可以使用ServletContextListener监听Web应用的启动,我们可以在Web应用启动时,就加载Spring的配置文件,创建应用上下文对象ApplicationContext,再将其存储到最大的域servletContext域中,这样就可以在任意位置从域中获得应用上下文ApplicationContext对象了。
1.2 Spring提供获取应用上下文的工具
Spring提供了一个监听器ContextLoaderListener就是对上述功能的封装,该监听器内部加载Spring配置文件,创建应用上下文对象,并存储到ServletContext域中,提供了一个客户端工具WebApplicationContextUtils供使用者获得应用上下文对象。
所以我们需要做的只有两件事:
- 在web.xml中配置ContextLoaderListener监听器(导入spring-web坐标)
- 使用WebApplicationContextUtils获得应用上下文对象ApplicationContext
1.3 知识要点
Spring集成web环境步骤
- 在web.xml配置ContextLoaderListener监听器
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:applicationContext.xml</param-value>
</context-param>
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
- 使用WebApplicationContextUtils获得应用上下文
ServletContext servletContext = this.getServletContext();
ApplicationContext app = WebApplicationContextUtils.getWebApplicationContext(servletContext);
2 SpringMVC简介
2.1 SpringMVC概述
SpringMVC是一种基于Java的实现MVC设计模式的请求驱动类型的轻量级Web框架,属于SpringFrameWork的后续产品,已经融合在SpringWebFlow中。
SpringMVC已经成为了目前最主流的MVC框架之一,并且随着Spring3.0的发布,全面超越Struts2,成为最优秀的MVC框架。它通过一套注解,让一个简单的Java类成为处理请求的控制器,而无需实现任何接口。同时它还支持RESTful编程风格的请求。
2.2 SpringMVC快速入门
需求:客户端发起请求,服务器端接收请求,执行逻辑并进行视图跳转
开发步骤:
- 导入SpringMVC相关坐标
- 配置SpringMVC核心控制器DispathcerServlet
<servlet>
<servlet-name>DispatcherServlet</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>DispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
- 创建Controller类和视图页面
- 使用注解配置Controller类中业务方法的映射地址
- 配置SpringMVC核心文件spring-mvc.xml
- 客户端发起请求
3 SpringMVC 组件解析
3.1 SpringMVC的执行流程
- 用户发送请求至前端控制器DispatcherServlet
- DispatcherServlet收到请求调用HandlerMapping处理器映射器
- 处理器映射器找到具体的处理器(可以根据xml配置、注解进行查找),生成处理器对象及处理器拦截器(如果有则生成)—— 并返回给DispatcherServlet
- DispatcherServlet调用HandlerAdapter处理器适配器
- HandlerAdapter经过适配调用具体的处理器(Controller,也叫后端控制器)
- Controller执行完成返回ModelAndView
- HandlerAdapter将Controller执行结果ModelAndView返回给DispatcherServlet
- DispatcherServlet将ModelAndView传给ViewResolver视图解析器
- ViewResolver解析后返回具体View
10.DispatcherServlet根据View进行渲染视图(即将模型数据填充至视图中)。DispatcherServlet响应用户
3.2 SpringMVC注解解析
@RequestMapping
作用:用于建立请求URL和处理请求方法之间的对应关系
位置:
- 类上,请求URL的第一级访问目录。此处不写的话,就相当于应用的根目录。
- 方法上,请求URL的第二级访问目录,与类上的使用@RequestMapping标注的一级目录一起组成访问虚拟路径
属性:
- value:用于指定请求的URL。它和path属性的作用是一样的
- method:用于指定请求的方式
- params:用于指定限制请求参数的条件。它支持简单的表达式。要求请求参数的key和value必须和配置一样
例如:
- params = {“accountName”},表示请求参数必须有accountName
- params = {“moeny!100”},表示请求参数中money不能是100
3.3 SpringMVC组件扫描
可以通过include-filter扫描包下的特定注解。
<context:component-scan base-package="com.romin">
<context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
</context:component-scan>
3.4 SpringMVC的XML配置解析
1.视图解析器
SpringMVC有默认组件配置,默认组件都是DispatcherServlet.properties配置文件中配置的,该配置文件地址org/springframework/web/servlet/DispatcherServler.properties,该文件中配置了默认的视图解析器,如下:
org.springframework.web.servler.ViewResolver=org.springframework.web.servlet.view.InternalResourceViewResolver
翻看该解析器源码,可以看到该解析器的默认设置,如下:
REDIRECT_URL_PREFIX = “redirect:” ——重定向前缀
FORWARD_URL_PREFIX = “forward:” ——转发前缀(默认)
prefix = " "; ——视图名称前缀
suffix = " "; ——视图名称后缀
4 SpringMVC的数据响应
4.1 SpringMVC的数据响应方式
- 页面跳转
- 直接返回字符串
- 通过ModelAndView对象返回
- 回写数据
- 直接返回字符串
- 返回对象或集合
4.2 页面跳转
- 返回字符串形式
直接返回字符串:此种方式会将返回的字符串与视图解析器的前后缀拼接后跳转。 - 返回ModelAndView对象
@RequestMapping("/quick")
public String save() {
System.out.println("Controller save running...");
return "success";
}
@RequestMapping("/quick2")
public ModelAndView save2() {
/*
Model:模型 用于封装数据
View:视图 用于展示数据
*/
ModelAndView modelAndView = new ModelAndView();
//设置模型数据
modelAndView.addObject("username", "romin");
//设置视图名称
modelAndView.setViewName("success");
return modelAndView;
}
@RequestMapping("/quick3")
public ModelAndView save3(ModelAndView modelAndView) {
//设置模型数据
modelAndView.addObject("username", "romin");
//设置视图名称
modelAndView.setViewName("success");
return modelAndView;
}
@RequestMapping("/quick4")
public String save4(Model model) {
//设置模型数据
model.addAttribute("username", "grizz");
return "success";
}
@RequestMapping("/quick5")
public String save5(HttpServletRequest request) {
request.setAttribute("username", "pandascrolls");
return "success";
}
4.3 回写数据
- 直接返回字符串
Web基础阶段,客户端访问服务器端,如果想直接回写字符串作为响应体返回的话,只需要response.getWriter().print(“hello world”)即可,那么在Controller中想直接回写字符串该怎样呢?
- 通过SpringMVC框架注入的response对象,使用response.getWriter().print(“hello world”)回写数据,此时不需要视图跳转,业务方法返回值为void。
@RequestMapping("/quick6")
public void save6(HttpServletResponse response) throws IOException {
response.getWriter().println("hello world");
}
@RequestMapping("/quick7")
@ResponseBody
public String save7() {
return "hello world";
}
@RequestMapping("/quick8")
@ResponseBody
public String save8() {
return "{\"username\":\"zhangsan\",\"age\":18}";
}
@RequestMapping("/quick9")
@ResponseBody
public String save9() throws JsonProcessingException {
User user = new User();
user.setUsername("lisi");
user.setAge(30);
//使用json的转换工具将对象转换成json格式再返回
ObjectMapper objectMapper = new ObjectMapper();
String json = objectMapper.writeValueAsString(user);
return json;
}
- 返回对象或集合
在方法上添加@ResponseBody就可以返回json格式的字符串,但是这样配置比较麻烦,配置的代码比较多,伊尼茨,我们可以使用mvc的注解驱动代替上述配置。
在SpringMVC的各个组件中,处理器映射器、处理器适配器、视图解析器成为SpringMVC的三大组件。使用< mvc:annotation-driven>自动加载RequestMappingHandlerMapping(处理器映射器)和RequestMappingHandlerAdapter(处理器适配器),可用在Spring-xml.xml配置文件中使用< mvc:annotation-driven>代替注解处理器和适配器的配置。
同时使用< mvc:annotation-driven>默认底层就会集成jackson进行对象或集合的json格式字符串的转换。
<!--mvc的注解驱动-->
<mvc:annotation-driven>
@RequestMapping("/quick10")
@ResponseBody
public User save10() {
User user = new User();
user.setUsername("lisi");
user.setAge(32);
return user;
}
5 SpringMVC获得请求数据
5.1 获得请求参数
客户端请求参数的格式是:name=value&name=value…
服务器端要获得请求的参数,有时还需要进行数据的封装,SpringMVC可以接收如下类型的参数:
- 基本类型参数
- POJO类型参数
- 数组类型参数
- 集合类型参数
5.2 获得基本类型参数
Controller中的业务方法的参数名称要与请求参数的name一致,参数值会自动映射匹配。
http://localhost:8080/quick11?username=wangwu&age=17
@RequestMapping("/quick11")
@ResponseBody
public void save11(String username, int age) {
System.out.println(username);
System.out.println(age);
}
5.3 获得POJO类型参数
Controller中的业务方法的POJO参数的属性名与请求参数的name一致,参数值会自动映射匹配。
http://localhost:8080/quick12?username=wangwu&age=17
@RequestMapping("/quick12")
@ResponseBody
public void save12(User user) {
System.out.println(user);
}
5.4 获得数组类型参数
Controller中的业务方法数组名称与请求参数的name一致,参数值会自动映射匹配。
http://localhost:8080/quick13?strs=111&strs=222&strs=333
@RequestMapping("/quick13")
@ResponseBody
public void save13(String[] strs) {
for (String str : strs) {
System.out.println(str);
}
}
5.5 获得集合类型参数
获得集合参数时,要将集合参数包装到一个POJO中才可以。
@RequestMapping("/quick14")
@ResponseBody
public void save14(VO vo) {
System.out.println(vo);
}
当使用ajax提交时,可以指定contentType为json形式,那么在方法参数位置使用@RequestBody可以直接接收集合数据而无需使用POJO进行包装。
@RequestMapping("/quick15")
@ResponseBody
public void save15(@RequestBody List<User> userList) {
System.out.println(userList);
}
5.6 请求数据乱码问题
<!--配置全局过滤的filter-->
<filter>
<filter-name>CharacterEncodingFilter</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>CharacterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
5.7 参数绑定注解@requestParam
当请求的参数名称与Controller的业务方法参数名称不一致时,就需要通过@RequestParam注解显式绑定
- value:指定请求的参数名
- required:指定请求是否需要包含该参数,默认是true
- defaultValue:当没有指定请求参数时,则使用指定的默认值
5.8 获得Restful风格的参数
Restful是一种软件架构风格、设计风格,而不是标准,只是提供了一组设计原则喝约束条件。主要用于客户端喝服务器交互类的软件,基于这个风格设计的软件可以更简洁,更有层次,更易于实现缓存机制等。
Restful风格的请求时使用”url+请求方式“表示一次请求目的的,HTTP协议里面四个表示操作方式的动词如下:
- GET:用于获取资源
- POST:用于新建资源
- PUT:用于更新资源
- DELETE:用于删除资源
例如:
- /user/1 GET: 得到 id = 1 的 user
- /user/1 DELETE:删除 id = 1 的 user
- /user/1 PUT: 更新 id = 1 的 user
- /user POST: 新增 user
上述url地址/user/1中的1就是要获得的请求参数,在SpringMVC中可以使用占位符进行参数绑定。地址/user/1可以写成/user/{id},占位符{id}对应的就是1的值。在业务方法中我们可以使用@PathVariable注解进行占位符的匹配获取工作。
http://localhost:8080/quick17/zhangsan
@RequestMapping("/quick17/{name}")
@ResponseBody
public void save17(@PathVariable(value = "name",required = true)String name) {
System.out.println(name);
}
5.9 自定义类型转换器
- SpringMVC默认已经提供了一些常用的类型转换器,例如客户端提交的字符串转换成int型进行参数设置。
- 但是不是所有的数据类型都提供了转换器,没有提供的就需要自定义转换器,例如:日期类型的数据就需要自定义转换器。
自定义类型转换器的开发步骤:
- 定义转换器类实现Converter接口
- 在配置文件中声明转换器
- 在< annotation-driven/>中引用转换器
public class DateConverter implements Converter<String, Date> {
public Date convert(String dateStr) {
SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
Date date = null;
try {
date = format.parse(dateStr);
} catch (ParseException e) {
e.printStackTrace();
}
return date;
}
}
<!--声明转换器-->
<bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">
<property name="converters">
<list>
<bean class="com.romin.converter.DateConverter"/>
</list>
</property>
</bean>
<!--mvc的注解驱动-->
<mvc:annotation-driven conversion-service="conversionService"/>
5.10 获取Servlet相关API
@RequestMapping("/quick19")
@ResponseBody
public void save19(HttpServletRequest request, HttpServletResponse response) {
}
5.11 获得请求头
- @RequestHeader
使用@RequestHeader可以获得请求头信息,相当于web阶段学习的request.getHeader(name)
@RequestHeader注解的属性如下:
- value:请求头的名称
- required:是否必须携带此请求头
@RequestMapping("/quick20")
@ResponseBody
public void save20(@RequestHeader(value = "User-Agent",required = false)String headerValue) {
System.out.println(headerValue);
}
- @CookieValue
使用@CookieValue注释的属性如下:
- value:指定cookie的名称
- required:是否必须携带此cookie
@RequestMapping("/quick21")
@ResponseBody
public void save21(@CookieValue(value = "JSESSIONID",required = false)String jsessionId) {
System.out.println(jsessionId);
}
5.12 文件上传
- 文件上传客户端三要素
- 表单项type = “file”
- 表单的提交方式是post
- 表单的enctype属性是多部分表单形式。即enctype=“multipart/form-data”
- 文件上传原理
- 当form表单修改为多部分表单时,request.getParamenter()将失效
- enctype=”application/x-www-form-urlencoded"时,form表单的正文内容格式是:key=value&key=value…
- 当form表单的enctype取值为Mutilpart/form-data时,请求正文内容就变成多部分形式:
<form action="${pageContext.request.contextPath}/quick22" method="post"
enctype="multipart/form-data">
名称:<input type="text" name="name"><br>
文件:<input type="file" name="uploadFile"><br>
<input type="submit" value="提交"><br>
</form>
5.13 单文件上传步骤
- 导入fileupload和io坐标
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.3.1</version>
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.3</version>
</dependency>
- 配置文件上传解析器
<!--配置文件上传解析器-->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!--上传文件总大小-->
<property name="maxUploadSize" value="5242800"/>
<!--上传单个文件的大小-->
<property name="maxUploadSizePerFile" value="5242800"/>
<!--上传文件的编码类型-->
<property name="defaultEncoding" value="UTF-8"/>
</bean>
- 编写文件上传代码
@RequestMapping("/quick22")
@ResponseBody
public void save22(String name, MultipartFile uploadFile) throws IOException {
System.out.println(name);
//获得文件名称
String originalFilename = uploadFile.getOriginalFilename();
uploadFile.transferTo(new File("C:\\upload\\" + originalFilename));
}
5.13 多文件上传步骤
编写文件上传代码
@RequestMapping("/quick23")
@ResponseBody
public void save23(String name, MultipartFile[] uploadFile) throws IOException {
System.out.println(name);
//获得文件名称
for (MultipartFile multipartFile : uploadFile) {
String originalFilename = multipartFile.getOriginalFilename();
multipartFile.transferTo(new File("C:\\upload\\" + originalFilename));
}
}