** 📌파일 업로드 구현 **

JSP + Servlet 환경에서 이미지, 첨부파일 등을 업로드하고

서버에 안전하게 저장하는 전체 흐름과 예제 완전 정리

---

🧩 목차

1. 개념: 파일 업로드란?
2. 전체 흐름도
3. enctype=”multipart/form-data”란?
4. 업로드 처리 방법 (cos.jar or commons-fileupload 사용)
5. 실전 예제 코드
6. 저장 경로 및 파일명 처리
7. 기술 면접 대비 핵심 요약
8. 마무리 요약 + Notion 작성 팁

---

✅ 1. 개념: 파일 업로드란?

항목	설명
정의	사용자가 브라우저에서 선택한 파일을 서버로 전송하고 저장하는 과정
사용 목적	프로필 이미지, 게시판 첨부파일, 문서 업로드 등
처리 방식	<form> 태그에서 enctype="multipart/form-data" 사용 필수

---

✅ 2. 전체 흐름도

[1] form.jsp
 ⬇ (파일 선택 + form 전송)
[2] UploadServlet
 ⬇ (MultipartRequest 처리)
[3] 서버 경로에 파일 저장
 ⬇
[4] DB에 파일명 저장 or 화면 출력

---

✅ 3. enctype=”multipart/form-data”란?

항목	설명
역할	파일을 포함한 form 데이터를 일반 텍스트가 아닌 바이너리 형식으로 전송
필수 조건	<form method="post" enctype="multipart/form-data"> 설정 시만 파일 전송 가능

---

✅ 4. 업로드 처리 방법

✅ 가장 많이 쓰는 방법: cos.jar (MultipartRequest)

항목	설명
클래스	com.oreilly.servlet.MultipartRequest
필요 라이브러리	cos.jar (웹 프로젝트 /WEB-INF/lib에 추가)
장점	간단하게 파일 저장 가능, 별도 Servlet 설정 불필요
단점	대용량 파일, 파일 필터 등 고급 기능 부족

---

✅ 5. 실전 예제 코드

---

📄 [1] upload.jsp (업로드 폼)

<form action="upload" method="post" enctype="multipart/form-data">
  파일 선택: <input type="file" name="uploadFile" /><br />
  <input type="submit" value="업로드" />
</form>

---

📄 [2] UploadServlet.java

@WebServlet("/upload")
public class UploadServlet extends HttpServlet {
  protected void doPost(HttpServletRequest request, HttpServletResponse response)
      throws ServletException, IOException {

    String savePath = request.getServletContext().getRealPath("/upload"); // 저장 폴더 경로
    int maxSize = 10 * 1024 * 1024; // 최대 10MB
    String encoding = "UTF-8";

    // cos.jar 기반 MultipartRequest 객체 생성
    MultipartRequest multi = new MultipartRequest(
      request,
      savePath,
      maxSize,
      encoding,
      new DefaultFileRenamePolicy() // 중복 시 파일명 자동 변경
    );

    // input name="uploadFile"의 파일 이름 얻기
    String fileName = multi.getFilesystemName("uploadFile");

    response.setContentType("text/html;charset=UTF-8");
    PrintWriter out = response.getWriter();
    out.println("<h3>업로드 완료: " + fileName + "</h3>");
  }
}

---

✅ 프로젝트에 cos.jar 추가 방법

• cos.jar 다운로드 링크
• /WEB-INF/lib/ 폴더에 넣기
• 프로젝트 재빌드 (이클립스, IntelliJ 등에서)

---

✅ 6. 저장 경로 및 파일명 처리 팁

항목	예시/설명
저장 경로	getServletContext().getRealPath("/upload") = 서버의 실제 경로
중복 방지	DefaultFileRenamePolicy() → 자동으로 파일명 변경 (예: photo.png → photo1.png)
DB 저장 시	파일명을 DB에 저장하면 이후 다운로드/출력에 활용 가능

---

✅ 7. 기술 면접 대비 핵심 요약 💬

질문	요점 정리
파일 업로드 시 form 설정은?	method=”post” + enctype=”multipart/form-data”
Servlet에서 파일 처리 클래스는?	MultipartRequest (cos.jar)
저장 경로는 어떻게 구하나요?	getServletContext().getRealPath("/폴더")
파일 중복 시 처리 방법은?	DefaultFileRenamePolicy() 또는 UUID 활용
cos.jar 말고 다른 방법은?	Apache commons-fileupload, Spring Multipart 지원 등

---

✅ 8. 마무리 요약 🧠

• 📁 파일 업로드는 Multipart/form-data로 처리
• 🔧 서버에서는 MultipartRequest로 파싱 후 저장
• 📌 파일명, 경로는 반드시 DB나 변수로 저장해서 관리
• ✅ 파일 업로드 구현은 게시판, 프로필 이미지, 자료실 등에서 기본 기술