Java EE Microservices with

<project>
  ...
  <name>javaee7-simple-sample</name>
  <packaging>war</packaging>
  ...
  <dependencies>
    <dependency>
      <groupId>javax</groupId>
      <artifactId>javaee-api</artifactId>
      <version>7.0</version>
      <scope>provided</scope>
    </dependency>
  </dependencies>
  ...

<plugin>  <!-- Add the wildfly-swarm-plugin -->
  <groupId>org.wildfly.swarm</groupId>
  <artifactId>wildfly-swarm-plugin</artifactId>
  <version>2017.3.3</version>
  <executions>
    <execution>
      <goals>
        <goal>package</goal>
      </goals>
    </execution>
  </executions>
</plugin>

mvn package                                # build
ls target                                  # check what has
... javaee7-simple-sample-swarm.jar ...    #   been built
java -jar javaee7-simple-sample-swarm.jar  # run the uberjar

<dependency> <!-- under dependencyManagement -->
  <groupId>org.wildfly.swarm</groupId>
  <artifactId>bom-all</artifactId>
  <version>2017.3.3</version>
  <type>pom</type>
  <scope>import</scope>
</dependency>
...
<dependencies> <!-- Fraction GAVs -->
  <dependency>
    <groupId>org.wildfly.swarm</groupId>
    <artifactId>jaxrs</artifactId>
  </dependency>
  <dependency>
    <groupId>org.wildfly.swarm</groupId>
    <artifactId>cdi</artifactId>
  </dependency>
  ...

public static void main(String[] args) throws Exception {
  new Swarm().fraction(
    new DatasourcesFraction()
      .jdbcDriver("h2", (d) -> {
        d.driverClassName("org.h2.Driver");
        d.xaDatasourceClass("org.h2.jdbcx.JdbcDataSource");
        d.driverModuleName("com.h2database.h2");
      })
      .dataSource("ExampleDS", (ds) -> {
        ds.driverName("h2");
        ds.connectionUrl("jdbc:h2:mem:test;"
          + "DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE");
        ds.userName("sa"); ds.password("sa");
      })
  ).start().deploy();
}

logger:               # project-defaults.yml file
  level: DEBUG
swarm:
  port:
    offset: 10
---
project:              # To specify the "development" stage,
  stage: development  # run with
logger:               #   java -jar my-swarm.jar -S development
  level: DEBUG
swarm:
  port:
    offset: 50
---
project:
  stage: production
logger:
  level: INFO
...

<!-- pom.xml -->
<dependency>
  <groupId>org.wildfly.swarm</groupId>
  <artifactId>topology-consul</artifactId>
</dependency>

/* Inside main() method */
JAXRSArchive deployment = ...
/* register */
deployment.as(TopologyArchive.class)
    .advertise("my-time-service");

java -Dswarm.consul.url=http://127.0.0.1:8500 -jar *-swarm.jar

<!-- pom.xml -->
<dependency>
  <groupId>org.wildfly.swarm</groupId>
  <artifactId>ribbon</artifactId>
</dependency>

                                         //    discovery by
@ResourceGroup( name="my-time-service" ) // <- service name
public interface TimeService {           //    lookup done
                                         //    by Consul fraction
    @TemplateName("currentTime")
    @Http(
            method = Http.HttpMethod.GET,
            uri = "/"
    )
    @Hystrix(
            fallbackHandler = TimeFallbackHandler.class
    )
    RibbonRequest<ByteBuf> currentTime();

                           // Ribbon can provide an implementation
                           // of the TimeService
    TimeService INSTANCE = Ribbon.from(TimeService.class);
}

<!-- pom.xml -->
<dependency>
  <groupId>org.wildfly.swarm</groupId> <!-- typically      -->
  <artifactId>swagger</artifactId>     <!-- in combination -->
</dependency>                          <!-- with jaxrs     -->

/* Inside main() method */
SwaggerArchive archive =
    ShrinkWrap.create(SwaggerArchive.class, "swagger-app.war");
/* Tell swagger where our resources are */
archive.setResourcePackages("org.myorg.myresources");

curl http://localhost:8080/swagger.json

{   "swagger":"2.0",
    "info":{"version":"1.0.0"},
    "host":"localhost:8080",
    "basePath":"/swagger",
    "tags":[{"name":"time"}],
    "schemes":["http"],
    "paths": {
        "/time/now": {
            "get": {
                "tags":["time"],
                "summary":"Get the current time",
                "description":"Returns the time as a string",
                "operationId":"get",
                "produces":["application/json"],
                "parameters":[],
                "responses": {
...