This document will show you how to bootstrap an Event Bus service using Vert.x Service Proxy module. As you will see, this approach is particularly useful when you want to design and consume a service on the event bus using plain Java interfaces.

You will build a Vert.x application that exposes and uses BarmanService, an Event Bus Service that generates beers and manages customer bills. We are going to deploy two verticles: the BarmanVerticle that exposes the service and the DrunkVerticle that consumes the service

• A text editor or IDE

• Java 8 higher

• Maven

Here is the content of the pom.xml file you should be using:

You must import both vertx-codegen with processor classifier and vertx-service-proxy. We are going to use vertx-web-client to load the beer names.

First, we must define our service interface. Under the hood, a code generator analyze it and generates the event bus message handler and the proxy class.

This is the BarmanService interface:

1. Add @VertxGen and @ProxyGen to trigger code generation

2. Define the method that generates a new beer and adds it to the bill of the customer specified. When the beer is ready, It calls the handler with the new beer

3. Define the method that retrieves the bill.

4. Define the method that settles the bill. This is a fire and forget method

5. Specify the method that creates a new proxy. BarmanServiceVertxEBProxy is the class name of the proxy that the code generator will create for us

There are a couple of rules you must follow while defining the service interface. Look at Restrictions for service interface for more info. In our interface we are using a couple of primitives and Beer, a POJO annotated as @DataObject. If you want to use @DataObject`s inside your interface, they must define both a constructor with only a `JsonObject parameter and a toJson() method that returns a JsonObject

To trigger the code generation, you must also add in the same package of the interface a package-info.java with @ModuleGen annotation:

Now you can implement the BarmanService.

For giveMeARandomBeer():

1. Send a request to the Craft Beer Name Generator Service

2. Fail the async method if the request to external service failed

3. Create a new Beer

4. Add the beer to the customer bill

5. Complete the async method with the generated beer

For getMyBill():

For settleMyBill():

Now we can expose the service inside the BarmanVerticle with the ServiceBinder class:

1. Instantiate the BarmanServiceImpl

2. Instantiate the ServiceBinder

3. Configure the service address

4. Register the service on the event bus

Now we can use the service with the generated proxy. For demo purposes I’m going to use it inside another verticle called DrunkVerticle:

1. Instantiate the proxy

2. Let’s try the first beer 🍺

3. Something went wrong during beer retrieval, fail the verticle start

4. Drinking the first one 🍻

5. Give me another one 🍺

6. Drinking the second one 🍻

7. Time to go home. Give me the bill

8. Pay the bill

To run the application deploy the BarmanVerticle and subsequently the DrunkVerticle

You can run the application from:

1. your IDE, by running the main method from the BeersApplication class, or

2. with Maven: mvn compile exec:java

You should see something like this:

This how-to explained to you:

1. How to design and implement an Event Bus Service using Vert.x Service Proxy, and

2. How to expose the service on the event bus, and

3. How to use the service

• Vert.x Service Proxy Documentation