Spring Bootのリクエスト/レスポンス入門：HTTPメソッド・ヘッダー・ステータスをやさしく解説

Spring Bootのリクエスト/レスポンス入門：HTTPメソッド・ヘッダー・ステータス

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

生徒

「Spring Bootでリクエストやレスポンスを扱うとき、どんな仕組みになってるんですか？」

先生

「Spring Bootでは、HTTPメソッドやリクエストヘッダー、レスポンスステータスコードなどをコントローラーで簡単に扱えるようになっていますよ。」

生徒

「例えばGETとかPOSTの違いとかもあるんですよね？」

先生

「そうですね。それでは、HTTPメソッドの使い分けやヘッダー、ステータスコードの基本から順番に見ていきましょう！」

1. Spring BootとHTTPメソッドの関係

Spring Bootでは、@GetMappingや@PostMappingといったアノテーションを使って、HTTPリクエストを処理することができます。HTTPメソッドは、Webアプリケーションにおいてクライアントがサーバーに対してどのような操作をしたいのかを示す手段です。

例えば以下のようなHTTPメソッドがあります：

GET： データの取得に使う
POST： 新しいデータの作成や送信
PUT： データの更新
DELETE： データの削除

Spring Bootでは、それぞれに対応したアノテーションでリクエストを受け取れます。


@RestController
public class UserController {

    @GetMapping("/user")
    public String getUser() {
        return "ユーザー情報を取得しました";
    }

    @PostMapping("/user")
    public String createUser() {
        return "ユーザーを作成しました";
    }
}

2. リクエストヘッダーとレスポンスヘッダーとは？

HTTPリクエストやレスポンスには、ヘッダーという情報が含まれます。リクエストヘッダーは、ブラウザやアプリケーションがサーバーに送る追加情報です。レスポンスヘッダーは、サーバーがクライアントに返す追加情報です。

例えば、User-Agent（どんなブラウザか）、Content-Type（データ形式）、Accept（受け取り可能なデータ形式）などがよく使われます。

Spring Bootでは、リクエストヘッダーを@RequestHeaderで取得できます。


@GetMapping("/header-test")
public String headerTest(@RequestHeader("User-Agent") String userAgent) {
    return "あなたのブラウザは：" + userAgent;
}

3. レスポンスのステータスコードの設定

レスポンスにはHTTPステータスコードを設定することで、クライアントに処理結果を伝えることができます。たとえば、200 OKや404 Not Found、500 Internal Server Errorなどが代表的です。

Spring BootではResponseEntityを使うことで、ステータスコードも細かく制御できます。


@GetMapping("/status")
public ResponseEntity<String> getStatus() {
    return new ResponseEntity<>("正常に処理されました", HttpStatus.OK);
}

もしエラーやデータが見つからない場合は以下のように記述できます。


@GetMapping("/status404")
public ResponseEntity<String> getNotFound() {
    return new ResponseEntity<>("データが見つかりません", HttpStatus.NOT_FOUND);
}

4. HTTPメソッドの使い分け例

リクエストの種類に応じて、HTTPメソッドを使い分けることで、Webサービスの設計が明確になります。例えばユーザー情報を操作するAPIでは以下のように設計するのが一般的です：

GET /users：ユーザー一覧の取得
GET /users/{id}：特定ユーザーの取得
POST /users：新規ユーザー作成
PUT /users/{id}：ユーザー情報の更新
DELETE /users/{id}：ユーザーの削除

このような設計は「REST API設計」と呼ばれ、Spring Bootでも非常によく使われる設計スタイルです。

5. JSON形式のリクエストとレスポンス

Spring Bootでは、JSON形式のリクエストやレスポンスを簡単に扱うことができます。クライアントからJSONデータを受け取り、Javaオブジェクトに変換するには、@RequestBodyを使います。


@PostMapping("/json")
public ResponseEntity<String> receiveJson(@RequestBody User user) {
    return new ResponseEntity<>("名前：" + user.getName(), HttpStatus.OK);
}

このように書くだけで、Spring Bootが自動的にJSONをJavaオブジェクトに変換してくれます。逆にJavaオブジェクトをJSONにして返すことも自動で行われます。

6. 実行結果の例

上記の/header-testを実行すると、以下のようなレスポンスが返ってくる場合があります。


あなたのブラウザは：Mozilla/5.0 (Windows NT 10.0; Win64; x64)

7. Web開発で必須！HTTPの基礎知識を理解しよう

Spring BootでWebアプリケーションを作るうえで、HTTPのリクエスト・レスポンス・ヘッダー・ステータスコードの理解は欠かせません。これらをしっかり把握しておくことで、実践的なAPI開発がスムーズに進みます。特にRESTfulな設計やエラーハンドリングを行う際には、HTTPの基本をおさえることが重要です。

まとめ

Spring BootとHTTPの基本を振り返る

