00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019
00020
00021
00022
00023
00024
00025
00026
00027
00028
00029
00030
00031
00032
00033
00034
00035
00036
00037
00038
00039
00040
00041
00042
00043
00044
00045
00046
00047
00048
00049
00050
00051
00052
00053
00054
00055
00056
00057
00058
00059
00060
00061
00062
00063
00064
00065
00066
00067
00068
00069
00070
00071
00072
00073
00074
00075
00076
00077
00078
00079 #ifndef _PLUGINMGR_H
00080 #define _PLUGINMGR_H
00081
00082 #define DEFAULT_PLUGINDIR "/usr/lib/pwlib"
00083
00084 #include <ptlib/plugin.h>
00085
00086 template <class C>
00087 void PLoadPluginDirectory(C & obj, const PDirectory & directory, const char * suffix = NULL)
00088 {
00089 PDirectory dir = directory;
00090 if (!dir.Open()) {
00091 PTRACE(4, "Cannot open plugin directory " << dir);
00092 return;
00093 }
00094 PTRACE(4, "Enumerating plugin directory " << dir);
00095 do {
00096 PString entry = dir + dir.GetEntryName();
00097 PDirectory subdir = entry;
00098 if (subdir.Open())
00099 PLoadPluginDirectory<C>(obj, entry, suffix);
00100 else {
00101 PFilePath fn(entry);
00102 if (
00103 (fn.GetType() *= PDynaLink::GetExtension()) &&
00104 (
00105 (suffix == NULL) || (fn.GetTitle().Right(strlen(suffix)) *= suffix)
00106 )
00107 )
00108 obj.LoadPlugin(entry);
00109 }
00110 } while (dir.Next());
00111 }
00112
00114
00115
00116
00117
00118 class PPluginManager : public PObject
00119 {
00120 PCLASSINFO(PPluginManager, PObject);
00121
00122 public:
00123
00124 BOOL LoadPlugin (const PString & fileName);
00125 void LoadPluginDirectory (const PDirectory & dir);
00126
00127
00128 PStringList GetPluginTypes() const;
00129 PStringList GetPluginsProviding(const PString & serviceType) const;
00130 PPluginServiceDescriptor * GetServiceDescriptor(const PString & serviceName, const PString & serviceType) const;
00131 PObject * CreatePluginsDevice(const PString & serviceName, const PString & serviceType, int userData = 0) const;
00132 PObject * CreatePluginsDeviceByName(const PString & deviceName, const PString & serviceType, int userData = 0) const;
00133 PStringList GetPluginsDeviceNames(const PString & serviceName, const PString & serviceType, int userData = 0) const;
00134
00135
00136 BOOL RegisterService (const PString & serviceName, const PString & serviceType, PPluginServiceDescriptor * descriptor);
00137
00138
00139 static PStringArray GetPluginDirs();
00140
00141
00142 static PPluginManager & GetPluginManager();
00143
00161 void AddNotifier(
00162 const PNotifier & filterFunction,
00163 BOOL existing = FALSE
00164 );
00165
00166 void RemoveNotifier(
00167 const PNotifier & filterFunction
00168 );
00169
00170 protected:
00171 void CallNotifier(PDynaLink & dll, INT code);
00172
00173 PMutex pluginListMutex;
00174 PList<PDynaLink> pluginList;
00175
00176 PMutex serviceListMutex;
00177 PList<PPluginService> serviceList;
00178
00179 PMutex notifierMutex;
00180 PList<PNotifier> notifierList;
00181 };
00182
00184
00185
00186
00187
00188 class PPluginModuleManager : public PObject
00189 {
00190 public:
00191 typedef PDictionary<PString, PDynaLink> PluginListType;
00192
00193 PPluginModuleManager(const char * _signatureFunctionName, PPluginManager * pluginMgr = NULL);
00194
00195 BOOL LoadPlugin(const PString & fileName)
00196 { if (pluginMgr == NULL) return FALSE; else return pluginMgr->LoadPlugin(fileName); }
00197
00198 void LoadPluginDirectory(const PDirectory &directory)
00199 { if (pluginMgr != NULL) pluginMgr->LoadPluginDirectory(directory); }
00200
00201 virtual void OnLoadPlugin(PDynaLink & , INT )
00202 { }
00203
00204 virtual PluginListType GetPluginList() const
00205 { return pluginList; }
00206
00207 virtual void OnShutdown()
00208 { }
00209
00210 protected:
00211 PluginListType pluginList;
00212 PDECLARE_NOTIFIER(PDynaLink, PPluginModuleManager, OnLoadModule);
00213
00214 protected:
00215 const char * signatureFunctionName;
00216 PPluginManager * pluginMgr;
00217 };
00218
00219 #endif // ifndef _PLUGINMGR_H