サーブレットでレスポンスを返す方法とは？PrintWriter・JSON・HTMLを初心者向けに解説！
生徒
「Javaのサーブレットで、レスポンスを返すって具体的にどうやるんですか？HTMLとかJSONも返せますか？」
先生
「サーブレットでは、HttpServletResponseを使って、テキストやHTML、JSONなどを返すことができるよ。PrintWriterを使えば簡単にレスポンスを出力できるんだ。」
生徒
「なるほど！具体的なコードの書き方も知りたいです！」
先生
「それじゃあ、テキスト、HTML、JSONそれぞれの返し方を順番に見ていこうか！」
1. サーブレットでレスポンスを返す基本
Javaサーブレットでクライアントにレスポンスを返すには、まず「レスポンスとは何か」をイメージしておくと分かりやすいです。ブラウザからのリクエスト（お願い）に対して、サーバーが返してあげる「お返事」がレスポンスです。このお返事を作るために使うのが、HttpServletResponseオブジェクトです。
HttpServletResponseは、サーブレットとブラウザのあいだで「どんな内容を返すのか」「どんな形式で返すのか」を管理する役割を持っています。テキスト、HTML、JSONなどさまざまな形式のデータを返すことができ、サーブレット側で中身を書き込むと、その内容がブラウザに届けられます。
実際に文字を返すときは、responseオブジェクトからPrintWriterを取得して、そこに文字列を書き込んでいきます。イメージとしては、「手紙を書くためのペン」を手に入れて、そのペンで紙に文字を書いていくような感覚です。PrintWriterに書いた内容が、そのままレスポンスとしてクライアントに送られます。
サーブレットでレスポンスを返す流れを、初心者向けに簡単にまとめると次のようになります。
- ブラウザがサーブレットにアクセスする（リクエストを送る）
- サーブレットのdoGetやdoPostメソッドが呼び出される
- メソッドの中でHttpServletResponseを使ってレスポンスの中身を作る
- 作成したレスポンスがブラウザに返され、画面に表示される
たとえば、次のようにサーブレットから簡単なメッセージを返すことができます。
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
// ブラウザに返すための「書き込み用オブジェクト」を取得
PrintWriter out = response.getWriter();
// ここで書いた文字が、そのままブラウザに表示される
out.println("サーブレットからの基本的なレスポンスです。");
}
このように、HttpServletResponseとPrintWriterを使うことで、サーブレットから自由に文字列を返すことができます。次の項目では、テキスト・HTML・JSONといった具体的なレスポンス形式ごとの書き方を詳しく見ていきましょう。
2. テキストレスポンスの返し方（PrintWriter）
サーブレットからテキストレスポンスを返す場合、responseのsetContentTypeを"text/plain"に設定し、PrintWriterを使って出力します。
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/plain; charset=UTF-8");
PrintWriter out = response.getWriter();
out.println("これはテキストレスポンスです。");
}
これにより、クライアントにはプレーンテキストがそのまま表示されます。
将来を見据えて、＋αのスキルを身につけたい方へ
JavaやLinuxを学んでいても、「このままで市場価値は上がるのか」 「キャリアの選択肢を広げたい」と感じる方は少なくありません。
AIを学ぶならアイデミープレミアム
3. HTMLレスポンスの返し方
次に、HTMLをレスポンスとして返す方法を見てみましょう。ブラウザにHTMLを表示したい場合は、ContentTypeを"text/html"にして、HTMLタグを文字列として出力します。
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html; charset=UTF-8");
PrintWriter out = response.getWriter();
out.println("<!DOCTYPE html>");
out.println("<html>");
out.println("<head><title>サンプルHTML</title></head>");
out.println("<body><h1>HTMLを返すサーブレット</h1></body>");
out.println("</html>");
}
HTMLタグは文字列として扱う必要があります。タグの途中に変数を組み込むことも可能です。
4. JSONレスポンスの返し方
JSONデータを返すには、ContentTypeを"application/json"に設定し、JSON形式の文字列を出力します。JavaでJSONを扱うには、org.jsonやJacksonなどのライブラリを使うと便利ですが、ここではシンプルな文字列で返す例を紹介します。
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("application/json; charset=UTF-8");
PrintWriter out = response.getWriter();
out.println("{\"message\":\"こんにちは！JSONレスポンスです。\"}");
}
Ajax通信やAPIとして利用する場合、この形式でレスポンスを返すのが一般的です。
5. レスポンスの文字コードに注意しよう
日本語を含むレスポンスを返す場合、文字コードの設定が重要です。特にHTMLやJSONでは、「UTF-8」を明示的に指定しないと、文字化けが発生することがあります。
setContentTypeで「charset=UTF-8」を指定し、必要に応じてresponse.setCharacterEncoding("UTF-8")も併用するとより安全です。
6. HTMLファイルをJSPのように作るには？
PrintWriterでHTMLを書くと、すべてJavaコード内に文字列で記述する必要があるため、可読性が下がります。静的なHTMLページを扱いたい場合は、JSPファイルに処理を分離するのが一般的です。
ただし、学習段階ではサーブレットでHTML出力を経験することで、レスポンス処理の仕組みを理解できます。
7. レスポンス出力の注意点
レスポンスを返す際には、PrintWriterの出力後にflushやcloseは不要なケースが多いです。サーブレットコンテナが自動で処理してくれるためです。
ただし、エラー時にはresponse.sendErrorを使うなど、適切なレスポンスステータスの設定も重要です。ヘッダー情報を追加する場合は、出力前にresponse.setHeaderで指定できます。
8. JSONレスポンスで外部ライブラリを使う方法
本格的なWeb開発では、JSONの生成にJacksonやGsonなどのライブラリを使います。これらを使うと、JavaオブジェクトをそのままJSON形式に変換できるため、保守性が高まります。
初学者はまず文字列での返却に慣れてから、ライブラリの導入を検討しましょう。
9. レスポンスの種類と使い分け
サーブレットで返すレスポンスの種類は、用途によって使い分けが必要です。
- テキストレスポンス：簡易的な表示やテスト用
- HTMLレスポンス：ブラウザにページを表示する場合
- JSONレスポンス：APIやAjax通信のレスポンスに利用
このように、目的に応じてレスポンスの種類を選ぶことで、Javaサーブレットの実装力が高まります。
10. 今後のステップ：レスポンスとリダイレクト、JSPの連携
レスポンスの出力方法を覚えたら、次はリダイレクト（response.sendRedirect）や、JSPとの連携（RequestDispatcher）などの実践的なテクニックも学びましょう。
画面遷移やテンプレートの表示処理に強くなれば、より完成度の高いWebアプリケーションを作ることができます。
まとめ
今回は、Javaサーブレットでクライアントにレスポンスを返す方法について、初心者の方にもわかりやすく解説しました。JavaのWebアプリケーション開発において、レスポンスの返却処理は非常に重要な要素です。特にPrintWriterを使ったテキストレスポンスやHTMLレスポンス、そしてJSON形式でのレスポンス返却は、実際のWebシステムで頻繁に使用される基本中の基本です。
サーブレットでは、HttpServletResponseオブジェクトを使って、文字列としてHTMLやJSONを返すことができます。HTMLレスポンスでは、setContentType("text/html")を指定し、タグを出力することでブラウザ表示が可能になります。JSONレスポンスでは、ContentTypeを"application/json"に設定することがポイントで、特にAjax通信やAPIのレスポンス処理ではこの形式が一般的です。
また、日本語や記号を含むレスポンスを安全に扱うには、UTF-8の指定が不可欠です。文字化け防止のために、ContentTypeに「charset=UTF-8」を含める習慣をつけましょう。必要に応じて、setCharacterEncoding("UTF-8")を併用することで、さらに安全な文字コード管理が可能です。
下記は、HTMLレスポンスを返す際のサンプルコードです。出力結果にh1タグを含むHTMLが表示されることで、サーブレットの出力内容を視覚的に確認できます。
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html; charset=UTF-8");
PrintWriter out = response.getWriter();
out.println("<!DOCTYPE html>");
out.println("<html>");
out.println("<head><title>レスポンス確認</title></head>");
out.println("<body><h1>こんにちは、サーブレットからのHTMLです！</h1></body>");
out.println("</html>");
}
今後は、JSPと連携したレスポンス出力や、セッションやクッキーとの連動処理、またはSpring Frameworkでのレスポンス処理（@ResponseBodyやRestController）など、より発展的な使い方へとつなげていくとよいでしょう。
SEOの観点でも、サーブレットによるHTMLレスポンス設計では、意味のある構造や見出し、適切な文字コードの設定が検索エンジン評価に影響します。Webアプリケーションの品質向上のためにも、基礎となるレスポンス処理の理解をしっかり固めておくことが大切です。
最後に、JSONレスポンスで外部ライブラリ（Gson、Jacksonなど）を使うことで、Javaオブジェクトを自動でJSONに変換できるようになるので、現場での活用力もさらに高まります。
生徒
「サーブレットって、HTMLだけじゃなくてJSONも簡単に返せるんですね！APIの仕組みに近くてびっくりしました！」
先生
「その通り！JSONは今のWeb開発には欠かせない形式だから、最初から覚えておくと応用が効くよ。」
生徒
「response.setContentTypeやPrintWriterの使い方もわかってきました。HTMLも出せるし、文字コードも意識しないとですね。」
先生
「うん、文字化け対策やヘッダーの管理も大切なポイントだから、今回の知識をしっかり活かしてね！」
生徒
「次はJSPやリダイレクトも学んで、もっとWebアプリを作れるようになりたいです！」
この記事を読んだ人からの質問
