org.apache.activemq.transport.discovery
Interface DiscoveryAgent

All Superinterfaces:

Service

All Known Implementing Classes:

MulticastDiscoveryAgent, RendezvousDiscoveryAgent, SimpleDiscoveryAgent

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

Version:

$Revision$

Method Summary

java.lang.String	getGroup()
void	registerService(java.lang.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	setBrokerName(java.lang.String brokerName)
void	setDiscoveryListener(DiscoveryListener listener) Sets the discovery listener
void	setGroup(java.lang.String group)

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(java.lang.String name)
                     throws java.io.IOException

register a service

Parameters:

name -

details -

Throws:

javax.jms.JMSException

java.io.IOException

serviceFailed

void serviceFailed(DiscoveryEvent event)
                   throws java.io.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:

java.io.IOException

getGroup

java.lang.String getGroup()

setGroup

void setGroup(java.lang.String group)

setBrokerName

void setBrokerName(java.lang.String brokerName)