DiscoveryAgent (ActiveMQ 5.17.0 API)

All Superinterfaces:

Service

All Known Implementing Classes:

HTTPDiscoveryAgent, MasterSlaveDiscoveryAgent, MulticastDiscoveryAgent, SimpleDiscoveryAgent, ZeroconfDiscoveryAgent
```
public interface DiscoveryAgent
extends Service
```
An agent used to discover other instances of a service. We typically use a discovery agent to auto-discover JMS clients and JMS brokers on a network

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`void`	`registerService(String name)`	register a service
`void`	`serviceFailed(DiscoveryEvent event)`	A process actively using a service may see it go down before the DiscoveryAgent notices the service's failure.
`void`	`setDiscoveryListener(DiscoveryListener listener)`	Sets the discovery listener

Methods inherited from interface org.apache.activemq.Service
start, stop

- Method Detail
  - setDiscoveryListener
```
void setDiscoveryListener(DiscoveryListener listener)
```
    Sets the discovery listener
    
    Parameters:
    
    listener -
  - registerService
```
void registerService(String name)
              throws IOException
```
    register a service
    
    Parameters:
    
    name -
    
    Throws:
    
    IOException
  - serviceFailed
```
void serviceFailed(DiscoveryEvent event)
            throws IOException
```
    A process actively using a service may see it go down before the DiscoveryAgent notices the service's failure. That process can use this method to notify the DiscoveryAgent of the failure so that other listeners of this DiscoveryAgent can also be made aware of the failure.
    
    Throws:
    
    IOException