cloud-robots / bridge

A cloud service to exchange data with Robots

ev3dev.bridge

A publish/subscribe service to exchange data with Robots

Modules

• Client : Client Java Library for use in any robot
• Server : Spring Boot Bridge Server to run on any host

Ref

• Publish–subscribe pattern (Wikipedia)

bridge's Issues

Define API

Define the API for the bridge service

• Add Swagger UI
• Create simple YAML
• Complete YAML

Create website for the Project.

Create a Microsite for the project.
Publish javadocs about client and link swagger.

Periodically delete old messages

Base on configuration delete subscribers and messages older than certain time

Define Client API

API Proposal:

class MyExample(){

  private Bridge bridge;

  private void newsTopic(final Message message){
    System.out.println(message.getSubscriber() + " has news: " + message.getText());
  }

  private void helloTopic(final Message message){
    bridge.publish("hello", "hello " + message.getSubscriber());
  }

  public void run(){
    bridge = BrigeBuilder.connect("http://localhost:8080")
       .subscribe("news", this::newsTopic)
       .subscribe("hello", this::helloTopic)
       .options(Options.discardOwnMessages, true)                   
       .options(Options.refresh, 1500)
       .options(Options.logMessages, true)
       .build();

    bridge.publish("hello", "hello world");
  }
}

Create Mock for Server

Create the mocks for the server

Create mock for client

Implement client

implement a client, including the builder for it

Implement Server

Create the server based on system test

• Implement PUT /subscribe/
• Implement GET /subscribe/{subscriber}/
• Implement DELETE /subscribe/{subscriber}/
• Implement PUT /publish/{topic}/
• Implement GET /messages/{subscriber}/