src/include/common/event/ManageListener.h

00001 /*
00002  * Funambol is a mobile platform developed by Funambol, Inc. 
00003  * Copyright (C) 2003 - 2007 Funambol, Inc.
00004  * 
00005  * This program is free software; you can redistribute it and/or modify it under
00006  * the terms of the GNU Affero General Public License version 3 as published by
00007  * the Free Software Foundation with the addition of the following permission 
00008  * added to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED
00009  * WORK IN WHICH THE COPYRIGHT IS OWNED BY FUNAMBOL, FUNAMBOL DISCLAIMS THE 
00010  * WARRANTY OF NON INFRINGEMENT  OF THIRD PARTY RIGHTS.
00011  * 
00012  * This program is distributed in the hope that it will be useful, but WITHOUT
00013  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
00014  * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
00015  * details.
00016  * 
00017  * You should have received a copy of the GNU Affero General Public License 
00018  * along with this program; if not, see http://www.gnu.org/licenses or write to
00019  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
00020  * MA 02110-1301 USA.
00021  * 
00022  * You can contact Funambol, Inc. headquarters at 643 Bair Island Road, Suite 
00023  * 305, Redwood City, CA 94063, USA, or at email address info@funambol.com.
00024  * 
00025  * The interactive user interfaces in modified source and object code versions
00026  * of this program must display Appropriate Legal Notices, as required under
00027  * Section 5 of the GNU Affero General Public License version 3.
00028  * 
00029  * In accordance with Section 7(b) of the GNU Affero General Public License
00030  * version 3, these Appropriate Legal Notices must retain the display of the
00031  * "Powered by Funambol" logo. If the display of the logo is not reasonably 
00032  * feasible for technical reasons, the Appropriate Legal Notices must display
00033  * the words "Powered by Funambol".
00034  */
00035 
00036 
00037 #ifndef INCL_MANAGE_LISTENER
00038 #define INCL_MANAGE_LISTENER
00039 
00041 #include "event/SyncListener.h"
00042 #include "event/SyncItemListener.h"
00043 #include "event/SyncStatusListener.h"
00044 #include "event/SyncSourceListener.h"
00045 #include "event/TransportListener.h"
00046 #include "base/globalsdef.h"
00047 
00048 BEGIN_NAMESPACE
00049 
00050 /* This is the ManageListener class - which keeps track of the various registered
00051  * listeners. This is implemented as an singleton pattern to make sure only instance
00052  * is active at any point of time.
00053  * The implementation does not provide a dispose() method, because releasing the
00054  * instance means to unset all the listeners previously set. A method with the
00055  * same behavior is available, but with a more meaningful name (releaseAllListeners).
00056  */
00057 class ManageListener {
00058 
00059 public:
00060 
00062     static ManageListener & getInstance();
00064     static void releaseAllListeners();
00065 
00072     SyncListener* getSyncListener(const char *name = "");
00074     SyncListener* getSyncListener(int pos);
00075 
00082     TransportListener* getTransportListener(const char *name = "");
00084     TransportListener* getTransportListener(int pos);
00085 
00092     SyncSourceListener* getSyncSourceListener(const char *name = "");
00094     SyncSourceListener* getSyncSourceListener(int pos);
00095 
00102     SyncItemListener* getSyncItemListener(const char *name = "");
00104     SyncItemListener* getSyncItemListener(int pos);
00105 
00112     SyncStatusListener* getSyncStatusListener(const char *name = "");
00114     SyncStatusListener* getSyncStatusListener(int pos);
00115 
00116     void setSyncListener      (SyncListener* listener);
00117     void setTransportListener (TransportListener* listener);
00118     void setSyncSourceListener(SyncSourceListener* listener);
00119     void setSyncItemListener  (SyncItemListener* listener);
00120     void setSyncStatusListener(SyncStatusListener* listener);
00121 
00122     void unsetSyncListener(const char *name = "");
00123     void unsetTransportListener(const char *name = "");
00124     void unsetSyncSourceListener(const char *name = "");
00125     void unsetSyncItemListener(const char *name = "");
00126     void unsetSyncStatusListener(const char *name = "");
00127 
00128     int countSyncListeners() const { return synclisteners.size(); };
00129     int countTransportListeners() const { return transportlisteners.size(); };
00130     int countSyncStatusListeners() const { return syncstatuslisteners.size(); };
00131     int countSyncItemListeners() const { return syncitemlisteners.size(); };
00132     int countSyncSourceListeners() const { return syncsourcelisteners.size(); };
00133 
00134 private:
00135     static ManageListener *instance;
00136 
00137     //Registered Listeners : At present only one Listener per event family
00138     ArrayList synclisteners;
00139     ArrayList transportlisteners;
00140     ArrayList syncstatuslisteners;
00141     ArrayList syncitemlisteners;
00142     ArrayList syncsourcelisteners;
00143 
00144     //private constructor & destructor
00145     ManageListener() {}
00146     ~ManageListener();
00147 
00148     /* Search for the given listener in list. */
00149     Listener *lookupListener(const char* name, ArrayList &list);
00150 
00151     /* Set a new listener, replacing an existen one or adding it to the list. */
00152     bool setListener(Listener* listener, ArrayList &list);
00153 
00154     /* Unset a listener, referenced by name. If the listener with that name is
00155      * not found, it does nothing. */
00156     void unsetListener(const char* name, ArrayList &list);
00157     
00158 };
00159 
00160 END_NAMESPACE
00161 
00163 #endif
00164 

Generated on Wed Jan 14 17:15:36 2009 for Funambol C++ Client Library by  doxygen 1.5.2