package io.vertx.servicediscovery.spi;

import io.vertx.codegen.annotations.VertxGen;
import io.vertx.core.Future;
import io.vertx.core.Handler;
import io.vertx.core.Promise;
import io.vertx.core.Vertx;
import io.vertx.core.json.JsonObject;
import io.vertx.servicediscovery.Record;

The service exporter allows integrate other discovery technologies with the Vert.x service discovery. It maps entries from another technology to a Record and maps Record to a publication in this other technology. The exporter is one side of a service discovery bridge. 
Author:
Julien Viet/**
 * The service exporter allows integrate other discovery technologies with the Vert.x service discovery. It maps
 * entries from another technology to a {@link Record} and maps {@link Record} to a publication in this other
 * technology. The exporter is one side of a service discovery bridge.
 *
 * @author <a href="mailto:julien@julienviet.com">Julien Viet</a>
 */
@VertxGen
public interface ServiceExporter {

  
Starts the exporter.
Params:
vertx –         the vertx instance
publisher –     the service discovery instance
configuration – the bridge configuration if any
future –        a future on which the bridge must report the completion of the starting/**
   * Starts the exporter.
   *
   * @param vertx         the vertx instance
   * @param publisher     the service discovery instance
   * @param configuration the bridge configuration if any
   * @param future        a future on which the bridge must report the completion of the starting
   */
  void init(Vertx vertx, ServicePublisher publisher, JsonObject configuration,
            Promise<Void> future);

  
Notify a new record has been published, the record's registration can be used to uniquely
identify the record
Params:
record – the record/**
   * Notify a new record has been published, the record's registration can be used to uniquely
   * identify the record
   *
   * @param record the record
   */
  void onPublish(Record record);

  
Notify an existing record has been updated, the record's registration can be used to uniquely
identify the record
Params:
record – the record/**
   * Notify an existing record has been updated, the record's registration can be used to uniquely
   * identify the record
   *
   * @param record the record
   */
  void onUpdate(Record record);

  
Notify an existing record has been removed
Params:
id – the record registration id/**
   * Notify an existing record has been removed
   *
   * @param id the record registration id
   */
  void onUnpublish(String id);

  
Close the exporter
Params:
closeHandler – the handle to be notified when exporter is closed, may be null/**
   * Close the exporter
   *
   * @param closeHandler the handle to be notified when exporter is closed, may be {@code null}
   */
  void close(Handler<Void> closeHandler);

}