package io.vertx.servicediscovery.spi;

import io.vertx.codegen.annotations.VertxGen;
import io.vertx.core.AsyncResult;
import io.vertx.core.Handler;
import io.vertx.servicediscovery.Record;

The publisher is used by the importer to publish or unpublish records.
Author:
Julien Viet/**
 * The publisher is used by the importer to publish or unpublish records.
 *
 * @author <a href="mailto:julien@julienviet.com">Julien Viet</a>
 */
@VertxGen
public interface ServicePublisher {

  
Publishes a record.
Params:
record –        the record
resultHandler – handler called when the operation has completed (successfully or not). In case of success,
                     the passed record has a registration id required to modify and un-register the service./**
   * Publishes a record.
   *
   * @param record        the record
   * @param resultHandler handler called when the operation has completed (successfully or not). In case of success,
   *                      the passed record has a registration id required to modify and un-register the service.
   */
  void publish(Record record, Handler<AsyncResult<Record>> resultHandler);

  
Un-publishes a record.
Params:
id –            the registration id
resultHandler – handler called when the operation has completed (successfully or not)./**
   * Un-publishes a record.
   *
   * @param id            the registration id
   * @param resultHandler handler called when the operation has completed (successfully or not).
   */
  void unpublish(String id, Handler<AsyncResult<Void>> resultHandler);


  
Updates an existing record.
Params:
record –        the record
resultHandler – handler called when the operation has completed (successfully or not). In case of success,
                     the passed record has a registration id required to modify and un-register the service./**
   * Updates an existing record.
   *
   * @param record        the record
   * @param resultHandler handler called when the operation has completed (successfully or not). In case of success,
   *                      the passed record has a registration id required to modify and un-register the service.
   */
  void update(Record record, Handler<AsyncResult<Record>> resultHandler);

}