001 /** 002 * 003 * Copyright 2004 Protique Ltd 004 * 005 * Licensed under the Apache License, Version 2.0 (the "License"); 006 * you may not use this file except in compliance with the License. 007 * You may obtain a copy of the License at 008 * 009 * http://www.apache.org/licenses/LICENSE-2.0 010 * 011 * Unless required by applicable law or agreed to in writing, software 012 * distributed under the License is distributed on an "AS IS" BASIS, 013 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 014 * See the License for the specific language governing permissions and 015 * limitations under the License. 016 * 017 **/ 018 package org.activemq.transport; 019 020 import org.activemq.service.Service; 021 022 import javax.jms.JMSException; 023 import java.util.Map; 024 025 /** 026 * An agent used to discover other instances of a service. 027 * 028 * We typically use a discovery agent to auto-discover JMS clients and JMS brokers on a network 029 * 030 * @version $Revision: 1.1.1.1 $ 031 */ 032 public interface DiscoveryAgent extends Service { 033 034 /** 035 * Add a discovery listener 036 * @param listener 037 */ 038 public void addDiscoveryListener(DiscoveryListener listener); 039 040 /** 041 * remove a discovery listener 042 * @param listener 043 */ 044 public void removeDiscoveryListener(DiscoveryListener listener); 045 046 /** 047 * register a service 048 * @param name 049 * @param details 050 * @throws JMSException 051 */ 052 void registerService(String name, Map details) throws JMSException; 053 }