サーブレットでレスポンスを返す方法とは？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で「これはテキストだよ」という情報をブラウザに伝え、次にPrintWriterを使って実際の文字列を書き込みます。ここで指定する"text/plain"は「プレーンテキスト（飾りのない文字列）」という意味で、"; charset=UTF-8"は「文字コードはUTF-8です」と伝える役割があります。日本語を扱う場合、この文字コード指定を付けておくと文字化けを防ぎやすくなります。
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
// 1. 返すデータの種類と文字コードを指定（ここではテキスト）
response.setContentType("text/plain; charset=UTF-8");
// 2. ブラウザに文字を書き出すためのオブジェクトを取得
PrintWriter out = response.getWriter();
// 3. 実際に表示したいメッセージを書き込む
out.println("これはテキストレスポンスです。");
out.println("サーブレットから送られた文字が、そのまま表示されています。");
}
このサンプルを実行すると、ブラウザにはHTMLのようなデザインは付かず、メモ帳に表示されるようなシンプルな文字だけが表示されます。最初は物足りなく感じるかもしれませんが、「サーブレットでレスポンスを返す」流れをつかむにはちょうど良い練習になります。
流れとしては、①contentTypeで「テキストレスポンス」であることを伝える → ②PrintWriterを取得する → ③printlnで表示したい文字を出力する、という3ステップだけです。ここが理解できれば、次に学ぶHTMLレスポンスやJSONレスポンスでも、同じように「どんな形式のデータを返すのか」を切り替えていくだけだとイメージしやすくなります。
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アプリを作れるようになりたいです！」
この記事を読んだ人からの質問
プログラミング初心者からのよくある疑問／質問を解決します
Javaサーブレットでレスポンスを返すにはどうすればいいですか？
HttpServletResponseオブジェクトを使ってPrintWriterを取得し、テキストやHTML、JSONなどの形式でレスポンスを出力します。
テキスト形式でレスポンスを返すときのContent-Typeは何を指定すればよいですか？
Content-Typeに"text/plain"を指定し、文字化け対策として"charset=UTF-8"も付け加えるのが一般的です。
HTMLレスポンスをサーブレットで返すにはどうすればよいですか？
Content-Typeに"text/html; charset=UTF-8"を設定して、PrintWriterでHTMLタグを文字列として出力します。
JSON形式のレスポンスをJavaサーブレットで返すにはどうすればいいですか？
Content-Typeに"application/json; charset=UTF-8"を設定し、JSON文字列をPrintWriterで出力することで返せます。
日本語が含まれるサーブレットのレスポンスで文字化けを防ぐ方法は？
Content-Typeに"charset=UTF-8"を含め、必要であればresponse.setCharacterEncoding("UTF-8")も追加します。
サーブレットでPrintWriterを使ったあとにclose()は必要ですか？
通常は必要ありません。サーブレットコンテナが自動でリソースを開放してくれます。
サーブレットでエラーをレスポンスとして返したいときはどうすればいいですか？
response.sendErrorを使って、エラーステータスとメッセージを返すことができます。
JavaサーブレットでHTMLタグをコード内に書くのが見にくいのですが、どうすればいいですか？
JSPファイルを使うことでHTML部分を分離でき、コードの可読性が向上します。
Javaサーブレットで返せるレスポンスの種類には何がありますか？
主にテキスト（text/plain）、HTML（text/html）、JSON（application/json）があり、用途に応じて使い分けます。
JSONレスポンスでGsonやJacksonなどのライブラリを使いたいのですがどうすればよいですか？
JavaオブジェクトをGsonやJacksonでJSON形式に変換し、その結果をPrintWriterで出力すれば簡単に返せます。
サーブレットでレスポンスヘッダーを追加するにはどうすればよいですか？
response.setHeaderメソッドを使えば、任意のレスポンスヘッダーを追加できます。
職業訓練講師が解剖！Java Web開発の真髄「Servlet/JSP」とMVCアーキテクチャの本質。
累計120万PV超の技術メディア運営チームが贈る、商用開発基準の特別カリキュラム
職業訓練講師が解剖！Java Web開発の真髄「Servlet/JSP」とMVCアーキテクチャの本質。
Spring Boot等のモダンなフレームワークの背後で動く、Web開発の原点ServletとJSP。本講座では、HTTPリクエストからレスポンスまでのライフサイクルを徹底解剖。MVCモデルの真の役割分担を明確にし、ブラックボックス化されたWebの仕組みを「自力で制御する力」を60分で養います。
60分集中ワークショップ内容
【つくるもの】
Webアプリの骨格となる「MVC準拠の会員予約システム」のコア機能を構築。Servletでの制御、JavaBeansでのビジネスロジック、JSP（EL式/JSTL）での表示制御。この一連の流れを繋ぎ、フレームワークに依存しない「一生モノのWeb技術」を体得します。
【開発環境】
Apache Tomcatを使用。web.xmlの構造、セッション管理（HttpSession）、アノテーションによるマッピングなど、大規模システムの保守やモダンな環境への移行作業でも必須となる「低レイヤの知識」を職業訓練講師が伝授します。
この60分で得られる3つの革新スキル
リクエスト・セッション・アプリケーション、各スコープの最適な使い分けをマスターします。
レガシーなスクリプトレットを脱却し、保守性の高いJSPを書くためのプロの作法を習得します。
文字化け対策や認証チェックなど、システム全体の品質を支える共通基盤の構築術を伝授します。
※本講座は、Web開発の「中身」を深く知りたい方向けの「バックエンド核心理論講座」です。仕組みを理解し、トラブルシューティング能力を高めたいエンジニアを職業訓練講師が全力でバックアップします。
20名規模のプロジェクトリーダー（PL）が、トラブルを防ぐ実装ノウハウを直接伝授します。
