Servlets-file-uploading
サーブレット-ファイルのアップロード
サーブレットをHTMLフォームタグとともに使用して、ユーザーがファイルをサーバーにアップロードできるようにします。 アップロードされたファイルは、テキストファイル、画像ファイル、または任意のドキュメントです。
ファイルアップロードフォームの作成
以下の次のHTMコードは、アップローダーフォームを作成します。 以下は、注意すべき重要な点です-
- フォームの method 属性は POST メソッドに設定する必要があり、GETメソッドは使用できません
- フォームの enctype 属性は multipart/form-data に設定する必要があります。
- フォームの action 属性は、バックエンドサーバーでのファイルのアップロードを処理するサーブレットファイルに設定する必要があります。 次の例では、 UploadServlet サーブレットを使用してファイルをアップロードしています。
- 単一のファイルをアップロードするには、属性type = "file"を持つ単一の<input …/>タグを使用する必要があります。 複数のファイルのアップロードを許可するには、name属性に異なる値を持つ複数の入力タグを含めます。 ブラウザは、それぞれに[参照]ボタンを関連付けます。
<html>
<head>
<title>File Uploading Form</title>
</head>
<body>
<h3>File Upload:</h3>
Select a file to upload: <br/>
<form action = "UploadServlet" method = "post" enctype = "multipart/form-data">
<input type = "file" name = "file" size = "50"/>
<br/>
<input type = "submit" value = "Upload File"/>
</form>
</body>
</html>
これにより、ローカルPCからファイルを選択できる次の結果が表示され、ユーザーが[ファイルのアップロード]をクリックすると、選択したファイルとともにフォームが送信されます-
File Upload:
Select a file to upload:
NOTE: This is just dummy form and would not work.
バックエンドサーブレットの作成
以下は、アップロードされたファイルを受け入れ、それをディレクトリ<Tomcat-installation-directory>/webapps/dataに保存するサーブレット UploadServlet です。 このディレクトリ名は、次のようにweb.xmlの context-param 要素などの外部構成を使用して追加することもできます-
<web-app>
....
<context-param>
<description>Location to store uploaded file</description>
<param-name>file-upload</param-name>
<param-value>
c:\apache-tomcat-5.5.29\webapps\data\
</param-value>
</context-param>
....
</web-app>
以下は、一度に複数のファイルのアップロードを処理できるUploadServletのソースコードです。 先に進む前に、次のことを確認してください-
- 次の例はFileUploadに依存するため、クラスパスに commons-fileupload.x.x.jar ファイルの最新バージョンがあることを確認してください。 [[1]]
- FileUploadはCommons IOに依存するため、クラスパスに commons-io-x.x.jar ファイルの最新バージョンがあることを確認してください。 [[2]]
- 次の例をテストするときは、_maxFileSize_より小さいサイズのファイルをアップロードする必要があります。そうしないと、ファイルはアップロードされません。
- 事前にディレクトリc:\ tempおよびc:\ apache-tomcat8.0.28 \ webapps \ dataを作成したことを確認してください。
//Import required java libraries
import java.io.*;
import java.util.*;
import javax.servlet.ServletConfig;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileUploadException;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;
import org.apache.commons.io.output.*;
public class UploadServlet extends HttpServlet {
private boolean isMultipart;
private String filePath;
private int maxFileSize = 50 *1024;
private int maxMemSize = 4* 1024;
private File file ;
public void init( ){
//Get the file location where it would be stored.
filePath = getServletContext().getInitParameter("file-upload");
}
public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, java.io.IOException {
//Check that we have a file upload request
isMultipart = ServletFileUpload.isMultipartContent(request);
response.setContentType("text/html");
java.io.PrintWriter out = response.getWriter( );
if( !isMultipart ) {
out.println("<html>");
out.println("<head>");
out.println("<title>Servlet upload</title>");
out.println("</head>");
out.println("<body>");
out.println("<p>No file uploaded</p>");
out.println("</body>");
out.println("</html>");
return;
}
DiskFileItemFactory factory = new DiskFileItemFactory();
//maximum size that will be stored in memory
factory.setSizeThreshold(maxMemSize);
//Location to save data that is larger than maxMemSize.
factory.setRepository(new File("c:\\temp"));
//Create a new file upload handler
ServletFileUpload upload = new ServletFileUpload(factory);
//maximum file size to be uploaded.
upload.setSizeMax( maxFileSize );
try {
//Parse the request to get file items.
List fileItems = upload.parseRequest(request);
//Process the uploaded file items
Iterator i = fileItems.iterator();
out.println("<html>");
out.println("<head>");
out.println("<title>Servlet upload</title>");
out.println("</head>");
out.println("<body>");
while ( i.hasNext () ) {
FileItem fi = (FileItem)i.next();
if ( !fi.isFormField () ) {
//Get the uploaded file parameters
String fieldName = fi.getFieldName();
String fileName = fi.getName();
String contentType = fi.getContentType();
boolean isInMemory = fi.isInMemory();
long sizeInBytes = fi.getSize();
//Write the file
if( fileName.lastIndexOf("\\") >= 0 ) {
file = new File( filePath + fileName.substring( fileName.lastIndexOf("\\"))) ;
} else {
file = new File( filePath + fileName.substring(fileName.lastIndexOf("\\")+1)) ;
}
fi.write( file ) ;
out.println("Uploaded Filename: " + fileName + "<br>");
}
}
out.println("</body>");
out.println("</html>");
} catch(Exception ex) {
System.out.println(ex);
}
}
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, java.io.IOException {
throw new ServletException("GET method used with " +
getClass( ).getName( )+": POST method required.");
}
}
}
サーブレットのコンパイルと実行
上記のサーブレットUploadServletをコンパイルし、次のようにweb.xmlファイルに必要なエントリを作成します。
<servlet>
<servlet-name>UploadServlet</servlet-name>
<servlet-class>UploadServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>UploadServlet</servlet-name>
<url-pattern>/UploadServlet</url-pattern>
</servlet-mapping>
次に、上記で作成したHTMLフォームを使用してファイルをアップロードしてみます。 http://localhost:8080/UploadFileを試すと、ローカルマシンからファイルをアップロードするのに役立つ次の結果が表示されます。
File Upload:
Select a file to upload:
サーブレットスクリプトが正常に機能する場合は、ファイルをc:\ apache-tomcat8.0.28 \ webapps \ data \ディレクトリにアップロードする必要があります。