code quality in practice - oio orientation in objects ... · 2 © orientation in objects gmbh...

1

Orientation in Objects GmbH

Weinheimer Str. 68

68309 Mannheim

www.oio.de

[email protected]:

WildFly SwarmJava EE in one JAR

1.0

WildFly Swarm - Java EE in one JAR© Orientation in Objects GmbH

Abstract

Microservices-Architekturen können mit klassischen Application Servern nichts anfangen, stattdessen geht der Trend hin zu Fat-JARs und Self-contained Systems, in denen die Anwendung ihre Ablaufumgebung mitbringt. Nach dem Erfolg von Spring Boot und Co. haben mittlerweile auch die klassischen Java-EE-Applikationsserver-Hersteller Microservices-Frameworks im Programm.

In dieser Session wollen wir uns anschauen, wie mit WildFly Swarm die notwendigen Teile des WildFly AS mit der Applikation und allen benötigten Bibliotheken in einem ausführbaren JAR verpackt werden. Dazu diskutieren wir natürlich auch über für Microservices relevante Themen wie Konfiguration, Logging, Monitoring, Resilience und Service Discovery im Umfeld von WildFly Swarm. Als Abschluss wagen wir noch einen Ausblick auf Standardisierungsversuche im Rahmen von Java EE und der MicroProfile-Initiative.

2

2


Ihre Sprecher

Trainer, Berater, Entwickler

3

Falk Sippach (@sippsack)

Architektur

Agile Softwareentwicklung

Codequalität

Co-Organisator

WildFly Swarm - Java EE in one JAR© Orientation in Objects GmbH 4

Microservices

3


Spring BootDropwizardGrails

Play Framework

Ninja Web Framework

Vert.x

Spark Framework

WildFly Swarm


6

Hello, World!

Paketierung

Konfiguration

Überwachen

Kommunikation

Ausblick

4


Hello, World!


(1) Java EE Anwendung

(2) Maven Plugin

(3) Bauen + Starten

5


(1) Java EE Anwendung


<build>

<finalName>demo</finalName>

<plugins>

<plugin>

<groupId>org.wildfly.swarm</groupId>

<artifactId>wildfly-swarm-plugin</artifactId>

<version>${version.wildfly.swarm}</version>

<executions>

<execution>

<goals>

<goal>package</goal>

</goals>

</execution>

</executions>

</plugin>

</plugins>

</build>

(2) Maven Plugin

6


(3) Bauen + Starten


DEMO

7


Paketierung


WAR-Deployment Fat-JAR

8


"… by packaging them with just enough of the server runtime to

"java -jar" your application."

http://wildfly-swarm.io/


App-Code

WildFly

SwarmJAX-RS

CDI JPA

9


buildscript {

version = System.getProperty('swarmVersion') ?: '2016.11.0-SNAPSHOT'

}

apply plugin: 'wildfly-swarm'

swarm {

properties {

swarm.http.port = 8181

}

}

dependencyManagement {

imports {

mavenBom "org.wildfly.swarm:bom-all:$version"

}

}

dependencies {

compile "org.wildfly.swarm:jaxrs"

}

Und was

ist mit

Gradle?


Kommandozeilenwerkzeug: Swarmtool

10


Konfiguration


(1) Build-Abhängigkeiten

Fractions

Auto-Detection Dependencies Programmatisch

11


Fractions: Auto-Detection


Fractions: Explizite Dependencies

<dependencyManagement>

<dependencies>

<dependency>


<artifactId>bom-all</artifactId>

<version>${version.wildfly.swarm}</version>

<scope>import</scope>

<type>pom</type>

</dependency>

</dependencies>

</dependencyManagement>

12




<dependency>


<artifactId>hystrix</artifactId>

</dependency>

<dependency>


<artifactId>cdi</artifactId>

</dependency>

<dependency>


<artifactId>jaxrs</artifactId>

</dependency>

23


http://wildfly-swarm.io/generator/

13


Fractions: Programmatisch

main-Methode mit DSL (Fluent Interface)

Konfiguration der Fractions und WAR-Inhalt


public class Main {

public static void main(String[] args) throws Exception {

Swarm container = new Swarm()

.fraction(new JAXRSFraction())

.start();

JAXRSArchive appDeployment = ShrinkWrap.create(JAXRSArchive.class)

.addResource(Book.class)

.addResource(BookResource.class)

.addAllDependencies();

container.deploy(appDeployment);

}

}

14


(2) Laufzeitkonfiguration

standalone.xmlSystem PropertiesProperties/YAML

Java DSL


standalone.xml

Standard im WildFly

Konfiguration von Subsystemen, Realms, Datasources, Queues, Sockets, …

java -jar myapp-swarm.jar -c configurations/standalone.xml

15


logger:

level: DEBUG

swarm:

context:

path: /

port:

offset: 10

logger:

level: INFO

swarm:

port:

offset: 100

project-defaults.yml

project-production.yml

java -jar myapp-swarm.jar

// -S oder -Dswarm.project.stage

// oder –D swarm.project.stage.file

java -jar myapp-swarm.jar -S production

Stages


Injection Konfigurationswerte

