Spring bootでHelloWorldするまでの手順

:::note warn
↓↓↓　Eclipseのインストール先はこちら。
[Eclipse Downloads|The Eclipse Foundation](https://www.eclipse.org/downloads/)
:::

## はじめに
* EclipseにSpring bootをインストールする手順とHelloWorldするまでの手順を記述。
* 画像多めの構成。
* [Springに関する追加記事はこちら。](https://qiita.com/momomo1998/items/6ec614a9adcd47173a09)

## この記事の目的
* インストールから正常な環境構築ができているかの確認まで終えられるようにする。
* 今後自分で再度インストールする機会が訪れた時の手順再確認用。

# そもそも“Spring boot”とは
* アプリケーションを手軽に作成するためのフレームワーク(**枠組み・ひな形**)の集合体である**Spring Framework**に搭載のされているものの一つ。
* 集合体である機能を使いやすくするためのもの。

# HelloWorldとスモールスタート
* **環境が正しく構築できてるか**を確認することも重要な作業の一つ。
* **スモールスタート**：最低限の環境(最低限のコードの記述)で動作確認をすること。その中で最初に表示するものが「**HelloWorld**」である。
* **“最低限”** である理由：**環境が原因**なのか、**記述したコードが原因**なのか判断がつかなくなってしまうため。先に簡単な短いコードを記述し、重要なコードの記述をする前の確認作業を行う。

<br>

:::note warn
日本語仕様に設定しておりません。
一度アンインストールした後に再度インストールしたため、表記の違い等が少々ある可能性があります。
:::

# 手順1　Eclipseマーケットプレイスでインストール

* Eclipseを開き、「Help」を押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/b6f104d0-02a0-ffe1-a5b4-1740904e2b32.png)

* 「Eclipse　Marketplace」を押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/ca95c996-83ca-63b4-d667-3704a391a59b.png)

* 「Eclipse　Marketplace」というポップアップが表示されるので、検索欄に「Spring」と入力してenterキーを押す。　
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/0b805baa-7963-4fab-e09f-b4c2ef81688c.png)

* 「Spring Tools 4」の「Install」を押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/06376b47-b6dd-fbb6-c186-b74bb6b41c34.png)

* 以下画像のように元からチェックが入っているので、そのままの状態で「Confirm」を押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/3c2f967c-db47-707b-c1dc-dc2bc94ebca6.png)

* 「Finish」を押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/fefabb57-d803-5c51-bb47-036373350882.png)

:::note warn
以下のような表示が出てくる場合もあります。
:::
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/fd4aaa53-c3c9-a044-bd4a-557e63ec1d50.png)

* (別パターン)「https://…」の部分にチェックを入れて、「Trust Selected」を押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/9914b3c5-3593-5326-efc5-44aa4aced183.png)

* (別パターン)するとこんな表示に切り替わる。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/6049adb8-06cd-f2e7-3029-e94cd28620bc.png)

* (別パターン)「I do…」から「I accept…」に切り替えて、「Finish」を押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/1dbb4c5b-aab4-cd73-396a-b88c4bab5ee6.png)

:::note info
以下からはどちらも同じです。
:::

* Eclipseの画面右下にてインストールの進行状況が表示される。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/95963073-451d-64f7-29b4-80412d3f330e.png)

* リスタートしますか？というような表示が出てくるので、「Restart Now」を押して再起動する。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/2affbf26-9800-c040-24c4-883892b24078.png)

* 再起動が始まる。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/fb4dd6d2-1468-7bcc-83f1-0afaadd873f3.png)

:::note info
元の画面に戻ってくるので、ここから「HelloWorld」するために必要なプロジェクトの作成に入っていきます。
:::

# 手順2　新規プロジェクトhelloSpringの作成

* 「File」を押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/2798df59-809d-441d-5f91-1111a73dd86e.png)

* 「New」の上にカーソルを合わせて、更に左に表示される「Other…」を押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/cbb647fe-b80e-ae4f-a380-3490a639c8fb.png)

* 「Select a wizard」というポップアップが表示されるので、Spring Bootの左側にある「>」を押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/a75660d0-b72d-a167-8939-27065a289517.png)

* すると下に展開されるので、その中の「Spring Starter Project」を選択し、「Next>」を押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/64a433ec-7f5e-54b2-0c12-04925d559872.png)

* 以下のようなNew Spring Starter Projectというポップアップが表示される。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/f9508806-03f1-77d7-f7a9-e5e461d695bd.png)

* Nameのところにプロジェクトの名前を入力する。今回は「helloSpring」と入力。
※青線を引いたArtifactにも自動で同じ名前が入力される。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/2e78b746-37ab-a7a1-570f-88d05c39781b.png)

* 次に使用するライブラリを選択する。今回は

  * Spring Boot DevTools
  * Lombok
  * H2 Database
  * Spring Web

の4つのライブラリを入れるため、チェックボックスにチェックする。選択したものは緑枠内に表示される。
※青枠内のチェックボックスにないものでもAvailable:の検索画面から検索可能。「Lombok」がなかったため「L」を入力し検索。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/ca52782a-637c-c257-1fcb-58f170c7f138.png)

