[Spring Web Project] 스프링 MVC의 Controller(3) - 파일 업로드 처리

파일 업로드 처리

Servlet 3.0 이후(Tomcat7.0)에는 기본적으로 업로드 되는 파일을 처리할 수 있는 기능이 추가가 되었고 별도로 commons-fileupload 라이브러리 등을 사용합니다.

 

MVN REPOSITORY에서 Apache Commons FileUpload 라이브러리 코드를 pom.xml에 추가한다.

https://mvnrepository.com/artifact/commons-fileupload/commons-fileupload/1.4

 

pom.xml에 추가되는 commons-fileupload 라이브러리

pom.xml에 코드에 commons-fileupload 라이브러리를 추가하면 Maven Dependencies에 commons 관련 jar 파일 2개가 추가되는 것을 확인할 수 있다.

라이브러리를추가한 후 파일이 임시로 업로드될 폴더를 C 드라이브아래 upload/tmp로 작성합니다.

 

내 PC > 로컬 디스크(C:) > upload > tmp

servlet-context.xml 설정

servlet-context.xml은 스프링 MVC의 특정한 객체(빈)를 설정해서 파일을 처리합니다. 다른 객체(Bean)를 설정하는 것과 달리 파일 업로드의 경우에는 반드시 id 속성의 값을 'multipartResolver'로 정확하게 지정해야 하므로 주의가 필요합니다.

 

▶ servlet-context.xml에 추가하기

    <beans:bean id="multipartResolver"
        class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <beans:property name="defaultEncoding" value="utf-8"></beans:property>
        <!-- 1024 * 1024 * 10 bytes 10MB -->
        <beans:property name="maxUploadSize" value="104857560"></beans:property>
        <!-- 1024 * 1024 * 2 bytes 2MB -->
        <beans:property name="maxUploadSizePerFile"
            value="2097152"></beans:property>
        <beans:property name="uploadTempDir"
            value="file:/C:/upload/tmp"></beans:property>
        <beans:property name="maxInMemorySize" value="10485756"></beans:property>
    </beans:bean>

• maxUploadSize : 한 번의 Request로 전달될 수 있는 최대의 크기
• maxUploadSizePerFile : 하나의 파일 최대 크기
• maxInMemorySize : 메모리상에서 유지하는 최대의 크기
• uploadTempDir : 크기 이상의 데이터를 임시 파일의 형태로 보관하는 곳
• defaultEncoding : 업로드하는 파일의 한글 깨짐 문제 처리

SampleController에서는 다음과 같이 get 방식으로 파일을 업로드할 화면을 처리합니다.

 

▶ SampleController의 일부

    @GetMapping("/exUpload")
    public void exUpload() {
        log.info("/exUpload.........");
    }

파일 업로드를 해볼 /WEB-INF/views/sample/exUpload.jsp 파일을 작성합니다.

 

 

▶ exUpload.jsp

<form action="/sample/exUploadPost"  method="post" enctype="multiPART/form-data">

 <div>
   <input type='file' name='files'>
 </div>
 <div>
   <input type='file' name='files'>
 </div>
 <div>
   <input type='file' name='files'>
 </div>
 <div>
   <input type='file' name='files'>
 </div>
 <div>
   <input type='file' name='files'>
 </div>
 <div>
   <input type='submit'>
 </div>   
</form>

 

exUpload.jsp는 여러 개의 파일을 한꺼번에 업로드하는 예제로 작성해 봅니다. <form> 태그의 action 속성, method 속성, enctype 속성에 주의해서 작성해야 합니다. 실행했을 때는 아래와 같은 모습으로 보입니다.

 

 

exUpload.jsp의 action 속성값은 '/sample/exUploadPost'로 작성되었으므로, 이에 맞는 메서드를 SampleController에 추가합니다.

 

▶ SampleController의 일부

	@PostMapping("/exUploadPost")
	public void exUploadPost(ArrayList<MultipartFile> files) {
		
		files.forEach(file -> {
			log.info("------------------------------------");
			log.info(file.getOriginalFilename());
			log.info(file.getSize());
			log.info(file.getContentType());
		});
	}

 

스프링 MVC는 전달되는 파라미터가 동일한 이름으로 여러 개 존재하면 배열로 처리가능하므로 파라미터를 MultipartFile의 배열 타입으로 작성합니다. 실제로 파일을 업로드해 보면 아래와 같은 결과를 볼 수 있습니다. 현재 설정은 한 파일의 최대크기가 2MB이므로 그보다 작은 크기의 파일을 지정해서 업로드를 테스트합니다.

 

 

위의 그림에서 중간에 보이는 로그는 SampleController에서 업로드 정보가 올바르게 처리되는 것을 보여주고 있습니다.