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    }