KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > objectweb > petals > component > common > basic > binding > ExternalListenerManager


1 /**
2  * PETALS - PETALS Services Platform.
3  * Copyright (c) 2006 EBM Websourcing, http://www.ebmwebsourcing.com/
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Lesser General Public
7  * License as published by the Free Software Foundation; either
8  * version 2.1 of the License, or (at your option) any later version.
9  * This library is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with this library; if not, write to the Free Software
16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17  *
18  * -------------------------------------------------------------------------
19  * $Id: ExternalListenerManager.java 154 27 sept. 06 ofabre $
20  * -------------------------------------------------------------------------
21  */

22 package org.objectweb.petals.component.common.basic.binding;
23
24 /**
25  * This manager is used to enable a binding component to handle external service
26  * call. It defines methods to register and unregister listeners for external
27  * services.
28  * <p>
29  * This interface have to be implemented if the related binding component is
30  * used to listen to incoming messages from external services, in order to
31  * forward these messages to internal JBI Components.
32  *
33  * @author ofabre - EBM Websourcing
34  *
35  */

36 public interface ExternalListenerManager {
37
38     /**
39      * Start a listener for the given address.
40      *
41      * @param address
42      * the external address to listen to.
43      * @throws Exception
44      * if an error occurs during listener starting
45      */

46     public void startListening(String JavaDoc address) throws Exception JavaDoc;
47
48     /**
49      * Stop a listener for the given address.
50      *
51      * @param address
52      * the external address to listen to.
53      */

54     public void stopListening(String JavaDoc address);
55
56 }
57
Popular Tags