@Inject

@ConfigurationValue("swarm.context.path")

private String context;

@Inject

@ConfigurationValue("swarm.http.port")

private Integer port;

16


Argument Description

-D<name> or

-D<name>=<value>Java System Property

-P<file-or-url> Properties Datei für System Properties

-c <file-or-url> XML-Konfiguration (standalone.xml oder ein Fragment)

-s <file-or-url> YAML-Konfigurationsdatei

-S <active-profile>Name des zu aktivierenden Profils (Konfig-Block oder

project-[profile].yml)

Kommandozeilenparameter


Name Description Default

swarm.ds.name Name der Datasource ExampleDS

swarm.ds.username Benutzername treiberspezifisch

swarm.ds.password Passwort treiberspezifisch

swarm.ds.connection.url JDBC URL treiberspezifisch

Name Description Default

swarm.bind.address Interface to bind servers 0.0.0.0

swarm.port.offset Ports verschieben 0

swarm.deployment.timeout Timeout (in Sekunden), wie lange das Deployment dauern darf 300

Vordefinierte Parameter

17


Vorbereitete Server (Standalone Uber-JAR)

Keycloak

Swagger-UI

Management Console


Überwachen

18


(1) Logging

jboss-logging

Logstash-Integration

FluentD-Integration


container.fraction(new LoggingFraction()

.fileHandler("FILE", f -> {

Map<String, String> fileProps = new HashMap<>();

fileProps.put("path", "./my.log");

f.file(fileProps);

f.level(Level.INFO);

f.formatter("%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%e%n");

})

.rootLogger(Level.INFO, "FILE"));

swarm.logging=DEBUG

-Dswarm.logging=DEBUG

Konfiguration

19


swarm.logstash.hostname = logstash.intern

swarm.logstash.port = 9300

Konfiguration

<dependency>


<artifactId>logstash</artifactId>

</dependency>

Fraction


(2) Monitoring

Laufzeit-Status der Knoten

Health Check API

20


<dependency>


<artifactId>monitor</artifactId>

</dependency>

Fraction

http://localhost:8080/node

http://localhost:8080/heap

http://localhost:8080/threads

http://localhost:8080/health


@GET

@Path("/diskSpace")

@Health

public HealthStatus checkDiskspace() {

File path = new File(".");

long freeBytes = path.getFreeSpace();

long threshold = 1024 * 1024 * 100; // 100mb

return freeBytes>threshold ? HealthStatus.named("diskspace").up() :

HealthStatus.named("diskspace").down().withAttribute("freebytes", freeBytes);

}

21


(3) Management

Management Interface

Management Console

Jolokia (JMX over HTTP)


<dependency>


<artifactId>management</artifactId>

</dependency>

Fraction

swarm.management.http.port = 9990

swarm.management.https.port = 9993

Konfiguration

22


<dependency>


<artifactId>jolokia</artifactId>

</dependency>

Fraction

/jolokia/read/java.lang:type=Memory/HeapMemoryUsage

{"request": {

"mbean": "java.lang:type=Memory","attribute": "HeapMemoryUsage","type": "read"

},"value": {

"init": 268435456,"committed": 349700096,"max": 3790077952,"used": 207878656

},"timestamp": 1494375975,"status": 200

}


DEMO

23


Kommunikation


(1) Kommunikation

REST (JAX-RS)

Messaging (JMS)

24


(2) Datenzugriff

JPA, Datasources

NoSQL in Arbeit


JPA

Auto-Detection mit ExampleDS

<dependency>


<artifactId>jpa</artifactId>

</dependency>

<dependency>

<groupId>com.h2database</groupId>

<artifactId>h2</artifactId>

<version>${version.h2}</version>

</dependency>

25


