Spring Boot或春云可以快速实现文件上传
很多时候,我们需要快速集成Spring Boot或春云中的文件上传功能,但对于新手来说,添加文件上传功能需要查阅大量文档。这里有一个例子可以帮助你快速将文件上传功能集成到系统中。
第一步,我们需要在application.yml中配置文件上传大小
spring: servlet: multipart: ***x-file-size: 1500MB ***x-request-size: 1500MB
其次,为了快速处理文件名和URL,需要使用FilenameUtils,在pom.xml的依赖项中引入Apache Commons IO注意是否有引用,避免版本冲突。
<dependency> <groupId>commons-io</groupId> <artifactId>commons-io</artifactId> <version>2.11.0</version></dependency>
第三步是编写一个控制器来处理文件上传请求。
import org.apache.commons.io.FilenameUtils;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RequestParam;import org.springframework.web.bind.annotation.RestController;import org.springframework.web.multipart.MultipartFile;import javax.servlet.http.HttpServletRequest;import java.io.File;import java.util.LinkedHashMap;import java.util.Map;import java.util.UUID;/** * 文件上传控制器 * * @author 杨若瑜 */@RestController@RequestMapping("/platform/")public class UploadFileController { // 相对于项目根路径的上传路径 private static final String UPLOAD_FOLDER = "/upload/"; // 返回给前端的服务器根路径(分布式、CDN场景很有用) private static final String URL_SERVER = "http://127.0.0.1:8080/"; // 允许上传的文件扩展名 private static final String[] ALLOW_EXTENSIONS = new String[]{ // 图片 "jpg", "jpeg", "png", "gif", "bmp", // 压缩包 "zip", "rar", "gz", "7z", "cab", // 音视频, "wav", "avi", "mp4", "mp3", "m3u8", "ogg", "w***", "wmv", "rm", "rmvb", "aac", "mov", "asf", "flv", // 文档 "doc", "docx", "xls", "xlsx", "ppt", "pptx", "pot", "txt", "csv", "md", "pdf" }; /** * 判断文件名是否允许上传 * @param fileName 文件名 * @return */ public boolean isAllow(String fileName) { String ext = FilenameUtils.getExtension(fileName).toLowerCase(); for (String allowExtension : ALLOW_EXTENSIONS) { if (allowExtension.toLowerCase().equals(ext)) { return true; } } return false; } /** * 上传文件 * @param request 请求 * @param file 文件,与前台提交表单的file相一致 * @return 返回JSON */ @RequestMapping("upload") public Object upload(HttpServletRequest request, @RequestParam("file") MultipartFile file) { String webAppFolder = request.getServletContext().getRealPath("/"); String fileName = file.getOriginalFilename(); if (isAllow(fileName)) { String ext = FilenameUtils.getExtension(fileName).toLowerCase(); String newFileName = UUID.randomUUID().toString().replace("-", ""); // 自动创建上传目录 String targetPath = FilenameUtils.nor***lize(webAppFolder + "/" + UPLOAD_FOLDER); String targetFile = FilenameUtils.nor***lize(targetPath + "/" + newFileName + "." + ext); new File(targetPath).mkdirs(); try { String urlPath = URL_SERVER + "/" + UPLOAD_FOLDER + "/" + newFileName + "." + ext; file.transferTo(new File(targetFile)); Map<String, Object> resJson = new LinkedHashMap<>(); resJson.put("status", "success"); resJson.put("data", FilenameUtils.nor***lize(urlPath,true).replace("http:/","http://").replace("https:/","https://")); return resJson; } catch (Exception e) { e.printStackTrace(); Map<String, Object> resJson = new LinkedHashMap<>(); resJson.put("status", "error"); resJson.put("message", "文件上传失败:" + e.getMessage()); return resJson; } } else { Map<String, Object> resJson = new LinkedHashMap<>(); resJson.put("status", "error"); resJson.put("message", "该类型文件不允许上传"); return resJson; } }}
第四,写一个测试网页upload.html,启动它,测试它。
<!doctype html><html lang="zh"><head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, ***ximum-scale=1.0, minimum-scale=1.0"> <meta http-equiv="X-UA-Compatible" content="ie=edge"> <title>上传文件测试</title></head><body> <form action="/platform/upload" method="post" enctype="multipart/form-data"> 请选择文件:<input type="file" name="file"><br> <input type="submit" value="上传"> </form></body></html>
选择一张照片并上传。
此时,后台会返回一个JSON,我们打开data指向的图片,看看是否上传成功:
果然,图片已经上传成功。
至此,如何使用Spring Boot或Spring Cloud实现文件上传就写到这里了。最后需要补充的是,如果你的使用场景是通过ajax或者App上传的,那么表单提交类型必须是multipart/form-data,并且要通过post提交。
下面是jQuery的一个例子:
// userInfoAvatar是一个input,并且type为filevar file = document.getElementById('userInfoAvatar').files[0];var formData = new FormData();formData.append("file",file);$.ajax({ type: 'POST', url: '/platform/upload', data: formData, contentType: false, processData: false, dataType: "json", mimeType: "multipart/form-data", success: function(data) { // 成功时回调 }, error : function(data){ // 失败时回调 }});
以axios为例:
// userInfoAvatar是一个input,并且type为filelet file = document.getElementById('userInfoAvatar').files[0];let formData = new FormData();formData.append("file",file);axios({ method: 'POST',url: '/platform/upload',data:formData,headers: { 'Content-Type': 'multipart/form-data'}}).then((data)=>{ console.log(data)}).catch((ex)=>{ console.error(ex)})
在Http客户端上的Fluent API示例:
String fileName = 文件名;byte[] bytes = 文件的二进制;MultipartEntityBuilder builder = MultipartEntityBuilder.create() .setMode(HttpMultipartMode.BROWSER_COMPATIBLE) .setCharset(Charset.forName("utf-8"));builder.addBinaryBody("file", bytes, ContentType.MULTIPART_FORM_DATA, fileName); String responseJson = Request.Post("http://127.0.0.1:8080/platform/upload") .connectTimeout(20000) .socketTimeout(20000) .body(builder.build()) .execute().returnContent().asString();System.out.println(responseJson);
其他框架也可以这样做。切记在将用户放入正式环境之前,要加强安全保护,对用户进行身份验证。
本文来自北蕭投稿,不代表舒华文档立场,如若转载,请注明出处:https://www.chinashuhua.cn/24/497204.html