]>
Commit | Line | Data |
---|---|---|
0b9ab0bd | 1 | ///////////////////////////////////////////////////////////////////////////// |
02761f6c | 2 | // Name: src/common/dynload.cpp |
0b9ab0bd RL |
3 | // Purpose: Dynamic loading framework |
4 | // Author: Ron Lee, David Falkinder, Vadim Zeitlin and a cast of 1000's | |
5 | // (derived in part from dynlib.cpp (c) 1998 Guilhem Lavaux) | |
6 | // Modified by: | |
7 | // Created: 03/12/01 | |
8 | // RCS-ID: $Id$ | |
9 | // Copyright: (c) 2001 Ron Lee <ron@debian.org> | |
65571936 | 10 | // Licence: wxWindows licence |
0b9ab0bd RL |
11 | ///////////////////////////////////////////////////////////////////////////// |
12 | ||
0b9ab0bd RL |
13 | // ---------------------------------------------------------------------------- |
14 | // headers | |
15 | // ---------------------------------------------------------------------------- | |
16 | ||
17 | #include "wx/wxprec.h" | |
18 | ||
19 | #ifdef __BORLANDC__ | |
409bd320 | 20 | #pragma hdrstop |
0b9ab0bd RL |
21 | #endif |
22 | ||
23 | #if wxUSE_DYNAMIC_LOADER | |
24 | ||
25 | #ifdef __WINDOWS__ | |
409bd320 | 26 | #include "wx/msw/private.h" |
0b9ab0bd RL |
27 | #endif |
28 | ||
29 | #ifndef WX_PRECOMP | |
409bd320 VZ |
30 | #include "wx/log.h" |
31 | #include "wx/intl.h" | |
2b5f62a0 | 32 | #include "wx/hash.h" |
076fdb21 | 33 | #include "wx/utils.h" |
02761f6c | 34 | #include "wx/module.h" |
0b9ab0bd RL |
35 | #endif |
36 | ||
401eb3de | 37 | #include "wx/strconv.h" |
0b9ab0bd | 38 | |
409bd320 | 39 | #include "wx/dynload.h" |
0b9ab0bd | 40 | |
0b9ab0bd RL |
41 | |
42 | // --------------------------------------------------------------------------- | |
4f89dbc4 | 43 | // wxPluginLibrary |
0b9ab0bd RL |
44 | // --------------------------------------------------------------------------- |
45 | ||
46 | ||
dabd1377 JS |
47 | wxDLImports* wxPluginLibrary::ms_classes = NULL; |
48 | ||
49 | class wxPluginLibraryModule : public wxModule | |
50 | { | |
51 | public: | |
d0fcccc4 VZ |
52 | wxPluginLibraryModule() { } |
53 | ||
54 | // TODO: create ms_classes on demand, why always preallocate it? | |
55 | virtual bool OnInit() | |
56 | { | |
b2bb920f | 57 | wxPluginLibrary::ms_classes = new wxDLImports; |
d0fcccc4 | 58 | wxPluginManager::CreateManifest(); |
68379eaf | 59 | return true; |
d0fcccc4 VZ |
60 | } |
61 | ||
62 | virtual void OnExit() | |
63 | { | |
5276b0a5 | 64 | wxDELETE(wxPluginLibrary::ms_classes); |
d0fcccc4 VZ |
65 | wxPluginManager::ClearManifest(); |
66 | } | |
dabd1377 JS |
67 | |
68 | private: | |
69 | DECLARE_DYNAMIC_CLASS(wxPluginLibraryModule ) | |
70 | }; | |
71 | ||
72 | IMPLEMENT_DYNAMIC_CLASS(wxPluginLibraryModule, wxModule) | |
73 | ||
0b9ab0bd | 74 | |
23213f18 | 75 | wxPluginLibrary::wxPluginLibrary(const wxString &libname, int flags) |
4f89dbc4 | 76 | : m_linkcount(1) |
7c1e2b44 | 77 | , m_objcount(0) |
0b9ab0bd | 78 | { |
7ed9cd28 | 79 | const wxClassInfo* const oldFirst = wxClassInfo::GetFirst(); |
4f89dbc4 | 80 | Load( libname, flags ); |
7ed9cd28 | 81 | |
7cc3d0e0 VZ |
82 | // It is simple to know what is the first object in the linked list of |
83 | // wxClassInfo that we registered (it's also the last one chronologically), | |
84 | // it's just the new head of the wxClassInfo list: | |
85 | m_ourFirst = wxClassInfo::GetFirst(); | |
7ed9cd28 VZ |
86 | |
87 | // But to find the first wxClassInfo created by this library we need to | |
88 | // iterate until we get to the previous head as we don't have the links in | |
89 | // the backwards direction: | |
7cc3d0e0 | 90 | if ( m_ourFirst != oldFirst ) |
7ed9cd28 | 91 | { |
7cc3d0e0 | 92 | for ( const wxClassInfo* info = m_ourFirst; ; info = info->GetNext() ) |
7ed9cd28 VZ |
93 | { |
94 | if ( info->GetNext() == oldFirst ) | |
95 | { | |
7cc3d0e0 | 96 | m_ourLast = info; |
7ed9cd28 VZ |
97 | break; |
98 | } | |
99 | } | |
100 | } | |
101 | else // We didn't register any classes at all. | |
102 | { | |
103 | m_ourFirst = | |
104 | m_ourLast = NULL; | |
105 | } | |
4f89dbc4 | 106 | |
0b9ab0bd RL |
107 | if( m_handle != 0 ) |
108 | { | |
2d4957f2 | 109 | UpdateClasses(); |
0b9ab0bd RL |
110 | RegisterModules(); |
111 | } | |
112 | else | |
d0fcccc4 VZ |
113 | { |
114 | // Flag us for deletion | |
115 | --m_linkcount; | |
116 | } | |
0b9ab0bd RL |
117 | } |
118 | ||
4f89dbc4 | 119 | wxPluginLibrary::~wxPluginLibrary() |
0b9ab0bd | 120 | { |
01610529 RL |
121 | if( m_handle != 0 ) |
122 | { | |
123 | UnregisterModules(); | |
2d4957f2 | 124 | RestoreClasses(); |
01610529 | 125 | } |
0b9ab0bd RL |
126 | } |
127 | ||
d0fcccc4 VZ |
128 | wxPluginLibrary *wxPluginLibrary::RefLib() |
129 | { | |
130 | wxCHECK_MSG( m_linkcount > 0, NULL, | |
9a83f860 | 131 | wxT("Library had been already deleted!") ); |
d0fcccc4 VZ |
132 | |
133 | ++m_linkcount; | |
134 | return this; | |
135 | } | |
136 | ||
4f89dbc4 | 137 | bool wxPluginLibrary::UnrefLib() |
7c1e2b44 | 138 | { |
d0fcccc4 | 139 | wxASSERT_MSG( m_objcount == 0, |
9a83f860 | 140 | wxT("Library unloaded before all objects were destroyed") ); |
d0fcccc4 | 141 | |
ebf0caa1 | 142 | if ( m_linkcount == 0 || --m_linkcount == 0 ) |
7c1e2b44 RL |
143 | { |
144 | delete this; | |
68379eaf | 145 | return true; |
7c1e2b44 | 146 | } |
d0fcccc4 | 147 | |
68379eaf | 148 | return false; |
7c1e2b44 | 149 | } |
0b9ab0bd RL |
150 | |
151 | // ------------------------ | |
152 | // Private methods | |
153 | // ------------------------ | |
154 | ||
2d4957f2 VS |
155 | void wxPluginLibrary::UpdateClasses() |
156 | { | |
7ed9cd28 VZ |
157 | if ( !m_ourFirst ) |
158 | return; | |
159 | ||
160 | for ( const wxClassInfo *info = m_ourFirst; ; info = info->GetNext() ) | |
2d4957f2 | 161 | { |
b77a9389 | 162 | if( info->GetClassName() ) |
2d4957f2 VS |
163 | { |
164 | // Hash all the class names into a local table too so | |
165 | // we can quickly find the entry they correspond to. | |
b77a9389 | 166 | (*ms_classes)[info->GetClassName()] = this; |
2d4957f2 | 167 | } |
7ed9cd28 VZ |
168 | |
169 | if ( info == m_ourLast ) | |
170 | break; | |
2d4957f2 VS |
171 | } |
172 | } | |
173 | ||
174 | void wxPluginLibrary::RestoreClasses() | |
175 | { | |
ebf0caa1 VS |
176 | // Check if there is a need to restore classes. |
177 | if (!ms_classes) | |
178 | return; | |
179 | ||
7ed9cd28 VZ |
180 | if ( !m_ourFirst ) |
181 | return; | |
182 | ||
183 | for ( const wxClassInfo *info = m_ourFirst; ; info = info->GetNext() ) | |
2d4957f2 | 184 | { |
b77a9389 | 185 | ms_classes->erase(ms_classes->find(info->GetClassName())); |
7ed9cd28 VZ |
186 | |
187 | if ( info == m_ourLast ) | |
188 | break; | |
2d4957f2 VS |
189 | } |
190 | } | |
191 | ||
4f89dbc4 | 192 | void wxPluginLibrary::RegisterModules() |
0b9ab0bd RL |
193 | { |
194 | // Plugin libraries might have wxModules, Register and initialise them if | |
195 | // they do. | |
196 | // | |
197 | // Note that these classes are NOT included in the reference counting since | |
198 | // it's implicit that they will be unloaded if and when the last handle to | |
199 | // the library is. We do have to keep a copy of the module's pointer | |
200 | // though, as there is currently no way to Unregister it without it. | |
201 | ||
7c1e2b44 | 202 | wxASSERT_MSG( m_linkcount == 1, |
9a83f860 | 203 | wxT("RegisterModules should only be called for the first load") ); |
0b9ab0bd | 204 | |
7ed9cd28 | 205 | if ( m_ourFirst ) |
0b9ab0bd | 206 | { |
7ed9cd28 | 207 | for ( const wxClassInfo *info = m_ourFirst; ; info = info->GetNext() ) |
0b9ab0bd | 208 | { |
80a46597 | 209 | if( info->IsKindOf(wxCLASSINFO(wxModule)) ) |
7ed9cd28 VZ |
210 | { |
211 | wxModule *m = wxDynamicCast(info->CreateObject(), wxModule); | |
212 | ||
213 | wxASSERT_MSG( m, wxT("wxDynamicCast of wxModule failed") ); | |
0b9ab0bd | 214 | |
7ed9cd28 VZ |
215 | m_wxmodules.push_back(m); |
216 | wxModule::RegisterModule(m); | |
217 | } | |
0b9ab0bd | 218 | |
7ed9cd28 VZ |
219 | if ( info == m_ourLast ) |
220 | break; | |
0b9ab0bd RL |
221 | } |
222 | } | |
223 | ||
224 | // FIXME: Likewise this is (well was) very similar to InitializeModules() | |
225 | ||
df5168c4 MB |
226 | for ( wxModuleList::iterator it = m_wxmodules.begin(); |
227 | it != m_wxmodules.end(); | |
228 | ++it) | |
0b9ab0bd | 229 | { |
df5168c4 | 230 | if( !(*it)->Init() ) |
0b9ab0bd | 231 | { |
9a83f860 | 232 | wxLogDebug(wxT("wxModule::Init() failed for wxPluginLibrary")); |
0b9ab0bd RL |
233 | |
234 | // XXX: Watch this, a different hash implementation might break it, | |
235 | // a good hash implementation would let us fix it though. | |
236 | ||
237 | // The name of the game is to remove any uninitialised modules and | |
238 | // let the dtor Exit the rest on shutdown, (which we'll initiate | |
239 | // shortly). | |
240 | ||
df5168c4 | 241 | wxModuleList::iterator oldNode = m_wxmodules.end(); |
0b9ab0bd | 242 | do { |
df5168c4 MB |
243 | ++it; |
244 | if( oldNode != m_wxmodules.end() ) | |
245 | m_wxmodules.erase(oldNode); | |
246 | wxModule::UnregisterModule( *it ); | |
247 | oldNode = it; | |
248 | } while( it != m_wxmodules.end() ); | |
0b9ab0bd | 249 | |
7c1e2b44 | 250 | --m_linkcount; // Flag us for deletion |
0b9ab0bd RL |
251 | break; |
252 | } | |
253 | } | |
254 | } | |
255 | ||
4f89dbc4 | 256 | void wxPluginLibrary::UnregisterModules() |
0b9ab0bd | 257 | { |
df5168c4 | 258 | wxModuleList::iterator it; |
0b9ab0bd | 259 | |
df5168c4 MB |
260 | for ( it = m_wxmodules.begin(); it != m_wxmodules.end(); ++it ) |
261 | (*it)->Exit(); | |
0b9ab0bd | 262 | |
df5168c4 MB |
263 | for ( it = m_wxmodules.begin(); it != m_wxmodules.end(); ++it ) |
264 | wxModule::UnregisterModule( *it ); | |
0b9ab0bd | 265 | |
5385fa5b VS |
266 | // NB: content of the list was deleted by UnregisterModule calls above: |
267 | m_wxmodules.clear(); | |
0b9ab0bd RL |
268 | } |
269 | ||
270 | ||
271 | // --------------------------------------------------------------------------- | |
d0fcccc4 | 272 | // wxPluginManager |
0b9ab0bd RL |
273 | // --------------------------------------------------------------------------- |
274 | ||
dabd1377 | 275 | wxDLManifest* wxPluginManager::ms_manifest = NULL; |
0b9ab0bd RL |
276 | |
277 | // ------------------------ | |
278 | // Static accessors | |
279 | // ------------------------ | |
280 | ||
d0fcccc4 VZ |
281 | wxPluginLibrary * |
282 | wxPluginManager::LoadLibrary(const wxString &libname, int flags) | |
0b9ab0bd | 283 | { |
4f89dbc4 | 284 | wxString realname(libname); |
0b9ab0bd | 285 | |
4f89dbc4 RL |
286 | if( !(flags & wxDL_VERBATIM) ) |
287 | realname += wxDynamicLibrary::GetDllExt(); | |
288 | ||
d0fcccc4 VZ |
289 | wxPluginLibrary *entry; |
290 | ||
291 | if ( flags & wxDL_NOSHARE ) | |
292 | { | |
293 | entry = NULL; | |
294 | } | |
295 | else | |
296 | { | |
2b5f62a0 | 297 | entry = FindByName(realname); |
d0fcccc4 | 298 | } |
4f89dbc4 | 299 | |
d0fcccc4 | 300 | if ( entry ) |
0b9ab0bd | 301 | { |
9a83f860 VZ |
302 | wxLogTrace(wxT("dll"), |
303 | wxT("LoadLibrary(%s): already loaded."), realname.c_str()); | |
d0fcccc4 | 304 | |
7c1e2b44 | 305 | entry->RefLib(); |
0b9ab0bd RL |
306 | } |
307 | else | |
308 | { | |
4f89dbc4 | 309 | entry = new wxPluginLibrary( libname, flags ); |
0b9ab0bd | 310 | |
d0fcccc4 | 311 | if ( entry->IsLoaded() ) |
0b9ab0bd | 312 | { |
2b5f62a0 | 313 | (*ms_manifest)[realname] = entry; |
d0fcccc4 | 314 | |
9a83f860 VZ |
315 | wxLogTrace(wxT("dll"), |
316 | wxT("LoadLibrary(%s): loaded ok."), realname.c_str()); | |
d0fcccc4 | 317 | |
0b9ab0bd RL |
318 | } |
319 | else | |
320 | { | |
9a83f860 VZ |
321 | wxLogTrace(wxT("dll"), |
322 | wxT("LoadLibrary(%s): failed to load."), realname.c_str()); | |
d0fcccc4 VZ |
323 | |
324 | // we have created entry just above | |
325 | if ( !entry->UnrefLib() ) | |
326 | { | |
327 | // ... so UnrefLib() is supposed to delete it | |
9a83f860 | 328 | wxFAIL_MSG( wxT("Currently linked library is not loaded?") ); |
d0fcccc4 VZ |
329 | } |
330 | ||
331 | entry = NULL; | |
0b9ab0bd RL |
332 | } |
333 | } | |
d0fcccc4 | 334 | |
0b9ab0bd RL |
335 | return entry; |
336 | } | |
337 | ||
d0fcccc4 | 338 | bool wxPluginManager::UnloadLibrary(const wxString& libname) |
0b9ab0bd | 339 | { |
d0fcccc4 | 340 | wxString realname = libname; |
4f89dbc4 | 341 | |
2b5f62a0 | 342 | wxPluginLibrary *entry = FindByName(realname); |
0b9ab0bd | 343 | |
d0fcccc4 VZ |
344 | if ( !entry ) |
345 | { | |
346 | realname += wxDynamicLibrary::GetDllExt(); | |
0b9ab0bd | 347 | |
2b5f62a0 | 348 | entry = FindByName(realname); |
d0fcccc4 VZ |
349 | } |
350 | ||
351 | if ( !entry ) | |
352 | { | |
9a83f860 | 353 | wxLogDebug(wxT("Attempt to unload library '%s' which is not loaded."), |
d0fcccc4 VZ |
354 | libname.c_str()); |
355 | ||
68379eaf | 356 | return false; |
d0fcccc4 VZ |
357 | } |
358 | ||
9a83f860 | 359 | wxLogTrace(wxT("dll"), wxT("UnloadLibrary(%s)"), realname.c_str()); |
d0fcccc4 VZ |
360 | |
361 | if ( !entry->UnrefLib() ) | |
362 | { | |
363 | // not really unloaded yet | |
68379eaf | 364 | return false; |
d0fcccc4 VZ |
365 | } |
366 | ||
2b5f62a0 | 367 | ms_manifest->erase(ms_manifest->find(realname)); |
d0fcccc4 | 368 | |
68379eaf | 369 | return true; |
4f89dbc4 RL |
370 | } |
371 | ||
0b9ab0bd RL |
372 | // ------------------------ |
373 | // Class implementation | |
374 | // ------------------------ | |
375 | ||
23213f18 | 376 | bool wxPluginManager::Load(const wxString &libname, int flags) |
0b9ab0bd | 377 | { |
4f89dbc4 | 378 | m_entry = wxPluginManager::LoadLibrary(libname, flags); |
2b5f62a0 | 379 | |
4f89dbc4 | 380 | return IsLoaded(); |
0b9ab0bd RL |
381 | } |
382 | ||
4f89dbc4 | 383 | void wxPluginManager::Unload() |
0b9ab0bd | 384 | { |
9a83f860 | 385 | wxCHECK_RET( m_entry, wxT("unloading an invalid wxPluginManager?") ); |
0b9ab0bd | 386 | |
2b5f62a0 VZ |
387 | for ( wxDLManifest::iterator i = ms_manifest->begin(); |
388 | i != ms_manifest->end(); | |
389 | ++i ) | |
4f89dbc4 | 390 | { |
2b5f62a0 VZ |
391 | if ( i->second == m_entry ) |
392 | { | |
393 | ms_manifest->erase(i); | |
46113053 | 394 | break; |
2b5f62a0 | 395 | } |
4f89dbc4 | 396 | } |
2b5f62a0 VZ |
397 | |
398 | m_entry->UnrefLib(); | |
399 | ||
400 | m_entry = NULL; | |
0b9ab0bd RL |
401 | } |
402 | ||
0b9ab0bd | 403 | #endif // wxUSE_DYNAMIC_LOADER |