ServiceInstance (micronaut 1.2.5 API)

All Known Subinterfaces:

EmbeddedServerInstance

All Known Implementing Classes:

ConsulServiceInstance, EC2ServiceInstance, EurekaServiceInstance
```
public interface ServiceInstance
```
Represents a remote service discovered by the underlying discovery implementation.

Since:

1.0

Author:

Graeme Rocher

Nested Class Summary

Nested Classes
Modifier and Type Interface and Description

static interface ServiceInstance.Builder
A builder for building ServiceInstance references.

Nested Classes
Modifier and Type	Interface and Description
`static interface`	`ServiceInstance.Builder` A builder for building `ServiceInstance` references.

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`GROUP` Constant to represent the group of the service contained with `getMetadata()`.
`static String`	`REGION` Constant to represent the region of the service contained with `getMetadata()`.
`static String`	`ZONE` Constant to represent the zone of the service contained with `getMetadata()`.

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`static ServiceInstance.Builder`	`builder(String id, URI uri)` A builder to builder a `ServiceInstance`.
`default Optional<String>`	`getGroup()` Returns the application group.
`default HealthStatus`	`getHealthStatus()`
`default String`	`getHost()`
`String`	`getId()`
`default Optional<String>`	`getInstanceId()`
`default ConvertibleValues<String>`	`getMetadata()`
`default int`	`getPort()`
`default Optional<String>`	`getRegion()` Returns the region to use.
`URI`	`getURI()`
`default Optional<String>`	`getZone()` Returns the availability zone to use.
`default boolean`	`isSecure()`
`static ServiceInstance`	`of(String id, String host, int port)` Construct a new `ServiceInstance` for the given ID, host and port using the HTTP scheme.
`static ServiceInstance`	`of(String id, URI uri)` Construct a new `ServiceInstance` for the given ID and URL.
`static ServiceInstance`	`of(String id, URL url)` Construct a new `ServiceInstance` for the given ID and URL.
`default URI`	`resolve(URI relativeURI)` Resolve a URI relative to this service instance.

- Field Detail
  - GROUP
```
static final String GROUP
```
    Constant to represent the group of the service contained with getMetadata().
    
    See Also:
    
    Constant Field Values
  - ZONE
```
static final String ZONE
```
    Constant to represent the zone of the service contained with getMetadata().
    
    See Also:
    
    Constant Field Values
  - REGION
```
static final String REGION
```
    Constant to represent the region of the service contained with getMetadata().
    
    See Also:
    
    Constant Field Values
- Method Detail
  - getId
```
String getId()
```
    Returns:
    
    The identifier of the service used for purposes of service discovery
  - getURI
```
URI getURI()
```
    Returns:
    
    The service URI
  - getHealthStatus
```
default HealthStatus getHealthStatus()
```
    Returns:
    
    The HealthStatus of the instance
  - getInstanceId
```
default Optional<String> getInstanceId()
```
    Returns:
    
    The ID of the instance
  - getZone
```
default Optional<String> getZone()
```
    Returns the availability zone to use. A zone is, for example, the AWS availability zone.
    
    Returns:
    
    The zone to use
  - getRegion
```
default Optional<String> getRegion()
```
    Returns the region to use. A region is, for example, the AWS region
    
    Returns:
    
    The region
  - getGroup
```
default Optional<String> getGroup()
```
    Returns the application group. For example, the AWS auto-scaling group.
    
    Returns:
    
    The group to use
  - getMetadata
```
default ConvertibleValues<String> getMetadata()
```
    Returns:
    
    The service metadata
  - getHost
```
default String getHost()
```
    Returns:
    
    The service host
  - isSecure
```
default boolean isSecure()
```
    Returns:
    
    Is the service instance available over a secure connection
  - getPort
```
default int getPort()
```
    Returns:
    
    The service port
  - resolve
```
default URI resolve(URI relativeURI)
```
    Resolve a URI relative to this service instance.
    
    Parameters:
    
    relativeURI - The relative URI
    
    Returns:
    
    The relative URI
  - of
```
static ServiceInstance of(String id,
                          URL url)
```
    Construct a new ServiceInstance for the given ID and URL.
    
    Parameters:
    
    id - The ID
    
    url - The URL
    
    Returns:
    
    The instance
  - of
```
static ServiceInstance of(String id,
                          URI uri)
```
    Construct a new ServiceInstance for the given ID and URL.
    
    Parameters:
    
    id - The ID
    
    uri - The URI
    
    Returns:
    
    The instance
  - of
```
static ServiceInstance of(String id,
                          String host,
                          int port)
```
    Construct a new ServiceInstance for the given ID, host and port using the HTTP scheme.
    
    Parameters:
    
    id - The ID
    
    host - The host
    
    port - The port
    
    Returns:
    
    The instance
  - builder
```
static ServiceInstance.Builder builder(String id,
                                       URI uri)
```
    A builder to builder a ServiceInstance.
    
    Parameters:
    
    id - The id
    
    uri - The URI
    
    Returns:
    
    The builder

Interface ServiceInstance

Nested Class Summary

Field Summary

Method Summary

Field Detail

GROUP

ZONE

REGION

Method Detail

getId

getURI

getHealthStatus

getInstanceId

getZone

getRegion

getGroup

getMetadata

getHost

isSecure

getPort

resolve

of

of

of

builder