プログラミング
 Computer >> コンピューター >  >> プログラミング >> プログラミング

JSPでファイルアップロードを実装する方法｜HTMLフォームとサーバーサイド処理の完全解説

JSPはHTMLフォームタグと組み合わせることで、ユーザーがサーバーへファイルをアップロードできる仕組みを簡単に実装できます。アップロード対象はテキストファイルだけでなく、バイナリファイルや画像ファイルなど、あらゆる種類のドキュメントに対応可能です。

ファイルアップロードフォームの作成

まずは、ファイルアップロード用フォームの作成方法を見ていきましょう。以下のポイントは必ず押さえておく必要があります。

  • フォームの method 属性は必ず POST を指定します。GETメソッドは使用できません。

  • フォームの enctype 属性には multipart/form-data を設定します。

  • フォームの action 属性には、サーバーサイドでアップロード処理を行うJSPファイルを指定します。この例では uploadFile.jsp を使用します。

  • 単一ファイルをアップロードする場合は、type="file" 属性を持つ <input .../> タグを1つ配置します。複数ファイルのアップロードを許可したい場合は、name属性に異なる値を持つinputタグを複数追加しましょう。ブラウザはそれぞれに対して「参照」ボタンを表示します。

コード例：HTMLフォーム

<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からファイルを選択し、「Upload File」ボタンをクリックすると、選択したファイルとともにフォームが送信されます。

実行結果

File Upload
Select a file to upload

注意： 上記のフォームはあくまでもダミーのサンプルです。実際に動作させるには、ご自身の環境でコードを実行して確認してください。

バックエンドJSPスクリプトの作成

次に、アップロードされたファイルの保存先を定義します。プログラム内に直接ハードコードすることもできますが、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>

続いて、UploadFile.jsp のソースコードを紹介します。このスクリプトは複数ファイルの同時アップロードにも対応しています。実装を進める前に、以下の点を確認しておきましょう。

  • この例は FileUpload ライブラリに依存しています。クラスパスに最新版の commons-fileupload.x.x.jar が含まれていることを確認してください。ダウンロードは https://commons.apache.org/fileupload/ から可能です。

  • FileUploadはCommons IOにも依存しているため、最新版の commons-io-x.x.jar もクラスパスに追加してください。ダウンロードは https://commons.apache.org/io/ から入手できます。

  • テスト時には、maxFileSize より小さいサイズのファイルをアップロードしてください。上限を超えるファイルはアップロードされません。

  • 事前に c:\temp および c:\apache-tomcat5.5.29\webapps\data ディレクトリを作成しておいてください。

<%@ page import = "java.io.*,java.util.*, javax.servlet.*" %>
<%@ page import = "javax.servlet.http.*" %>
<%@ page import = "org.apache.commons.fileupload.*" %>
<%@ page import = "org.apache.commons.fileupload.disk.*" %>
<%@ page import = "org.apache.commons.fileupload.servlet.*" %>
<%@ page import = "org.apache.commons.io.output.*" %>

<%
   File file ;
   int maxFileSize = 5000 * 1024;
   int maxMemSize = 5000 * 1024;
   ServletContext context = pageContext.getServletContext();
   String filePath = context.getInitParameter("file-upload");

   // Verify the content type
   String contentType = request.getContentType();

   if ((contentType.indexOf("multipart/form-data") >= 0)) {
      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>JSP File 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();
               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: " + filePath +
               fileName + "<br>");
            }
         }
         out.println("</body>");
         out.println("</html>");
      } catch(Exception ex) {
         System.out.println(ex);
      }
   } else {
      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>");
   }
%>

それでは、先ほど作成したHTMLフォームから実際にファイルをアップロードしてみましょう。https://localhost:8080/UploadFile.htm にアクセスすると、次のような画面が表示され、ローカルマシン上の任意のファイルをアップロードできます。

File Upload
Select a file to upload

JSPスクリプトが正常に動作していれば、アップロードされたファイルは c:\apache-tomcat5.5.29\webapps\data\ ディレクトリに保存されているはずです。

  1. Windows 11でAndroidアプリを使ってみよう！導入手順をわかりやすく解説

    Windows 11の目玉機能のひとつが、Androidアプリへの対応です。Windows 10が「Windows Subsystem for Linux（WSL）」を搭載し、Linux環境を別途用意しなくてもLinuxプログラムを実行できるようにしたように、Windows 11では「Windows Subsystem for Android」と呼ばれる仕組みによって、PC上でAndroidアプリをネイティブに動かせるようになります。ただしこの機能は、準備が整っていなかったためか、Windows 11の初期リリースには含まれていませんでした。とはいえ、Microsoftが一部のユーザー向けに提

  2. Androidでアプリファイル(APK)をアーカイブして保存する方法

    AndroidのOSは、WindowsやmacOS、Linuxといった一般的なパソコン向けOSとは大きく異なります。パソコンのOSでは、実行するとアプリケーションがインストールされる「インストーラー」が存在し、その処理にはWindowsレジストリへの情報登録、デスクトップやスタートメニューへのショートカット作成、多数のファイルやフォルダーの生成などが含まれます。万が一インストーラーを紛失してしまうと、ハードディスク上のファイルから逆にインストーラーを作り直すことはできません。しかし、Android OSには、ユーザーがインストール済みアプリからAPK(インストールファイル)を作成し、後日のため