様々なシステムと連携する業務用Webアプリを開発するお仕事をしています。
連携先のシステムとの連動が開発工程の後期になることが多いため、それまでの期間中に使用する他システムシミュレータをちゃちゃっと準備したいと思い、今回はSpring Bootで作成してみます。
環境
macOS Big Sur
Visual Studio Code 1.53.1
要件
- HTTP
- REST API
- JSON
- レスポンスのコード、本文をソース修正なく変更できるようにしたい
準備
Javaはインストール済み。
Mavenが入っていないのでbrewでインストールする。
% mvn -v
zsh: command not found: mvn
% brew install maven
...
% mvn -v
Apache Maven 3.8.1 (05c21c65bdfed0f71a2f2ada8b84da59348c4c5d)
Maven home: /usr/local/Cellar/maven/3.8.1/libexec
Java version: 15.0.2, vendor: N/A, runtime: /usr/local/Cellar/openjdk/15.0.2/libexec/openjdk.jdk/Contents/Home
Default locale: ja_JP, platform encoding: UTF-8
OS name: "mac os x", version: "11.2.1", arch: "x86_64", family: "mac"
作成
4. 初めての Spring Boot アプリケーションの開発 の通りに進めていく。
POMの作成
任意のフォルダにpom.xmlを作成する。
pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>myproject</artifactId>
<version>0.0.1-SNAPSHOT</version>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.4.4</version>
</parent>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependencies>
<description/>
<developers>
<developer/>
</developers>
<licenses>
<license/>
</licenses>
<scm>
<url/>
</scm>
<url/>
<!-- Additional lines to be added here... -->
</project>
ターミナルでpom.xmlがある場所に移動しmvn packageを実行すると、target配下にmyproject-0.0.1-SNAPSHOT.jarが作成される。
初回はライブラリをMaven Central Repositoryからダウンロードするため、時間がかかる。
サンプルコントローラの作成
ソース用のディレクトリsrc/main/java/を作成し、配下にExample.javaを作成する。
Example.java
import org.springframework.boot.*;
import org.springframework.boot.autoconfigure.*;
import org.springframework.web.bind.annotation.*;
@RestController
@EnableAutoConfiguration
public class Example {
@RequestMapping("/")
String home() {
return "Hello World!";
}
public static void main(String[] args) {
SpringApplication.run(Example.class, args);
}
}
ターミナルでmvn spring-boot:runを実行すると、アプリケーションが起動される。
% mvn spring-boot:run
.....
. ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v2.4.4)
.....
2021-04-11 09:53:43.339 INFO 33707 --- [ main] Example : Started Example in 1.892 seconds (JVM running for 2.311)
ブラウザで http://localhost:8080 にアクセスすると、Hello World!が出力されることを確認できる。
実装
mainメソッドはコントローラから切り出しておく。
また、適当にパッケージを切っておく。
※上で作成したExample.javaは削除
Application.java
package mamfrog;
import org.springframework.boot.*;
import org.springframework.boot.autoconfigure.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
リクエストパラメータでレスポンスコードを指定
GETパラメータcodeで指定した数値をレスポンスコードに設定するコントローラを作成する。
RestTestController.java
package mamfrog.controller;
import java.util.HashMap;
import java.util.Map;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/rest")
public class RestTestController {
@RequestMapping("/")
public ResponseEntity<Map<String, Object>> home(
@RequestParam(value = "code", required = false, defaultValue = "200") String code) {
Map<String, Object> map = new HashMap<>();
map.put("code", code);
return new ResponseEntity<Map<String, Object>>(map, HttpStatus.resolve(Integer.parseInt(code)));
}
}
呼び出し例）http://localhost:8080/rest/?code=201
不正な値を指定された場合の考慮はしていない。
レスポンスボディはリクエストのcodeをそのまま返却する。
レスポンスを任意のJSONにする
上記コントローラを改造し、所定の場所にあるJSONファイルの内容をレスポンスボディとして返却するようにする。
今回はJSONライブラリとしてJacksonを使用。（pom.xml略）
- 所定の場所
BASE_PATHは固定値 - JSONファイル名はリクエストパラメータ
dataIdで指定（[dataId].jsonが所定の場所にあること） -
dataIdが指定なし、または対応するファイルがない場合は空のJSONを返却
RestTestController.java
package mamfrog.controller;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.HashMap;
import java.util.Map;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.apache.commons.lang3.StringUtils;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/rest")
public class RestTestController {
private static final String BASE_PATH = "./";
@RequestMapping("/")
public ResponseEntity<Map<String, Object>> home(
@RequestParam(value = "code", required = false, defaultValue = "200") String code,
@RequestParam(value = "dataId", required = false) String dataId) {
Map<String, Object> map = new HashMap<>();
if (StringUtils.isNotEmpty(dataId)) {
try {
InputStream getLocalJsonFile = new FileInputStream(BASE_PATH + dataId + ".json");
map = new ObjectMapper().readValue(getLocalJsonFile, HashMap.class);
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
return new ResponseEntity<Map<String, Object>>(map, HttpStatus.resolve(Integer.parseInt(code)));
}
}
JSONファイルサンプル
test.json
{
"key1": "aaaaaaaa",
"key2": false
}
呼び出し例）http://localhost:8080/rest/?dataId=test
連携試験用に内部で使用するだけなので、要件を満たす最低限のコードはこのくらい。
エラー処理などは必要に応じて追加していく感じ。
補足
Rest APIの動作確認はGoogle Chromeの拡張機能「Talend API Tester」が便利。
