Deployment API

[vietj]

Deployment API work-in-progress

Vertx has an API for deploying verticles designed when Vert.x was still prominently using callbacks. Unfortunately this API be changed much without breaking the API backward compatibility.

This is an attempt to provide a new API for Vert.x 5 that fits better with the Vert.x 4+ programming model (which is returning futures).

The new interface io.vertx.core.Deployment defines the lifecycle for deploying services in a vertx instance, it embraces Vert.x futures and Java functional interface style.

Future<String> fut = vertx.deploy(context -> vertx
  .createHttpServer()
  .requestHandler(req -> {
    req
      .response()
      .end("Hello World");
    }).listen(8080)
);

The deployment stop method provides a default implementation which can be overridden:

Future<String> fut = vertx.deploy(new Deployment() {
  HttpServer server;
  @Override
  public Future<?> start(Context context) {
    server = vertx.createHttpServer()
      .requestHandler(req -> {
        req.response().end("Hello World");
      });
    return server.listen(8080);
  }
  @Override
  public Future<?> stop(Context context) {
    return server.close();
  }
});