第十四回 #渋谷java 発表資料 http://shibuya-java.connpass.com/event/25382/

1. WILDFLY SWARM IN PROGRESS
2016-02-13 第十四回 #渋谷java
,@emaggame http://morec.at

2. 目次
WildFly
WIldFly Swarm
基本的な使い方
便利な Fraction
おまけ

3. http://wildfly.org/
Java EE 7 準拠のアプリケーションサーバ
2016-01-29 10.0.0.Final がリリース

4. http://wildfly-swarm.io
公式キャッチフレーズ "Rightsize Your Services"
Java EE で uber jar
Spring Boot のようなもの
Fraction という単位で必要な機能のみをもったアプ
リケーションを作成
最新版 1.0.0.Alpha8。ベースは WildFly 10.0.0.Final

5. 基本的な使い方
uberjar(* - s w a r m . j a r ) を作成するプラグイン
<plugin>
<groupId>org.wildfly.swarm</groupId>
<artifactId>wildfly­swarm­plugin</artifactId>
<configuration>
<mainClass>wildflyswarmtour.App</mainClass>
</configuration>
<executions>
<execution>
<goals><goal>package</goal></goals>
</execution>
</executions>
</plugin>

6. 基本的な使い方
好きな API を依存性に追加
<dependency>
<groupId>org.wildfly.swarm</groupId>
<artifactId>jaxrs</artifactId>
</dependency>

7. 基本的な使い方
アプリケーションを書く
普通の JAX-RS を利用したリソースクラス
import javax.ws.rs.GET;
import javax.ws.rs.Path;
@Path("/hello")
public class HelloWildFlySwarm {
@GET
public String hello() {
return "Hello, WildFly Swarm!";
}
}

8. 基本的な使い方
アプリケーションのエンドポイントを作成
import org.jboss.shrinkwrap.api.ShrinkWrap;
import org.wildfly.swarm.container.Container;
import org.wildfly.swarm.jaxrs.JAXRSArchive;
public class App {
public static void main(String[] args) throws Exception {
Container container = new Container();
JAXRSArchive deployment =
ShrinkWrap.create(JAXRSArchive.class);
deployment.addPackages(true, App.class.getPackage());
deployment.addAllDependencies();
container.start().deploy(deployment);
}
}