Spring Bootを使ったWebアプリケーション開発では、HTTPリクエストとレスポンスの理解が非常に重要です。本記事では、HTTPメソッド、リクエストヘッダー、レスポンスヘッダー、ステータスコード、そしてJSONデータの扱いまで幅広く解説しました。これらの知識は、REST API設計やバックエンド開発において欠かせない基礎となります。

特にHTTPメソッドの使い分けは、API設計の品質を大きく左右します。GETはデータ取得、POSTは新規作成、PUTは更新、DELETEは削除といった基本ルールを守ることで、可読性が高く保守しやすいAPIを構築できます。Spring Bootではこれらをアノテーションで簡潔に記述できるため、初心者でも直感的に扱える点が魅力です。

ヘッダーとステータスコードの重要性

リクエストヘッダーやレスポンスヘッダーは、クライアントとサーバーの間でやり取りされる補助情報です。User AgentやContent Typeなどを適切に扱うことで、より柔軟で安全な通信が実現できます。また、ステータスコードは処理結果を明確に伝える重要な要素です。200や404、500などを正しく使い分けることで、フロントエンドとの連携もスムーズになります。

JSONとSpring Bootの連携

JSON形式のデータは現代のWeb開発において標準的なフォーマットです。Spring BootではRequestBodyを使うことで、JSONを自動的にJavaオブジェクトへ変換できます。この仕組みによって、複雑なデータ処理もシンプルに記述でき、開発効率が大きく向上します。

実践的なサンプルプログラム


@RestController
@RequestMapping("/api/users")
public class UserRestController {

    @GetMapping
    public ResponseEntity<String> getUsers() {
        return new ResponseEntity<>("ユーザー一覧取得成功", HttpStatus.OK);
    }

    @PostMapping
    public ResponseEntity<String> createUser(@RequestBody User user) {
        return new ResponseEntity<>("ユーザー作成成功：" + user.getName(), HttpStatus.CREATED);
    }

    @PutMapping("/{id}")
    public ResponseEntity<String> updateUser(@PathVariable int id) {
        return new ResponseEntity<>("ユーザー更新成功 ID：" + id, HttpStatus.OK);
    }

    @DeleteMapping("/{id}")
    public ResponseEntity<String> deleteUser(@PathVariable int id) {
        return new ResponseEntity<>("ユーザー削除成功 ID：" + id, HttpStatus.OK);
    }
}

上記のように、Spring BootではRESTfulな設計を簡単に実現できます。エンドポイント設計とHTTPメソッドを組み合わせることで、実務でも通用するAPI開発が可能になります。

実行結果のイメージ


ユーザー一覧取得成功
ユーザー作成成功：山田太郎
ユーザー更新成功 ID：1
ユーザー削除成功 ID：1

このように、リクエストに応じて適切なレスポンスが返ることで、クライアント側との連携がスムーズになります。特にフロントエンド開発と連携する際には、ステータスコードとレスポンス内容を明確に設計することが重要です。

先生と生徒の振り返り会話

生徒

「HTTPメソッドって、ただの種類じゃなくて設計そのものに関わるんですね」

先生

「その通りです。正しく使い分けることで、誰が見ても分かりやすいAPIになります」

生徒

「ヘッダーやステータスコードも意識することで、より実践的な開発ができそうです」

先生

「はい。特にエラー処理や認証などでは重要になります。細かい部分ですが品質に大きく影響します」

生徒

「JSONの扱いも思ったより簡単でした。自動変換は便利ですね」

先生

「Spring Bootの強みの一つです。これを活用すれば開発効率は大きく上がります」

生徒

「今回の内容をしっかり復習して、自分でもAPIを作ってみます」

先生

「それが一番の近道です。実際に手を動かして理解を深めていきましょう」

生成AIを基礎から学びたい方へ

ChatGPTなどの生成AIをこれから学びたい方に向けて、AIスキルアカデミーの口コミ・評判、料金、無料セミナーの内容を詳しくまとめています。

AIスキルアカデミーの口コミ・評判を詳しく見る

スタースクール：社会人向け実務教育プロジェクト

【職業訓練講師が直接指導】

社会人向けSpring Boot実務セミナー｜職業訓練講師が教えるWebシステム構築の極意

Java入門からSpring Boot実務まで。現場で絶賛される「設計の型」を最短距離で習得。

技術記事の内容を、自分の「スキル」へ変える。

職業訓練講師が最短攻略！社会人向けSpring Bootによる「商用Webシステム構築」の実践。

モダンJava開発の事実上の標準Spring Boot。本セミナーでは、その圧倒的利便性の核にある「DI（依存性の注入）」を完全解剖。「設定より規約」を体現した効率的なアーキテクチャ設計を学び、ThymeleafやSpring Data JPAを組み合わせた、現場で必須となるWebシステムの作り方を60分で濃縮体験します。