13.8. Spring's multipart (fileupload) support

13.8.1. Introduction

MultipartResolver 인터페이스를 사용하여 파일 업로드를 구현할 수 있습니다. 내부 구현체는 Commons FileUpload 와 COS FileUpload 를 사용합니다.

기본적으로 Spring은 Multipart 를 지원하진 않지만 Multipart를 포함하는 요청이 들어오면 Context에 설정해둔 MutipartResoolver를 사용하여 적절하게 처리할 수 있습니다.

13.8.2. Using the MultipartResolver

Multipart 기능을 사용하기 위해 먼저 사요할 MultipartResolver를 bean으로 등록해야 합니다.

CommonsMultipartResolver 등록하기 :: commons-fileupload.jar, commons-io.jar 필요함

<bean id=”multipartResolver”

    <!– one of the properties available; the maximum file size in bytes –>
    <property name=”maxUploadSize” value=”100000″/>

CosMultipartResolver 등록하기 :: cos.jar 필요함

<bean id=”multipartResolver” class=”org.springframework.web.multipart.cos.CosMultipartResolver”>

    <!– one of the properties available; the maximum file size in bytes –>
    <property name=”maxUploadSize” value=”100000″/>

13.8.3. Handling a file upload in a form

화면에서 파일 입력 받기.

        <title>Upload a file please</title>
        <h1>Please upload a file</h1>
        <form method=”post” action=”upload.form” enctype=”multipart/form-data”>
            <input type=”file” name=”file”/>
            <input type=”submit”/>

화면에서 입력받은 파일을 객체로 바인딩 해야 하는데 이 때 String 타입으로 바인딩하려면 StringMultipartEditor, byte타입의 배열로 바인딩 하려면 ByteArrayMultipartEditor 를 사용할 수 있습니다.

byte 타입의 배열 이나 String으로 바인딩하지 않고 MultipartFile 타입으로 받으려면 별다른 바인딩이 필요 없습니다.

이 세가지 방법 중 String으로 바인딩하는 예제를 보겠습니다.

public class FileUploadController extends SimpleFormController {

    protected ModelAndView onSubmit(
        HttpServletRequest request,
        HttpServletResponse response,
        Object command,
        BindException errors) throws ServletException, IOException {

         // cast the bean
        FileUploadBean bean = (FileUploadBean) command;

         let’s see if there’s content there
        String file = bean.getFile();
        if (file == null) {
             // hmm, that’s strange, the user did not upload anything

         // well, let’s do nothing with the bean for now and return
        return super.onSubmit(request, response, command, errors);

    protected void initBinder(HttpServletRequest request, ServletRequestDataBinder binder)
        throws ServletException {
        // to actually be able to convert Multipart instance to a String
        // we have to register a custom editor
        binder.registerCustomEditor(String.class, new StringMultipartFileEditor());
        // now Spring knows how to handle multipart object and convert them


public class FileUploadBean {

    private String file;

    public void setFile(String file) {
        this.file = file;

    public String getFile() {
        return file;

오호.. 간단하군요. 집에가서 써먹어 봐야겠습니다.