概要
Spring Boot 2.1.6、Kotlin、Mavenを、Spring Initializrという、SpringBootアプリケーションの雛形を作成できるサイトで作成し、IntelliJ IDEA Community Editionにインポート。その後ControllerとView(SpringBootではtemplate)を追加し、簡単なWebアプリをローカル実行。
その後、GAEにデプロイしてそちらでも問題ないことを確認するところまでを書く。
環境
- IntelliJ IDEA Community Edition 2019.1.3
- Spring Boot 2.1.6
- Kotlin 1.2.71
- Java 8
- Maven
- Google Cloud Platform
- Google App Engine Standerd Environment
事前準備
- GCP環境に、GAEのJavaランタイムでデプロイできること
- IntelliJ IDEAにCloud Codeプラグインをインストール済み
- IntelliJ IDEAをPleiades日本語化プラグインを用いて日本語化しておく
(日本語化については好み)
Spring Initializrで雛形作成
Spring Initializr
以下の内容を指定して、Generate Projectボタンを押します。
クリック後、zipファイルがダウンロードされるので、zipを適当な箇所に解凍します。
(自分はCドライブ直下にコピーして、そこで解凍しています。)
- Project:Maven Project
- Language:Kotlin
- Spring Boot:2.1.6
- Project Metadata
- Packaging:War
- Java:8
- それ以外については以下キャプチャ参照(Artifactとかは好みかと思います。)
プロジェクト構成の確認
│ .gitignore
│ HELP.md
│ mvnw
│ mvnw.cmd
│ pom.xml
│
├─.mvn
│ └─wrapper
│ maven-wrapper.jar
│ maven-wrapper.properties
│ MavenWrapperDownloader.java
│
└─src
├─main
│ ├─kotlin
│ │ └─com
│ │ └─example
│ │ └─mavenkotlinwar
│ │ MavenkotlinwarApplication.kt
│ │ ServletInitializer.kt
│ │
│ └─resources
│ │ application.properties
│ │
│ ├─static
│ └─templates
└─test
└─kotlin
└─com
└─example
└─mavenkotlinwar
MavenkotlinwarApplicationTests.kt
IntelliJ IDEAにプロジェクトをインポート
-
IntelliJ IDEAを起動して、ファイル ⇒ 新規 ⇒ 既存ソースからプロジェクトを選択します。
「インポートするファイルまたはディレクトリーの選択」ウインドウが出るので、対象プロジェクトのpom.xmlを選択し、OKボタンを押します。 -
「Maven プロジェクトを自動的にインポートする」のチェックボックスをチェックし、次へボタンを押します。
-
「インポートする Maven プロジェクトの選択」では、デフォルトでチェックされているので、そのままで次へボタンを押します。
-
プロジェクトJDKについては人によると思いますが、自分はjdk1.9だったので、変更せず次へボタンを押しました。
-
新規作成するIntelliJ IDEAプロジェクトの名前は、変更あれば変更し、なければそのままで完了ボタンを押します。
-
新規プロジェクトウインドウが出るので、どちらかを選んでボタンを押します。
(自分は新規ウインドウで開いています。)
controllerを作成
-
src/main/kotlin/com/example/com/example/mavenkotlinwar配下にcontrollerパッケージを作成します。
-
作成したcontrollerパッケージ配下に、TransitionTestControllerクラスを作成します。
ソースは以下の通りです。
import org.springframework.stereotype.Controller
import org.springframework.ui.Model
import org.springframework.web.bind.annotation.GetMapping
import org.springframework.web.bind.annotation.RequestMapping
import org.springframework.web.bind.annotation.RequestMethod
import org.springframework.web.bind.annotation.RequestParam
@Controller
@RequestMapping("transitionTest")
class `TransitionTestController` {
@GetMapping("/input")
fun input(
@RequestParam(value = "name", required = false, defaultValue = "world") name: String,
model: Model): String {
model.addAttribute("name", name)
return "transitionInput"
}
@RequestMapping("/output", method = arrayOf(RequestMethod.POST))
fun output(
@RequestParam(value = "user", required = true) user: String,
@RequestParam(value = "age", required = true) age: String,
model: Model): String {
model.addAttribute("user", user)
model.addAttribute("age", age)
return "transitionOutput"
}
}
templateを作成
- src/main/resources/template配下に、transitionInput.htmlを作成します。
ソースは以下の通りです。
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8" http-equiv="Content-Type" content="text/html" />
<title>入力画面</title>
</head>
<body>
<p th:text="'Hello, ' + ${name} + '!'" />
<form method="post" action="output">
<span>入力値1: </span>
<input type="text" name="input1" value="" />
<br />
<span>入力値2: </span>
<input type="text" name="input2" value="" />
<br />
<input type="submit" value="send" />
</form>
</body>
</html>
2. src/main/resources/template配下に、transitionOutput.htmlを作成します。
ソースは以下の通りです。
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8" http-equiv="Content-Type" content="text/html" />
<title>出力画面</title>
</head>
<body>
<p th:text="'入力値1は、' + ${input1} + 'でした。'" />
<p th:text="'入力値2は、' + ${input2} + 'でした。'" />
</body>
</html>
application.propertiesにjdbcドライバーをセット
(プロジェクト作成時、DependenciesのSQLを選択していないかたは読み飛ばしてください。)
application.propertiesに、以下を張り付けてください。
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306
ローカル環境で、プログラムを実行
-
IntelliJ IDEAの表示 ⇒ ツール・ウィンドウ ⇒ Mavenを選択します。
-
Mavenウィンドウが表示されるので、Plugins ⇒ spring-boot ⇒ spring-boot:runで右クリックし、実行を押します。
- spring-bootの実行ログに、Tomcat Startedとか、Started MavenkotlinwarApplicationKtと出ていることを確認します。
- http://localhost:8080/transitionTest/input にアクセスし、入力画面が表示されることを確認します。
- 適当な値を入力して、sendボタンを押します。
- 出力画面に遷移し、入力画面で入力した値が表示されていることを確認します。
GAEへのデプロイ準備
-
GAEデプロイのため、appengine-web.xmlを作成します。
ツール ⇒ Cloud Code ⇒ App Engine ⇒ Add App Engine Support ⇒ Google App Engine Standardを押します。 -
モジュールの選択ウィンドウが表示されたら、対象のモジュールを選択し、OKボタンを押します。
- ライブラリーはデフォルトのまま(Servlet APIにチェックされている)で、OKボタンを押します。
- src/main配下に、webapp/WEB-INFフォルダが新規作成され、appengine-web.xmlが作成されたことを確認します。
ファイルの中身は、初期作成のままで問題ないです。
GAEへのデプロイ
- ツール ⇒ Cloud Code ⇒ App Engine ⇒ App Engine へデプロイを押します。
押下後、Create Deployment Configurationウィンドウが表示されます。
- プロジェクト: Google Cloud プロジェクトの選択を押し、設定したGoogleアカウントに紐づくGCPプロジェクトが表示された後、デプロイしたいプロジェクトを選択し、OKボタンを押します。
- Create Deployment Configurationウィンドウが再表示され、プロジェクトに、先ほど選択した「プロジェクト名:アカウント名」が選択されていることを確認後、実行ボタンを押します。
GAEへのデプロイ後の動作確認
- デプロイ完了後、https://{GCPのプロジェクトID}.appspot.com/transitionTest/input にアクセスし、ローカル環境でspring-boot実行したとき同様の画面が表示されることを確認します。
- 適当な値を入力してからsendボタンを押して、画面遷移することを確認します。
最後に
最初はgradleを使ってGAEにデプロイしようとしていましたが、GAEデプロイ時にデプロイ対象としてプロジェクトを選択できなかったため、mavenに変更しました。
gradleについてはもう少し調査が必要そうです。
以上、お読みいただきありがとうございました。