上传文件是我们最常见的一个业务场景,下面本篇知识点沿用知识点10的项目,为大家介绍如何开发但文件上传与多文件上传。
用例:添加用户时单文件上传工牌上的证件照第一步:我们在user表中添加一个字段,用来保存文件名
第二步:在User的Bean文件中添加该字段
private String zp;
第三步:在添加用户页面表单中,添加一个文件标签,同时注意表单属性enctype="multipart/form-data" method="post"
第四步:将之前开发的JS添加方法注释掉,开发一个新的JS事件
function saveObject() {
var ser = $("#addFrm").serialize();
//封装文件
var formData = new FormData();
formData.append("file", $("#file")[0].files[0]);
//把表单参数追加到文件对象里
var splitArr = ser.split("&");
for ( x in splitArr){
//等号切分
var s = splitArr[x].split("=");
if(s[0]=="name"){
formData.append("name",$("#name_po").val());
}else{
formData.append(s[0],s[1]);
}
}
// ajax请求
$.ajax({
type: "POST",
url: "/user/add",
data: formData,
processData: false,
contentType: false,
success: function (data) {
alert("文件接收成功")
},
error: function (e) {
alert("文件接收失败");
}
});
}
我这里要解释三点:
一、JS的文件对象不止可以传递文件,它本身也是一个请求参数体的封装类,不要以为它只能用来传递文件
二、对于name参数的处理,并没有直接使用serialize的结果,是因为如果直接封装它的结果,则对于保存值为中文的name字段来说,就成了一个样子是字节数组的字符串,传入后台后会发现进入数据库的是 %87%78%78%78 这样的数据
三、回调函数并没有想之前那样跳转列表页面,这一点后面在解释
第五步:对UserController的添加方法做改造,接收数据
@RequestMapping("/add")
@ResponseBody
public boolean add(User user, MultipartFile file){
try {
if (file != null) {
//判断文件不为空
if (!file.isEmpty()) {
//获取文件名称
String originalFilename = file.getOriginalFilename();
//新文件名称
String fileName = UUID.randomUUID() + "_" + originalFilename;
//创建新文件对象
File destFile = new File("D://imgs", fileName);
//判断目标文件存在否
if (!destFile.getParentFile().exists()) {
//创建目录
destFile.mkdirs();
}
//执行拷贝过程
file.transferTo(destFile);
//保存文件的绝对路径
user.setZp(destFile.getAbsolutePath());
}
}
return userService.save(user);
}catch (IOException io){
io.getMessage();
return false;
}
}
这里我解释两点:
一、在正统的开发中,如果你的项目组不是一个一穷二白刚开始的项目,那么你会拿到团队给你的项目要用的maven仓库依赖,同github上拉取的项目中的pom是一致的,有的项目应为没有自定义的代码所以也会直接使用官方maven库,这个看不同的项目不同的情况,总之正常情况下,会有开发好的工具类,供你将接收到的文件直接上传到项目上准备好的图片文件服务器上,并且将保存路径存放到数据库中,大家可以在百度随便搜索一下图片,你通过f12会发现,它本质上指向的是一个文件服务器路径,比如 https://www.bai.com/img/asdasdhakjaljoicnishaoiu 这种格式的路径
二、我前端并没有在上传成功后跳转列表界面,是因为我的文件存储在了本地一个路径下,数据库里虽然保存了路径,但是访问不到的,但是有第三方插件可以帮助你完成的
映射路径,达到到通过一个虚拟路径来访问你电脑上真实本地路径的需求,但是我觉得没那个必要 ,大家有兴趣可以找一找这样的插件
最后运行代码,看数据库中的效果以及本地文件是否有
用例:添加用户时多文件上传证件照以及另外的任意张个人照
第一步:在user表中添加一个字段保存员工个人照,逻辑上我们将任意个数的文件用逗号分隔路径保存在同一个字段中
第二步:User的Bean实体中添加此字段
private String grz;
第三步:我们在add页面再次修改表单,在单文件上传的基础上,添加一个多文件标签,应注意多文件标签格式
第四步:将单文件上传的JS注释掉,再次重写JS事件
function saveObject() {
var ser = $("#addFrm").serialize();
//封装文件:这里要注意重点来了
var formData = new FormData();
//员工证件照
formData.append("file", $("#file")[0].files[0]);
//封装员工的任意张个人照
var files = $("#files")[0].files;
for(var i=0;i
formData.append("files",files[i]);
}
// 把表单参数追加到文件对象里
var splitArr = ser.split("&");
for ( x in splitArr){
//等号切分
var s = splitArr[x].split("=");
if(s[0]=="name"){
formData.append("name",$("#name_po").val());
}else{
formData.append(s[0],s[1]);
}
}
// ajax请求
$.ajax({
type: "POST",
url: "/user/add",
data: formData,
processData: false,
contentType: false,
success: function (data) {
alert("文件接收成功")
},
error: function (e) {
alert("文件接收失败");
}
});
}
第五步:更改添加数据的控制器
@RequestMapping("/add")
@ResponseBody
public boolean add(User user,MultipartFile file,MultipartFile[] files){
try {
//证件照的处理
if (file != null) {
//判断文件不为空
if (!file.isEmpty()) {
//获取文件名称
String originalFilename = file.getOriginalFilename();
//新文件名称
String fileName = UUID.randomUUID() + "_" + originalFilename;
//创建新文件对象
File destFile = new File("D://imgs", fileName);
//判断目标文件存在否
if (!destFile.getParentFile().exists()) {
//创建目录
destFile.mkdirs();
}
//执行拷贝过程
file.transferTo(destFile);
//保存文件的绝对路径
user.setZp(destFile.getAbsolutePath());
}
}
//任意张个人照的处理
if(files!=null ){
//准备一个字符串缓冲区,保存任意张个人照路径
StringBuffer grzPaths = new StringBuffer();
for(MultipartFile t:files){
if(!t.isEmpty()){
//获取文件名称
String originalFilename = t.getOriginalFilename();
//新文件名称
String fileName = UUID.randomUUID() + "_" + originalFilename;
//创建新文件对象
File destFile = new File("D://imgs", fileName);
//判断目标文件存在否
if (!destFile.getParentFile().exists()) {
//创建目录
destFile.mkdirs();
}
//执行拷贝过程
t.transferTo(destFile);
//拼接文件的绝对路径,用逗号隔开
grzPaths.append(destFile.getAbsolutePath()+",");
}
}
//保存所有个人照路径
user.setGrz(grzPaths.delete(grzPaths.length()-1,grzPaths.length()).toString());
grzPaths.delete(0,grzPaths.length());
}
}catch (IOException io){
io.getMessage();
}
return userService.save(user);
}
最后运行看效果
照片大小有限:我们可以看idea控制台输出的插入语句
JDBC Connection [HikariProxyConnection@1836305745 wrapping com.mysql.cj.jdbc.ConnectionImpl@4a8b92be] will not be managed by Spring ==> Preparing: INSERT INTO user ( id, name, email, brith, did, zp, grz ) VALUES ( ?, ?, ?, ?, ?, ?, ? ) ==> Parameters: 1535922688499924993(Long), 多文件测试(String), 123456789%40qq.com(String), 2022-06-12 00:00:00.0(Timestamp), 1(Integer), D:imgs5abc847a-d9f6-4cc3-9740-e04941671ad2_上传.jpeg(String), D:imgs9500a12a-f1df-4a52-b53a-1ee7a6f44d6c_1.webp,D:imgsf4c29816-6c21-48dd-bff8-80788d78f0c8_2.webp(String) <== Updates: 1 Closing non transactional SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@3a6fb92e]
到此文件上传开发完成
末尾说一点我上面用的是JS,因为考虑到多样化的开发,如果你没有其他需求,你就完成上传就心满意足了,那么你完全可以傻瓜式的submit按钮直接提交表单
但是任然要注意表单中的特定属性值不能错
最后说两个spring boot配置文件中对上传文件大小的配置
#上传单个文件大小的限制 spring.servlet.multipart.max-file-size=2MB #多上传的时候文件大小的限制 spring.servlet.multipart.max-request-size=10MB



