Spring Boot CLIの設定とHelloWorldの例

私の前の投稿「Spring Bootの紹介」と「Spring Bootのコンポーネントと内部」では、Spring Bootの基礎と4つの主要なSpring Bootコンポーネントの使用方法について説明しました。今回は、Spring Bootのコンポーネントの1つ、CLIについて詳しく説明します。

Spring Boot CLIとは何ですか？

Spring Boot CLI（コマンドラインインターフェース）は、コマンドプロンプトからSpring Bootアプリケーションを実行してテストするためのSpring Bootソフトウェアです。CLIを使用してSpring Bootアプリケーションを実行すると、内部的にはSpring Boot StarterとSpring Boot AutoConfigurateコンポーネントを使用してすべての依存関係を解決し、アプリケーションを実行します。内部的には、GroovyとGrape（JAR依存関係マネージャー）が組み込まれており、Spring Bootのデフォルトを追加し、すべての依存関係を自動的に解決します。Windows環境でのCLIのインストール、CLIのセットアップ、およびCLIコマンドについて説明します。ほかの環境でもほぼ同様です。

Spring Boot CLIのインストール

WindowsインストーラーまたはZipファイルを使用してSpring Boot CLIソフトウェアをインストールできます。どちらの方法も簡単にインストールでき、同じSpring Boot CLIソフトウェアを提供します。私たちはZipファイルを使用する簡単な方法を選択します。Spring Bootの最新バージョンを使用します：1.2.3.RELEASE。Spring Boot CLIソフトウェアを以下のURLからダウンロードできます：https://start.spring.io/（これについては後の投稿で詳しく説明します）。Windows環境にSpring Boot CLIソフトウェアをインストールしてセットアップする手順は以下の通りです。

• Spring Initilizrを使用してSpring Boot CLIのZipファイルをダウンロードします。
  以下のように「Download Spring CLI Zip」ボタンをクリックします：Spring Boot CLIのZipファイルをローカルファイルシステムにダウンロードしたら、以下のようになります：– spring-boot-cli-1.2.3.RELEASE.zipファイルをローカルファイルシステムに展開します。
  WindowsシステムでSpring Boot CLIの環境変数を設定します。以下のように設定します。

set PATH=D:\spring-boot-cli-1.2.3.RELEASE\bin;%PATH%

• 以下のコマンドを実行して、インストールプロセスを確認してください。
  以下に示すように、”spring –version” を使用して Spring Boot CLI のバージョンを知ることができます。

spring --version

“spring –help” を使用して Spring Boot CLI のバージョンを知ることができます。

spring --help

これで Spring Boot CLI のインストールプロセスが正常に完了しました。Spring Boot の “HelloWorld” の例について説明する前に、まずコマンドプロンプトから Groovy スクリプトを実行する方法を見てみましょう。

Spring Boot の “spring” コマンド

Spring Boot CLI ソフトウェアは、コマンドプロンプトから Spring Boot Groovy スクリプトを実行するための “spring” コマンドを提供します。先ほど見たように、Spring Boot の “spring –help” コマンドには、さまざまな目的でこのコマンドを使用するための多くのオプションがあります。ここで使用する重要なオプションは、”run” オプションです。“spring” コマンドの構文:

 spring run <SpringBoot-Groovy-Scriptname>

ここに、Spring Boot アプリケーションの Groovy スクリプトファイル名があります。このコマンドを使用して、Spring Boot の HelloWorld 例を実行します。Spring Boot CLI を使用したシンプルな HelloWorld Spring Boot の例を扱う時が来ました。

Spring Boot HelloWorldの例

今から、Spring Boot MVC RestControllerの例を開発していきます。これは、PivotalチームからTwitterに公開された最初の例であり、Spring Boot Frameworkの強力さを示すためのものです。Spring Boot HelloWorldの例を開発するために、以下の手順に従ってください：

• ローカルファイルシステムに「HelloWorld」という名前のフォルダを作成して、Groovyスクリプトを配置します。
• 次の内容を使用してGroovyスクリプトファイルを開発します

@RestController
class HelloWorld {
  @RequestMapping("/")
  String hello() {
    "Hello JournalDev World."
  }
}

このファイルをHelloWorld.groovyと名付けます。ここで、拡張子”.groovy”は必須です。コードの説明

• Spring 4 MVCの@RestController注釈を使用してRESTコントローラーを定義しました。
• Spring MVCの@RequestMapping注釈を使用して、マッピングURL「/」を定義しました。
• クライアントまたはWebブラウザーに文字列を返すメソッドを定義しました。

コードの観察 HelloWorld.groovyを観察すると、以下の重要な点がわかります。

• インポートなし
• Views、ViewResolverなどのSpring MVCコンポーネントを定義するための他のXML構成はありません。
• web.xmlもDispatcherServletの宣言もありません
• アプリケーションwarファイルを作成するためのビルドスクリプトもありません
• このアプリケーションをデプロイするためにwarファイルをビルドする必要はありません

では、誰がSpring Boot HelloWorldアプリケーションにこれらすべてのものを提供するのでしょうか？まず、アプリケーションを実行して結果を確認し、その後にこの質問に答えます。- 今、Spring Boot HelloWorldの例のフォルダは次のようになっています。

今、Spring Boot HelloWorldの例はSpring MVC RestControllerで準備ができています。Spring Boot Frameworkのパワーを知るために、この例を実行してテストする時が来ました。

Spring Boot HelloWorldの例を実行する

私たちのSpring Boot HelloWorldの例アプリケーションをテストするために、次の手順に従ってください。

• ローカルファイルシステムの「HelloWorld」フォルダでコマンドプロンプトを開きます。
• 次のコマンドを実行します。

 spring run HelloWorld.groovy

• “spring run” コマンド コンソールの出力を観察してください。
  注意： 上のスクリーンショットを観察すると、「SpringApplication」クラスファイルがハイライト表示されています。ここで o.s.boot.SpringApplication は org.springframework.boot.SpringApplication クラスを指します。この SpringApplication とは何でしょうか？それはどのように使用されますか？これらの質問に答えるためには、私の次の投稿を参照してください。- ブラウザを開いて、次のリンクにアクセスしてください。
  このURLにアクセス：https://localhost:8080/ これで最初のSpring Boot MVC RESTful WebServiceにアクセスできるようになりました。

このSpring Bootアプリケーションを観察すると、次の疑問が浮かぶかもしれません：これらのすべての機能をSpring Boot HelloWorldアプリケーションに提供するのは誰でしょうか？

• インポートなし
• Views、ViewResolverなどのSpring MVCコンポーネントを定義するための他のXML構成なし
• web.xml なし、および DispatcherServlet 宣言なし
• アプリケーションの war ファイルを作成するためのビルドスクリプトなし
• このアプリケーションをデプロイするために war ファイルをビルドする必要はありません

{
“error”: “Upstream error…”
}