author | zecke <zecke> | 2002-09-10 12:09:49 (UTC) |
---|---|---|
committer | zecke <zecke> | 2002-09-10 12:09:49 (UTC) |
commit | 6b77a1cdb9536b1c135eb86d53a6b2c22c19b0a4 (patch) (unidiff) | |
tree | 6ebc93c6432f4ed9d00ef1448b6a047ef522a79a /library/qlibrary.cpp | |
parent | d10cddb3c9ce75bc90b14add14bc133737fe35aa (diff) | |
download | opie-6b77a1cdb9536b1c135eb86d53a6b2c22c19b0a4.zip opie-6b77a1cdb9536b1c135eb86d53a6b2c22c19b0a4.tar.gz opie-6b77a1cdb9536b1c135eb86d53a6b2c22c19b0a4.tar.bz2 |
Qtopia1-6 merge
still to test
bic changes to be resolved
more changes to be made?
-rw-r--r-- | library/qlibrary.cpp | 4 |
1 files changed, 2 insertions, 2 deletions
diff --git a/library/qlibrary.cpp b/library/qlibrary.cpp index 4aabbc5..cbf49a3 100644 --- a/library/qlibrary.cpp +++ b/library/qlibrary.cpp | |||
@@ -1,260 +1,260 @@ | |||
1 | /********************************************************************** | 1 | /********************************************************************** |
2 | ** Copyright (C) 2000 Trolltech AS. All rights reserved. | 2 | ** Copyright (C) 2000-2002 Trolltech AS. All rights reserved. |
3 | ** | 3 | ** |
4 | ** This file is part of Qtopia Environment. | 4 | ** This file is part of the Qtopia Environment. |
5 | ** | 5 | ** |
6 | ** This file may be distributed and/or modified under the terms of the | 6 | ** This file may be distributed and/or modified under the terms of the |
7 | ** GNU General Public License version 2 as published by the Free Software | 7 | ** GNU General Public License version 2 as published by the Free Software |
8 | ** Foundation and appearing in the file LICENSE.GPL included in the | 8 | ** Foundation and appearing in the file LICENSE.GPL included in the |
9 | ** packaging of this file. | 9 | ** packaging of this file. |
10 | ** | 10 | ** |
11 | ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE | 11 | ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE |
12 | ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. | 12 | ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. |
13 | ** | 13 | ** |
14 | ** See http://www.trolltech.com/gpl/ for GPL licensing information. | 14 | ** See http://www.trolltech.com/gpl/ for GPL licensing information. |
15 | ** | 15 | ** |
16 | ** Contact info@trolltech.com if any conditions of this licensing are | 16 | ** Contact info@trolltech.com if any conditions of this licensing are |
17 | ** not clear to you. | 17 | ** not clear to you. |
18 | ** | 18 | ** |
19 | **********************************************************************/ | 19 | **********************************************************************/ |
20 | 20 | ||
21 | 21 | ||
22 | #include "qlibrary_p.h" | 22 | #include "qlibrary_p.h" |
23 | 23 | ||
24 | // uncomment this to get error messages | 24 | // uncomment this to get error messages |
25 | //#define QT_DEBUG_COMPONENT 1 | 25 | //#define QT_DEBUG_COMPONENT 1 |
26 | // uncomment this to get error and success messages | 26 | // uncomment this to get error and success messages |
27 | //#define QT_DEBUG_COMPONENT 2 | 27 | //#define QT_DEBUG_COMPONENT 2 |
28 | 28 | ||
29 | #ifndef QT_DEBUG_COMPONENT | 29 | #ifndef QT_DEBUG_COMPONENT |
30 | # if defined(QT_DEBUG) | 30 | # if defined(QT_DEBUG) |
31 | # define QT_DEBUG_COMPONENT 1 | 31 | # define QT_DEBUG_COMPONENT 1 |
32 | # endif | 32 | # endif |
33 | #endif | 33 | #endif |
34 | 34 | ||
35 | #ifndef QT_NO_COMPONENT | 35 | #ifndef QT_NO_COMPONENT |
36 | 36 | ||
37 | // KAI C++ has at the moment problems with unloading the Qt plugins. So don't | 37 | // KAI C++ has at the moment problems with unloading the Qt plugins. So don't |
38 | // unload them as a workaround for now. | 38 | // unload them as a workaround for now. |
39 | #if defined(Q_CC_KAI) || defined(Q_OS_MAC) | 39 | #if defined(Q_CC_KAI) || defined(Q_OS_MAC) |
40 | #define QT_NO_LIBRARY_UNLOAD | 40 | #define QT_NO_LIBRARY_UNLOAD |
41 | #endif | 41 | #endif |
42 | 42 | ||
43 | #if defined(Q_WS_WIN) && !defined(QT_MAKEDLL) | 43 | #if defined(Q_WS_WIN) && !defined(QT_MAKEDLL) |
44 | #define QT_NO_LIBRARY_UNLOAD | 44 | #define QT_NO_LIBRARY_UNLOAD |
45 | #endif | 45 | #endif |
46 | 46 | ||
47 | /* Platform independent QLibraryPrivate implementations */ | 47 | /* Platform independent QLibraryPrivate implementations */ |
48 | #ifndef QT_LITE_COMPONENT | 48 | #ifndef QT_LITE_COMPONENT |
49 | 49 | ||
50 | #include "qtimer.h" | 50 | #include "qtimer.h" |
51 | 51 | ||
52 | extern Q_EXPORT QApplication *qApp; | 52 | extern Q_EXPORT QApplication *qApp; |
53 | 53 | ||
54 | QLibraryPrivate::QLibraryPrivate( QLibrary *lib ) | 54 | QLibraryPrivate::QLibraryPrivate( QLibrary *lib ) |
55 | : QObject( 0, lib->library().latin1() ), pHnd( 0 ), libIface( 0 ), unloadTimer( 0 ), library( lib ) | 55 | : QObject( 0, lib->library().latin1() ), pHnd( 0 ), libIface( 0 ), unloadTimer( 0 ), library( lib ) |
56 | { | 56 | { |
57 | } | 57 | } |
58 | 58 | ||
59 | QLibraryPrivate::~QLibraryPrivate() | 59 | QLibraryPrivate::~QLibraryPrivate() |
60 | { | 60 | { |
61 | if ( libIface ) | 61 | if ( libIface ) |
62 | libIface->release(); | 62 | libIface->release(); |
63 | killTimer(); | 63 | killTimer(); |
64 | } | 64 | } |
65 | 65 | ||
66 | /* | 66 | /* |
67 | Only components that implement the QLibraryInterface can | 67 | Only components that implement the QLibraryInterface can |
68 | be unloaded automatically. | 68 | be unloaded automatically. |
69 | */ | 69 | */ |
70 | void QLibraryPrivate::tryUnload() | 70 | void QLibraryPrivate::tryUnload() |
71 | { | 71 | { |
72 | if ( library->policy() == QLibrary::Manual || !pHnd || !libIface ) | 72 | if ( library->policy() == QLibrary::Manual || !pHnd || !libIface ) |
73 | return; | 73 | return; |
74 | 74 | ||
75 | if ( !libIface->canUnload() ) | 75 | if ( !libIface->canUnload() ) |
76 | return; | 76 | return; |
77 | 77 | ||
78 | #if defined(QT_DEBUG_COMPONENT) && QT_DEBUG_COMPONENT == 2 | 78 | #if defined(QT_DEBUG_COMPONENT) && QT_DEBUG_COMPONENT == 2 |
79 | if ( library->unload() ) | 79 | if ( library->unload() ) |
80 | qDebug( "%s has been automatically unloaded", library->library().latin1() ); | 80 | qDebug( "%s has been automatically unloaded", library->library().latin1() ); |
81 | #else | 81 | #else |
82 | library->unload(); | 82 | library->unload(); |
83 | #endif | 83 | #endif |
84 | } | 84 | } |
85 | 85 | ||
86 | #else // QT_LITE_COMPOINENT | 86 | #else // QT_LITE_COMPOINENT |
87 | 87 | ||
88 | QLibraryPrivate::QLibraryPrivate( QLibrary *lib ) | 88 | QLibraryPrivate::QLibraryPrivate( QLibrary *lib ) |
89 | : pHnd( 0 ), libIface( 0 ), library( lib ) | 89 | : pHnd( 0 ), libIface( 0 ), library( lib ) |
90 | { | 90 | { |
91 | } | 91 | } |
92 | 92 | ||
93 | #endif // QT_LITE_COMPOINENT | 93 | #endif // QT_LITE_COMPOINENT |
94 | 94 | ||
95 | void QLibraryPrivate::startTimer() | 95 | void QLibraryPrivate::startTimer() |
96 | { | 96 | { |
97 | #ifndef QT_LITE_COMPONENT | 97 | #ifndef QT_LITE_COMPONENT |
98 | unloadTimer = new QTimer( this ); | 98 | unloadTimer = new QTimer( this ); |
99 | connect( unloadTimer, SIGNAL( timeout() ), this, SLOT( tryUnload() ) ); | 99 | connect( unloadTimer, SIGNAL( timeout() ), this, SLOT( tryUnload() ) ); |
100 | unloadTimer->start( 5000, FALSE ); | 100 | unloadTimer->start( 5000, FALSE ); |
101 | #endif | 101 | #endif |
102 | } | 102 | } |
103 | 103 | ||
104 | void QLibraryPrivate::killTimer() | 104 | void QLibraryPrivate::killTimer() |
105 | { | 105 | { |
106 | #ifndef QT_LITE_COMPONENT | 106 | #ifndef QT_LITE_COMPONENT |
107 | delete unloadTimer; | 107 | delete unloadTimer; |
108 | unloadTimer = 0; | 108 | unloadTimer = 0; |
109 | #endif | 109 | #endif |
110 | } | 110 | } |
111 | 111 | ||
112 | /*! | 112 | /*! |
113 | \class QLibrary qlibrary.h | 113 | \class QLibrary qlibrary.h |
114 | 114 | ||
115 | \brief The QLibrary class provides a wrapper for handling shared libraries. | 115 | \brief The QLibrary class provides a wrapper for handling shared libraries. |
116 | 116 | ||
117 | This class is temporarily copied from Qt 3.0. | 117 | This class is temporarily copied from Qt 3.0. |
118 | */ | 118 | */ |
119 | 119 | ||
120 | /*! | 120 | /*! |
121 | \enum QLibrary::Policy | 121 | \enum QLibrary::Policy |
122 | 122 | ||
123 | This enum type defines the various policies a QLibrary can have with respect to | 123 | This enum type defines the various policies a QLibrary can have with respect to |
124 | loading and unloading the shared library. | 124 | loading and unloading the shared library. |
125 | 125 | ||
126 | The \e policy can be: | 126 | The \e policy can be: |
127 | 127 | ||
128 | \value Delayed The library get's loaded as soon as needed and unloaded in the destructor | 128 | \value Delayed The library get's loaded as soon as needed and unloaded in the destructor |
129 | \value Immediately The library is loaded immediately and unloaded in the destructor | 129 | \value Immediately The library is loaded immediately and unloaded in the destructor |
130 | \value Manual Like delayed, and library has to be unloaded manually | 130 | \value Manual Like delayed, and library has to be unloaded manually |
131 | */ | 131 | */ |
132 | 132 | ||
133 | /*! | 133 | /*! |
134 | Creates a QLibrary object for the shared library \a filename. | 134 | Creates a QLibrary object for the shared library \a filename. |
135 | The library get's loaded if \a pol is Immediately. | 135 | The library get's loaded if \a pol is Immediately. |
136 | 136 | ||
137 | Note that \a filename does not need to include the (platform specific) | 137 | Note that \a filename does not need to include the (platform specific) |
138 | file extension, so calling | 138 | file extension, so calling |
139 | 139 | ||
140 | \code | 140 | \code |
141 | QLibrary lib( "mylib" ); | 141 | QLibrary lib( "mylib" ); |
142 | \endcode | 142 | \endcode |
143 | 143 | ||
144 | would be equivalent to | 144 | would be equivalent to |
145 | 145 | ||
146 | \code | 146 | \code |
147 | QLibrary lib( "mylib.dll" ); | 147 | QLibrary lib( "mylib.dll" ); |
148 | \endcode | 148 | \endcode |
149 | 149 | ||
150 | on Windows. But \e "mylib.dll" will obviously not work on other platforms. | 150 | on Windows. But \e "mylib.dll" will obviously not work on other platforms. |
151 | 151 | ||
152 | \sa setPolicy(), unload() | 152 | \sa setPolicy(), unload() |
153 | */ | 153 | */ |
154 | QLibrary::QLibrary( const QString& filename, Policy pol ) | 154 | QLibrary::QLibrary( const QString& filename, Policy pol ) |
155 | : libfile( filename ), libPol( pol ), entry( 0 ) | 155 | : libfile( filename ), libPol( pol ), entry( 0 ) |
156 | { | 156 | { |
157 | d = new QLibraryPrivate( this ); | 157 | d = new QLibraryPrivate( this ); |
158 | if ( pol == Immediately ) | 158 | if ( pol == Immediately ) |
159 | load(); | 159 | load(); |
160 | } | 160 | } |
161 | 161 | ||
162 | /*! | 162 | /*! |
163 | Deletes the QLibrary object. | 163 | Deletes the QLibrary object. |
164 | The library will be unloaded if the policy is not Manual. | 164 | The library will be unloaded if the policy is not Manual. |
165 | 165 | ||
166 | \sa unload(), setPolicy() | 166 | \sa unload(), setPolicy() |
167 | */ | 167 | */ |
168 | QLibrary::~QLibrary() | 168 | QLibrary::~QLibrary() |
169 | { | 169 | { |
170 | if ( libPol == Manual || !unload() ) { | 170 | if ( libPol == Manual || !unload() ) { |
171 | if ( entry ) { | 171 | if ( entry ) { |
172 | entry->release(); | 172 | entry->release(); |
173 | entry = 0; | 173 | entry = 0; |
174 | } | 174 | } |
175 | } | 175 | } |
176 | delete d; | 176 | delete d; |
177 | } | 177 | } |
178 | 178 | ||
179 | void QLibrary::createInstanceInternal() | 179 | void QLibrary::createInstanceInternal() |
180 | { | 180 | { |
181 | if ( libfile.isEmpty() ) | 181 | if ( libfile.isEmpty() ) |
182 | return; | 182 | return; |
183 | 183 | ||
184 | if ( !d->pHnd ) { | 184 | if ( !d->pHnd ) { |
185 | ASSERT( entry == 0 ); | 185 | ASSERT( entry == 0 ); |
186 | load(); | 186 | load(); |
187 | } | 187 | } |
188 | 188 | ||
189 | if ( d->pHnd && !entry ) { | 189 | if ( d->pHnd && !entry ) { |
190 | #if defined(QT_DEBUG_COMPONENT) && QT_DEBUG_COMPONENT == 2 | 190 | #if defined(QT_DEBUG_COMPONENT) && QT_DEBUG_COMPONENT == 2 |
191 | qWarning( "%s has been loaded.", library().latin1() ); | 191 | qWarning( "%s has been loaded.", library().latin1() ); |
192 | #endif | 192 | #endif |
193 | typedef QUnknownInterface* (*UCMInstanceProc)(); | 193 | typedef QUnknownInterface* (*UCMInstanceProc)(); |
194 | UCMInstanceProc ucmInstanceProc; | 194 | UCMInstanceProc ucmInstanceProc; |
195 | ucmInstanceProc = (UCMInstanceProc) resolve( "ucm_instantiate" ); | 195 | ucmInstanceProc = (UCMInstanceProc) resolve( "ucm_instantiate" ); |
196 | entry = ucmInstanceProc ? ucmInstanceProc() : 0; | 196 | entry = ucmInstanceProc ? ucmInstanceProc() : 0; |
197 | if ( entry ) { | 197 | if ( entry ) { |
198 | entry->queryInterface( IID_QLibrary, (QUnknownInterface**)&d->libIface); | 198 | entry->queryInterface( IID_QLibrary, (QUnknownInterface**)&d->libIface); |
199 | if ( d->libIface ) { | 199 | if ( d->libIface ) { |
200 | if ( !d->libIface->init() ) { | 200 | if ( !d->libIface->init() ) { |
201 | #if defined(QT_DEBUG_COMPONENT) | 201 | #if defined(QT_DEBUG_COMPONENT) |
202 | qWarning( "%s: QLibraryInterface::init() failed.", library().latin1() ); | 202 | qWarning( "%s: QLibraryInterface::init() failed.", library().latin1() ); |
203 | #endif | 203 | #endif |
204 | unload(); | 204 | unload(); |
205 | return; | 205 | return; |
206 | } | 206 | } |
207 | 207 | ||
208 | d->killTimer(); | 208 | d->killTimer(); |
209 | if ( libPol != Manual ) | 209 | if ( libPol != Manual ) |
210 | d->startTimer(); | 210 | d->startTimer(); |
211 | } | 211 | } |
212 | } else { | 212 | } else { |
213 | #if defined(QT_DEBUG_COMPONENT) | 213 | #if defined(QT_DEBUG_COMPONENT) |
214 | qWarning( "%s: No interface implemented.", library().latin1() ); | 214 | qWarning( "%s: No interface implemented.", library().latin1() ); |
215 | #endif | 215 | #endif |
216 | unload(); | 216 | unload(); |
217 | } | 217 | } |
218 | } | 218 | } |
219 | } | 219 | } |
220 | 220 | ||
221 | /*! | 221 | /*! |
222 | Returns the address of the exported symbol \a symb. The library gets | 222 | Returns the address of the exported symbol \a symb. The library gets |
223 | loaded if necessary. The function returns NULL if the symbol could | 223 | loaded if necessary. The function returns NULL if the symbol could |
224 | not be resolved, or if loading the library failed. | 224 | not be resolved, or if loading the library failed. |
225 | 225 | ||
226 | \code | 226 | \code |
227 | typedef int (*addProc)( int, int ); | 227 | typedef int (*addProc)( int, int ); |
228 | 228 | ||
229 | addProc add = (addProc) library->resolve( "add" ); | 229 | addProc add = (addProc) library->resolve( "add" ); |
230 | if ( add ) | 230 | if ( add ) |
231 | return add( 5, 8 ); | 231 | return add( 5, 8 ); |
232 | else | 232 | else |
233 | return 5 + 8; | 233 | return 5 + 8; |
234 | \endcode | 234 | \endcode |
235 | 235 | ||
236 | \sa queryInterface() | 236 | \sa queryInterface() |
237 | */ | 237 | */ |
238 | void *QLibrary::resolve( const char* symb ) | 238 | void *QLibrary::resolve( const char* symb ) |
239 | { | 239 | { |
240 | if ( !d->pHnd ) | 240 | if ( !d->pHnd ) |
241 | load(); | 241 | load(); |
242 | if ( !d->pHnd ) | 242 | if ( !d->pHnd ) |
243 | return 0; | 243 | return 0; |
244 | 244 | ||
245 | void *address = d->resolveSymbol( symb ); | 245 | void *address = d->resolveSymbol( symb ); |
246 | if ( !address ) { | 246 | if ( !address ) { |
247 | #if defined(QT_DEBUG_COMPONENT) | 247 | #if defined(QT_DEBUG_COMPONENT) |
248 | // resolveSymbol() might give a warning; so let that warning look so fatal | 248 | // resolveSymbol() might give a warning; so let that warning look so fatal |
249 | qWarning( QString("Trying to resolve symbol \"_%1\" instead").arg( symb ) ); | 249 | qWarning( QString("Trying to resolve symbol \"_%1\" instead").arg( symb ) ); |
250 | #endif | 250 | #endif |
251 | address = d->resolveSymbol( QString( "_" ) + symb ); | 251 | address = d->resolveSymbol( QString( "_" ) + symb ); |
252 | } | 252 | } |
253 | return address; | 253 | return address; |
254 | } | 254 | } |
255 | 255 | ||
256 | /*! | 256 | /*! |
257 | \overload | 257 | \overload |
258 | 258 | ||
259 | Loads the library \a filename and returns the address of the exported symbol \a symb. | 259 | Loads the library \a filename and returns the address of the exported symbol \a symb. |
260 | Note that like for the constructor, \a filename does not need to include the (platform specific) | 260 | Note that like for the constructor, \a filename does not need to include the (platform specific) |