[Quick Start] Building a TODO web microservice client with QBit

fadihub edited this page Jun 8, 2015 · 6 revisions




Getting Started




Callbacks and Reactor

Event Bus



QBit case studies

QBit 2 Roadmap

Related Projects

Clone this wiki locally

Building a TODO web microservice client with QBit

This wiki will walk you through the process for building a websocket client for the Todo web service we built in the first wiki.

What you will build

You will build a websocket client service that will POST/GET the following:

Greeting Hello World Sun Jan 25 13:10:47 PST 2015
Tutorial I hope you got this to work Sun Jan 25 13:10:47 PST 2015

to the the todo-service you have built in the first tutorial.

How to complete this guide

In order to complete this example successfully you will need the following installed on your machine:

Now that your machine is all ready let's get started:

-Download and unzip the source repository for this guide, or clone it using Git:

git clone https://github.com/fadihub/todo-service-websocket-client.git

Once this is done you can test the service, let's first explain the process:

This is the /TodoItem that the client is GETTING/POSTING, provides a plain old java object with fields, constructors, and accessors for the description, name, and date data:

TodoItem Listing


package io.advantageous.qbit.examples.client;

import java.util.Date;

public class TodoItem {

    private String description;
    private String name;
    private Date due;

    public TodoItem(final String description, final String name, final Date due) {
        this.description = description;
        this.name = name;
        this.due = due;

    public TodoItem(String description, String name) {

        this.description = description;
        this.name = name;
        due = new Date();

    public String getDescription() {
        return description;

    public String getName() {
        return name;

    public Date getDue() {
        return due;

    public void setDescription(String description) {
        this.description = description;

    public void setName(String name) {
        this.name = name;

    public void setDue(Date due) {
        this.due = due;

TodoServiceClientInterface Listing

This is the /TodoServiceClientInterface:


package io.advantageous.qbit.examples.client;

import io.advantageous.qbit.reactive.Callback;

import java.util.List;

public interface TodoServiceClientInterface {

    void list(Callback<List<TodoItem>> handler);

    void add(TodoItem todoItem);


TodoClientMain listing

To run the client and POST the items Greeting and Tutorial:


package io.advantageous.qbit.examples.client;

import io.advantageous.qbit.client.Client;
import io.advantageous.qbit.client.ClientBuilder;
import org.boon.core.Sys;

 * Created by fadi on 1/9/15.
public class TodoClientMain {

    public static void main(String... args) {

        String host = "localhost";

        int port = 8080;

        Client client = new ClientBuilder().setPort(port).setHost(host).setPollTime(10)

        TodoServiceClientInterface todoService =
                client.createProxy(TodoServiceClientInterface.class, "todoService");


        todoService.add(new TodoItem("Greeting", "Hello World"));
        todoService.add(new TodoItem("Tutorial","I hope you got this to work"));


        todoService.list(todoItems -> { //LAMBDA EXPRESSION Java 8

            for (TodoItem item : todoItems) {
                System.out.println("TODO ITEM " + item.getDescription() + " " + item.getName() + " " + item.getDue());




Now we are ready to test this client service.

Test the client

In order for this client to work you need to have todo-service running then cd into ~/todo-service-websocket-client and run gradle clean then gradle run you will get the following:

Greeting Hello World Sun Jan 25 13:10:47 PST 2015
Tutorial I hope you got this to work Sun Jan 25 13:10:47 PST 2015

Greeting and Tutorial represent the descriptions for the two TodoItems we are POSTING, Hello World and I hope you got this to work represent the name for the two TodoItems, also Sun Jan 25 13:10:47 PST 2015 will be different in your case, it will represent your current time on your machine.

If you:

curl http://localhost:8080/services/todo-service/todo/

you will get:

[{"description":"Greeting","name":"Hello World"},{"description":"Tutorial","name":"I hope you got this to work"}] 

which reflects what we mentioned before.


You have just built and tested a TODO web service client with QBit. See you in the next tutorial.