企业级spring-boot案例系列文章上线了,涵盖了大部分企业级的spring-boot使用场景,会不定期进行更新,企业级spring-boot案例源码地址:https://gitee.com/JourWon/spring-boot-example,欢迎各位大佬一起学习和指正
网站上传图片、文件等,常见操作是直接上传到服务器的webapp目录下,或者直接上传服务的一个指定的文件夹下面。这种方式对于简单的单机应用确实是很方便、简单,出现的问题也会比较少。但是对于分布式项目,直接上传到项目路径的方式显然是不可靠的,而且随着业务量的增加,文件也会增加,对服务器的压力自然就增加了。这里简单的介绍常见的几种上传图片、文件的方式。
-
直接上传到指定的服务器路径;
-
上传到第三方内容存储器,比如将图片保存到阿里云OSS;
-
自己搭建文件存储服务器,如:FastDFS,FTP服务器等
本文主要讲最简单的方式,即上传文件或者图片到服务器的一个指定的文件夹下面,项目结构如下图
com.github.xiaoymin
knife4j-spring-boot-starter
org.projectlombok
lombok
true
org.springframework.boot
spring-boot-starter-web
在application.yml
配置文件添加如下配置
spring配置
spring:
application:
应用名称
name: spring-boot-file-upload
servlet:
multipart:
单个文件所能上传的文件大小
max-file-size: 1MB
单次请求所能上传文件的总文件大小
max-request-size: 10MB
@EnableKnife4j
@Configuration
public class Knife4jConfig {
/**
-
创建Docket对象
-
@return Docket
*/
@Bean
public Docket createRestApi() {
return new Docket(DocumentationType.OAS_30)
.apiInfo(apiInfo())
.select()
.apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
.paths(PathSelectors.any())
.build();
}
/**
-
API基础信息
-
@return ApiInfo
*/
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title(“Knife4j-API接口文档”)
.description(“API接口文档”)
.contact(new Contact(“JourWon”, “https://thinkwon.blog.csdn.net/”, “JourWon@163.com”))
.version(“1.0.0”)
.build();
}
}
4.1 响应编码枚举
@Getter
@AllArgsConstructor
public enum CommonResponseCodeEnum {
/**
- 成功
*/
SUCCESS(“00000”, “成功”),
/**
- 用户请求参数错误
*/
REQUEST_PARAMETER_ILLEGAL(“A0400”, “用户请求参数错误”),
/**
- 访问未授权
*/
UNAUTHORIZED_ACCESS(“A0301”, “访问未授权”),
/**
- 不支持当前请求类型
*/
NONSUPPORT_REQUEST_TYPE(“A0444”, “不支持当前请求类型”),
/**
- 用户id不存在
*/
USER_ID_NOT_EXIST(“A0445”, “用户id不存在”),
/**
- 数据库字段重复
*/
DATABSE_FIELD_DUPLICATE(“A0446”, “数据库字段重复”),
/**
- 系统执行出错
*/
SYSTEM_EXCEPTION(“B0001”, “系统执行出错”),
/**
- 系统执行超时
*/
SYSTEM_EXECUTION_TIMEOUT(“B0100”, “系统执行超时”),
;
/**
- 响应编码
*/
private final String code;
/**
- 响应信息
*/
private final String message;
}
4.2 上传文件信息
@Data
@NoArgsConstructor
@AllArgsConstructor
public class UploadFile {
/**
- 文件名
*/
private String fileName;
/**
- 文件url
*/
private String url;
}
4.3 统一返回前端的响应对象
@Data
@NoArgsConstructor
@AllArgsConstructor
@ApiModel(value = “CommonResponse-统一返回前端的响应对象”)
public class CommonResponse implements Serializable {
private static final long serialVersionUID = -1338376281028943181L;
/**
- MDC_KEY
*/
public static final String MDC_KEY = “traceId”;
@ApiModelProperty(value = “响应编码”)
private String code;
@ApiModelProperty(value = “响应信息”)
private String message;
@ApiModelProperty(value = “业务数据”)
private T data;
@ApiModelProperty(value = “traceId”)
private String traceId = MDC.get(MDC_KEY);
@ApiModelProperty(value = “响应日期时间”)
@JsonFormat(timezone = “GMT+8”, pattern = “yyyy-MM-dd HH:mm:ss.SSS”)
private LocalDateTime localDateTime = LocalDateTime.now();
public CommonResponse(String code, String message) {
this.code = code;
this.message = message;
}
public CommonResponse(CommonResponseCodeEnum commonResponseCodeEnum) {
this.code = commonResponseCodeEnum.getCode();
this.message = commonResponseCodeEnum.getMessage();
}
public CommonResponse(T data) {
this.code = CommonResponseCodeEnum.SUCCESS.getCode();
this.message = CommonResponseCodeEnum.SUCCESS.getMessage();
this.data = data;
}
public CommonResponse(CommonResponseCodeEnum commonResponseCodeEnum, T data) {
this.code = commonResponseCodeEnum.getCode();
this.message = commonResponseCodeEnum.getMessage();
this.data = data;
}
public static CommonResponse success() {
return new CommonResponse<>(CommonResponseCodeEnum.SUCCESS);
}
public static CommonResponse success(String message) {
return new CommonResponse<>(CommonResponseCodeEnum.SUCCESS.getCode(), message);
}
public static CommonResponse success(T data) {
return new CommonResponse<>(CommonResponseCodeEnum.SUCCESS, data);
}
public static CommonResponse success(CommonResponseCodeEnum commonResponseCodeEnum, T data) {
return new CommonResponse<>(commonResponseCodeEnum, data);
}
public static CommonResponse failure(CommonResponseCodeEnum commonResponseCodeEnum) {
return new CommonResponse<>(commonResponseCodeEnum);
}
public static CommonResponse failure(CommonResponseCodeEnum commonResponseCodeEnum, T data) {
return new CommonResponse<>(commonResponseCodeEnum, data);
}
}
5.1 文件上传接口
public interface FileStorageService {
/**
- 初始化方法,创建文件夹
*/
void init();
/**
-
保存文件
-
@param multipartFile
*/
void save(MultipartFile multipartFile);
/**
-
根据文件名加载文件
-
@param filename
-
@return
*/
Resource load(String filename);
/**
-
加载所有的文件
-
@return
*/
Stream
/**
- 递归删除文件
*/
void clear();
}
5.2 文件上传接口实现类
@Service
public class FileStorageServiceImpl implements FileStorageService {
private final Path path = Paths.get(“fileStorage”);
@Override
public void init() {
try {
if (!Files.exists(path)) {
Files.createDirectory(path);
}
} catch (IOException e) {
throw new RuntimeException(“Could not initialize folder for upload!”);
}
}
最后
自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。
深知大多数Java工程师,想要提升技能,往往是自己摸索成长,自己不成体系的自学效果低效漫长且无助。
因此收集整理了一份《2024年Java开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Java开发知识点,不论你是刚入门Android开发的新手,还是希望在技术上不断提升的资深开发者,这些资料都将为你打开新的学习之门!
如果你觉得这些内容对你有帮助,需要这份全套学习资料的朋友可以戳我获取!!
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!
ould not initialize folder for upload!");
}
}
最后
自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。
深知大多数Java工程师,想要提升技能,往往是自己摸索成长,自己不成体系的自学效果低效漫长且无助。
因此收集整理了一份《2024年Java开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
[外链图片转存中…(img-ddnWgPK5-1715238315783)]
[外链图片转存中…(img-DQzNEnIh-1715238315783)]
[外链图片转存中…(img-5NJij9bh-1715238315784)]
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Java开发知识点,不论你是刚入门Android开发的新手,还是希望在技术上不断提升的资深开发者,这些资料都将为你打开新的学习之门!
如果你觉得这些内容对你有帮助,需要这份全套学习资料的朋友可以戳我获取!!
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!