9. 基本的な使い方
あとはパッケージングすれば uber jar のできあがり。
$ mvn clean package && java ­jar target/hello­swarm.jar
19:10:43,529 INFO [org.jboss.msc] (main) JBoss MSC version 1.2.6.Final
19:10:43,692 INFO [org.jboss.as] (MSC service thread 1­6) WFLYSRV0049: Wi
2016­02­11 19:10:44,407 INFO [org.jboss.as.naming] (ServerService Thread
[...]
$ curl localhost:8080/hello
Hello, WildFly Swarm!

10. 基本的な使い方
その他に以下の方法でも起動可能
mvn wildfly-swarm:run
IDE から main() メソッド実行
Gradle を使いたい場合は以下を参考に。
https://github.com/wildfly-swarm/wildfly-swarm-
examples/tree/1.0.0.Alpha8/gradle

11. 便利な FRACTION
Netflix OSS
Keycloak
Swagger
...

12. NETFLIX OSS
https://github.com/Netflix
Microservices の雄、Netflix は様々なライブラリを公開

13. NETFLIX OSS
WildFly Swarm では Ribbon と Hystrix および依存ライブラ
リがすぐ使える。
<dependency>
<groupId>org.wildfly.swarm</groupId>
<artifactId>ribbon</artifactId>
</dependency>
https://wildfly-swarm.gitbooks.io/wildfly-swarm-users-
guide/content/netflixoss.html

14. NETFLIX OSS
Ribbon と Hystrix の主な機能
Ribbon: クライアントサイド ロードバランシング
Hystrix: サーキットブレーカ

15. NETFLIX OSS
Time Service と Event Service の 2 サービスがある例
https://github.com/wildfly-swarm/wildfly-swarm-
examples/tree/1.0.0.Alpha8/ribbon

16. NETFLIX OSS
Time Service は冗長化(ポート 8081 と 8082)
Event Service は時刻表示に Time Service に依存

17. NETFLIX OSS
Time Service は 8081 がダウンしても実行可能

18. NETFLIX OSS
Time Service 両系ダウンすると Event Service は時刻表示
にフォールバック用のレスポンス(次ページ)を利用

19. NETFLIX OSS
import com.netflix.hystrix.HystrixInvokableInfo;
import com.netflix.ribbon.hystrix.FallbackHandler;
import io.netty.buffer.ByteBuf;
import rx.Observable;
import java.util.Map;
public class TimeFallbackHandler
implements FallbackHandler<ByteBuf> {
@Override
public Observable<ByteBuf> getFallback(
HystrixInvokableInfo<?> hystrixInfo,
Map<String, Object> requestProps) {
String fallback = "{ "h": 12 }";
return ...
}
}

20. KEYCLOAK
http://keycloak.jboss.org/
様々な認証形式に対応した認証・認可サーバ

21. KEYCLOAK
WildFly Swarm では Keycloak クライアントがリソース制
限を設定する API を用意
deployment.as(Secured.class)
.protect( "/some­resource" )
.withMethod( "GET" )
.withRoles( "admin" );
<dependency>
<groupId>org.wildfly.swarm</groupId>
<artifactId>keycloak</artifactId>
</dependency>
https://wildfly-swarm.gitbooks.io/wildfly-swarm-users-
guide/content/keycloak.html

22. KEYCLOAK
Keycloak サーバを WildFly Swarm を用いた
uber jar にすることも可能
自分でいろいろ設定したい場合
ビルド済みのものを利用したい場合
https://wildfly-swarm.gitbooks.io/wildfly-swarm-users-
guide/content/keycloak_server.html
https://wildfly-swarm.gitbooks.io/wildfly-swarm-users-
guide/content/servers.html#_keycloak_server

23. SWAGGER
http://swagger.io/
REST API を定義する仕様を定めるライブラリ
2016-01-01 Open API と改名

24. SWAGGER
WildFly Swarm では JAX-RS を用いた REST API に対して、
Swagger の定める REST API 仕様の表現である
swagger.json を出力する機能を用意
<dependency>
<groupId>org.wildfly.swarm</groupId>
<artifactId>swagger</artifactId>
</dependency>
https://wildfly-swarm.gitbooks.io/wildfly-swarm-users-
guide/content/swagger.html
http://wildfly-swarm.io/posts/wildfly-swarm-s-got-
swagger/

25. SWAGGER
現在時刻をレスポンスする API の例
https://github.com/wildfly-swarm/wildfly-swarm-
examples/tree/1.0.0.Alpha8/jaxrs/swagger

26. SWAGGER
import io.swagger.annotations.*;
@Path("/time")
@Api(value = "/time", description = "Get the time", tags = "time")
public class TimeResource {
@GET
@Path("/now")
@ApiOperation(value = "Get the current time",
notes = "Returns the time as a string",
response = String.class
)
@Produces(MediaType.APPLICATION_JSON)
public String get() {
return String.format("{"value" : "The time is %s"}", ...);
}
}
$ curl localhost:8080/time/now
{"value" : "The time is 2016­02­13T14:00:00.000+09:00"}

27. SWAGGER
$ curl localhost:8080/swagger.json
{
"paths": {
"/time/now": {
"get": {
"responses": { "200": {
"schema": { "type": "string" },
"description": "successful operation"
}
},

28. SWAGGER
$ curl localhost:8080/swagger.json
"produces": [
"application/json"
],
"operationId": "get",
"description": "Returns the time as a string",
"summary": "Get the current time",
"tags": [
"time"
]

29. SWAGGER
ドキュメンテーション UI である も WildFly
Swarm で動かせる。
Swagger UI
https://wildfly-swarm.gitbooks.io/wildfly-swarm-users-
guide/content/servers.html#_swagger_ui_server
ビルド済みの jar をダウンロードして実行
$ wget ­­trust­server­names http://bit.ly/swagger­ui­100Alpha8­swarm
$ java ­jar swagger­ui­1.0.0.Alpha8­swarm.jar

30. SWAGGER

31. SWAGGER
現在の 1.0.0.Alpha8 の注意点として、
CDI を利用すると実行時エラーになる
AmbiguousResolutionException thrown with swagger
fraction
https://issues.jboss.org/browse/SWARM-271

32. おまけ
WildFly Swarm を一通り触ってみるブログエントリ
WildFly Swarm 周遊
http://morec.at/blog/2015/12/21/wildfly-swarm-tour
Hello WildFly Swarm
簡単な CRUD アプリ
Arquillian を使った Integration Test
Keycloak による認証
Docker イメージ作成

33. 最後に
WildFly Swarm は Java EE アプリケーションが手軽に作成
できるだけでなく、様々な API のインテグレーションに
も注力しています。
ぜひ触っていただいて応援やコミュニティに参加いただ
くとともに、機能追加やバグ指摘などお願いします。
Community
JIRA
http://wildfly-swarm.io/community/
https://issues.jboss.org/secure/RapidBoard.jspa?
rapidView=2972