Eclipse Vert.x tool-kit codebase containing real world examples (CRUD, auth, advanced patterns, etc) that adheres to the RealWorld spec and API.

Demo RealWorld

This codebase was created to demonstrate a fully fledged fullstack application built with Eclipse Vert.x) including CRUD operations, authentication, routing, pagination, and more.

We've gone to great lengths to adhere to the Eclipse Vert.x community styleguides & best practices.

For more information on how to this works with other frontends/backends, head over to the RealWorld repo.

How it works

This application demonstrates an approach to using Eclipse Vert.x infrastructure to implement a web api.

Some modules used in this app:

Spring to perform dependency injection
Jackson to perform Serialization/Deserialization on the web layer
Flyway to perform database version control
H2 Database Engine to persist data
JBCrypt for hash passwords
Slugify to get title slugs
Vert.x JDBC Client to execute async queries
Vert.x Service Proxy to expose services on the event bus
Vert.x RxJava to perform async operations in business layer

Project Structure

main/generated   ->   VertxEBProxy, VertxProxyHandler and Request/Response converters
+--java
|  +--com
|     +--example
|        +--realworld
|           +-- application     ->     spec logic implementation
|           +-- domain          ->     domain model objects
|           +-- infrastructure  ->     technical details package

Getting started

Start local server

./mvnw spring-boot:run

The server should be running at http://localhost:8080

Running the application's integrated tests

./mvnw test

Running postman collection tests

./collections/run-api-tests.sh

Building jar file

./mvnw package

file location: target/vertx-springboot-realworld-example-app.jar

Database changes can be made to the application.yml file.

spring:
  datasource:
    url: jdbc:h2:mem:testdb;DB_CLOSE_ON_EXIT=FALSE;DB_CLOSE_DELAY=-1
    username: sa
    password:

Help

Improvements are welcome, feel free to contribute.

diegocamara / vertx-springboot-realworld-example-app