Java ServletのHttpServletのdoHeadメソッド完全ガイド！初心者でもわかるHEADリクエストの使い方と実装方法
Javaの基礎を体系的に整理しながら学習したい方には、 資格対策としても定評のある定番教材が参考になります。
Javaプログラマ Silver SE 17 教科書をAmazonで見る※ Amazon広告リンク
生徒
「ServletでGETと似てるけどレスポンスボディがないHTTPリクエストってありますか？」
先生
「はい、それはHEADリクエストです。JavaのServletではdoHead()メソッドを使って処理できます。」
生徒
「GETとの違いや、いつ使うかがよく分かりません…」
先生
「ではdoHead()メソッドの基本と、HTTP HEADリクエストの特徴を一緒に見ていきましょう。」
1. doHeadメソッドとは
doHead()メソッドは、JavaのHttpServletクラスに用意されているメソッドで、HTTPのHEADリクエストを処理するために使います。
HEADリクエストはGETとほぼ同じ処理を行いますが、レスポンスボディ（データの本体）を返しません。ヘッダーだけを返すのが特徴です。
このメソッドを使うことで、ファイルサイズや更新日時などのメタ情報だけを確認でき、データ転送量を減らすことができます。
2. HEADリクエストの用途とメリット
HEADメソッドは、以下のような場面で活用されます。
- ファイルの存在確認
- 更新日時の確認（キャッシュ制御）
- コンテンツサイズの確認
- リンク切れチェック
たとえばWebクローラーやAPIのクライアントは、まずHEADでレスポンスヘッダーを確認し、必要であればGETを行うという使い方をします。
データのダウンロードを行わずに情報が得られるため、通信コストが抑えられ、処理が高速になります。
3. doHeadの基本的な実装方法
doHead()は、通常はdoGet()の処理を呼び出すことで、ヘッダーだけを生成させます。ただし、PrintWriterやOutputStreamに出力しないよう注意が必要です。
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
public class HeadExampleServlet extends HttpServlet {
@Override
protected void doHead(HttpServletRequest request, HttpServletResponse response)
throws IOException {
// ヘッダーだけ生成し、ボディは出力しない
response.setContentType("text/plain");
response.setContentLength(100); // 任意のサイズを指定
response.setHeader("X-Sample-Header", "HEADメソッドの例");
}
}
このようにしてdoHead()を実装すれば、レスポンスボディなしで必要な情報をクライアントに伝えることができます。
4. doHeadとdoGetの連携
多くのServletでは、doHead()からdoGet()を呼び出して、ヘッダーだけ生成することもあります。この場合、Servletコンテナがレスポンスの本体部分を自動的に無視してくれます。
@Override
protected void doHead(HttpServletRequest request, HttpServletResponse response)
throws IOException {
doGet(request, response); // ヘッダーのみ送られる
}
ただし、doGet()の中で大量の出力処理がある場合は、無駄な計算になる可能性があるため、状況に応じてdoHead()だけに専用処理を書くのも良い方法です。
5. HTTPヘッダーのカスタマイズ
doHead()メソッドでは、レスポンスヘッダーを柔軟にカスタマイズできます。例えば以下のように、日時や独自の情報を設定することができます。
response.setHeader("Last-Modified", "Mon, 20 May 2024 12:00:00 GMT");
response.setHeader("Cache-Control", "no-cache");
これにより、HTTPのキャッシュ機能やクライアントの動作に影響を与える制御が可能となり、パフォーマンスやセキュリティの向上に貢献します。
6. doHeadの注意点とテスト方法
doHead()は一見地味なメソッドですが、ブラウザやツールからHEADリクエストを送って動作を確認することが重要です。例えば、curlを使ってテストできます。
curl -I http://localhost:8080/myapp/servlet
このコマンドはHEADリクエストを送信し、レスポンスヘッダーだけを表示してくれます。Servletの動作確認やデバッグにも便利です。
7. doHeadの実装で得られる効果
doHead()メソッドを実装することで、Webアプリケーションのレスポンス制御が細かくできるようになります。
クライアントとの通信効率を高めたり、キャッシュ戦略を明確にしたり、APIの健全性チェックに利用したりと、実は多くの用途がある重要なメソッドです。
初心者のうちはあまり使う機会が少ないかもしれませんが、HTTPの基本に触れるうえで非常に有益な知識です。