.fraction(new DatasourcesFraction()

.jdbcDriver("h2", (d) -> {

d.driverClassName("org.h2.Driver");

d.xaDatasourceClass("org.h2.jdbcx.JdbcDataSource

d.driverModuleName("com.h2database.h2");

})

.dataSource("MyDS", (ds) -> {

ds.driverName("h2");

ds.connectionUrl("jdbc:h2:mem:test;DB_CLOSE_DELAY

ds.userName("sa");

ds.password("sa");

})

)

49

Datasource

<dependency>

<groupId>com.h2database</groupId>

<artifactId>h2</artifactId>

<version>${version.h2}</version>

</dependency>

JDBC-Treiber

(Auto-Detection oder explizit)

Datasource-Definition

(DSL, YAML oder XML)

swarm:

datasources:

data-sources:

MyDS:

driver-name: myh2

connection-url: jdbc:h2:mem:test;DB_CLOSE_DELAY

user-name: sa

password: sa

jdbc-drivers:

myh2:

driver-class-name: org.h2.Driver

xa-datasource-name: org.h2.jdbcx.JdbcDataSource

driver-module-name: com.h2database.h2


(3) Service Discovery + Registration

Topology Fraction

JGroups oder Consul

26


Topology topology = Topology.lookup();

Map<String, ?> services = topology.asMap();

Client

JAXRSArchive deployment = ShrinkWrap.create(JAXRSArchive.class);

deployment.as(TopologyArchive.class).advertise("books");

Registrieren


(4) Resilience

Hystrix

Ribbon

27


@ResourceGroup( name="time" )

public interface TimeService {

TimeService INSTANCE = Ribbon.from(TimeService.class);

@TemplateName("currentTime")

@Http(method = Http.HttpMethod.GET, uri = "/")

@Hystrix(fallbackHandler = TimeFallbackHandler.class)

RibbonRequest<ByteBuf> currentTime();

}


(5) Security

Security Realm

JAAS

SSO mit Keycloak

28


container.fraction(new ManagementFraction()

.securityRealm("ManagementRealm", (realm) -> {

realm.inMemoryAuthentication((authn) -> {

authn.add("admin", "geheim", true);

});

realm.inMemoryAuthorization((authz) -> {

authz.add("admin", "admin");

});

})

);


<dependency>


<artifactId>keycloak</artifactId>

</dependency>

Fraction


deployment.as(Secured.class)

.protect("/books")

.withMethod("GET")

.withRole("admin");

swarm.keycloak.json.path = /srv/…

Konfiguration

29


<dependency>


<artifactId>keycloak-server</artifactId>

</dependency>

Fraction


(6) Testen

Arquillian

30


@RunWith(Arquillian.class)

public class UserServiceTests {

@Inject

private UserService service;

@Test

public void testGetAllUsers() {

assertEquals(3, service.getAllUsers().size());

}

@Deployment

public static Archive createDeployment() {


deployment.addResource(UserService.class);

return deployment;

}

}


Ausblick

31


(1) Java EE 8

Released: September 2017Security API statt

JMS 2.1, Management 2.0 + MVC API


(2) Java EE 9

Ursprünglich geplant für 2018Reaktive APIs, OAuth + OpenID, Circuit

Breaker, NoSQL APIs

32


(3) MicroProfile

IBM, RedHat, Tomitribe, …

Zukunft: Java EE Profil?

Abwarten, was mit EE4J passiert!


Vendor Microservice JAR size/MbStart Up Time/Secs

WebSphere Liberty

Session Voting 35 7

WildFly Swarm Session 65 6

PayaraSession Schedule

33 5

TomEE Speaker 35 3

KumuluzEE*Session Schedule

11 2

https://readlearncode.com/java-ee/eclipse-microprofile-5-things-you-need-to-know

(3) Enterprise Java ist schwergewichtig?

33


(3) MicroProfile

September 2016: 1.0

CDI, JAX-RS, JSON-P


(3) MicroProfile

Juli 2017: 1.1

Config 1.0

34


(3) MicroProfile

September 2017: Version 1.2

Health Check 1.0, Metrics 1.0, Fault Tolerance 1.0, JWT Propagation 1.0, JSON-P 1.0, JAX-RS 2.0, , Config 1.1


(3) Roadmap MicroProfile

Dezember 2017: Version 1.3

März 2018: Version 2.0 (Java EE 8 Update)

35


(4) Warum Standards?

Unabhängigkeit

Bewährt

Know-How


Fazit

36


WildFly Swarm

veröffentlicht im Mai 2015

1.0.0 seit Juni 2016

Monatliche Releases seit 2016.8.1

Apache License 2.0

http://wildfly-swarm.io


Vorteile

Lösung auf Basis von Java EE

Fat-JAR oder App-Server

Drittbibliotheken (Ribbon, Hystrix, …)

Integration (Keycloak, Hawkular, …)

37


Nachteile

kurze Releasezyklen

Unstable Fractions

wenige Drittbibliotheken

Doku und Demos "im Fluß"


Feature WildFly Swarm

REST-APIs JAX-RS, Swagger, HATEOAS

Messaging JMS

Deployment Fat JAR oder WAR

Build-Tools Maven, Gradle, Swarmtool

Konfiguration System-/Umgebungsvariablen, standalone.xml,

Properties-/YAML-Dateien

Unterstützung von Stages/Profile

Logging jboss-logging, Logstash

Monitoring ja mit Health Checks, Hawkular

Management HTTP, JMX, Jolokia

Sicherheit JAAS, Keycloak (SSO, OAuth, OpenID)

Service Discovery JGroups oder Consul

Resilience Hystrix, Ribbon

38


Links

• WildFly Swarm User's Guide

– https://wildfly-swarm.gitbooks.io/wildfly-swarm-users-guide/

• WildFly Swarm Reference Guide

– https://reference.wildfly-swarm.io/

• WildFly Swarm HOWTO

– https://howto.wildfly-swarm.io/

• WildFly Swarm Examples

– https://github.com/wildfly-swarm/wildfly-swarm-examples

75

Orientation in Objects GmbH

Weinheimer Str. 68

68309 Mannheim

www.oio.de

[email protected]

Vielen Dank für Ihre

Aufmerksamkeit!

https://wildfly-swarm.gitbooks.io/wildfly-swarm-users-guide/

https://reference.wildfly-swarm.io/

https://howto.wildfly-swarm.io/

code quality in practice - oio orientation in objects ... · 2 © orientation in objects gmbh...

Documents