📌 [Java Servlet 파일 업로드 구현 - FileSystem 저장 + 목록 출력 + Drag & Drop + Axios 비동기 처리]

📅 날짜

2025년 4월 18일

---

📝 학습 내용

✅ 파일 업로드 방식 비교

방식	설명	장점	단점
DB (BLOB)	DB에 파일 자체를 저장	트랜잭션/백업 용이	대용량 처리 부적합
FileSystem + 경로만 DB저장	파일은 서버에 저장, DB에는 경로만 저장	성능 우수, 단순 처리	경로 관리 실패 시 불안정

---

✅ 전체 업로드/다운로드 흐름 요약

[1] 사용자 파일 선택 or Drag & Drop
 ↓
[2] JS에서 FormData 구성 후 Axios로 서버에 POST 요청
 ↓
[3] UploadController → FileServiceImpl 호출 → 파일 저장
 ↓
[4] 목록 요청 → ListController → 파일 시스템에서 목록 조회
 ↓
[5] 다운로드 요청 시 → DownloadController → FileServiceImpl.download()
 ↓
[6] 파일 스트리밍 후 사용자 브라우저로 전송

---

✅ @MultipartConfig 설정

@WebServlet("/file/upload")
@MultipartConfig(
  fileSizeThreshold = 1024 * 1024,
  maxFileSize = 1024 * 1024 * 5,
  maxRequestSize = 1024 * 1024 * 20
)

---

✅ UploadController.java

• POST 요청 시 업로드 처리
• 업로드 성공 시 목록 페이지로 리다이렉트
• 실패 시 업로드 뷰로 다시 포워딩
• 사용자에게 성공 메시지 전달 가능 (req.setAttribute("message", "업로드 성공!") 등)

---

✅ FileServiceImpl.java - 업로드, 목록, 다운로드 통합

🔹 파일 업로드

String folderName = LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyyMMdd_HHmmss"));
String UploadPath = ROOT_PATH + "/" + UPLOAD_PATH + "/" + folderName + "/";
File dir = new File(UploadPath);
if (!dir.exists()) dir.mkdirs();

String filename = ... // 원본 이름
String uuid = UUID.randomUUID().toString();
String newFileName = uuid + "_" + filename; // UUID 적용
part.write(UploadPath + newFileName);

🔹 파일 확장자 제한 예시

String ext = filename.substring(filename.lastIndexOf(".") + 1).toLowerCase();
List<String> blocked = List.of("exe", "bat", "sh");
if (blocked.contains(ext)) throw new ServletException("허용되지 않는 파일 형식입니다.");

🔹 파일 목록 조회

Map<String, List<File>> map = new LinkedHashMap<>();
for (File folder : uploadRoot.listFiles()) {
    map.put(folder.getName(), Arrays.stream(folder.listFiles()).toList());
}

🔹 파일 다운로드

String path = ROOT_PATH + "/" + UPLOAD_PATH + "/" + folder + "/" + filename;
File file = new File(path);
if (!file.exists()) {
  response.sendError(HttpServletResponse.SC_NOT_FOUND, "파일이 존재하지 않습니다.");
  return false;
}
response.setHeader("Content-Disposition", "attachment;filename=" + URLEncoder.encode(filename, "UTF-8"));

---

✅ ListController.java

Map<String, List<File>> map = fileService.getFileList();
req.setAttribute("map", map);
req.getRequestDispatcher("/WEB-INF/view/file/list.jsp").forward(req, resp);

---

✅ DownloadController.java

boolean isDownloaded = fileService.download(req, resp);
// 직접 다운로드 처리 (뷰 없음)

---

✅ list.jsp - 업로드된 파일 목록 출력 + 다운로드 링크

<h1>FILE LIST</h1>
<%
	Map<String,List<File>> map = (Map<String,List<File>>)request.getAttribute("map");
	if (map != null) {
		for (String folder : map.keySet()) {
%>
	<h3><%= folder %></h3>
<%
			for (File file : map.get(folder)) {
%>
	<a href="/file/download?folder=<%= folder %>&filename=<%= file.getName() %>">
		<%= file.getName() %>
	</a><br/>
<%
			}
			out.println("<hr/>");
		}
	}
%>

---

📚 개념 정리

🔹 multipart/form-data란?

HTML 폼에서 파일을 포함한 데이터를 서버로 전송할 때 사용하는 인코딩 방식

🔹 FormData 객체란?

JS에서 파일 및 데이터를 key-value 쌍으로 구성하여 서버에 보내는 객체

🔹 UUID란?

Universal Unique Identifier. 중복되지 않는 고유한 문자열로 파일명 충돌을 방지함

🔹 Content-Disposition: attachment란?

브라우저가 파일을 열지 않고 다운로드하게 지시하는 응답 헤더

🔹 Part란?

multipart 요청에서 파일 또는 필드 하나하나를 의미하는 객체 (Servlet 3.0 이상 지원)

🔹 URLEncoder.encode()란?

URL에 한글, 공백, 특수문자가 들어갈 경우 깨짐을 방지하기 위해 인코딩 처리하는 메서드

---

🔗 참고 자료

• Java Servlet - Part API
• MultipartConfig 공식 설명
• Java UUID

---

이제 이 내용을 Velog에 그대로 복붙해서 업로드 가능합니다! 🚀
다음 편에서는 파일 삭제 기능 구현, 파일 경로 DB 저장 및 조회, 파일명 정규화/보안 필터링을 이어서 다룰 수 있어요.
필요하면 바로 말해주세요! 😊