# 手順3　新規フォルダcontrollerと新規ファイルHelloController.javaの作成

* 下記のように自動生成されたものがPackage Explorerに表示される。
※プロジェクトが表示されるまで少し時間がかかる場合もある。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/6a7169f0-3659-9d0d-4d5f-cf4549248b20.png)

* Package Explorerにフォルダを新規作成する場合はcom.example.demoの下に作成する。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/3938fac0-baac-b330-064c-cfaac36660b3.png)

:::note info
今回はProject Explorerを表示し、新規作成します。
初期はPackage Explorerで表示されていると思いますので、まずはproject Explorerの表示の仕方から記載します。
:::

* 「Window」を押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/0e6f53c2-21c5-0dca-6e52-df76b70237d1.png)

* 「Show View」にカーソルを合わせ、「Project Explorer」を押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/0d7eda37-dafe-cfbc-18bd-d37fe7c8dbae.png)

* Package Explorerの横にProject Explorerが新たに表示される。

:::note info
「Window」→「Show View」は、「Project Explorer」「Package Explorer」「Console」など、よく使うものが表示できる流れなので覚えておくと便利です。
ふとした時に「Console」などが消えてしまった場合は、この流れで表示できます。
:::

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/34335dfd-eccb-be43-a89c-14c2756795e7.png)

* helloSpringの左にある「>」を押し、展開後に表示される「com.example.demo」の下にcontrollerというフォルダを作るので、「com.example.demo」の上で右クリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/a63f5429-c25c-65bf-d5dc-50304e3db148.png)

* 「New」の上にカーソルを合わせ、「Source Folder」を押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/156672fc-5281-a0aa-a341-3fd6be4ffe3a.png)

* 以下のような画像がポップアップで表示される。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/2a13e31c-42e5-2efa-a7da-f5f4b2cc23a2.png)

* 作成したいフォルダの名前(今回はcontroller)を入力して、「Finish」を押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/6caec8fd-27f3-dd00-ae56-95c70d78a11c.png)

* com.example.demoの下にcom.example.demo.controllerが作成される。次にHelloController.javaというファイルを作るため、「com.example.demo.controller」の上で右クリック。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/a252a6b1-9e28-f331-67bb-7950ba54b40f.png)

* 「New」の上にカーソルを合わせ、「Class」を押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/5ae0119b-ad8a-8254-e24d-eaa2a71d45a1.png)

* 以下のようなポップアップが表示される。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/50de0699-0937-deb0-d95a-d6212f70bfc4.png)

* 作成したいファイルの名前(今回はHelloController)を入力して、「Finish」を押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/fcc1ff4b-dd98-c3c5-c0b4-3e2af7a82c44.png)

* 中身が入ったためcom.example.demo.controllerのアイコンが茶色に変化し、HelloController.javaが作成される。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/0d794274-117e-f714-6712-3b9a804af3a5.png)

# 手順4　HelloWorldと表示するためのコードの入力とブラウザ表示

* 以下のコードをコピーしてお使いください。

:::note info
```
package com.example.demo.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {
    @GetMapping("/")
    public String hello() {
        return "hello";
    }
    @GetMapping("/test")
    public String test() {
        return "test api";
    }
}
```
1：ブラウザ(Browser)がGET /のリクエストをサーバー(Server)に送信。
2：サーバーがHelloControllerクラスのhello()メソッドを呼び出し、"hello"という文字列を生成してブラウザに返す。
3：ブラウザは受け取ったレスポンスを表示し、GET /testのリクエストも処理され、"test api"という文字列が生成されてブラウザに返す。
:::

* 上記コードをHelloController.javaに張り付け、キーボードのctrlとSを押し保存する。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/db8f24b1-e2d4-50e7-d87f-f2010efc80cd.png)

:::note info
以下からSpring Bootを動かせる状態にする作業を行います。
:::

* 一番上にある「helloSpring」の上で右クリックし、「Run As」にカーソルを合わせ、「3 Spring Boot App」を押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/1b287274-0074-1bdc-6192-22b6c979309f.png)

* Consoleを出すと、以下のように表示される。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/6fe9dbe9-7f3e-c261-3e4b-6301a5597d25.png)

:::note info
いよいよブラウザで表示する作業に移ります。
:::

* ブラウザを開き、「http://*localhost*:8080」と入力し、Enterキーを押す。
今回はGoogle Chromeを使用。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/53facc71-40d6-e1c8-74e0-346e81db903f.png)

* 以下のように「hello」と表示されればOK。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/24c1ae3f-7a87-846f-a394-f51e00574f4f.png)

* 最後に「 http://*localhost*:8080/test 」と入力し、Enterキーを押す。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/590720bf-b5bd-2916-f15e-4a787b4210e8.png)

* 以下のように「test api」と表示されればOK。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3624672/e9bccb4b-ca4e-a803-8b9f-41e4bd7a2a6b.png)

## おわりに
* これでSpring bootのインストールから、環境構築ができているかの確認までが完了できたかと思われます。
* 分かりづらい部分も多くあったかと思われますが、どなたかの役に立てますと幸いです。