파일 업로드 multipart/form-data

출처 : http://blog.naver.com/callzone?Redirect=Log&logNo=140055259392

파일 업로드를 위한 기본적인 폼 형태

 

웹 브라우저를 통해서 파일은 전송하기 위해서 폼 구성에 대해서 알아보자. form  태그의 속성돌중 input 태그들이 있는데

이들중 <input type="file"> 태그는 파일을 선택할 수 있는 창을 만든다.

또한 이렇게 선택된 파일을 전송하기 위해서 form 태그의 속성들 중 method외 enctype을 다음과 같이 지정한다.

 

<form name="formName" method="post" enctype="multipart/form-data">

 

<input type="file" name="selectfile">

 

Warn

 

<form method="post" enctype="multipart/form-data">으로 지정한 폼 요소에서 파일 업로드를 위한

파일 요소를 지정해야한다.

<input type="file" name="filetype"> input 태그의 속성으로 type은 file로 지정하고,

 이 태그에 대한 이름을 명시 해야한다.

 

<form method="post">의 형태로 전송한 폼에 담겨진 파라미터들은 request 객체를 통해서 이름에 해당되는 값을 얻어낼 수 있다.

하지만 이렇게 <form name="formName" method="post" enctype="multipart/form-data">에서 enctype="multipart/form-data"로

지정한 폼을 전송했을때, request 객체로 파라미터의 값을 얻어 낼수 없다.

 

그래서 enctype="multipart/form-data" 로 전송한 폼에 담겨진 파라미터들에 대한 이름과 값을 얻어내기 위해,그리고

<input type="file">로 지정된 파일을 서버상의 한 폴더에 업로드하기 위해서 특별한 컴포넌트가 필요하다.

http://servlets.com 에서 제공하는 cos.jar 파일에는 필요한 컴포넌트가 있다.

이 컴포넌트를 설치하자.

 

Tip

파일업로드 및, 폼 데이터를 파싱하는 컴포넌트로 cos.jar 이에외도 많은 컴포넌트가 있다.

 

cos.jar를 myapp/WEB-INF/lib폴더에 복사하는 이유

 

JSP에서 cos.jar의 패키지를 이용하게 되는데 , cos.jar는 톰켓에 기본적으로 내장되어 있지 않은 외부의 패키지이다.

외부의 패캐니는 WEB-INF/lib 폴더에 위치해야 하는데, 이때 WEB-INF는 각각의 웹 어플리케이션에 이 폴더가

존재한다. 본이이 작성하는 모든 예제는 myapp로 이름 지어진 웹 어플리케이션에 위치하는데, 이 어플리케이션이 실행될

때 사용되는 패키지가 해당 어플리케이션 /WEB-INF/lib 폴더에 있는 패키지 이다.

 

Constructor Summary

 

MultipartRequest(javax.servlet.http.HttpServletReqeust request,

                         java.lang.String.saveDirectory,

                         int maxPostSize,

                         java.lang.String encoding,

                         FileRenamePolicy policy)

 

Method Summary

 

java.lang.String                              getContentType(java.lang.String name)

                                                    업로드된 파일의 컨텐트 타입을 반환, 업로드된 파일이 없으면 null을 반환

 

java.io.File                                    getFile(java.lang.String name)

                                                    서버 상에 업로드된 파일의 파일 객체를 반환, 업로드된 파일이 없다면 null을 반환

 

java.util.Enumeration                      getFileNames()

                                                   폼 요소 중 input 태그 속성이 file로 된 파라미터의 이름들을 반환, upload 된

                                                   파일이 없으면 비어있는 Enumeration을 반환

 

java.lang.String                             getFilesystemName(java.lang.String name)

                                                   사용자가 지정해서 서버 상에 실제로 업로드된 파일명을 반환

 

java.lang.String                             getOrignalFileName(java.lang.String name)

                                                   사용자가 지정해서 서버상에 업로드된 파일명을 반환, 이때의 파일명은 파일 중복을

                                                   고려한 파일명 변경 전의 이름을 말한다.

 

java.lang.String                             getParameter(java.lang.String name)

                                                   스트링으로 주어진 이름에 대한 값을 반환. 값 없이 파라미터가 전송되었거나 해당되는

                                                   이름의 파라미터가 전송이 안 되었을 경우 null 를 반환

 

java.util.Enumeration                      getParameterNames()

                                                   모든 파라미터 이름을 Enumeration 으로 반환 한다.

 

java.lang.String[]                          getParameterValues(java.lang.String name)

                                                   주어진 이름에 대한 값을 스트링 배열로 반환, 파라미터가 전송되지 않았을 때는 null 반환

 

 첫 번째로 해야 할 부분은 폼 enctype 속성을 multipart/form-data로 지정한 폼에 담겨진 파라미터를 읽어오기 위해서

MultipartRequest 의 객체를 생성해야 한다. 이 객체를 통해서 파일 업로드를 구현 할 수 있다.

MultipartRequest 객체를 생성한후 객체를 통해서 MultiPartRequest 클래스에서 제공하는 메소드들을 사용하면 쉽게 파일 업로드와 파라미터를 읽어 올 수 있다.

MultipartRequest 객체를 생성한 뒤, 메소드 사용의 예를 들어 파일 업로드와 파라미터에 대한 처리를 위한 절차를 설명 하겠다.

 

