JSP 파일 업로드 개요
JSP(JavaServer Pages)를 사용하면 사용자가 웹 브라우저에서 이미지, 문서 등 다양한 파일을 서버로 전송하는 기능을 비교적 간단하게 구현할 수 있습니다. 이 글에서는 JSP 환경에서 파일 업로드 기능을 만들기 위해 반드시 알아야 할 핵심 요소들을 단계별로 정리했습니다.
1. multipart/form-data 형식의 HTML 폼 작성
파일을 업로드하려면 먼저 HTML 폼의 enctype 속성을 multipart/form-data로 지정해야 합니다. 이 속성이 없으면 서버 측에서 파일 데이터를 정상적으로 받을 수 없습니다.
<form action="upload.jsp" method="post" enctype="multipart/form-data">
<input type="file" name="file" />
<input type="submit" value="업로드" />
</form>2. Apache Commons FileUpload 라이브러리 준비
JSP에서 멀티파트 요청을 손쉽게 처리하려면 Apache 재단에서 제공하는 Commons FileUpload와 Commons IO 라이브러리가 필요합니다. 두 JAR 파일을 다운로드한 후 프로젝트의 WEB-INF/lib 디렉터리에 넣어주면 됩니다.
- commons-fileupload.jar — 멀티파트 요청 파싱 담당
- commons-io.jar — 파일 입출력 유틸리티 제공
3. 업로드를 처리하는 JSP 코드 작성
라이브러리가 준비되었다면, 전송된 파일을 저장할 JSP 페이지를 작성합니다. 기본적인 처리 흐름은 다음과 같습니다.
DiskFileItemFactory factory = new DiskFileItemFactory();
ServletFileUpload upload = new ServletFileUpload(factory);
List<FileItem> items = upload.parseRequest(request);
for (FileItem item : items) {
if (!item.isFormField()) {
String fileName = new File(item.getName()).getName();
File savedFile = new File("/업로드경로/" + fileName);
item.write(savedFile);
}
}위 코드는 요청으로 전달된 파일 항목을 순회하며, 실제 파일인 경우 지정한 경로에 저장하는 방식입니다. 실무에서는 파일명 중복 방지, 확장자 검증, 업로드 용량 제한 등의 보안 처리를 함께 적용하는 것이 좋습니다.
마치며
지금까지 JSP에서 파일 업로드 기능을 구현하는 기본 절차를 살펴보았습니다. 더 자세한 설명과 예제가 필요하다면 아래 Tutorialspoint의 공식 튜토리얼을 참고해 보세요.