解决乱码问题:SpringMVC 给我们提供了一个过滤器,可以在 web.xml
中配置:
<filter>
<filter-name>encodingfilter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilterfilter-class>
<init-param>
<param-name>encodingparam-name>
<param-value>utf-8param-value>
init-param>
filter>
<filter-mapping>
<filter-name>encodingfilter-name>
<url-pattern>/*url-pattern>
filter-mapping>
但是有些极端情况下,这个过滤器对 get
的支持不好。
处理方法:修改 tomcat 配置文件,设置编码:
<Connector URIEncoding="utf-8" port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />
或者可以在代码中放入如下的 自定义过滤器:
package com.yusael.filter;
import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletRequestWrapper;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.util.Map;
/**
* 解决 get 和 post 请求 全部乱码的过滤器
*/
public class GenericEncodingFilter implements Filter {
@Override
public void destroy() {
}
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
//处理response的字符编码
HttpServletResponse myResponse=(HttpServletResponse) response;
myResponse.setContentType("text/html;charset=UTF-8");
// 转型为与协议相关对象
HttpServletRequest httpServletRequest = (HttpServletRequest) request;
// 对request包装增强
HttpServletRequest myrequest = new MyRequest(httpServletRequest);
chain.doFilter(myrequest, response);
}
@Override
public void init(FilterConfig filterConfig) throws ServletException {
}
}
//自定义request对象,HttpServletRequest的包装类
class MyRequest extends HttpServletRequestWrapper {
private HttpServletRequest request;
//是否编码的标记
private boolean hasEncode;
//定义一个可以传入HttpServletRequest对象的构造函数,以便对其进行装饰
public MyRequest(HttpServletRequest request) {
super(request);// super必须写
this.request = request;
}
// 对需要增强方法 进行覆盖
@Override
public Map getParameterMap() {
// 先获得请求方式
String method = request.getMethod();
if (method.equalsIgnoreCase("post")) {
// post请求
try {
// 处理post乱码
request.setCharacterEncoding("utf-8");
return request.getParameterMap();
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
} else if (method.equalsIgnoreCase("get")) {
// get请求
Map<String, String[]> parameterMap = request.getParameterMap();
if (!hasEncode) { // 确保get手动编码逻辑只运行一次
for (String parameterName : parameterMap.keySet()) {
String[] values = parameterMap.get(parameterName);
if (values != null) {
for (int i = 0; i < values.length; i++) {
try {
// 处理get乱码
values[i] = new String(values[i]
.getBytes("ISO-8859-1"), "utf-8");
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
}
}
}
hasEncode = true;
}
return parameterMap;
}
return super.getParameterMap();
}
//取一个值
@Override
public String getParameter(String name) {
Map<String, String[]> parameterMap = getParameterMap();
String[] values = parameterMap.get(name);
if (values == null) {
return null;
}
return values[0]; // 取回参数的第一个值
}
//取所有值
@Override
public String[] getParameterValues(String name) {
Map<String, String[]> parameterMap = getParameterMap();
String[] values = parameterMap.get(name);
return values;
}
}
然后在 web.xml
中配置这个过滤器即可。
<filter>
<filter-name>encodingfilter-name>
<filter-class>com.yusael.filter.GenericEncodingFilterfilter-class>
filter>
<filter-mapping>
<filter-name>encodingfilter-name>
<url-pattern>/*url-pattern>
filter-mapping>
json语法
{"name": "QinJiang"}
{"age": "3"}
{"sex": "男"}
var obj = {a: 'Hello', b: 'World'}; // 这是一个对象,注意键名也是可以使用引号包裹的
var json = '{"a": "Hello", "b": "World"}'; // 这是一个 JSON 字符串,本质是一个字符串
JSON字符串 转换为 JavaScript 对象,使用 JSON.parse()
方法:
var obj = JSON.parse('{"a": "Hello", "b": "World"}');
// 结果是 {a: 'Hello', b: 'World'}
JavaScript 对象 转换为 JSON字符串,使用 JSON.stringify()
方法:
var json = JSON.stringify({a: 'Hello', b: 'World'});
// 结果是 '{"a": "Hello", "b": "World"}'
测试代码:
// 编写一个 js对象
var user = {
name : "yusael",
age : 3,
sex : "男"
};
// 将 js对象 转为 json字符串
var str = JSON.stringify(user);
console.log(str);
// 将 json字符串 转为js对象
var userObj = JSON.parse(str);
console.log(userObj);
<dependency>
<groupId>com.fasterxml.jackson.coregroupId>
<artifactId>jackson-databindartifactId>
<version>2.11.0version>
dependency>
使用 json 注意 解决乱码问题:用 @RequestMaping
的 produces
指定响应体返回类型和编码。
@RequestMapping(value = "/json", produces = "application/json;charset=utf-8")
@Controller
public class UserController {
// 解决乱码问题
@RequestMapping(value = "/json", produces = "application/json;charset=utf-8")
@ResponseBody
public String json() throws JsonProcessingException {
// 创建一个 jackson 的对象映射器, 用来解析数据
ObjectMapper mapper = new ObjectMapper();
// 创建一个对象
User user = new User(1, "zhenyu", "男");
// 将对象解析成 json 格式
String str = mapper.writeValueAsString(user);
System.out.println(str);
// 由于@ResponseBody注解, 这里会将 str 转成 json 格式返回
return str;
}
}
通过 @RequestMapping(value = "/json", produces = "application/json;charset=utf-8")
解决乱码比较麻烦,如果项目中有许多请求则每一个都要添加,可以通过 Spring 配置统一指定,这样就不用每次都去处理了
我们可以在 springmvc 的配置文件上添加一段消息 StringHttpMessageConverter
转换配置:
<mvc:annotation-driven>
<mvc:message-converters register-defaults="true">
<bean class="org.springframework.http.converter.StringHttpMessageConverter">
<constructor-arg value="UTF-8"/>
bean>
<bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
<property name="objectMapper">
<bean class="org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean">
<property name="failOnEmptyBeans" value="false"/>
bean>
property>
bean>
mvc:message-converters>
mvc:annotation-driven>
在类上直接使用 @RestController
,这样子,里面所有的方法都只会返回 Json 字符串了,不用再每一个都添加 @ResponseBody
。在前后端分离开发中,一般都使用 @RestController
,十分便捷。
@RestController // 使得所有方法都返回 Json 字符串
public class UserController {
@RequestMapping(value = "/json")
public String json() throws JsonProcessingException {
// 创建一个 jackson 的对象映射器, 用来解析数据
ObjectMapper mapper = new ObjectMapper();
// 创建一个对象
User user = new User(1, "zhenyu", "男");
// 将对象解析成 json 格式
String str = mapper.writeValueAsString(user);
System.out.println(str);
// 由于@RestController 注解, 这里会将 str 转成 json 格式返回;
return str;
}
}
@RequestMapping("/json1")
public String json2() throws JsonProcessingException {
ObjectMapper mapper = new ObjectMapper();
User user1 = new User(1, "Jack", "男");
User user2 = new User(2, "Rose", "女");
User user3 = new User(3, "Kitty", "女");
User user4 = new User(4, "Jerry", "男");
User user5 = new User(5, "Yusael", "男");
List<User> users = new ArrayList<>();
users.add(user1);
users.add(user2);
users.add(user3);
users.add(user4);
users.add(user5);
String str = mapper.writeValueAsString(users);
return str;
}
默认日期格式是 时间戳 —— 1970年1月1日到当前日期的毫秒数。
@RequestMapping("/json2")
public String json2() throws JsonProcessingException {
ObjectMapper mapper = new ObjectMapper();
Date date = new Date();
String str = mapper.writeValueAsString(date);
return str;
}
// 输出 1591877669906
解决方案:取消 timestamps
形式,自定义时间格式。
@RequestMapping("/json3")
public String json3() throws JsonProcessingException {
ObjectMapper mapper = new ObjectMapper();
// 设置不使用时间戳的格式
mapper.configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, false);
// 自定义日期格式对象
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
// 指定日期格式
mapper.setDateFormat(sdf);
Date date = new Date();
String str = mapper.writeValueAsString(date);
return str;
}
// 输出: 2020-06-11 20:16:36
如果要经常使用的话,这样是比较麻烦的,我们可以将这些代码封装到一个工具类中;
public class JsonUtils{
public static String getJson(Object object){
return getJson(object,"yyyy-MM-dd HH:mm:ss");
}
public static String getJson(Object object,String dateFormat){
ObjectMapper mapper = new ObjectMapper();
// 不使用时间戳的方式
mapper.configura(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS,false);
// 自定义日期格式对象
SimpleDateFormat sdf = new SimpleDateFormat(dateFormat);
// 指定日期格式
mapper.setDateFormat(sdf);
Date date = new Date();
try {
return mapper.writeValueAsString(date);
} catch (JsonProcessingException e) {
e.printStackTrace();
}
return null;
}
}
使用工具类,代码就变得更加简单了。
@RequestMapping("/json4")
public String json4() throws JsonProcessingException {
ObjectMapper mapper = new ObjectMapper();
return JsonUtils.getJson(new Date());
}
<dependency>
<groupId>com.alibabagroupId>
<artifactId>fastjson2artifactId>
<version>1.2.60version>
dependency>
fastjson 中三个主要的类:
JSONObject 代表 Json 对象
JSONObject 实现了 Map 接口, 猜想 JSONObject 底层操作是由 Map 实现的。
JSONObject 对应 Json 对象,通过各种形式的 get() 方法可以获取 Json 对象中的数据,也可利用诸如 size(),isEmpty() 等方法获取 “键 : 值对” 的个数和判断是否为空。其本质是通过实现 Map 接口并调用接口中的方法完成的。
JSONArray 代表 Json 对象数组
内部是由 List 接口中的方法来完成操作的。
JSON 代表 JSONObject 和 JSONArray 的转化
测试代码:
public class FastJsonDemo {
public static void main(String[] args) {
User user1 = new User(1, "Jack", "男");
User user2 = new User(2, "Rose", "女");
User user3 = new User(3, "Kitty", "女");
User user4 = new User(4, "Jerry", "男");
User user5 = new User(5, "Yusael", "男");
List<User> list = new ArrayList<User>();
list.add(user1);
list.add(user2);
list.add(user3);
list.add(user4);
list.add(user5);
System.out.println("*******Java对象 转 JSON字符串*******");
String str1 = JSON.toJSONString(list);
System.out.println("JSON.toJSONString(list) ==> " + str1);
String str2 = JSON.toJSONString(user1);
System.out.println("JSON.toJSONString(user1) ==> " + str2);
System.out.println("\n****** JSON字符串 转 Java对象*******");
User jp_user1=JSON.parseObject(str2, User.class);
System.out.println("JSON.parseObject(str2,User.class) ==> " + jp_user1);
System.out.println("\n****** Java对象 转 JSON对象 ******");
JSONObject jsonObject1 = (JSONObject) JSON.toJSON(user2);
System.out.println("(JSONObject) JSON.toJSON(user2) ==> " + jsonObject1.getString("name"));
System.out.println("\n****** JSON对象 转 Java对象 ******");
User to_java_user = JSON.toJavaObject(jsonObject1, User.class);
System.out.println("JSON.toJavaObject(jsonObject1, User.class) ==> " + to_java_user);
}
}
<build>
<resources>
<resource>
<directory>src/main/javadirectory>
<includes>
<include>**/*.propertiesinclude>
<include>**/*.xmlinclude>
includes>
<filtering>falsefiltering>
resource>
<resource>
<directory>src/main/resourcesdirectory>
<includes>
<include>**/*.propertiesinclude>
<include>**/*.xmlinclude>
includes>
<filtering>falsefiltering>
resource>
resources>
build>
SpringMVC 的处理器拦截器类似于 Servlet 开发中的过滤器 Filter,用于对处理器进行 预处理 和 后处理。开发者可以自己定义一些拦截器来实现特定的功能。
过滤器与拦截器的区别:拦截器是 AOP 思想的具体应用。
过滤器(filter):
拦截器(interceptor):
想要自定义拦截器,必须实现 HandlerInterceptor
接口。
配置 web.xml 和 springmvc-servlet.xml 文件
编写一个拦截器:
package com.yusael.interceptor;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class MyInterceptor implements HandlerInterceptor {
// 在请求处理的方法之前执行
// 如果返回 true 执行下一个拦截器(放行)
// 如果返回 false 就不执行下一个拦截器
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
System.out.println("---------处理前---------");
return true;
}
// 在请求处理方法执行之后执行
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
System.out.println("---------处理后---------");
}
// 在 dispatcherServlet 处理后执行, 做清理工作
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
System.out.println("---------清理---------");
}
}
在 SpringMVC 的配置文件中配置拦截器
<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/**"/>
<bean class="com.yusael.interceptor.MyInterceptor"/>
mvc:interceptor>
mvc:interceptors>
编写一个 Controller,接收请求:
前端 index.jsp
拦截器测试
启动 Tomcat 进行测试。
如果自定义拦截器中 preHandle
返回 false
,表示不放行,被拦截了,不继续执行了。
如果自定义拦截器中 preHandle
返回 true
,表示放行,继续执行后面的代码。
思路:
如果没有拦截器,也就是上面思路中的 1 和 2 步,用户未登录也可以进入主页
编写一个登陆页面 login.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
login
登录页面
编写一个 Controller 处理请求
package com.yusael.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import javax.servlet.http.HttpSession;
@Controller
@RequestMapping("/user")
public class UserController {
// 跳转到登录界面
@RequestMapping("/toLogin")
public String toLogin() {
return "login";
}
// 跳转到成功页面
@RequestMapping("/toSuccess")
public String toSucess() {
return "success";
}
// 登录提交
@RequestMapping("/login")
public String login(HttpSession session, String username, String password) {
// 向 session 记录用户身份信息
System.out.println("接收前端 ===> " + username);
session.setAttribute("user", username);
return "success";
}
// 登录过期
@RequestMapping("/logout")
public String logout(HttpSession httpSession) {
// session 过期
httpSession.invalidate();
return "login";
}
}
编写一个登陆成功的页面 success.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
success
登录成功页面
${user}
注销
编写主页 index.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
index
首页
<%--登录--%>
登录
成功页面
编写用户登录拦截器 LoginInterceptor.java
package com.yusael.interceptor;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.HttpSession;
public class LoginInterceptor implements HandlerInterceptor{
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
// 如果是登录页面则放行
System.out.println(request.getRequestURI());
if(request.getRequestURI().contains("login")){
return true;
}
HttpSession session = request.getSession();
// 如果用户已经登陆也放行
if(session.getAttribute("user") != null){
return true;
}
// 如果用户没有登录则跳转到登录界面
request.getRequestDispatcher("/WEB-INF/jsp/login.jsp").forward(request,response);
return false;
}
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
}
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
}
}
在 Springmvc 的配置文件中注册拦截器:
<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/**"/>
<bean id="loginInterceptor" class="com.yusael.interceptor.LoginInterceptor"/>
mvc:interceptor>
mvc:interceptors>
由于配置了 拦截器,直接登录 成功页面,虽然会请求跳转到 success.jsp 页面,但是由于不满足拦截器进行了判断,不满足放行的条件则会跳转到 登录界面。只有满足拦截器放行的条件才会跳转到 成功页面
文件上传是项目开发中最常见的功能之一 ,SpringMVC 可以很好的支持文件上传,但是 SpringMVC 上下文中默认没有装配 MultipartResolver,因此默认情况下其不能处理文件上传工作。如果想使用Spring 的文件上传功能,则需要在上下文中配置 MultipartResolver。
对前端表单的要求:为了能上传文件,必须将表单的 method
设置为 POST
,并将 enctype
设置为multipart/form-data
。只有在这样的情况下,浏览器才会把用户选择的文件以二进制数据发送给服务器;
表单中的 enctype
(编码方式)属性的说明:
application/x-www=form-urlencoded
:默认方式,只处理表单域中的 value 属性值,采用这种编码方式的表单会将表单域中的值处理成 URL 编码方式。multipart/form-data
:这种编码方式会以二进制流的方式来处理表单数据,这种编码方式会把文件域指定文件的内容也封装到请求参数中,不会对字符编码。text/plain
:除了把空格转换为 “+” 号外,其他字符都不做编码处理,这种方式适用直接通过表单发送邮件。
一旦设置了 enctype
为 multipart/form-data
,浏览器即会采用二进制流的方式来处理表单数据,而对于文件上传的处理则涉及在服务器端解析原始的 HTTP 响应。
在2003年,Apache Software Foundation 发布了开源的 Commons FileUpload 组件,其很快成为Servlet/JSP 程序员上传文件的最佳选择。
Servlet3.0 规范已经提供方法来处理文件上传,但这种上传需要在 Servlet 中完成;而Spring MVC则提供了更简单的封装;
Spring MVC 为文件上传提供了直接的支持,这种支持是用即插即用的 MultipartResolver 实现的。
Spring MVC 使用 Apache Commons FileUpload 技术实现了一个 MultipartResolver 实现类:
CommonsMultipartResolver。因此,SpringMVC 的文件上传还需要依赖 Apache Commons FileUpload 的组件。
引入 commons-fileupload 的依赖
<dependency>
<groupId>commons-fileuploadgroupId>
<artifactId>commons-fileuploadartifactId>
<version>1.3.3version>
dependency>
<dependency>
<groupId>javax.servletgroupId>
<artifactId>javax.servlet-apiartifactId>
<version>4.0.1version>
dependency>
配置 bean:multipartResolver
注:这个 bean
的 id 必须为:multipartResolver
,否则上传文件会报 400 的错误。
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<property name="defaultEncoding" value="utf-8"/>
<property name="maxUploadSize" value="10485760"/>
<property name="maxInMemorySize" value="40960"/>
bean>
CommonsMultipartFile
的 常用方法:
String getOriginalFilename() 获取上传文件的原名
InputStream getInputStream() 获取文件流
void transferTo(File dest) 将上传文件保存到一个目录文件中
编写前端页面:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
file
Controller
package com.yusael.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.commons.CommonsMultipartFile;
import javax.servlet.http.HttpServletRequest;
import java.io.*;
@Controller
public class FileController {
// @RequestParam("file") 将 name=file 控件得到的文件封装成 CommonsMultipartFile 对象
// 批量上传 CommonsMultipartFile 则为数组即可
@RequestMapping("/upload")
public String fileUpload(@RequestParam("file")CommonsMultipartFile file, HttpServletRequest request) throws IOException {
// 获取文件名
String uploadFileName = file.getOriginalFilename();
// 如果文件名为空, 直接回到首页
if ("".equals(uploadFileName)){
return "redirect:/index.jsp";
}
System.out.println("上传文件名: " + uploadFileName);
// 上传路径保存设置
String path = request.getServletContext().getRealPath("/upload");
// 如果路径不存在, 则创建一个
File realPath = new File(path);
if (!realPath.exists()) {
realPath.mkdirs();
}
System.out.println("上传文件保存地址: " + realPath);
// 文件输入流
InputStream is = file.getInputStream();
// 文件输出流
OutputStream os = new FileOutputStream(new File(realPath, uploadFileName));
// 读取写出
int len = 0;
byte[] buffer = new byte[1024];
while ((len = is.read(buffer)) != -1) {
os.write(buffer, 0, len);
os.flush();
}
os.close();
is.close();
return "redirect:/index.jsp";
}
}
Controller:
@RequestMapping("/upload2")
public String fileUpload2(@RequestParam("file") CommonsMultipartFile file, HttpServletRequest request) throws IOException {
// 上传路径保存设置
String path = request.getServletContext().getRealPath("/upload");
File realPath = new File(path);
if (!realPath.exists()) {
realPath.mkdir();
}
System.out.println("上传文件保存地址: " + realPath);
// 通过 CommonsMultipartFile 的方法直接写文件
file.transferTo(new File(realPath + "/" + file.getOriginalFilename()));
return "redirect:/index.jsp";
}
前端页面 index.jsp:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
file
文件下载步骤:
代码实现:
@RequestMapping("/download")
public String downloads(HttpServletResponse response , HttpServletRequest request) throws Exception{
// 要下载的图片地址
String path = request.getServletContext().getRealPath("/upload");
String fileName = "SpringBoot笔记.pdf";
// 1、设置response 响应头
response.reset(); // 设置页面不缓存, 清空buffer
response.setCharacterEncoding("UTF-8"); // 字符编码
response.setContentType("multipart/form-data"); // 二进制传输数据
// 设置响应头
response.setHeader("Content-Disposition",
"attachment;fileName="+ URLEncoder.encode(fileName, "UTF-8"));
File file = new File(path,fileName);
// 2、读取文件--输入流
InputStream input = new FileInputStream(file);
// 3、写出文件--输出流
OutputStream out = response.getOutputStream();
byte[] buff = new byte[1024];
int len = 0;
// 4、执行 写出操作
while ((len = input.read(buff)) != -1) {
out.write(buff, 0, len);
out.flush();
}
out.close();
input.close();
return null;
}
前端页面 index.jsp:
点击下载