io.vertx.servicediscovery

## Class ServiceDiscoveryOptions

- java.lang.Object
- - io.vertx.servicediscovery.ServiceDiscoveryOptions

-     public class ServiceDiscoveryOptions
      extends Object

  Options to configure the service discovery.
  Author:
    Clement Escoffier

- - ### Field Summary

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `static String` | `DEFAULT_ANNOUNCE_ADDRESS`
    `static String` | `DEFAULT_USAGE_ADDRESS`

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `ServiceDiscoveryOptions()` Creates a new instance of `ServiceDiscoveryOptions` using the default values.
    `ServiceDiscoveryOptions(JsonObject json)` Creates a new instance of `ServiceDiscoveryOptions` from its JSON representation.
    `ServiceDiscoveryOptions(ServiceDiscoveryOptions other)` Creates a new instance of `ServiceDiscoveryOptions` by copying the values from another instance.

  - ### Method Summary

    All Methods Instance Methods Concrete Methods
    Modifier and Type | Method and Description
    --- | ---
    `String` | `getAnnounceAddress()`
    `JsonObject` | `getBackendConfiguration()`
    `String` | `getName()` Gets the service discovery name used in service usage events.
    `String` | `getUsageAddress()`
    `boolean` | `isAutoRegistrationOfImporters()`
    `ServiceDiscoveryOptions` | `setAnnounceAddress(String announceAddress)` Sets the event bus address on which the service arrivals, departures and modifications are announced.
    `ServiceDiscoveryOptions` | `setAutoRegistrationOfImporters(boolean autoRegistrationOfImporters)` Sets whether or not the registration of importers declared as SPI is enabled.
    `ServiceDiscoveryOptions` | `setBackendConfiguration(JsonObject backendConfiguration)` Sets the configuration passed to the `ServiceDiscoveryBackend`.
    `ServiceDiscoveryOptions` | `setName(String name)` Sets the service discovery name used in the service usage events.
    `ServiceDiscoveryOptions` | `setUsageAddress(String usageAddress)` Sets the usage address: the event bus address on which are sent the service usage events (bind / release).
    `JsonObject` | `toJson()` Builds the JSON representation for the current `ServiceDiscoveryOptions`.

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### Field Detail

    - #### DEFAULT_ANNOUNCE_ADDRESS

          public static final String DEFAULT_ANNOUNCE_ADDRESS

      See Also:
        Constant Field Values

    - #### DEFAULT_USAGE_ADDRESS

          public static final String DEFAULT_USAGE_ADDRESS

      See Also:
        Constant Field Values

  - ### Constructor Detail

    - #### ServiceDiscoveryOptions

          public ServiceDiscoveryOptions()

      Creates a new instance of `ServiceDiscoveryOptions` using the default values.

    - #### ServiceDiscoveryOptions

          public ServiceDiscoveryOptions(ServiceDiscoveryOptions other)

      Creates a new instance of `ServiceDiscoveryOptions` by copying the values from another instance.
      Parameters:
        `other` - the instance to copy

    - #### ServiceDiscoveryOptions

          public ServiceDiscoveryOptions(JsonObject json)

      Creates a new instance of `ServiceDiscoveryOptions` from its JSON representation.
      Parameters:
        `json` - the json object

  - ### Method Detail

    - #### toJson

          public JsonObject toJson()

      Builds the JSON representation for the current `ServiceDiscoveryOptions`.
      Returns:
        the json representation

    - #### getAnnounceAddress

          public String getAnnounceAddress()

      Returns:
        the event bus address on which the service arrivals, departures and modifications are announced. This address must be consistent in the whole application.

    - #### setAnnounceAddress

          public ServiceDiscoveryOptions setAnnounceAddress(String announceAddress)

      Sets the event bus address on which the service arrivals, departures and modifications are announced. This address must be consistent in the whole application.
      Parameters:
        `announceAddress` - the address, must not be `null`
      Returns:
        the current `ServiceDiscoveryOptions`

    - #### getBackendConfiguration

          public JsonObject getBackendConfiguration()

      Returns:
        the backend configuration. Cannot be `null`.

    - #### setBackendConfiguration

          public ServiceDiscoveryOptions setBackendConfiguration(JsonObject backendConfiguration)

      Sets the configuration passed to the `ServiceDiscoveryBackend`. Refer to the backend documentation to get more details on the requirements. The default backend does not need any configuration.
      Parameters:
        `backendConfiguration` - the backend configuration
      Returns:
        the current `ServiceDiscoveryOptions`

    - #### setName

          public ServiceDiscoveryOptions setName(String name)

      Sets the service discovery name used in the service usage events. If not set, the node id is used.
      Parameters:
        `name` - the name to use.
      Returns:
        the current `ServiceDiscoveryOptions`

    - #### getName

          public String getName()

      Gets the service discovery name used in service usage events. If not set the node id is used.
      Returns:
        the name

    - #### getUsageAddress

          public String getUsageAddress()

      Returns:
        the event bus address on which are sent the service usage events (bind / release).

    - #### setUsageAddress

          public ServiceDiscoveryOptions setUsageAddress(String usageAddress)

      Sets the usage address: the event bus address on which are sent the service usage events (bind / release).
      Parameters:
        `usageAddress` - the address, `null` to disable use service usage tracking
      Returns:
        the current `ServiceDiscoveryOptions`

    - #### isAutoRegistrationOfImporters

          public boolean isAutoRegistrationOfImporters()

      Returns:
        whether or not the registration of importers declared as SPI is enabled.

    - #### setAutoRegistrationOfImporters

          public ServiceDiscoveryOptions setAutoRegistrationOfImporters(boolean autoRegistrationOfImporters)

      Sets whether or not the registration of importers declared as SPI is enabled.
      Parameters:
        `autoRegistrationOfImporters` - `true` to enable the importation, `false` otherwise
      Returns:
        the current `ServiceDiscoveryOptions`

Copyright © 2019 Eclipse. All rights reserved.