Skip to content

Latest commit

 

History

History
191 lines (106 loc) · 7.97 KB

README.adoc

File metadata and controls

191 lines (106 loc) · 7.97 KB

Vert.x RxJava3 extension examples

IMPORTANT: These examples use the RX Java 3 API. If you are interested in RX Java 2, check the rxjava-2-examples module.

Here you will find examples demonstrating Vert.x RxJava3 extension in action.

Vert.x RxJava 3 extension provides Rxified version of the Vert.x APIs.Please consult the Vert.x RxJava manual for detailed documentation on Vert.x core.

RxJava Web client examples

These examples show the Rxified HTTP api.

Simple

A simple web client.

The client creates an Single<HttpRequest<String>> and then subscribe multiple times to the single to send the request.

Zip

A variation of the simple example with two client requests mapped to an Single<JsonObject> and then zipped in a single json object.

The main interest is to get the final result when the two responses are delivered.

Unmarshalling

The web client json response is unmarshalled to a Java object using the web client unmarshalling features.

RxJava Web examples

Real-time

This example demonstrates how an RxJava Flowable source can be sent real-time to the browser via a SockJSSocket.

SocksJS gives a WebSocket-like API in client side JavaScript even if the browser or network doesn’t support WebSockets.

This is ideal for so-called real-time web applications where you want quick, responsive communication between server and client, and you’re probably rendering the user interface on the client side.

Run the server in your IDE, then open your browser and hit link:http://localhost:8080

This serves the index page which contains some JavaScript which opens an event bus connection to the server.

When the connection is open, a SockJS connection is opened on the /news-feed uri. When data arrives in the handler the script just uses some simple JQuery to write the message to the page.

On the server side, in the server when a SockJS connection arrives, we subscribe to an Flowable<String> (that is created from the EventBus, but it would be another source of data) and send to the browser the observed items.

When you get the index page in your browser you should see it update every second as it receives a message.

RxJava 3 Http examples

These examples show the Rxified HTTP api.

Simple

A simple http server and client.

The server uses an Flowable<HttpServerRequest> to serve request:

The client uses an Flowable<HttpClientRequest and applies flatMap to get a Flowable<Buffer>

Reduce

Same as simple example however the client applies several operations on this flowable to end with the http client response:

  • flatMap transforms the Flowable<HttpClientResponse>Flowable<Buffer>

  • reduce merge all response buffers in a single buffer

  • map transform the buffer to a string

  • subscribe delivers the response content

Zip

A variation of the simple example with two client requests mapped to an Flowable<JsonObject> and then zipped in a single json object.

The main interest is to get the final result when the two responses are delivered.

Unmarshalling

The http client json response is unmarshalled to a Java object: the RxHelper.unmarshaller static method creates a Rx operator applied to the response via the lift.

RxJava event bus examples

The event bus provides a natural fit with the Rx api.

Publish / Subscribe

A reinterpretation of the core publish / subscribe example with the subscriber using the Rx api.

Ping / Pong

An example of sending, receiving and replying to messages using the Rx api.

Zip replies

The example Sender sends two messages over the event bus and wait for replies, the zip operation is applied to deliver a single reply when the two replies are received.

RxJava 3 Database examples

SQL client example

An example showing the SQL client Rxified api, after the client connected to the database, it chains operations via the flatMap operation and then subscribes to the result.

SQL client Transaction Handling

An example showing a Rxified SQL client api to handle simplified transaction that commits if all succeeded or rollback with exception propagation to the caller in case of anyone failed.

Mongo example

An example showing the Mongo Service Rxified api, after the client connected to Mongo, it chains createCollection and insert via flatMap and then subscribes to the result to do a query in the onComplete.

Scheduler examples

Vertx for RxJava provides schedulers for performing delayed, periodic actions.

Periodic events

RxJava timer can use Vertx scheduler for scheduling actions on the event loop, this example shows a 1-second periodic flowable scheduled on Vertx event loop.

Blocking action example

When a Flowable operation is blocking, a blocking Vertx scheduler can be used to perform the action, this examples shows how blocking operation can be scheduled on Vert.x

Scheduler examples

These examples demonstrate usage of Vert.x net servers and clients with RxJava 3

Greeter

This example combines RecordParser and RxJava 3 for a TCP client/server exchange. When the client sends a name to the server, it replies with a greeting. Names and greetings are line-separated.

Services examples

Rxified Vert.x Services examples

Service Proxy example

This example shows you how to make your service proxy Rxified with RxJava 3.