3.6 KiB
3.6 KiB
DOC-002: 파일 업로드
Introduction
파일을 업로드하는데 LOCAL과 S3 두가지 전략이 있다. LOCAL은 WAS 가 접근가능한 저장공간을 제어하는 정책(기본)이며,
S3는 AWS의 저장 스토리지를 다루는 전략이다.
어떤 전략을 취하든 우리는 동일한 인터페이스를 이용하면 된다.
Interface
SaveToStorageService 의 operate 메서드를 호출해 파일 업로드를 수행한다.
| Arguments | Description |
|---|---|
| FileUploadType | 파일 타입과 업로드 전략 등 파일 업로드에 필요한 정보를 담은 enum 객체 |
| MultipartFile | 업로드 Multipart File |
- FileUploadType 에 정의한 FileStorageType 설정값(
LocalorS3) 을 통해 업로드 공간이 결정된다.
| 반환 타입 | 설명 |
|---|---|
| Optional<SaveToStorage> | ... |
Set up
파일 업로드에 관한 공통 설정은 core.properties 에 선언했다.
spring.servlet.multipart.max-file-size=10MB
spring.servlet.multipart.max-request-size=50MB
spring.servlet.multipart.file-size-threshold=1MB
스프링 profile 별로 차별화된 설정은 core-${spring.profiles.active}.properties 에 기술한다.
(예) core-local.properties
# `Public` 업로드 경로
path.upload.public=${user.home}/upload/public
# file-size-threshold 용량이 넘는 파일 업로드시 사용할 임시 디렉토리
path.upload.tmpdir=${user.home}/upload/tmpdir
spring.servlet.multipart.location=${path.upload.tmpdir}
path.upload.tmpdir는 multipart 용량이file-size-threshold을 초과할 때 임시적으로 파일을 저장 할 수 있는 공간이다.
How to use
파일 업로드는 SaveToStorageService 를 이용한다.
// 예제 게시판 업로드
SaveToStorageService.operate(FileUploadType.EXAMPLE_PUBLIC, multipartFile);
-
FileUploadType은 파일 업로드 타입과 저장 경로, 그리고 외부 공개여부에 대한 정보를 정의한 enum 객체이다. -
multipartFile사용자가 선택한 파일 객체.
FileUploadType 객체는 파일 업로드와 관한 필수 정보를 담고 있다. 추후 새로운 파일 업로드 기능이 추가 될때 마다 이곳에 관련 정보를 기술해야합니다.
// FileUploadType.EXAMPLE_PUBLIC 에 정의된 정보
...
EXAMPLE_PUBLIC(
FileStorageType.LOCAL, // fileStorageType
"/exampleBoard", // sub 디렉토리
Set.of( // 허용 타입
AcceptableFileType.IMAGE,
AcceptableFileType.EXCEL,
AcceptableFileType.PPT,
AcceptableFileType.HWP,
AcceptableFileType.WORD,
AcceptableFileType.CSV,
AcceptableFileType.TXT,
AcceptableFileType.PDF,
AcceptableFileType.ZIP)),
fileStorageType은 파일이 저장될 공간.LOCAL과S3가 제공된다.subPath는 게시판에 따른 분류 등으로 사용할 때 이용. 공지사항 게시물의 업로드 파일이기에 /exampleBoard 서브 경로에 담도록 지정했다.acceptableFileTypes에 허용할 파일 타입을 명시. 지정된 파일 타입과 다른 파일이 업로드 될때UnAcceptableFileExceoption이 발생한다.
acceptableFileTypes
SaveToStorageService는 acceptableFileTypes 에 기술된
FileType 을 기준으로 검증작업을 수행한다. multipartFile 을 inputstream 으로 읽어 MIME Type 적합성 여부를 판단한다.