カテゴリ: Servlet 更新日: 2025/08/23

JavaのPartクラスのgetHeaderメソッドを徹底解説!初心者でもわかるServletでのヘッダー情報の取得方法

PartのgetHeaderメソッド
PartのgetHeaderメソッド

先生と生徒の会話形式で理解しよう

生徒

「JavaのServletでファイルをアップロードする処理を書いてるんですけど、ヘッダーの情報ってどうやって取るんですか?」

先生

「それなら、javax.servlet.http.PartインターフェースのgetHeaderメソッドを使うことで、アップロードされたファイルに付随するヘッダー情報を取得できますよ。」

生徒

「へぇ、Partって何ですか?getHeaderってどんなときに使うんですか?」

先生

「じゃあ、これからJava ServletのPartインターフェースと、getHeaderメソッドの使い方について順番に見ていきましょう!」

1. Java Servletとは?

1. Java Servletとは?
1. Java Servletとは?

JavaのServlet(サーブレット)は、Webアプリケーションを作成するための技術です。javax.servletパッケージに含まれていて、HTTPリクエストを受け取り、レスポンスを返す仕組みを提供します。フォームの送信やファイルアップロードなどの処理にも使われています。

2. javax.servlet.http.Partインターフェースとは?

2. <code>javax.servlet.http.Part</code>インターフェースとは?
2. javax.servlet.http.Partインターフェースとは?

javax.servlet.http.Partインターフェースは、Servlet 3.0から追加された機能で、マルチパートリクエスト(ファイルアップロードなど)を処理するために使います。

ユーザーがフォームでファイルを送信したとき、そのファイルはPartとしてServletに渡されます。

Partには、ファイルの名前やサイズ、MIMEタイプ、ヘッダーなどの情報が含まれています。

3. getHeaderメソッドの役割

3. <code>getHeader</code>メソッドの役割
3. getHeaderメソッドの役割

PartインターフェースのgetHeader(String name)メソッドは、指定した名前のヘッダー情報を取得するために使います。

たとえば、ファイル名を取得したいときには、content-dispositionヘッダーを読み取ることで可能になります。

このメソッドを使うことで、アップロードされたファイルの情報を細かく確認できます。

4. getHeaderメソッドの使い方

4. <code>getHeader</code>メソッドの使い方
4. getHeaderメソッドの使い方

Java Servletでマルチパートデータを扱う場合、@MultipartConfigアノテーションを使ってServletを設定し、request.getPart()メソッドでPartオブジェクトを取得します。その後getHeaderを使ってヘッダー情報を読み取ります。


import java.io.IOException;
import javax.servlet.ServletException;
import javax.servlet.annotation.MultipartConfig;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.Part;

@MultipartConfig
public class UploadServlet extends HttpServlet {
    protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        Part filePart = request.getPart("file");
        String header = filePart.getHeader("content-disposition");

        response.setContentType("text/plain");
        response.getWriter().println("ヘッダー情報: " + header);
    }
}

5. ヘッダーからファイル名を取り出すには?

5. ヘッダーからファイル名を取り出すには?
5. ヘッダーからファイル名を取り出すには?

getHeaderで取得したcontent-dispositionには、ファイル名などが含まれています。ファイル名を取り出すには、ヘッダーの文字列を解析する必要があります。


String header = filePart.getHeader("content-disposition");
for (String cd : header.split(";")) {
    if (cd.trim().startsWith("filename")) {
        String fileName = cd.substring(cd.indexOf('=') + 1).trim().replace("\"", "");
        System.out.println("ファイル名: " + fileName);
    }
}

6. よく使われるヘッダーの種類

6. よく使われるヘッダーの種類
6. よく使われるヘッダーの種類

Partオブジェクトから取得できる代表的なヘッダーは以下のとおりです。

  • content-disposition:ファイル名やフォームフィールド名の情報
  • content-type:アップロードされたファイルのMIMEタイプ
  • content-length:ファイルサイズ

7. getHeadersgetHeaderNamesとの違い

7. <code>getHeaders</code>や<code>getHeaderNames</code>との違い
7. getHeadersgetHeaderNamesとの違い

getHeaderは1つのヘッダー値を返しますが、同じ名前のヘッダーが複数ある場合は、getHeaders(String name)で全ての値を取得することができます。また、getHeaderNames()を使えば利用可能な全ヘッダーの名前一覧が取得できます。


Collection<String> headers = filePart.getHeaderNames();
for (String name : headers) {
    for (String value : filePart.getHeaders(name)) {
        System.out.println(name + ": " + value);
    }
}

8. Servletのファイルアップロードに必要な設定

8. Servletのファイルアップロードに必要な設定
8. Servletのファイルアップロードに必要な設定

ServletでPartを使うためには、以下の設定が必要です。

  • @MultipartConfigアノテーションをServletクラスに付けること
  • HTMLフォームにenctype="multipart/form-data"を指定すること

HTMLフォームの例は次のようになります。


<form action="upload" method="post" enctype="multipart/form-data">
    <input type="file" name="file">
    <button type="submit">アップロード</button>
</form>

サーブレットやJSPの基礎を体系的に理解したい人には、 定番の入門書がこちらです。

スッキリわかるサーブレット&JSP入門をAmazonで見る

※ Amazon広告リンク

カテゴリの一覧へ
新着記事
New1
Spring
SpringDataJPAのJPAクエリメソッド「EndingWith」の使い方を完全ガイド!初心者向け解説
更新記事
New2
Spring
SpringDataJPAのJPAクエリメソッド「StartingWith」の使い方を完全ガイド!初心者向け解説
更新記事
New3
Spring
SpringDataJPAのJPAクエリメソッド「NotLike」の使い方を完全ガイド!初心者向け解説
更新記事
New4
Spring
SpringDataJPAのJPAクエリメソッド「Like」の使い方を完全ガイド!初心者向け解説
更新記事
人気記事
No.1
Java&Spring記事人気No1
Spring
Spring BootとJavaの互換性一覧!3.5/3.4/3.3はJava 21・17に対応してる?
No.2
Java&Spring記事人気No2
Java
JavaのBooleanクラスの使い方を完全ガイド!初心者でもわかる真偽値の操作
No.3
Java&Spring記事人気No3
JSP
JSPの基本タグ一覧と使い方まとめ!実務で使えるタグを紹介
No.4
Java&Spring記事人気No4
Java
JavaのIOExceptionクラス徹底解説!初心者向けファイル入出力エラー対策ガイド
No.5
Java&Spring記事人気No5
Spring
SpringのBindingResultを完全ガイド!初心者でもわかる入力チェックとエラー処理
No.6
Java&Spring記事人気No6
JSP
JSPでif文・for文を使う方法!初心者でもわかるJavaとの違いと使い方
No.7
Java&Spring記事人気No7
Spring
SpringのModelクラスとaddAttributeメソッドの使い方を完全ガイド!初心者でも安心
No.8
Java&Spring記事人気No8
Spring
SpringDataJPAのJPAクエリメソッド「EndingWith」の使い方を完全ガイド!初心者向け解説