파일 업로드 서블릿 예제
form 태그로 처리페이지(upload.itwill)를 POST 방식으로 요청하여 사용자로부터 입력받은 값과 파일을 전달하는 HTML 문서 작성
웹프로그램 요청시 사용자로부터 입력받은 파일을 전달하기 위해 form 태그를 사용한다.
→ 사용자로부터 입력된 파일을 웹프로그램에게 전달하기 위해 form 태그의 method 속성값을 반드시 [post]로 설정하고 enctype 속성값을 [multipart/form-data]로 설정한다.
multipart/form-data:파일을 원시데이터로 전달하는 속성값
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Servlet</title>
</head>
<body>
<h1>파일 업로드</h1>
<hr>
<form action="upload.itwill" method="post" enctype="multipart/form-data">
<table>
<tr>
<td>올린이</td>
<td><input type="text" name="uploader"></td>
</tr>
<tr>
<td>파일1</td>
<td><input type="file" name="fileone"></td>
</tr>
<tr>
<td>파일2</td>
<td><input type="file" name="filetwo"></td>
</tr>
<tr>
<td colspan="2"><button type="submit">제출</button></td>
</tr>
</table>
</form>
</body>
</html>
입력페이지(fileupload.html)에서 전달된 값과 파일명을 클라이언트에게 전달하여 응답하는 서블릿 생성
→ 전달파일은 서버 디렉토리에 저장한다. 이를 파일 업로드(Upload) 처리라고 부른다.
[multipart/form-data]로 전달된 값은 request 객체로부터 입력스트림(ServletInputStream 객체)을 제공받아 임시파일에 저장한 후 전달값과 전달파일을 구분하여 처리한다.
→ [multipart/form-data]를 처리하는 클래스를 이용하여 처리하는 것을 권장한다.
먼저 [multipart/form-data]를 처리하는 클래스가 포함된 라이브러리를 다운로드 받아 프로젝트에 빌드해야한다.
방법1) Apache 그룹에서 배포한 commons-fileupload 라이브러리의 클래스를 사용할 수 있다.
→ 파일 업로드를 할 때, 선택적으로 파일을 업로드를 할 수 있다. (검증 통과한 파일의 업로드만 가능하다)
방법2) Oreilly 그룹에서 배포한 cos 라이브러리의 클래스를 사용할 수 있다.
→ 파일 업로드를 할 때, 무조건 파일을 업로드 해야한다. (검증을 할 수 없으며, 검증과 상관없이 모두 업로드한다)
Oreilly 그룹에서 배포한 cos 라이브러리를 다운로드 받아 프로젝트에 빌드 처리하기
1. http://www.servlets.com 사이트 접속 >> COS File Upload Library 메뉴 >> cos-22.05.zip 파일 다운로드
2. cos-22.05.zip 파일 압축 풀기 >> cos-22.05 폴더로 이동 >> lib 폴더 >> cos.jar 파일 복사
3. 프로젝트 >> src/main/webapp >> WEB-INF >> lib >> cos.jar 파일 붙여넣기
/WEB-INF/lib 폴더에 라이브러리 파일(jar 파일)을 복사 붙여넣기 하면 자동으로 빌드 처리 된다.
UploadServlet 클래스 생성
@WebServlet("/upload.itwill")
public class UploadServlet extends HttpServlet {
private static final long serialVersionUID = 1L;
protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
//파일형태(MimeType)를 변경
response.setContentType("text/html;charset=utf-8");
//응답파일을 생성하기 위한 출력스트림을 반환받아 저장
PrintWriter out=response.getWriter();
}
}
클라이언트가 접근할 수 있도록 wepabb 내에 upload 폴더를 생성했다.
1.전달파일을 저장하기 위한 서버 디렉토리의 시스템 파일 경로를 반환받아 저장한다.
→ 이클립스의 작업 디렉토리(WorkSpace)가 아닌 WAS 프로그램이 사용하는 웹디렉토리(WebApps)의 시스템 경로를 반환받아 파일 시스템 경로를 반환한다.
String saveDirectory=request.getServletContext().getRealPath("/upload");
//System.out.println("saveDirectory = "+saveDirectory);
파일을 업로드
이미지를 업로드하면 이미지를 이클립스에서 작업하는 upload 폴더가 아니라,
[C:\Users\user\Desktop\apache-tomcat-9.0.75\webapps\servlet\upload] 경로에서 확인할 수 있다.
주의) WAS 프로그램이 실행(Start)될 때 이클립스의 작업 디렉토리의 파일을 이용하여 웹디렉토리의 자원(Context)으로 변환하여 저장한다. (동기화 처리)
→ 작업 디렉토리에 업로드 파일이 없으므로 동기화 처리되면 웹디렉토리에 업로드된 파일이 소멸된다.
2. cos 라이브러리의 MultipartRequest 클래스로 객체를 생성한다.
→ 객체를 생성하면 모든 전달파일을 제공받아 서버 디렉토리에 저장하기 때문에 자동 업로드 처리 된다.
MultipartRequest 객체 : [multipart/form-data]로 전달받은 값과 파일을 처리하기 위한 객체
→ MultipartRequest(HttpServletRequest request, saveDirectory, [,int maxPostSize][, String encoding][, FileRenamePolicy policy]) 생성자를 이용하여 객체를 생성한다.
- request : 요청정보가 저장된 HttpServletRequest 객체를 전달
- saveDirectory : 전달파일이 저장될 서버 디렉토리의 파일 시스템 경로를 전달
- maxPostSize : 전달파일의 용량을 제한하기 위한 크기(Byte)를 전달 (생략시 무제한 기본값으로 사용)
- encoding : 전달값에 제공받기 위한 문자형태를 전달 (생략시 서유럽어를 기본값으로 사용)
- policy : FileRenamePolicy 객체를 전달 (생략시 전달파일로 기존파일을 덮어씌운다)
FileRenamePolicy 객체 : 업로드될 파일의 이름과 같은 이름의 파일이 서버 디렉토리에 이미 존재할 경우, 업로드될 파일의 이름을 변경하는 기능을 제공하는 객체
→ FileRenamePolicy 인터페이스를 상속받은 자식클래스로 객체를 생성한다.
MultipartRequest mr=new MultipartRequest(request, saveDirectory, 20*1024*1024
, "utf-8", new DefaultFileRenamePolicy());
3. MultipartRequest 객체를 이용하여 전달값을 반환받아 저장한다.
→ MultipartRequest.getParamater(String name) 또는 getParamaterValues(String name) 메소드 호출
String uploader=mr.getParameter("uploader");
4. MultipartRequest 객체를 이용하여 전달파일명을 반환받아 저장한다.
MultipartRequest .getOriginalFileName(String name) : 매개변수로 전달된 이름의 전달 파일명(입력파일)을 반환하는 메소드
String fileone=mr.getOriginalFileName("fileone");
String filetwo=mr.getOriginalFileName("filetwo");
5. 응답파일 생성
out.println("<!DOCTYPE html>");
out.println("<html>");
out.println("<head>");
out.println("<meta charset='UTF-8'>");
out.println("<title>Servlet</title>");
out.println("</head>");
out.println("<body>");
out.println("<h1>파일업로드</h1>");
out.println("<hr>");
out.println("<p>올린이 = "+uploader+"</p>");
out.println("<p>파일1 = "+fileone+"</p>");
out.println("<p>파일2 = "+filetwo+"</p>");
out.println("</body>");
out.println("</html>");
[전체 소스코드]
package xyz.itwill.servlet;
import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import com.oreilly.servlet.MultipartRequest;
import com.oreilly.servlet.multipart.DefaultFileRenamePolicy;
//입력페이지(fileupload.html)에서 전달된 값과 파일명을 클라이언트에게 전달하여 응답하는 서블릿
// => 전달파일은 서버 디렉토리에 저장한다. - 파일 업로드(Upload) 처리
@WebServlet("/upload.itwill")
public class UploadServlet extends HttpServlet {
private static final long serialVersionUID = 1L;
protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
response.setContentType("text/html;charset=utf-8");
PrintWriter out=response.getWriter();
if(request.getMethod().equals("GET")) {
response.sendRedirect("fileupload.html");
return;
}
request.setCharacterEncoding("utf-8");
/*
//form 태그의 [multipart/form-data]로 전달된 입력값은 HttpServletRequest 객체의
//getParameter() 메소드를 호출하여 반환이 불가능하다.
String uploader=request.getParameter("uploader");
*/
//전달파일을 저장하기 위한 서버 디렉토리의 시스템 파일 경로를 반환받아 저장
String saveDirectory=request.getServletContext().getRealPath("/upload");
//System.out.println("saveDirectory = "+saveDirectory);
//cos 라이브러리의 MultipartRequest 클래스로 객체 생성
MultipartRequest mr=new MultipartRequest(request, saveDirectory, 20*1024*1024
, "utf-8", new DefaultFileRenamePolicy());
//MultipartRequest 객체를 이용하여 전달값을 반환받아 저장
String uploader=mr.getParameter("uploader");
//MultipartRequest 객체를 이용하여 전달파일명을 반환받아 저장
String fileone=mr.getOriginalFileName("fileone");
String filetwo=mr.getOriginalFileName("filetwo");
//응답파일 생성
out.println("<!DOCTYPE html>");
out.println("<html>");
out.println("<head>");
out.println("<meta charset='UTF-8'>");
out.println("<title>Servlet</title>");
out.println("</head>");
out.println("<body>");
out.println("<h1>파일업로드</h1>");
out.println("<hr>");
out.println("<p>올린이 = "+uploader+"</p>");
out.println("<p>파일1 = "+fileone+"</p>");
out.println("<p>파일2 = "+filetwo+"</p>");
out.println("</body>");
out.println("</html>");
}
}
FileRenamePolicy 객체를 사용한 경우 getFilesystemName() 메소드를 사용해 업로드된 파일명을 반환할 수 있다.
MultipartRequest.getFilesystemName(String name) : 매개변수로 전달된 이름의 파일명(업로드된 파일명)을 반환하는 메소드 → FileRenamePolicy 객체를 사용한 경우 호출하는 메소드
String fileone=mr.getFilesystemName("fileone");
String filetwo=mr.getFilesystemName("filetwo);
'학원 > 복기' 카테고리의 다른 글
[Servlet] 세션(Session) (0) | 2023.06.18 |
---|---|
[Servlet] 쿠키(Cookie) (0) | 2023.06.18 |
[Servlet] 생명주기(Lifecycle) (0) | 2023.06.15 |
[Servlet] 이미지 파일로 응답하기 위한 서블릿 만들기 (0) | 2023.06.15 |
[Servlet] Servlet 프로그램 작성 방법 (2) (0) | 2023.06.15 |