quarkus

Example of a Servetless using the red hat framework

Is this repo useful? Please ⭑Star this repository and share the love.

Create project

In order to create your first project, it's easy enough to use mvn and use the Quarkus plugin.

mvn io.quarkus:quarkus-maven-plugin:0.13.1:create \
    -DprojectGroupId=your.group.id \
    -DprojectArtifactId=Your_artifact_id \
    -DclassName="package.and.class.name.of.your.first.Resource" \
    -Dpath="/your_endpoint"

Run

Once that you have your project created, you just need to run the compile and run command of mvn quarkus

./mvnw compile quarkus:dev`

Now you can reach the application container indext.html http://localhost:8080/

And if you want to reach your first endpoint created you can go to http://localhost:8080/your_endpoint

CDI(Context and Dependency Injection)

In Quarkus the Dependency injection happens when we compile our project, that's the reason why it's so fast. That brings some limitations, like the use of Reflection in your application it's limited.

You can read the way to inject dependencies in your project purely with annotations here

Program

Here I develop a simple Serverless where thanks to Quarkus and JAX-RS we make the transport(Request/Response) layer totally agnostic. You can see the API resource of the application as entry point here

Web socket

Here I develop a simple web socket chat, based on example that you can find in Quarkus documentation.

The code can be find here

Also the client code here

To run it, just run quarkus command

./mvnw quarkus:add-extension -Dextensions="smallrye-openapi"

And go into

http://localhost:8080/politrons/chat

Vertx

Integration with Vertx library, using some features as the extensions of RxJava2 you can see the examples of the resource here

To run it, just run quarkus command

./mvnw quarkus:add-extension -Dextensions="smallrye-openapi"

And go into:

• Streaming

  http://localhost:8080/streaming.html
  

• Http

  http://localhost:8080/vertx/delay/{delay}
  

Open API

Another cool feature of Quarkus, is that allow register your API and generate an OpenAPI file with all the API description.

You just need to run the Quarkus mvn command

./mvnw quarkus:add-extension -Dextensions="smallrye-openapi"

Health check

You can take a look how to implement health check in Quarkus here

http://localhost:8080/health

Response

{
    "outcome": "UP",
    "checks": [
        {
            "name": "Politrons health check",
            "state": "UP",
            "data": {
                "Oracle database": "running",
                "Cassandra database": "running"
            }
        }
    ]
}