me.magnet.consultant

Class Consultant.Builder

java.lang.Object

me.magnet.consultant.Consultant.Builder

Enclosing class:

Consultant

public static class Consultant.Builder
extends Object

Allows you to build a custom Consultant object.

Method Summary

Modifier and Type	Method and Description
Consultant	build() Builds a new instance of the Consultant class using the specified arguments.
Consultant.Builder	identifyAs(String serviceName) States the identify of this application.
Consultant.Builder	identifyAs(String serviceName, String datacenter) States the identify of this application.
Consultant.Builder	identifyAs(String serviceName, String datacenter, String hostname) States the identify of this application.
Consultant.Builder	identifyAs(String serviceName, String datacenter, String hostname, String instanceName) States the identify of this application.
Consultant.Builder	onSettingUpdate(String key, SettingListener listener) Specifies a callback listener which is notified of whenever the specified setting is updated.
Consultant.Builder	onValidConfig(ConfigListener listener) Specifies a callback listener which is notified of whenever a new and valid configuration is detected in Consul.
Consultant.Builder	usingExecutor(ScheduledExecutorService executor) States that Consultant should use a specific executor service for listening to configuration updates.
Consultant.Builder	validateConfigWith(ConfigValidator validator) Specifies the validator which is used to determine if a new configuration detected in Consul is valid, and may be published through the ConfigListener callback.
Consultant.Builder	withConsulHost(String host) Specifies where the Consul REST API can be reached on.

Methods inherited from class java.lang.Object

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

Method Detail

usingExecutor

public Consultant.Builder usingExecutor(ScheduledExecutorService executor)

States that Consultant should use a specific executor service for listening to configuration updates. If no executor service is specified, Consultant will create a private executor service. This executor service will automatically be cleaned up when the JVM terminates, or when shutdown() is called on the Consultant object.

Parameters:

executor - The ScheduledExecutorService to use to schedule jobs on.

Returns:

The Builder instance.

withConsulHost

public Consultant.Builder withConsulHost(String host)

Specifies where the Consul REST API can be reached on. Alternatively you can specify this through the environment variable CONSUL_HOST=http://localhost.

Parameters:

host - The host where the Consul REST API can be found.

Returns:

The Builder instance.

identifyAs

public Consultant.Builder identifyAs(String serviceName)

States the identify of this application. This is used to figure out what configuration settings apply to this application. If you don't set the identity using this method, you must define it using environment variables such as SERVICE_NAME, and optionally SERVICE_DC and SERVICE_HOST.

Parameters:

serviceName - The name of this service.

Returns:

The Builder instance.

identifyAs

public Consultant.Builder identifyAs(String serviceName,
                                     String datacenter)

States the identify of this application. This is used to figure out what configuration settings apply to this application. If you don't set the identity using this method, you must define it using environment variables such as SERVICE_NAME, and optionally SERVICE_DC and SERVICE_HOST.

Parameters:

serviceName - The name of this service.

datacenter - The name of the datacenter where this service is running in.

Returns:

The Builder instance.

identifyAs

public Consultant.Builder identifyAs(String serviceName,
                                     String datacenter,
                                     String hostname)

States the identify of this application. This is used to figure out what configuration settings apply to this application. If you don't set the identity using this method, you must define it using environment variables such as SERVICE_NAME, and optionally SERVICE_DC and SERVICE_HOST.

Parameters:

serviceName - The name of this service.

datacenter - The name of the datacenter where this service is running in.

hostname - The name of the host where this service is running on.

Returns:

The Builder instance.

identifyAs

public Consultant.Builder identifyAs(String serviceName,
                                     String datacenter,
                                     String hostname,
                                     String instanceName)

States the identify of this application. This is used to figure out what configuration settings apply to this application. If you don't set the identity using this method, you must define it using environment variables such as SERVICE_NAME, and optionally SERVICE_DC, SERVICE_HOST, and SERVICE_INSTANCE.

Parameters:

serviceName - The name of this service.

datacenter - The name of the datacenter where this service is running in.

hostname - The name of the host where this service is running on.

instanceName - The name/role of this service instance.

Returns:

The Builder instance.

onValidConfig

public Consultant.Builder onValidConfig(ConfigListener listener)

Specifies a callback listener which is notified of whenever a new and valid configuration is detected in Consul.

Parameters:

listener - The listener to call when a new valid configuration is detected.

Returns:

The Builder instance.

onSettingUpdate

public Consultant.Builder onSettingUpdate(String key,
                                          SettingListener listener)

Specifies a callback listener which is notified of whenever the specified setting is updated.

Parameters:

listener - The listener to call when the specified setting is updated.

Returns:

The Builder instance.

validateConfigWith

public Consultant.Builder validateConfigWith(ConfigValidator validator)

Specifies the validator which is used to determine if a new configuration detected in Consul is valid, and may be published through the ConfigListener callback.

Parameters:

validator - The validator to call when a new configuration is detected.

Returns:

The Builder instance.

build

public Consultant build()

Builds a new instance of the Consultant class using the specified arguments.

Returns:

The constructed Consultant object.