目录
一、SpringMVC的数据响应
1.1 SpringMVC的数据响应方式
(1) 页面跳转
- 直接返回字符串
- 通过ModelAndView对象返回
(2)回写数据
- 直接返回字符串
- 返回对象或集合
1.1.1 页面跳转
(1)返回字符串形式
// 请求地址 http://localhost:8080/user/quick
@RequestMapping(value = "/quick", method = RequestMethod.GET, params ={"username"})
public String save() {
System.out.println("Controller save running...");
return "success";
}
@RequestMapping(value = "/quick4")
public String save4(Model model) {
model.addAttribute("username","咕咕咕咕");
return "success";
}
(2)返回ModelAndView对象
@RequestMapping(value = "/quick2")
public ModelAndView save2() {
/*
Model:模型,作用:封装数据
View: 视图,作用:展示数据
*/
ModelAndView modelAndView = new ModelAndView();
//设置模型数据
modelAndView.addObject("username","咕咕");
//设置视图
modelAndView.setViewName("success");
return modelAndView;
}
@RequestMapping(value = "/quick3")
public ModelAndView save3(ModelAndView modelAndView) {
//设置模型数据
modelAndView.addObject("username","咕咕猫");
//设置视图
modelAndView.setViewName("success");
return modelAndView;
}
(3)向request域存储数据
@RequestMapping(value = "/quick5")
public String save5(HttpServletRequest request) {
request.setAttribute("username","咕咕咕咕咕");
return "success";
}
1.1.2 回写数据
(1)直接返回字符串
Web基础阶段,客户端访问服务器端,如果想直接回写字符串作为响应体返回的话,只需要使用 response.getWriter().print(“hello world”) 即可,那么在Controller中想直接回写字符串可以使用以下方法
① 通过SpringMVC框架注入的response对象,使用response.getWriter().print(“hello world”) 回写数据,此时不需要视图跳转,业务方法返回值为void
@RequestMapping(value = "/quick6") public void save6(HttpServletResponse response) throws IOException { response.getWriter().print("hello,咕咕猫"); }
② 将需要回写的字符串直接返回,但此时需要通过@ResponseBody注解告知SpringMVC框架,方法返回的字符串不是跳转是直接在http响应体中返回
@RequestMapping(value = "/quick7", produces = "application/json;charset=utf-8") @ResponseBody//告知SpringMVC框架,不进行视图跳转,直接进行数据回写 public String save7() { return "hello,咕咕猫"; }
- 在异步项目中,客户端与服务器端往往要进行json格式字符串交互,此时我们可以手动拼接json字符串返回
@RequestMapping(value = "/quick8", produces = "application/json;charset=utf-8") @ResponseBody//告知SpringMVC框架,不进行视图跳转,直接进行数据回写 public String save8() { return "{\"username\":\"zhangsan\",\"age\":18}"; }
- 上述方式手动拼接json格式字符串的方式很麻烦,开发中往往要将复杂的java对象转换成json格式的字符串, 我们可以使用web阶段学习过的json转换工具jackson进行转换,导入jackson坐标
<!--jackson--> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-core</artifactId> <version>2.9.0</version> </dependency> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> <version>2.9.0</version> </dependency> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-annotations</artifactId> <version>2.9.0</version> </dependency> <!--或者使用fastjson也可以--> <dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.62</version> </dependency>
- 通过jackson转换json格式字符串,回写字符串
@RequestMapping(value = "/quick9", produces = "application/json;charset=utf-8") @ResponseBody//告知SpringMVC框架,不进行视图跳转,直接进行数据回写 public String save9() { User user = new User(); user.setUsername("lisi"); user.setAge(30); //使用Fastjson的转换工具将对象转换成json格式的字符串再返回 String jsonString = JSON.toJSONString(user); return jsonString; }
(2)返回对象或集合
通过SpringMVC帮助我们对对象或集合进行json字符串的转换并回写,为处理器适配器配置消息转换参数, 指定使用jackson进行对象或集合的转换,因此需要在spring-mvc.xml中进行如下配置:
<!--配置处理器映射器--> <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"> <property name="messageConverters"> <list> <bean class="com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter"/> </list> </property> </bean>
@RequestMapping(value = "/quick10", produces = "application/json;charset=utf-8") @ResponseBody//告知SpringMVC框架,不进行视图跳转,直接进行数据回写 public User save10() { User user = new User(); user.setUsername("wangwu"); user.setAge(35); return user; }
- 在方法上添加@ResponseBody就可以返回json格式的字符串,但是这样配置比较麻烦,配置的代码比较多, 因此,我们可以使用mvc的注解驱动代替上述配置。(pom文件里要导入上面三个jackson坐标)
<!--mvc的注解驱动--> <mvc:annotation-driven/>
在 SpringMVC 的各个组件中,处理器映射器、处理器适配器、视图解析器称为 SpringMVC 的三大组件。 使用自动加载 RequestMappingHandlerMapping(处理映射器)和 RequestMappingHandlerAdapter( 处理适配器 ),可用在Spring-xml.xml配置文件中使用替代注解处理器和适配器的配置。 同时使用默认底层就会集成jackson进行对象或集合的json格式字符串的转换。
二、SpringMVC获得请求数据
2.1 获得请求参数
客户端请求参数的格式是:name=value&name=value… … 服务器端要获得请求的参数,有时还需要进行数据的封装,SpringMVC可以接收如下类型的参数:
- 基本类型参数
- POJO类型参数
- 数组类型参数
- 集合类型参数
2.1.1 获得基本类型参数
Controller中的业务方法的参数名称要与请求参数的name一致,参数值会自动映射匹配
http://localhost:8080/spring_mvc_war_exploded/user/quick11?username=ggm&age=18
// 获得基本类型参数 @RequestMapping(value = "/quick11", produces = "application/json;charset=utf-8") @ResponseBody//告知SpringMVC框架,不进行视图跳转,直接进行数据回写 public void save11(String username, int age) { System.out.println(username); System.out.println(age); }
2.1.2 获得POJO类型参数
Controller中的业务方法的POJO参数的属性名与请求参数的name一致,参数值会自动映射匹配
http://localhost:8080/spring_mvc_war_exploded/user/quick12?username=ggm&age=18
// 获得POJO类型参数 @RequestMapping(value = "/quick12", produces = "application/json;charset=utf-8") @ResponseBody//告知SpringMVC框架,不进行视图跳转,直接进行数据回写 public void save12(User user) { System.out.println(user); }
2.1.3 获得数组类型参数
Controller中的业务方法数组名称与请求参数的name一致,参数值会自动映射匹配
http://localhost:8080/spring_mvc_war_exploded/user/quick13?strs=111&strs=222&strs=333
// 获得数组类型参数 @RequestMapping(value = "/quick13", produces = "application/json;charset=utf-8") @ResponseBody//告知SpringMVC框架,不进行视图跳转,直接进行数据回写 public void save13(String[] strs) { System.out.println(Arrays.asList(strs)); }
2.1.4 获得集合类型数据
当使用ajax提交时,可以指定contentType为json形式,那么在方法参数位置使用@RequestBody可以 直接接收集合数据而无需使用POJO进行包装
// 获得集合类型参数 @RequestMapping(value = "/quick14", produces = "application/json;charset=utf-8") @ResponseBody//告知SpringMVC框架,不进行视图跳转,直接进行数据回写 public void save14(VO vo) { System.out.println(vo); } // 获得集合类型参数 @RequestMapping(value = "/quick15") @ResponseBody//告知SpringMVC框架,不进行视图跳转,直接进行数据回写 public void save15(@RequestBody List<User> userList) { System.out.println(userList); }
注意:通过谷歌开发者工具抓包发现,没有加载到jquery文件,原因是SpringMVC的前端控制器 DispatcherServlet的url-pattern配置的是/,代表对所有的资源都进行过滤操作,我们可以通过以下两种 方式指定放行静态资源:
- 在spring-mvc.xml配置文件中指定放行的资源
<!--开放资源的访问--> <!--mapping:客户端访问资源的路径 location:文件目录--> <mvc:resources mapping="/js/**" location="/js/"/>
- 使用标签 <mvc:default-servlet-handler/> 标签
<mvc:default-servlet-handler/>
2.2 请求数据乱码问题
当post请求时,数据会出现乱码,我们可以设置一个过滤器来进行编码的过滤
<!--配置全局过滤的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>
2.3 参数绑定注解@RequestParam
当请求的参数名称与Controller的业务方法参数名称不一致时,就需要通过@RequestParam注解显示的绑定
<form action="${pageContext.request.contextPath}/user/quick14" method="post"> <%--表明是第几个User对象的username和age--%> <input type="text" name="userList[0].username"><br/> <input type="text" name="userList[0].age"><br/> <input type="text" name="userList[1].username"><br/> <input type="text" name="userList[1].age"><br/> <input type="submit"> </form>
// 参数绑定注解@RequestParam @RequestMapping(value = "/quick16") @ResponseBody//告知SpringMVC框架,不进行视图跳转,直接进行数据回写 public void save16(@RequestParam(value="name", required = false, defaultValue = "gugumao") String username) { System.out.println(username); }
注解@RequestParam还有如下参数可以使用:
- value:与请求参数名称
- required:在指定的请求参数是否必须包括,默认是true,提交时如果没有此参数则报错
- defaultValue:当没有指定请求参数时,则使用指定的默认值赋值
2.4 获得Restful风格的参数
Restful 是一种软件架构风格、设计风格,而不是标准,只是提供了一组设计原则和约束条件。主要用于客户端和服务 器交互类的软件,基于这个风格设计的软件可以更简洁,更有层次,更易于实现缓存机制等。
Restful 风格的请求是使用 “url+请求方式” 表示一次请求目的的,HTTP 协议里面四个表示操作方式的动词如下:
- GET:用于获取资源
- POST:用于新建资源
- PUT:用于更新资源
- DELETE:用于删除资源
上述url地址/user/1中的1就是要获得的请求参数,在SpringMVC中可以使用占位符进行参数绑定。地址/user/1可以写成 /user/{id},占位符{id}对应的就是1的值。在业务方法中我们可以使用@PathVariable注解进行占位符的匹配获取工作
http://localhost:8080/spring_mvc_war_exploded/user/quick19/zhangsan
// 获得Restful风格的参数 @RequestMapping(value = "/quick17/{name}") @ResponseBody//告知SpringMVC框架,不进行视图跳转,直接进行数据回写 public void save17(@PathVariable(value = "name") String username) { System.out.println(username); }
2.5 自定义类型转换器
• SpringMVC 默认已经提供了一些常用的类型转换器,例如客户端提交的字符串转换成int型进行参数设置。
• 但是不是所有的数据类型都提供了转换器,没有提供的就需要自定义转换器,例如:日期类型的数据就需要自定义转换器。
自定义类型转换器的开发步骤:
① 定义转换器类实现Converter接口
② 在配置文件中声明转换器
③ 在中引用转换器
① 定义转换器类实现Converter接口
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.learn.converter.DateConverter"/> </list> </property> </bean>
③ 在 <annotation-driven> 中引用转换器
<mvc:annotation-driven conversion-service="conversionService"/>
2.6 获得Servlet相关API
SpringMVC支持使用原始ServletAPI对象作为控制器方法的参数进行注入,常用的对象如下:
- HttpServletRequest
- HttpServletResponse
- HttpSession
// 获得Servlet相关API @RequestMapping(value = "/quick19") @ResponseBody//告知SpringMVC框架,不进行视图跳转,直接进行数据回写 public void save19(HttpServletRequest request, HttpServletResponse response, HttpSession session) { System.out.println(request); System.out.println(response); System.out.println(session); }
2.7 获得请求头
1. @RequestHeader
使用@RequestHeader可以获得请求头信息,相当于web阶段学习的request.getHeader(name) @RequestHeader注解的属性如下:
- value:请求头的名称
- required:是否必须携带此请求头
// 获得请求头 @RequestMapping(value = "/quick20") @ResponseBody//告知SpringMVC框架,不进行视图跳转,直接进行数据回写 public void save20(@RequestHeader(value = "User-Agent") String user_agent) { System.out.println(user_agent); }
2. @CookieValue
使用@CookieValue可以获得指定Cookie的值 @CookieValue注解的属性如下:
- value:指定cookie的名称
- required:是否必须携带此cookie
// 获得请求头 @RequestMapping(value = "/quick21") @ResponseBody//告知SpringMVC框架,不进行视图跳转,直接进行数据回写 public void save21(@CookieValue(value = "JSESSIONID") String jsessionId) { System.out.println(jsessionId); }
2.8 文件上传
1. 文件上传客户端三要素
- 表单项 type = "file"
- 表单的提交方式是post
- 表单的encype属性是多部分表单形式,即enctype = "multipart/form-data"
2. 文件上传原理
- 当form表单修改为多部分表单时,request.getParameter()将失效
- enctype = "application/x-www-form-urlencoded"时,form表单的正文内容格式是:key=value&key=value&key=value
- 当form表单的enctype取值为Mutilpart/form-data时,请求正文内容就变成多部分形式:
2.8.1 单文件上传实现
①导入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="defaultEncoding" value="UTF-8"/> <property name="maxUploadSize" value="50000"/> </bean>
③ 编写文件上传代码
// 文件上传 @RequestMapping(value = "/quick22") @ResponseBody//告知SpringMVC框架,不进行视图跳转,直接进行数据回写 public void save22(String username, MultipartFile uploadFile1,MultipartFile uploadFile2) throws IOException { System.out.println(username); //获得上传文件的名称 String originalFilename = uploadFile1.getOriginalFilename(); //保存文件 uploadFile1.transferTo(new File("D:\\Geek\\" + originalFilename)); }
2.8.2 多文件上传实现
多文件上传,只需要将页面修改为多个文件上传项,将方法参数MultipartFile类型修改为MultipartFile[ ]即可
<form action="${pageContext.request.contextPath}/user/quick23" method="post" enctype="multipart/form-data"> 名称<input type="text" name="username"><br/> 文件1<input type="file" name="uploadFile"><br/> 文件2<input type="file" name="uploadFile"><br/> <input type="submit" value="提交"> </form>
// 多文件上传 @RequestMapping(value = "/quick23") @ResponseBody//告知SpringMVC框架,不进行视图跳转,直接进行数据回写 public void save23(String username, MultipartFile[] uploadFile) throws IOException { System.out.println(username); for (MultipartFile multipartFile : uploadFile) { String originalFilename = multipartFile.getOriginalFilename(); multipartFile.transferTo(new File("D:\\Geek\\"+originalFilename)); } }