[Servlet] 파일 업로드 서블릿

파일 업로드 서블릿 예제

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

개뿌

[Servlet] 파일 업로드 서블릿

파일 업로드 서블릿 예제

form 태그로 처리페이지(upload.itwill)를 POST 방식으로 요청하여 사용자로부터 입력받은 값과 파일을 전달하는 HTML 문서 작성

입력페이지(fileupload.html)에서 전달된 값과 파일명을 클라이언트에게 전달하여 응답하는 서블릿 생성

'학원 > 복기' 카테고리의 다른 글

티스토리툴바

[Servlet] 파일 업로드 서블릿

파일 업로드 서블릿 예제

form 태그로 처리페이지(upload.itwill)를 POST 방식으로 요청하여 사용자로부터 입력받은 값과 파일을 전달하는 HTML 문서 작성

입력페이지(fileupload.html)에서 전달된 값과 파일명을 클라이언트에게 전달하여 응답하는 서블릿 생성

'학원 > 복기' 카테고리의 다른 글

'학원/복기' Related Articles

티스토리툴바