org.apache.activemq.transport.discovery
Interface DiscoveryAgent

All Superinterfaces:

Service

All Known Implementing Classes:

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

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 -

details -

Throws:

javax.jms.JMSException

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