Form表單的要求

1.提供from表單，method必須是post（post方式可以提交大量資料）

2.提供input type=”file”標籤

3.form表單的enctype屬性必須是multipart/form-data（就是在設定請求訊息頭的Content-Type）

• application/x-www-form-urlencoded(預設)。請求報文內容的格式為name=admin&password=123。伺服器通過request.getParameter(“name”);來獲取資料
• multipart/form-data。請求報文內容的格式為

Content-Type
 
: multipart/form-data; boundary=---------------------------28512195225210
Content-Length: 295

-----------------------------28512195225210
Content-Disposition: form-data; name="a"

q
-----------------------------28512195225210
Content-Disposition: form-data; name="b"; filename="a.txt"
Content-Type: text
 
/plain

eaglezsx
-----------------------------28512195225210--

資料被分隔線分成一段一段的，其中每兩個分隔線之間的資料稱為一個item。request.getParameter(“name”)方法獲取指定的表單欄位字元內容，但檔案上傳表單已經不再是字元內容，而是位元組內容，所以失效。用request.getInputStream();方法可以獲取位元組流。

例子

新建一個a.txt，裡邊隨便寫點兒東西，eaglezsx。

新建一個upload.jsp

<form enctype="multipart/form-data"
 
 action="${pageContext.request.contextPath}/servlet/uploadServlet" method="post">
        <input type="text" name="a" />
        <input type="file" name="b"/></br>
        <input type="submit" value="提交"/>
</form>

新建一個Servlet，UploadServlet.java

public class UploadServlet extends HttpServlet {

    public void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        ServletInputStream sis=request.getInputStream();//獲取請求報文中的內容
        int len=-1;
        byte[] b=new byte[1024];
        while ((len=sis.read(b))!=-1) {
            System.out.println(new String(b,0,len));//將請求報文中的內容轉化為字串，列印到控制檯
        }
        sis.close();

    }

    public void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        doGet(request, response);
    }

}

執行結果為

-----------------------------17157105472171
Content-Disposition: form-data; name="a"

hello
-----------------------------17157105472171
Content-Disposition: form-data; name="b"; filename="a.txt"
Content-Type: text/plain

eaglezsx
-----------------------------17157105472171--

這就是從瀏覽器接收到的那些東西。把這些東西解析了，就可以獲得需要的內容了。自己解析起來比較麻煩。有現成的元件commons fileupload來解析這些請求。Apache的官網有它的使用者指南http://commons.apache.org/proper/commons-fileupload/using.html裡邊有個小例子。

在使用FileUpload元件時，需要匯入commons-fileupload和commons-io兩個jar包。

通過這個例子，可以看出主要用這幾樣東西

DiskFileItemFactory類

如果上傳的檔案比較小，將儲存在記憶體中。如果上傳的檔案比較大，則會以臨時檔案的形式儲存在磁碟的臨時資料夾中。預設情況下，檔案儲存在記憶體還是硬碟臨時資料夾的臨界值是10240，即10K。

構造方法

• DiskFileItemFactory():採用預設臨界值10240，預設臨時資料夾為D:\Java\apache-tomcat-7.0.52\temp，Tomcat安裝目錄中的temp資料夾中。
• DiskFileItemFactory(int sizeThreshold,File repository):採用引數指定臨界值和臨時檔案的儲存位置

方法

• setSizeThreshold(int sizeThreshold)：設定臨界值
• setRepository(File repository)：設定臨時檔案的儲存位置

ServletFileUpload類

構造方法：

• ServletFileUpload(FileItemFactory fileItemFactory)

方法：

• parseRequest(HttpServletRequest req):解析出Form表單中的每個欄位的資料，並將它們分別包裝成獨立的FileItem物件，然後將這些FileItem物件加入進一個List型別的集合物件中返回。
• isMultipartContent()：是個靜態方法，判斷請求訊息中的內容是否是multipart/form-data型別，如果是則返回true。

FileItem介面

• boolean isFormFiled()：用於判斷FileItem類物件封裝的資料是一個普通文字表單欄位，還是一個檔案表單欄位，如果是普通表單欄位則返回true。
• String getFiledName():獲取表單欄位name屬性的值。
• String getName()：獲取檔案上傳欄位中的檔名
• String getString():獲取普通欄位的value屬性的值。
• String getString(String encoding):可以設定編碼，這樣普通標籤的value為中文時就不會亂碼了

• void write(File file):將FileItem物件中儲存的主體內容儲存到某個指定的檔案中。如果內容是在臨時檔案中，那麼DiskFileItem被垃圾回收後，臨時檔案會被自動刪除。

• String getContentType()：獲取上傳檔案的型別，即表單欄位描述頭屬性Content-Type的值，如“image/jpeg”。

• boolean isInMemory()：判斷FileItem物件封裝的資料內容是儲存在記憶體中，還是儲存在臨時檔案中，在記憶體中則返回true。
• long getSize():返回該上傳檔案的大小（以位元組為單位）
• InputStream getInputStream()：以流的形式返回上傳檔案的內容

public class UploadServlet extends HttpServlet {

