Spring Initializr でプロジェクトの作成
構築するもの
どんなブラウザーでも接続できる典型的な "Hello World!" Web API を作成します。あなたの名前を伝えることで、フレンドリーな応答を返してくれます。必要なもの
統合開発環境 (IDE)
人気の選択肢としては Eclipse STS (Pleiades All in One)、IntelliJ IDEA、Visual Studio Code などがあります。
ステップ 1 : 新しい Spring Boot プロジェクトを開始する
Eclipse STS、IntelliJ IDEA Ultimate、VSCode のプロジェクト作成ウィザード (内部的には Spring Initializr (英語) 呼び出し) を使用して、プロジェクトを作成します。ここでは、Eclipse STS を使用した Web 最小構成の例を示します。ファイル > 新規 > Spring スタータープロジェクト > そのまま「次へ」 > 依存関係で "Spring Boot DevTools" と "Spring Web" を選択して「完了」を押します。
生成されたプロジェクトには Spring Boot が含まれています。これは、Spring をアプリ内で使用できるようにするフレームワークですが、多くのコードや構成は必要ありません。Spring Boot は、Spring プロジェクトを開始するための最も迅速で最も人気のある方法です。
ステップ 2 : コードを追加
src/main/java/com/example/demo
フォルダーの DemoApplication.java
ファイルを開き、以下のコードに示すメソッドとアノテーションを追加して、ファイルの内容を変更します。コードをコピーして貼り付けるか、入力するだけです。
package com.example.demo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@SpringBootApplication
@RestController
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
@GetMapping("/hello")
public String hello(@RequestParam(value = "name", defaultValue = "World") String name) {
return String.format("Hello %s!", name);
}
}
これは、Spring Boot で単純な "Hello World" Web サービスを作成するために必要なすべてのコードです。
追加した hello()
メソッドは、name という文字列パラメーターを取得し、このパラメーターをコード内の単語 "Hello"
と組み合わせるように設計されています。つまり、リクエストで自分の名前を "Amy"
に設定すると、レスポンスは "Hello Amy" になります。
@RestController
アノテーションは、このコードが Web 経由で使用可能にする必要があるエンドポイントを記述していることを Spring に伝えます。@GetMapping(“/hello”)
は Spring に、hello()
メソッドを使用して http://localhost:8080/hello
アドレスに送信されるリクエストに応答するように指示します。最後に、@RequestParam
は Spring にリクエストに名前の値があることを期待するように指示していますが、そこにない場合はデフォルトで "World"
という単語を使用します。
ステップ 3 : 試してみよう
プログラムを実行してみましょう。単純な Java アプリケーションと同じように実行するだけです。Eclipse STS では Boot ダッシュボードから実行できます。
これとよく似た出力が表示されるはずです。
ここの最後の数行は、Spring が起動したことを示しています。Spring Boot に組み込まれた Apache Tomcat サーバーは Web サーバーとして動作し、localhost
ポート 8080
でリクエストをリッスンしています。ブラウザーを開き、上部のアドレスバーに http://localhost:8080/hello
と入力します。次のようなわかりやすいレスポンスが返されるはずです。
ここでクイズ
URL の末尾に ?name=Amy
を追加するとどうなるでしょうか?
次は人気のガイドを試してみよう
Spring がいかにシンプルであるかはすでにお分かりいただけたと思いますが、非常に柔軟でもあります。Spring でできることは何千もあります。最も一般的な選択肢を紹介するガイドが多数用意されています。学習を続けて、これらの追加ガイドのいずれかを試してみませんか ?