MultipartRequest의 생성자

 

MultipartRequest의 생성자를 종류가 많다.

cos.jar 에 있는 MultipartRequest 클래스의 생성자 중 다음의 생성자는 한글 인코딩,업로드되는 파일이 기존에 파일과 중복될때

의 단점을 해결한 생성자이다.

 

그래서 이 생성자를 사용하여 MultipartRequest 의 객체를 생성한다.

 

MultipartRequest multi = new MultiPartRequest(request,

                                                                   folderDirectory,

                                                                   1024*10,

                                                                   "euc-kr",

                                                                   new DefaultFileRenamePolicy());

 

첫 번째 인자는 Request 객체이고,

두 번재 인자는 업로드된 파일이 저장될 파일폴더 경로 이다.

세 번째 인자를 업로드할 파일의 최대 크기이다.( 1024=1024Bytes, 즉 1KB, 1024*10 = 10KB )

네 번째는 인코딩 타입

다섯 번째 인자는 업로드 될 파일명이 기존에 업로드된 파일명과 같은 경우 덮어쓰기를 방지하기 위해 설정하는 부분이다.

 

이 객체가 생성되면서 폼에서 지정한 파일이 서버상의 폴더에 저장된다.

 

Warn!!!

 

파일 업로드를 위한 파일 선택을 위해서 <input type="file">을 사용합니다.

그리고 이 <input type="file">라는 폼 요소를 포함하는 폼은 파일 전송을 위해서

<form method="post" enctype="multipart/form-data"> 로 속성을 지정해야 한다.

 

 

 

getParameterNames() 메소드

 

Enumeration params = multi.getParameterNames();

 

multi 라는 이름을 가지는 객체를 통해서 MultipartRequest  클래스에 있는 메소드를 사용 할수 있는데,

getParameterNames() 메소드는 폼에서 전송한 파라미터들의 이름을 Enumeration 타입으로 반환한다.

폼에 있는 input 태그중 file 속성이 아닌 모든 파라미터들의 이름을 반환하는 메소드 이다.

 

 

getParameter() 메소드

 

String paramValue = multi.getParameter(java.lang.String name);

 

getParameter 메소드는 request 객체에서 사용되는 getParameter 메소드처럼 파라미터의 이름을 인자로 받아서 그 파라미터

의 값을 반환하는 메소드이다.

이 메소드에 전달될 인자는 getParameterNames() 메소드를 통해서 얻어온 파라미터 이름을 인자로 주면 그 파라미터에 담긴 값을반환한다.

 

getFileNames() 메소드

 

Enumeration files = multi.getFileNames();

 

getFileNmaes() 메소드는 폼 요소 중 file 속성으로 지정된 input 태그의 이름, 즉 file 속성을 가진 파라미터의 이름을 Enumeration 타입

으로 반환한다.

예를 들면 <input type="file" name="uploadfile"> 태그가 폼 요소에 있었다면 getFileNmaes() 메소드는 uploadfile

이란 파라미터의 이름을 담긴 Enumeration을 반환한다.

 

 

getFilesystemName() 메소드

 

String filename = multi.getFilesystemNmae(name);

 

file 속성으로 지정된 input 태그에 의해 서버 상에 실제로 업로드된 파일 이름을 스트링 타입으로 반환한다.

이 메소드가 반환하는 파일명의 file 속성을 가진 input 태그에서 사용자가 지정한 파일 이름이 아니고

사용자가 선택한 파일이 실제 서버 상의 폴더에 저장 되었을 때의 파일명을 반환한다.

아래의 getOriginalFileNmae() 메소드에서 비교 설명 하겠다.

 

getOriginalFileName() 메소드

 

String original = multi.getOriginalFileName(name);

 

getOriginalFileName() 메소드는 사용자가 직접 지정한 파일명을 반환한다.

MultipartRequest 의 생성자 중 중복된 파일을 덮어쓰는 것을 방지하기 위해 사용되는 FileRenamePolicy 인터페이스를

구현한 DefaultFileRenamePolicy 에 의해서 파일명이 변경되기 전의 파일명을 반환한다.

 

getFileSystemName() 메소드는 기존에 업로드된 파일명들 중에 새로 업로드할 파일명이 중복될 경우 파일명 뒤에

filename1.***, filename2.*** 식으로 변경된 이름을 반환한다.

중복되는 경우가 없다면 원래의 파일명을 반환한다.

 

getOriginalFileName() 은 사용자가 지정해서 업로드되는 파일명을 반환하고,

getFileSystemName()  메소드는 파일명이 중복되는 경우 변경된 파일명을 반환한다.

 

 

getContentType() 메소드

 

String type = multi.getContentType(name);

 

getContentType() 메소드는 업로드된 파일의 컨텐트 타입을 반환한다.

 

 

getFile() 메소드

 

File f = multi.getFile(name);

 

getFile() 메소드는 서버 상에 업로드된 파일에 대한 파일 객체를 반환한다.

 

Tip

File 클래스는 java.io 패키지에 있다.

File 클래스를 사용하기 위해 java.io 패키지를 임포트해야 한다.

 

[출처] 파일 업로드 multipart/form-data|작성자 센스