    public void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        if (ServletFileUpload.isMultipartContent(request)) {

            File repository=new File("G:/");
            DiskFileItemFactory factory=new DiskFileItemFactory(1024*1024, repository);

            ServletFileUpload upload=new ServletFileUpload(factory);

            try {
                List<FileItem> items=upload.parseRequest(request);//這句話執行就會開始產生臨時檔案，這句話執行完後，臨時檔案也就產生了，臨時檔案和上傳的檔案一樣大，後面的操作都是對臨時檔案的操作
                for (FileItem item : items) {
                    if (item.isFormField()) {
                        processFormField(item);
                    }else {
                        try {
                            processUploadedFile(item);
                        } catch (Exception e) {

                            e.printStackTrace();
                        }
                    }
                }


            } catch (FileUploadException e) {

                e.printStackTrace();
            }

        }else {
            System.out.println("這不是檔案上傳表單");
        }

    }

    private void processUploadedFile(FileItem item) throws Exception {
        String fieldName=item.getFieldName();
        String fileName=item.getName();
        String contentType=item.getContentType();
        boolean isInMemory=item.isInMemory();
        long sizeInBytes=item.getSize();

        System.out.println(fieldName+" "+fileName+" "+contentType+" "+" "+isInMemory+" "+sizeInBytes);

        //把上傳的檔案儲存d盤
        File uploadedFile=new File("D:/"+fileName);

        item.write(uploadedFile);//這種方式臨時檔案會自動刪除

        //或者採用流的形式操作資料，這種方式需要呼叫delete方法來刪除臨時檔案
        /*
        InputStream uploadedStream=item.getInputStream();
        FileOutputStream fos=new FileOutputStream(uploadedFile);
        int len=0;
        byte[] b=new byte[1024];
        while((len=uploadedStream.read(b))!=-1){
            fos.write(b,0,len);
        }
        uploadedStream.close();
        fos.close();
        item.delete();
        */
    }

    private void processFormField(FileItem item) {
        String name=item.getFieldName();
        String value=item.getString();

        System.out.println("name:"+name+"---"+"value:"+value);
    }

    public void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        doGet(request, response);
    }

}

顯示結果為

name:a---value:hello
b a.txt text/plain  true 8

需要注意的問題

1.getName()在有的瀏覽器中獲取的是檔名（a.txt），但在有些瀏覽器中獲取的就是完整的路徑（C:\Users\YZ\Desktop\a.txt）。

解決方法

String filename=fileitem.getName();
filename=filename.substring(filename.lastIndexOf(File.separator)+1);

filename=FilenameUtils.getName(filename);

2.如果客戶端上傳了一個jsp，上面寫著一段讓伺服器關機的程式碼。之後客戶端訪問這個jsp，jsp裡邊的程式碼就會執行。

為了保證伺服器的安全，把上傳檔案的目錄放在使用者訪問不到的地方。WEB-INF下

File uploadedFile=new File(this.getServletContext().getRealPath("/WEB-INF/uploadedfile"));

3.如果上傳的檔名稱相同，以前的檔案會被覆蓋

讓檔名唯一即可

filename=UUID.randomUUID()+"_"+filename;

4.把檔案都放到一個資料夾裡到時候檢索的時候會很慢

把檔案打散，弄一些子目錄

• 通過日期打散

File uploadedFile=new File(this.getServletContext().getRealPath("/WEB-INF/uploadedfile"));
SimpleDateFormat sdf=new SimpleDateFormat("yyyy-MM-dd");
String date=sdf.format(new Date());
uploadedFile=new File(uploadedFile,date);

• 通過雜湊值打散

int hashcode=fileName.hashCode();//返回此物件的雜湊值
String code=Integer.toHexString(hashcode);//將其轉換為16進位制的字元，se3343ie
String childDirectory=code.charAt(0)+File.separator+code.charAt(1);// s/e
uploadedFile=new File(uploadedFile,childDirectory);

5.限制檔案的大小

ServletFileUpload中的

• setFileSizeMax(位元組):設定單個檔案的大小
• setSizeMax(位元組)：總檔案大小（多檔案上傳）

6.使用者沒有選擇檔案，就點選了上傳

判斷檔名是否為空即可

7.檔名為中文時會亂碼。

用ServletFileUpload的setHeaderEncoding方法設定一下。

8.普通欄位的value為中文時會亂碼

String value=item.getString("utf-8");

用Streaming API實現上傳

前面用的是傳統的API實現上傳，commons-fileupload還有一套Streaming API。官方文件http://commons.apache.org/proper/commons-fileupload/streaming.html說這種方法沒有傳統方法便利，但效能更好。傳統方法有多便利我沒看出來（有知道的，麻煩告訴我一下），但Streaming API在效能上的提升確可以明顯的看出來。傳統方法中，上傳的檔案都要先儲存到記憶體或臨時檔案中，然後在對記憶體或臨時檔案進行操作。這樣的話，如果我上傳的大檔案，相當於操作了檔案兩遍，先把上傳檔案弄到快取檔案中，再把快取檔案複製一份到最終目錄。如果用Streaming API的話，直接把上傳的檔案傳到最終的目錄。

public class UploadServlet2 extends HttpServlet {

    public void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        if (ServletFileUpload.isMultipartContent(request)) {

            ServletFileUpload upload=new ServletFileUpload();
            try {
                FileItemIterator iter = upload.getItemIterator(request);

                while(iter.hasNext()){
                    FileItemStream item=iter.next();
                    String name=item.getFieldName();//獲取name屬性的值

                    if(item.isFormField()){
                        processFormField(item);
                    }else{
                        processUploadedFile(item);
                    }
                }

            } catch (FileUploadException e) {

                e.printStackTrace();
            }


        }else {
            System.out.println("這不是檔案上傳表單");
        }

    }

    private void processUploadedFile(FileItemStream item) throws IOException{

        InputStream is=item.openStream();
        FileOutputStream fos=new FileOutputStream(new File("D:/"+item.getName()));

        int len=-1;
        byte[] b=new byte[1024*1024];
        while((len=is.read(b))!=-1){
            fos.write(b, 0, len);
        }
        is.close();
        fos.close();

    }

    private void processFormField(FileItemStream item) throws IOException {
        String name=item.getFieldName();
        InputStream is=item.openStream();
        String value=Streams.asString(is);


        System.out.println("name:"+name+"---"+"value:"+value);
    }

    public void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        doGet(request, response);
    }

}