author | zecke <zecke> | 2004-05-29 18:43:13 (UTC) |
---|---|---|
committer | zecke <zecke> | 2004-05-29 18:43:13 (UTC) |
commit | 43c1ce80bc5faf16fe9d86c4685512659f5180bc (patch) (unidiff) | |
tree | ebd64b019954d702a39bad96d3324bbe79d7f9b6 | |
parent | f568ff9c68bdc61cbc4482f9b2c6e1096cecaae0 (diff) | |
download | opie-43c1ce80bc5faf16fe9d86c4685512659f5180bc.zip opie-43c1ce80bc5faf16fe9d86c4685512659f5180bc.tar.gz opie-43c1ce80bc5faf16fe9d86c4685512659f5180bc.tar.bz2 |
Make Enabled/Disabled work.
Problem was /home/ich/foo//plugins/foo
where /home/ich/foo/ was OPIEDIR and we added /
-rw-r--r-- | libopie2/opiecore/opluginloader.cpp | 3 |
1 files changed, 2 insertions, 1 deletions
diff --git a/libopie2/opiecore/opluginloader.cpp b/libopie2/opiecore/opluginloader.cpp index 3d286e5..e7eddc2 100644 --- a/libopie2/opiecore/opluginloader.cpp +++ b/libopie2/opiecore/opluginloader.cpp | |||
@@ -28,764 +28,765 @@ private: | |||
28 | 28 | ||
29 | OPluginLibraryHolder(); | 29 | OPluginLibraryHolder(); |
30 | ~OPluginLibraryHolder(); | 30 | ~OPluginLibraryHolder(); |
31 | QDict<QLibrary> m_libs; | 31 | QDict<QLibrary> m_libs; |
32 | static OPluginLibraryHolder* m_self; | 32 | static OPluginLibraryHolder* m_self; |
33 | }; | 33 | }; |
34 | 34 | ||
35 | OPluginLibraryHolder* OPluginLibraryHolder::m_self = 0; | 35 | OPluginLibraryHolder* OPluginLibraryHolder::m_self = 0; |
36 | OPluginLibraryHolder* OPluginLibraryHolder::self() { | 36 | OPluginLibraryHolder* OPluginLibraryHolder::self() { |
37 | if ( !m_self ) | 37 | if ( !m_self ) |
38 | m_self = new OPluginLibraryHolder; | 38 | m_self = new OPluginLibraryHolder; |
39 | 39 | ||
40 | return m_self; | 40 | return m_self; |
41 | } | 41 | } |
42 | 42 | ||
43 | OPluginLibraryHolder::OPluginLibraryHolder() {} | 43 | OPluginLibraryHolder::OPluginLibraryHolder() {} |
44 | OPluginLibraryHolder::~OPluginLibraryHolder() {} | 44 | OPluginLibraryHolder::~OPluginLibraryHolder() {} |
45 | 45 | ||
46 | /* | 46 | /* |
47 | * We do simple ref counting... We will add the QLibrary again | 47 | * We do simple ref counting... We will add the QLibrary again |
48 | * and again to the dictionary and on deref we will pop and pop it | 48 | * and again to the dictionary and on deref we will pop and pop it |
49 | * until there are no more library and we will unload and delete the library | 49 | * until there are no more library and we will unload and delete the library |
50 | * luckily dlopen does some ref counting as well so we don't need | 50 | * luckily dlopen does some ref counting as well so we don't need |
51 | * to hack QPEApplication | 51 | * to hack QPEApplication |
52 | */ | 52 | */ |
53 | QLibrary* OPluginLibraryHolder::ref(const QString& str) { | 53 | QLibrary* OPluginLibraryHolder::ref(const QString& str) { |
54 | QLibrary *lib = m_libs[str]; | 54 | QLibrary *lib = m_libs[str]; |
55 | 55 | ||
56 | /* if not in the dict try to load it */ | 56 | /* if not in the dict try to load it */ |
57 | if ( !lib ) { | 57 | if ( !lib ) { |
58 | lib = new QLibrary( str, QLibrary::Immediately ); | 58 | lib = new QLibrary( str, QLibrary::Immediately ); |
59 | if ( !lib->isLoaded() ) { | 59 | if ( !lib->isLoaded() ) { |
60 | delete lib; | 60 | delete lib; |
61 | return 0l; | 61 | return 0l; |
62 | } | 62 | } |
63 | } | 63 | } |
64 | 64 | ||
65 | /* now refcount one up */ | 65 | /* now refcount one up */ |
66 | m_libs.insert( str, lib ); | 66 | m_libs.insert( str, lib ); |
67 | return lib; | 67 | return lib; |
68 | } | 68 | } |
69 | 69 | ||
70 | /* | 70 | /* |
71 | * 'unshadow' the items until we're the last then unload and delete | 71 | * 'unshadow' the items until we're the last then unload and delete |
72 | */ | 72 | */ |
73 | void OPluginLibraryHolder::deref( QLibrary* lib ) { | 73 | void OPluginLibraryHolder::deref( QLibrary* lib ) { |
74 | if ( !lib ) | 74 | if ( !lib ) |
75 | return; | 75 | return; |
76 | 76 | ||
77 | QString str = lib->library(); | 77 | QString str = lib->library(); |
78 | /* no need to check if the lib was inserted or such */ | 78 | /* no need to check if the lib was inserted or such */ |
79 | (void) m_libs.take( str ); | 79 | (void) m_libs.take( str ); |
80 | if ( !m_libs[str] ) { | 80 | if ( !m_libs[str] ) { |
81 | lib->unload(); | 81 | lib->unload(); |
82 | delete lib; | 82 | delete lib; |
83 | } | 83 | } |
84 | } | 84 | } |
85 | } | 85 | } |
86 | 86 | ||
87 | /** | 87 | /** |
88 | * We want values with 30,29,28 at the beginning of the list | 88 | * We want values with 30,29,28 at the beginning of the list |
89 | */ | 89 | */ |
90 | 90 | ||
91 | bool operator<( const OPluginItem& l, const OPluginItem& r ) { | 91 | bool operator<( const OPluginItem& l, const OPluginItem& r ) { |
92 | return l.position() > r.position(); | 92 | return l.position() > r.position(); |
93 | } | 93 | } |
94 | 94 | ||
95 | bool operator>( const OPluginItem& l, const OPluginItem& r ) { | 95 | bool operator>( const OPluginItem& l, const OPluginItem& r ) { |
96 | return l.position() < r.position(); | 96 | return l.position() < r.position(); |
97 | } | 97 | } |
98 | 98 | ||
99 | bool operator<=( const OPluginItem& l, const OPluginItem& r ) { | 99 | bool operator<=( const OPluginItem& l, const OPluginItem& r ) { |
100 | return l.position() >= r.position(); | 100 | return l.position() >= r.position(); |
101 | } | 101 | } |
102 | 102 | ||
103 | /** | 103 | /** |
104 | * \brief Creates an Empty OPluginItem | 104 | * \brief Creates an Empty OPluginItem |
105 | * | 105 | * |
106 | * create an empty pluginitem. Position is set to -1 and the | 106 | * create an empty pluginitem. Position is set to -1 and the |
107 | * other things are used with the default ctors | 107 | * other things are used with the default ctors |
108 | */ | 108 | */ |
109 | OPluginItem::OPluginItem() | 109 | OPluginItem::OPluginItem() |
110 | : m_pos( -1 ) { | 110 | : m_pos( -1 ) { |
111 | } | 111 | } |
112 | 112 | ||
113 | /** | 113 | /** |
114 | * @todo Create Internal name so we can have the plugin names translated. Or only for the gui? I'm not yet sure | 114 | * @todo Create Internal name so we can have the plugin names translated. Or only for the gui? I'm not yet sure |
115 | * \brief Create an OPluginItem | 115 | * \brief Create an OPluginItem |
116 | * | 116 | * |
117 | * Create a Plugin Item with all information. If you for some reasons | 117 | * Create a Plugin Item with all information. If you for some reasons |
118 | * need to create your own OPluginItems make sure that 'name' is always the same | 118 | * need to create your own OPluginItems make sure that 'name' is always the same |
119 | * as it if used for positions and exclude list. | 119 | * as it if used for positions and exclude list. |
120 | * | 120 | * |
121 | * @param name The if available translated Name | 121 | * @param name The if available translated Name |
122 | * @param path The path to the plugin must be absolute. | 122 | * @param path The path to the plugin must be absolute. |
123 | * @param b If the OPluginItem is enabled or not | 123 | * @param b If the OPluginItem is enabled or not |
124 | * @param pos The position of the plugin if used for sorting | 124 | * @param pos The position of the plugin if used for sorting |
125 | * | 125 | * |
126 | */ | 126 | */ |
127 | OPluginItem::OPluginItem( const QString& name, const QString& path, bool b, int pos ) | 127 | OPluginItem::OPluginItem( const QString& name, const QString& path, bool b, int pos ) |
128 | : m_name( name ), m_path( path ), m_enabled( b ), m_pos( pos ) | 128 | : m_name( name ), m_path( path ), m_enabled( b ), m_pos( pos ) |
129 | {} | 129 | {} |
130 | 130 | ||
131 | /** | 131 | /** |
132 | * \brief simple d'tor | 132 | * \brief simple d'tor |
133 | */ | 133 | */ |
134 | OPluginItem::~OPluginItem() { | 134 | OPluginItem::~OPluginItem() { |
135 | } | 135 | } |
136 | 136 | ||
137 | /** | 137 | /** |
138 | * \brief Test if this Item is Empty and does not represent a loadable plugin | 138 | * \brief Test if this Item is Empty and does not represent a loadable plugin |
139 | * Test if a OPluginItem is empty. A OPluginItem is empty if name and path are empty | 139 | * Test if a OPluginItem is empty. A OPluginItem is empty if name and path are empty |
140 | * ,pos equals -1 and the item is disabled | 140 | * ,pos equals -1 and the item is disabled |
141 | * | 141 | * |
142 | * @see QString::isEmpty() | 142 | * @see QString::isEmpty() |
143 | * | 143 | * |
144 | */ | 144 | */ |
145 | bool OPluginItem::isEmpty()const { | 145 | bool OPluginItem::isEmpty()const { |
146 | if ( m_pos != -1 ) return false; | 146 | if ( m_pos != -1 ) return false; |
147 | if ( m_enabled ) return false; | 147 | if ( m_enabled ) return false; |
148 | if ( !m_name.isEmpty() ) return false; | 148 | if ( !m_name.isEmpty() ) return false; |
149 | if ( !m_path.isEmpty() ) return false; | 149 | if ( !m_path.isEmpty() ) return false; |
150 | 150 | ||
151 | return true; | 151 | return true; |
152 | } | 152 | } |
153 | 153 | ||
154 | /** | 154 | /** |
155 | * \brief test equality | 155 | * \brief test equality |
156 | * operator to test equalness of two OPluginItem | 156 | * operator to test equalness of two OPluginItem |
157 | */ | 157 | */ |
158 | bool OPluginItem::operator==( const OPluginItem& r )const{ | 158 | bool OPluginItem::operator==( const OPluginItem& r )const{ |
159 | if ( m_pos != r.m_pos ) return false; | 159 | if ( m_pos != r.m_pos ) return false; |
160 | if ( m_enabled != r.m_enabled) return false; | 160 | if ( m_enabled != r.m_enabled) return false; |
161 | if ( m_name != r.m_name ) return false; | 161 | if ( m_name != r.m_name ) return false; |
162 | if ( m_path != r.m_path ) return false; | 162 | if ( m_path != r.m_path ) return false; |
163 | return true; | 163 | return true; |
164 | } | 164 | } |
165 | 165 | ||
166 | /** | 166 | /** |
167 | * \brief test non equality | 167 | * \brief test non equality |
168 | * operator to test non-equalness of two OPluginItem | 168 | * operator to test non-equalness of two OPluginItem |
169 | */ | 169 | */ |
170 | bool OPluginItem::operator!=( const OPluginItem& r )const{ | 170 | bool OPluginItem::operator!=( const OPluginItem& r )const{ |
171 | return !( *this == r ); | 171 | return !( *this == r ); |
172 | } | 172 | } |
173 | 173 | ||
174 | /** | 174 | /** |
175 | * \brief returns the name of the plugin | 175 | * \brief returns the name of the plugin |
176 | * return the name of this Plugin | 176 | * return the name of this Plugin |
177 | */ | 177 | */ |
178 | QString OPluginItem::name()const { | 178 | QString OPluginItem::name()const { |
179 | return m_name; | 179 | return m_name; |
180 | } | 180 | } |
181 | 181 | ||
182 | /** | 182 | /** |
183 | * \brief return the path of the plugin | 183 | * \brief return the path of the plugin |
184 | */ | 184 | */ |
185 | QString OPluginItem::path()const { | 185 | QString OPluginItem::path()const { |
186 | return m_path; | 186 | return m_path; |
187 | } | 187 | } |
188 | 188 | ||
189 | /** | 189 | /** |
190 | * \brief Return if this item is enabled. | 190 | * \brief Return if this item is enabled. |
191 | */ | 191 | */ |
192 | bool OPluginItem::isEnabled()const { | 192 | bool OPluginItem::isEnabled()const { |
193 | return m_enabled; | 193 | return m_enabled; |
194 | } | 194 | } |
195 | 195 | ||
196 | /** | 196 | /** |
197 | * \brief return the position of a plugin. | 197 | * \brief return the position of a plugin. |
198 | * return the position of the item | 198 | * return the position of the item |
199 | * -1 is the default value and means normally that the whole items are unsorted. | 199 | * -1 is the default value and means normally that the whole items are unsorted. |
200 | * Higher numbers belong to an upper position. With plugins with the postions 20,19,5,3 | 200 | * Higher numbers belong to an upper position. With plugins with the postions 20,19,5,3 |
201 | * the item with pos 20 would be the first in the list returned by the OGenericPluginLoader | 201 | * the item with pos 20 would be the first in the list returned by the OGenericPluginLoader |
202 | * | 202 | * |
203 | * @see OGenericPluginLoader::allAvailable | 203 | * @see OGenericPluginLoader::allAvailable |
204 | * @see OGenericPluginLoader::filtered | 204 | * @see OGenericPluginLoader::filtered |
205 | */ | 205 | */ |
206 | int OPluginItem::position()const{ | 206 | int OPluginItem::position()const{ |
207 | return m_pos; | 207 | return m_pos; |
208 | } | 208 | } |
209 | 209 | ||
210 | /** | 210 | /** |
211 | * \brief set the name of a plugin | 211 | * \brief set the name of a plugin |
212 | * Set the name of the Plugin Item | 212 | * Set the name of the Plugin Item |
213 | * @param name | 213 | * @param name |
214 | */ | 214 | */ |
215 | void OPluginItem::setName( const QString& name ) { | 215 | void OPluginItem::setName( const QString& name ) { |
216 | m_name = name; | 216 | m_name = name; |
217 | } | 217 | } |
218 | 218 | ||
219 | /** | 219 | /** |
220 | * \brief set the path of a plugin | 220 | * \brief set the path of a plugin |
221 | * Set the path of Plugin Item. The path must be absolute. | 221 | * Set the path of Plugin Item. The path must be absolute. |
222 | * @param name The path of the plugin | 222 | * @param name The path of the plugin |
223 | */ | 223 | */ |
224 | void OPluginItem::setPath( const QString& name ) { | 224 | void OPluginItem::setPath( const QString& name ) { |
225 | m_path = name; | 225 | m_path = name; |
226 | } | 226 | } |
227 | 227 | ||
228 | /** | 228 | /** |
229 | * \brief enable or disable the to load attribute | 229 | * \brief enable or disable the to load attribute |
230 | * Set the Enabled attribute. Such changes won't be saved. If you want to save it | 230 | * Set the Enabled attribute. Such changes won't be saved. If you want to save it |
231 | * use a OPluginManager to configure your plugins manually or Opie::Ui::OPluginConfig | 231 | * use a OPluginManager to configure your plugins manually or Opie::Ui::OPluginConfig |
232 | * for a graphical frontend. | 232 | * for a graphical frontend. |
233 | * | 233 | * |
234 | * @param enabled Enable or Disable the Enabled Attribute | 234 | * @param enabled Enable or Disable the Enabled Attribute |
235 | */ | 235 | */ |
236 | void OPluginItem::setEnabled( bool enabled ) { | 236 | void OPluginItem::setEnabled( bool enabled ) { |
237 | m_enabled = enabled; | 237 | m_enabled = enabled; |
238 | } | 238 | } |
239 | 239 | ||
240 | /** | 240 | /** |
241 | * \brief Set the position. | 241 | * \brief Set the position. |
242 | * Set the position | 242 | * Set the position |
243 | * @param pos The position | 243 | * @param pos The position |
244 | * | 244 | * |
245 | * @see position() | 245 | * @see position() |
246 | */ | 246 | */ |
247 | void OPluginItem::setPosition( int pos ) { | 247 | void OPluginItem::setPosition( int pos ) { |
248 | m_pos = pos; | 248 | m_pos = pos; |
249 | } | 249 | } |
250 | 250 | ||
251 | 251 | ||
252 | 252 | ||
253 | /** | 253 | /** |
254 | * \brief create a PluginLoader | 254 | * \brief create a PluginLoader |
255 | * | 255 | * |
256 | * Create a PluginLoader autoDelete is set to false | 256 | * Create a PluginLoader autoDelete is set to false |
257 | * | 257 | * |
258 | * \code | 258 | * \code |
259 | * Opie::Core::OGenericPluginLoader loader("myapp-plugin"); | 259 | * Opie::Core::OGenericPluginLoader loader("myapp-plugin"); |
260 | * Opie::Core::OPluginItem::List lst = loader.filtered(); | 260 | * Opie::Core::OPluginItem::List lst = loader.filtered(); |
261 | * for(Opie::Core::OPluginItem::List::Iterator it = lst.begin(); it!=lst.end();++it){ | 261 | * for(Opie::Core::OPluginItem::List::Iterator it = lst.begin(); it!=lst.end();++it){ |
262 | * MyIface* iface = static_cast<MyIface*>(loader.load(*it,IID_MyIface)); | 262 | * MyIface* iface = static_cast<MyIface*>(loader.load(*it,IID_MyIface)); |
263 | * } | 263 | * } |
264 | * \endcode | 264 | * \endcode |
265 | * | 265 | * |
266 | * \code | 266 | * \code |
267 | * Opie::Core::OGenericPluginLoader loader("myapp-plugin"); | 267 | * Opie::Core::OGenericPluginLoader loader("myapp-plugin"); |
268 | * Opie::Core::OPluginItem::List lst = loader.filtered(); | 268 | * Opie::Core::OPluginItem::List lst = loader.filtered(); |
269 | * for(Opie::Core::OPluginItem::List::Iterator it = lst.begin(); it!=lst.end();++it){ | 269 | * for(Opie::Core::OPluginItem::List::Iterator it = lst.begin(); it!=lst.end();++it){ |
270 | * MyIface* iface = static_cast<MyIface*>(loader.load(*it,IID_MyIface)); | 270 | * MyIface* iface = static_cast<MyIface*>(loader.load(*it,IID_MyIface)); |
271 | * } | 271 | * } |
272 | * ... | 272 | * ... |
273 | * loader.clear(); | 273 | * loader.clear(); |
274 | * | 274 | * |
275 | * \endcode | 275 | * \endcode |
276 | * | 276 | * |
277 | * @param name The name of the plugin directory. | 277 | * @param name The name of the plugin directory. |
278 | * @param isSorted Tell the PluginLoader if your Plugins are sorted | 278 | * @param isSorted Tell the PluginLoader if your Plugins are sorted |
279 | */ | 279 | */ |
280 | OGenericPluginLoader::OGenericPluginLoader( const QString& name, bool isSorted) | 280 | OGenericPluginLoader::OGenericPluginLoader( const QString& name, bool isSorted) |
281 | : m_dir( name ), m_autoDelete( false ), m_isSafeMode( false ), | 281 | : m_dir( name ), m_autoDelete( false ), m_isSafeMode( false ), |
282 | m_isSorted( isSorted ) | 282 | m_isSorted( isSorted ) |
283 | { | 283 | { |
284 | setPluginDir( QPEApplication::qpeDir() + "/plugins/"+name ); | 284 | setPluginDir( QPEApplication::qpeDir() + "plugins/"+name ); |
285 | readConfig(); | 285 | readConfig(); |
286 | } | 286 | } |
287 | 287 | ||
288 | 288 | ||
289 | /** | 289 | /** |
290 | * \brief simple d'tor that cleans up depending on autoDelete | 290 | * \brief simple d'tor that cleans up depending on autoDelete |
291 | * | 291 | * |
292 | * calls clear if autoDelete is true. This will release all interfaces | 292 | * calls clear if autoDelete is true. This will release all interfaces |
293 | * and remove the library from this process if the refcount falls to zero | 293 | * and remove the library from this process if the refcount falls to zero |
294 | */ | 294 | */ |
295 | OGenericPluginLoader::~OGenericPluginLoader() { | 295 | OGenericPluginLoader::~OGenericPluginLoader() { |
296 | if ( m_autoDelete ) | 296 | if ( m_autoDelete ) |
297 | clear(); | 297 | clear(); |
298 | } | 298 | } |
299 | 299 | ||
300 | /** | 300 | /** |
301 | * \brief Enable or disable autoDelete on destruction | 301 | * \brief Enable or disable autoDelete on destruction |
302 | * | 302 | * |
303 | * enable autoDelete. This will call clear on the d'tor | 303 | * enable autoDelete. This will call clear on the d'tor |
304 | * | 304 | * |
305 | * @see ~OGenericPluginLoader | 305 | * @see ~OGenericPluginLoader |
306 | * @see clear() | 306 | * @see clear() |
307 | */ | 307 | */ |
308 | void OGenericPluginLoader::setAutoDelete( bool t ) { | 308 | void OGenericPluginLoader::setAutoDelete( bool t ) { |
309 | m_autoDelete = t; | 309 | m_autoDelete = t; |
310 | } | 310 | } |
311 | 311 | ||
312 | /** | 312 | /** |
313 | * \brief See if autoDelete is enabled. | 313 | * \brief See if autoDelete is enabled. |
314 | */ | 314 | */ |
315 | bool OGenericPluginLoader::autoDelete()const{ | 315 | bool OGenericPluginLoader::autoDelete()const{ |
316 | return m_autoDelete; | 316 | return m_autoDelete; |
317 | } | 317 | } |
318 | 318 | ||
319 | /** | 319 | /** |
320 | * \brief unload all loaded Plugins | 320 | * \brief unload all loaded Plugins |
321 | * | 321 | * |
322 | * This will unload all returned QUnknownInterfaces by load. Unload | 322 | * This will unload all returned QUnknownInterfaces by load. Unload |
323 | * will be called. | 323 | * will be called. |
324 | */ | 324 | */ |
325 | void OGenericPluginLoader::clear() { | 325 | void OGenericPluginLoader::clear() { |
326 | QPtrDictIterator<QLibrary> it( m_library ); | 326 | QPtrDictIterator<QLibrary> it( m_library ); |
327 | for ( ;it.current(); ) | 327 | for ( ;it.current(); ) |
328 | unload( static_cast<QUnknownInterface*>( it.currentKey() ) ); | 328 | unload( static_cast<QUnknownInterface*>( it.currentKey() ) ); |
329 | } | 329 | } |
330 | 330 | ||
331 | /** | 331 | /** |
332 | * \brief unload the Plugin and the accompanied Resources. | 332 | * \brief unload the Plugin and the accompanied Resources. |
333 | * | 333 | * |
334 | * This will take the iface from the internal QPtrDict, Release it, | 334 | * This will take the iface from the internal QPtrDict, Release it, |
335 | * and deref the libray used. | 335 | * and deref the libray used. |
336 | * The visibility depends on the QPtrDict. | 336 | * The visibility depends on the QPtrDict. |
337 | * @see QPtrDict::insert | 337 | * @see QPtrDict::insert |
338 | */ | 338 | */ |
339 | void OGenericPluginLoader::unload( QUnknownInterface* iface ) { | 339 | void OGenericPluginLoader::unload( QUnknownInterface* iface ) { |
340 | if ( !iface ) | 340 | if ( !iface ) |
341 | return; | 341 | return; |
342 | 342 | ||
343 | iface->release(); | 343 | iface->release(); |
344 | Internal::OPluginLibraryHolder::self()->deref( m_library.take( iface ) ); | 344 | Internal::OPluginLibraryHolder::self()->deref( m_library.take( iface ) ); |
345 | } | 345 | } |
346 | 346 | ||
347 | /** | 347 | /** |
348 | * \brief The name of the plugins. | 348 | * \brief The name of the plugins. |
349 | * | 349 | * |
350 | * Return the name/type you specified in the constructor. | 350 | * Return the name/type you specified in the constructor. |
351 | * This is at least used by the OPluginManager to find the right config | 351 | * This is at least used by the OPluginManager to find the right config |
352 | */ | 352 | */ |
353 | QString OGenericPluginLoader::name()const { | 353 | QString OGenericPluginLoader::name()const { |
354 | return m_dir; | 354 | return m_dir; |
355 | } | 355 | } |
356 | 356 | ||
357 | 357 | ||
358 | /** | 358 | /** |
359 | * \brief See if loading of a plugin segfaulted | 359 | * \brief See if loading of a plugin segfaulted |
360 | * This tells you | 360 | * This tells you |
361 | * if by previous tries to load, loading crashed your application. | 361 | * if by previous tries to load, loading crashed your application. |
362 | * If isInSafeMode you can use the GUI to configure the plugins prior to loading | 362 | * If isInSafeMode you can use the GUI to configure the plugins prior to loading |
363 | * | 363 | * |
364 | * @return true if prior loading failed | 364 | * @return true if prior loading failed |
365 | */ | 365 | */ |
366 | bool OGenericPluginLoader::isInSafeMode()const { | 366 | bool OGenericPluginLoader::isInSafeMode()const { |
367 | return m_isSafeMode; | 367 | return m_isSafeMode; |
368 | } | 368 | } |
369 | 369 | ||
370 | 370 | ||
371 | /** | 371 | /** |
372 | * \brief Return all Plugins found in the plugins dirs. | 372 | * \brief Return all Plugins found in the plugins dirs. |
373 | * Return the list of all available plugins. This will go through all plugin | 373 | * Return the list of all available plugins. This will go through all plugin |
374 | * directories and search for your type of plugins ( by subdir ) | 374 | * directories and search for your type of plugins ( by subdir ) |
375 | * | 375 | * |
376 | * @param sorted Tell if you want to have the positions sorted. This only makes sense if you | 376 | * @param sorted Tell if you want to have the positions sorted. This only makes sense if you |
377 | */ | 377 | */ |
378 | OPluginItem::List OGenericPluginLoader::allAvailable( bool sorted )const { | 378 | OPluginItem::List OGenericPluginLoader::allAvailable( bool sorted )const { |
379 | OPluginItem::List lst; | 379 | OPluginItem::List lst; |
380 | for ( QStringList::ConstIterator it = m_plugDirs.begin(); it != m_plugDirs.end(); ++it ) | 380 | for ( QStringList::ConstIterator it = m_plugDirs.begin(); it != m_plugDirs.end(); ++it ) |
381 | lst += plugins( *it, sorted, false ); | 381 | lst += plugins( *it, sorted, false ); |
382 | 382 | ||
383 | if ( sorted ) | 383 | if ( sorted ) |
384 | qHeapSort( lst ); | 384 | qHeapSort( lst ); |
385 | return lst; | 385 | return lst; |
386 | } | 386 | } |
387 | 387 | ||
388 | /** | 388 | /** |
389 | * \brief Return only the enabled plugins | 389 | * \brief Return only the enabled plugins |
390 | * Return only activated plugins. | 390 | * Return only activated plugins. |
391 | * | 391 | * |
392 | * @param sorted If the list should be sorted | 392 | * @param sorted If the list should be sorted |
393 | */ | 393 | */ |
394 | OPluginItem::List OGenericPluginLoader::filtered( bool sorted )const { | 394 | OPluginItem::List OGenericPluginLoader::filtered( bool sorted )const { |
395 | OPluginItem::List lst; | 395 | OPluginItem::List lst; |
396 | for ( QStringList::ConstIterator it = m_plugDirs.begin(); it != m_plugDirs.end(); ++it ) | 396 | for ( QStringList::ConstIterator it = m_plugDirs.begin(); it != m_plugDirs.end(); ++it ) |
397 | lst += plugins( *it, sorted, true ); | 397 | lst += plugins( *it, sorted, true ); |
398 | 398 | ||
399 | if ( sorted ) | 399 | if ( sorted ) |
400 | qHeapSort( lst ); | 400 | qHeapSort( lst ); |
401 | return lst; | 401 | return lst; |
402 | } | 402 | } |
403 | 403 | ||
404 | 404 | ||
405 | /** | 405 | /** |
406 | * \brief Load a OPluginItem for the specified interface | 406 | * \brief Load a OPluginItem for the specified interface |
407 | * This will open the resource of the OPluginItem::path() and then will query | 407 | * This will open the resource of the OPluginItem::path() and then will query |
408 | * if the Interface specified in the uuid is available and then will manage the | 408 | * if the Interface specified in the uuid is available and then will manage the |
409 | * resource and Interface. | 409 | * resource and Interface. |
410 | * | 410 | * |
411 | * @param item The OPluginItem that should be loaded | 411 | * @param item The OPluginItem that should be loaded |
412 | * @param uuid The Interface to query for | 412 | * @param uuid The Interface to query for |
413 | * | 413 | * |
414 | * @return Either 0 in case of failure or the Plugin as QUnknownInterface* | 414 | * @return Either 0 in case of failure or the Plugin as QUnknownInterface* |
415 | */ | 415 | */ |
416 | QUnknownInterface* OGenericPluginLoader::load( const OPluginItem& item, const QUuid& uuid) { | 416 | QUnknownInterface* OGenericPluginLoader::load( const OPluginItem& item, const QUuid& uuid) { |
417 | /* | 417 | /* |
418 | * Check if there could be a library | 418 | * Check if there could be a library |
419 | */ | 419 | */ |
420 | QString pa = item.path(); | 420 | QString pa = item.path(); |
421 | if ( pa.isEmpty() ) | 421 | if ( pa.isEmpty() ) |
422 | return 0l; | 422 | return 0l; |
423 | 423 | ||
424 | /* | 424 | /* |
425 | * See if we get a library | 425 | * See if we get a library |
426 | * return if we've none | 426 | * return if we've none |
427 | */ | 427 | */ |
428 | setSafeMode( pa, true ); | 428 | setSafeMode( pa, true ); |
429 | QLibrary *lib = Internal::OPluginLibraryHolder::self()->ref( pa ); | 429 | QLibrary *lib = Internal::OPluginLibraryHolder::self()->ref( pa ); |
430 | if ( !lib ) { | 430 | if ( !lib ) { |
431 | setSafeMode(); | 431 | setSafeMode(); |
432 | return 0l; | 432 | return 0l; |
433 | } | 433 | } |
434 | 434 | ||
435 | /** | 435 | /** |
436 | * try to load the plugin and just in case initialize the pointer to a pointer again | 436 | * try to load the plugin and just in case initialize the pointer to a pointer again |
437 | */ | 437 | */ |
438 | QUnknownInterface* iface=0; | 438 | QUnknownInterface* iface=0; |
439 | if ( lib->queryInterface( uuid, &iface ) == QS_OK ) { | 439 | if ( lib->queryInterface( uuid, &iface ) == QS_OK ) { |
440 | installTranslators(pa.left( pa.find("."))); | 440 | installTranslators(pa.left( pa.find("."))); |
441 | m_library.insert( iface, lib ); | 441 | m_library.insert( iface, lib ); |
442 | }else | 442 | }else |
443 | iface = 0; | 443 | iface = 0; |
444 | 444 | ||
445 | setSafeMode(); | 445 | setSafeMode(); |
446 | 446 | ||
447 | return iface; | 447 | return iface; |
448 | } | 448 | } |
449 | 449 | ||
450 | /** | 450 | /** |
451 | * @internal and reads in the safe mode | 451 | * @internal and reads in the safe mode |
452 | */ | 452 | */ |
453 | void OGenericPluginLoader::readConfig() { | 453 | void OGenericPluginLoader::readConfig() { |
454 | 454 | ||
455 | 455 | ||
456 | /* read the config for SafeMode */ | 456 | /* read the config for SafeMode */ |
457 | OConfig conf( m_dir + "-odpplugins" ); | 457 | OConfig conf( m_dir + "-odpplugins" ); |
458 | conf.setGroup( "General" ); | 458 | conf.setGroup( "General" ); |
459 | m_isSafeMode = conf.readBoolEntry( "SafeMode", false ); | 459 | m_isSafeMode = conf.readBoolEntry( "SafeMode", false ); |
460 | } | 460 | } |
461 | 461 | ||
462 | /** | 462 | /** |
463 | * @internal Enter or leave SafeMode | 463 | * @internal Enter or leave SafeMode |
464 | */ | 464 | */ |
465 | void OGenericPluginLoader::setSafeMode(const QString& str, bool b) { | 465 | void OGenericPluginLoader::setSafeMode(const QString& str, bool b) { |
466 | OConfig conf( m_dir + "-odpplugins" ); | 466 | OConfig conf( m_dir + "-odpplugins" ); |
467 | conf.setGroup( "General" ); | 467 | conf.setGroup( "General" ); |
468 | conf.writeEntry( "SafeMode", b ); | 468 | conf.writeEntry( "SafeMode", b ); |
469 | conf.writeEntry( "CrashedPlugin", str ); | 469 | conf.writeEntry( "CrashedPlugin", str ); |
470 | } | 470 | } |
471 | 471 | ||
472 | /** | 472 | /** |
473 | * @internal | 473 | * @internal |
474 | * | 474 | * |
475 | * Set the List of Plugin Dirs to lst. Currently only QPEApplication::qpeDir()+"/plugins/"+mytype | 475 | * Set the List of Plugin Dirs to lst. Currently only QPEApplication::qpeDir()+"/plugins/"+mytype |
476 | * is used as plugin dir | 476 | * is used as plugin dir |
477 | */ | 477 | */ |
478 | void OGenericPluginLoader::setPluginDirs( const QStringList& lst ) { | 478 | void OGenericPluginLoader::setPluginDirs( const QStringList& lst ) { |
479 | m_plugDirs = lst; | 479 | m_plugDirs = lst; |
480 | } | 480 | } |
481 | 481 | ||
482 | /** | 482 | /** |
483 | * | 483 | * |
484 | * @internal | 484 | * @internal |
485 | * Set the Plugin Dir to str. Str will be the only element in the list of plugin dirs | 485 | * Set the Plugin Dir to str. Str will be the only element in the list of plugin dirs |
486 | */ | 486 | */ |
487 | void OGenericPluginLoader::setPluginDir( const QString& str) { | 487 | void OGenericPluginLoader::setPluginDir( const QString& str) { |
488 | m_plugDirs.clear(); | 488 | m_plugDirs.clear(); |
489 | m_plugDirs.append( str ); | 489 | m_plugDirs.append( str ); |
490 | } | 490 | } |
491 | 491 | ||
492 | 492 | ||
493 | /** | 493 | /** |
494 | * @internal | 494 | * @internal |
495 | */ | 495 | */ |
496 | bool OGenericPluginLoader::isSorted()const{ | 496 | bool OGenericPluginLoader::isSorted()const{ |
497 | return m_isSorted; | 497 | return m_isSorted; |
498 | } | 498 | } |
499 | 499 | ||
500 | /* | 500 | /* |
501 | * make libfoo.so.1.0.0 -> foo on UNIX | 501 | * make libfoo.so.1.0.0 -> foo on UNIX |
502 | * make libfoo.dylib -> foo on MAC OS X Unix | 502 | * make libfoo.dylib -> foo on MAC OS X Unix |
503 | * windows is obviously missing | 503 | * windows is obviously missing |
504 | */ | 504 | */ |
505 | /** | 505 | /** |
506 | * @internal | 506 | * @internal |
507 | */ | 507 | */ |
508 | QString OGenericPluginLoader::unlibify( const QString& str ) { | 508 | QString OGenericPluginLoader::unlibify( const QString& str ) { |
509 | QString st = str.mid( str.find( "lib" )+3 ); | 509 | QString st = str.mid( str.find( "lib" )+3 ); |
510 | #ifdef Q_OS_MACX | 510 | #ifdef Q_OS_MACX |
511 | return st.left( st.findRev( ".dylib" ) ); | 511 | return st.left( st.findRev( ".dylib" ) ); |
512 | #else | 512 | #else |
513 | return st.left( st.findRev( ".so" ) ); | 513 | return st.left( st.findRev( ".so" ) ); |
514 | #endif | 514 | #endif |
515 | } | 515 | } |
516 | 516 | ||
517 | /** | 517 | /** |
518 | * @internal | 518 | * @internal |
519 | * | 519 | * |
520 | * \brief method to return available plugins. Internal and for reeimplementations | 520 | * \brief method to return available plugins. Internal and for reeimplementations |
521 | * | 521 | * |
522 | *Return a List of Plugins for a dir and add positions and remove disabled. | 522 | *Return a List of Plugins for a dir and add positions and remove disabled. |
523 | * If a plugin is on the excluded list assign position -2 | 523 | * If a plugin is on the excluded list assign position -2 |
524 | * | 524 | * |
525 | * @param dir The dir to look in | 525 | * @param dir The dir to look in |
526 | * @param sorted Should positions be read? | 526 | * @param sorted Should positions be read? |
527 | * @param disabled Remove excluded from the list | 527 | * @param disabled Remove excluded from the list |
528 | */ | 528 | */ |
529 | OPluginItem::List OGenericPluginLoader::plugins( const QString& _dir, bool sorted, bool disabled )const { | 529 | OPluginItem::List OGenericPluginLoader::plugins( const QString& _dir, bool sorted, bool disabled )const { |
530 | #ifdef Q_OS_MACX | 530 | #ifdef Q_OS_MACX |
531 | QDir dir( _dir, "lib*.dylib" ); | 531 | QDir dir( _dir, "lib*.dylib" ); |
532 | #else | 532 | #else |
533 | QDir dir( _dir, "lib*.so" ); | 533 | QDir dir( _dir, "lib*.so" ); |
534 | #endif | 534 | #endif |
535 | 535 | ||
536 | |||
536 | OPluginItem::List lst; | 537 | OPluginItem::List lst; |
537 | 538 | ||
538 | /* | 539 | /* |
539 | * get excluded list and then iterate over them | 540 | * get excluded list and then iterate over them |
540 | * Excluded list contains the name | 541 | * Excluded list contains the name |
541 | * Position is a list with 'name.pos.name.pos.name.pos' | 542 | * Position is a list with 'name.pos.name.pos.name.pos' |
542 | * | 543 | * |
543 | * For the look up we will create two QMap<QString,pos> | 544 | * For the look up we will create two QMap<QString,pos> |
544 | */ | 545 | */ |
545 | QMap<QString, int> positionMap; | 546 | QMap<QString, int> positionMap; |
546 | QMap<QString, int> excludedMap; | 547 | QMap<QString, int> excludedMap; |
547 | 548 | ||
548 | 549 | ||
549 | OConfig cfg( m_dir+"-odpplugins" ); | 550 | OConfig cfg( m_dir+"-odpplugins" ); |
550 | cfg.setGroup( _dir ); | 551 | cfg.setGroup( _dir ); |
551 | 552 | ||
552 | 553 | ||
553 | QStringList excludes = cfg.readListEntry( "Excluded", ',' ); | 554 | QStringList excludes = cfg.readListEntry( "Excluded", ',' ); |
554 | for ( QStringList::Iterator it = excludes.begin(); it != excludes.end(); ++it ) | 555 | for ( QStringList::Iterator it = excludes.begin(); it != excludes.end(); ++it ) |
555 | excludedMap.insert( *it, -2 ); | 556 | excludedMap.insert( *it, -2 ); |
556 | 557 | ||
557 | if ( m_isSorted ) { | 558 | if ( m_isSorted ) { |
558 | QStringList pos = cfg.readListEntry( "Positions", '.' ); | 559 | QStringList pos = cfg.readListEntry( "Positions", '.' ); |
559 | QStringList::Iterator it = pos.begin(); | 560 | QStringList::Iterator it = pos.begin(); |
560 | while ( it != pos.end() ) | 561 | while ( it != pos.end() ) |
561 | positionMap.insert( *it++, (*it++).toInt() ); | 562 | positionMap.insert( *it++, (*it++).toInt() ); |
562 | } | 563 | } |
563 | 564 | ||
564 | 565 | ||
565 | 566 | ||
566 | 567 | ||
567 | QStringList list = dir.entryList(); | 568 | QStringList list = dir.entryList(); |
568 | for (QStringList::Iterator it = list.begin(); it != list.end(); ++it ) { | 569 | for (QStringList::Iterator it = list.begin(); it != list.end(); ++it ) { |
569 | QString str = unlibify( *it ); | 570 | QString str = unlibify( *it ); |
570 | OPluginItem item( str, _dir + "/" + *it ); | 571 | OPluginItem item( str, _dir + "/" + *it ); |
571 | 572 | ||
572 | bool ex = excludedMap.contains( str ); | 573 | bool ex = excludedMap.contains( str ); |
573 | /* | 574 | /* |
574 | * if disabled but we should show all mark it as disabled | 575 | * if disabled but we should show all mark it as disabled |
575 | * else continue because we don't want to add the item | 576 | * else continue because we don't want to add the item |
576 | * else if sorted we assign the right position | 577 | * else if sorted we assign the right position |
577 | */ | 578 | */ |
578 | if ( ex && !disabled) | 579 | if ( ex && !disabled) |
579 | item.setEnabled( false ); | 580 | item.setEnabled( false ); |
580 | else if ( ex && disabled ) | 581 | else if ( ex && disabled ) |
581 | continue; | 582 | continue; |
582 | else if ( sorted ) | 583 | else if ( sorted ) |
583 | item.setPosition( positionMap[str] ); | 584 | item.setPosition( positionMap[str] ); |
584 | 585 | ||
585 | lst.append( item ); | 586 | lst.append( item ); |
586 | } | 587 | } |
587 | 588 | ||
588 | return lst; | 589 | return lst; |
589 | } | 590 | } |
590 | 591 | ||
591 | /** | 592 | /** |
592 | * @internal generate a list of languages from $LANG | 593 | * @internal generate a list of languages from $LANG |
593 | */ | 594 | */ |
594 | QStringList OGenericPluginLoader::languageList() { | 595 | QStringList OGenericPluginLoader::languageList() { |
595 | if ( m_languages.isEmpty() ) { | 596 | if ( m_languages.isEmpty() ) { |
596 | /* | 597 | /* |
597 | * be_BY.CP1251 We will add, be_BY.CP1251,be_BY,be | 598 | * be_BY.CP1251 We will add, be_BY.CP1251,be_BY,be |
598 | * to our list of languages. | 599 | * to our list of languages. |
599 | */ | 600 | */ |
600 | QString str = ::getenv( "LANG" ); | 601 | QString str = ::getenv( "LANG" ); |
601 | m_languages += str; | 602 | m_languages += str; |
602 | int pos = str.find( '.' ); | 603 | int pos = str.find( '.' ); |
603 | 604 | ||
604 | if ( pos > 0 ) | 605 | if ( pos > 0 ) |
605 | m_languages += str.left( pos ); | 606 | m_languages += str.left( pos ); |
606 | 607 | ||
607 | int n_pos = str.find( '_' ); | 608 | int n_pos = str.find( '_' ); |
608 | if ( pos > 0 && n_pos >= pos ) | 609 | if ( pos > 0 && n_pos >= pos ) |
609 | m_languages += str.left( n_pos ); | 610 | m_languages += str.left( n_pos ); |
610 | 611 | ||
611 | } | 612 | } |
612 | return m_languages; | 613 | return m_languages; |
613 | } | 614 | } |
614 | 615 | ||
615 | /** | 616 | /** |
616 | * @internal | 617 | * @internal |
617 | * Tries to install languages using the languageList for the type | 618 | * Tries to install languages using the languageList for the type |
618 | */ | 619 | */ |
619 | void OGenericPluginLoader::installTranslators(const QString& type) { | 620 | void OGenericPluginLoader::installTranslators(const QString& type) { |
620 | QStringList lst = languageList(); | 621 | QStringList lst = languageList(); |
621 | 622 | ||
622 | /* | 623 | /* |
623 | * for each language and maybe later for each language dir... | 624 | * for each language and maybe later for each language dir... |
624 | * try to load a Translator | 625 | * try to load a Translator |
625 | */ | 626 | */ |
626 | for ( QStringList::Iterator it = lst.begin(); it != lst.end(); ++it ) { | 627 | for ( QStringList::Iterator it = lst.begin(); it != lst.end(); ++it ) { |
627 | QTranslator* trans = new QTranslator( qApp ); | 628 | QTranslator* trans = new QTranslator( qApp ); |
628 | QString tfn = QPEApplication::qpeDir()+"/i18n/" + *it + "/" + type + ".qm" ; | 629 | QString tfn = QPEApplication::qpeDir()+"/i18n/" + *it + "/" + type + ".qm" ; |
629 | 630 | ||
630 | /* | 631 | /* |
631 | * If loaded then install else clean up and don't leak | 632 | * If loaded then install else clean up and don't leak |
632 | */ | 633 | */ |
633 | if ( trans->load( tfn ) ) | 634 | if ( trans->load( tfn ) ) |
634 | qApp->installTranslator( trans ); | 635 | qApp->installTranslator( trans ); |
635 | else | 636 | else |
636 | delete trans; | 637 | delete trans; |
637 | } | 638 | } |
638 | } | 639 | } |
639 | 640 | ||
640 | /** | 641 | /** |
641 | * \brief Simple c'tor. | 642 | * \brief Simple c'tor. |
642 | * | 643 | * |
643 | * Simple C'tor same as the one of the base class. Additional this | 644 | * Simple C'tor same as the one of the base class. Additional this |
644 | * class can cast for you if you nee it. | 645 | * class can cast for you if you nee it. |
645 | * | 646 | * |
646 | * | 647 | * |
647 | * @param name The name of your plugin class | 648 | * @param name The name of your plugin class |
648 | * @param sorted If plugins are sorted | 649 | * @param sorted If plugins are sorted |
649 | * | 650 | * |
650 | * @see OGenericPluginLoader | 651 | * @see OGenericPluginLoader |
651 | */ | 652 | */ |
652 | OPluginLoader::OPluginLoader( const QString& name, bool sorted ) | 653 | OPluginLoader::OPluginLoader( const QString& name, bool sorted ) |
653 | : OGenericPluginLoader( name, sorted ) | 654 | : OGenericPluginLoader( name, sorted ) |
654 | { | 655 | { |
655 | } | 656 | } |
656 | 657 | ||
657 | /** | 658 | /** |
658 | * d'tor | 659 | * d'tor |
659 | * @see OGenericPluginLoader::~OGenericPluginLoader | 660 | * @see OGenericPluginLoader::~OGenericPluginLoader |
660 | */ | 661 | */ |
661 | OPluginLoader::~OPluginLoader() { | 662 | OPluginLoader::~OPluginLoader() { |
662 | } | 663 | } |
663 | 664 | ||
664 | /** | 665 | /** |
665 | * \brief C'Tor using a OGenericPluginLoader | 666 | * \brief C'Tor using a OGenericPluginLoader |
666 | * The C'tor. Pass your OGenericPluginLoader to manage | 667 | * The C'tor. Pass your OGenericPluginLoader to manage |
667 | * OGenericPluginLoader::allAvailable plugins. | 668 | * OGenericPluginLoader::allAvailable plugins. |
668 | * | 669 | * |
669 | * | 670 | * |
670 | * @param loader A Pointer to your OGenericPluginLoader | 671 | * @param loader A Pointer to your OGenericPluginLoader |
671 | * @param name The name | 672 | * @param name The name |
672 | */ | 673 | */ |
673 | OPluginManager::OPluginManager( OGenericPluginLoader* loader) | 674 | OPluginManager::OPluginManager( OGenericPluginLoader* loader) |
674 | : m_loader( loader ), m_isSorted( false ) | 675 | : m_loader( loader ), m_isSorted( false ) |
675 | { | 676 | { |
676 | } | 677 | } |
677 | 678 | ||
678 | /** | 679 | /** |
679 | * \brief Overloaded c'tor using a List of Plugins and a type name | 680 | * \brief Overloaded c'tor using a List of Plugins and a type name |
680 | * Overloaded Constructor to work with a 'Type' of plugins | 681 | * Overloaded Constructor to work with a 'Type' of plugins |
681 | * and a correspending list of those. In this case calling load | 682 | * and a correspending list of those. In this case calling load |
682 | * is a no operation. | 683 | * is a no operation. |
683 | * | 684 | * |
684 | * @param name The name of your plugin ('today','inputmethods','applets') | 685 | * @param name The name of your plugin ('today','inputmethods','applets') |
685 | * @param lst A List with plugins of your type to manage | 686 | * @param lst A List with plugins of your type to manage |
686 | * @param isSorted If the List should be treated sorted | 687 | * @param isSorted If the List should be treated sorted |
687 | */ | 688 | */ |
688 | OPluginManager::OPluginManager( const QString& name, const OPluginItem::List& lst, bool isSorted) | 689 | OPluginManager::OPluginManager( const QString& name, const OPluginItem::List& lst, bool isSorted) |
689 | : m_loader( 0l ), m_cfgName( name ), m_plugins( lst ), m_isSorted( isSorted ) | 690 | : m_loader( 0l ), m_cfgName( name ), m_plugins( lst ), m_isSorted( isSorted ) |
690 | { | 691 | { |
691 | } | 692 | } |
692 | 693 | ||
693 | /** | 694 | /** |
694 | * \brief A simple d'tor | 695 | * \brief A simple d'tor |
695 | */ | 696 | */ |
696 | OPluginManager::~OPluginManager() { | 697 | OPluginManager::~OPluginManager() { |
697 | } | 698 | } |
698 | 699 | ||
699 | /** | 700 | /** |
700 | * \brief Return the OPluginItem where loading is likely to have crashed on. | 701 | * \brief Return the OPluginItem where loading is likely to have crashed on. |
701 | 702 | ||
702 | * Return the Item that made the OGenericPluginLoader crash | 703 | * Return the Item that made the OGenericPluginLoader crash |
703 | * the returned OPluginItem could be empty if no crash occured | 704 | * the returned OPluginItem could be empty if no crash occured |
704 | * which should apply most of the time. It could also be empty if the crashed | 705 | * which should apply most of the time. It could also be empty if the crashed |
705 | * plugin is not in the current list of available/managed plugins | 706 | * plugin is not in the current list of available/managed plugins |
706 | * | 707 | * |
707 | * @see OPluginItem::isEmpty | 708 | * @see OPluginItem::isEmpty |
708 | * @return OPluginItem that crashed the loader | 709 | * @return OPluginItem that crashed the loader |
709 | */ | 710 | */ |
710 | OPluginItem OPluginManager::crashedPlugin()const { | 711 | OPluginItem OPluginManager::crashedPlugin()const { |
711 | return m_crashed; | 712 | return m_crashed; |
712 | } | 713 | } |
713 | 714 | ||
714 | /** | 715 | /** |
715 | * \brief Return a list of plugins that are managed by this OPluginManager | 716 | * \brief Return a list of plugins that are managed by this OPluginManager |
716 | * | 717 | * |
717 | * Return the list of managed plugins. This could either result | 718 | * Return the list of managed plugins. This could either result |
718 | * from passing a OGenericPluginLoader and calling load or by | 719 | * from passing a OGenericPluginLoader and calling load or by |
719 | * giving name and a list of plugins. | 720 | * giving name and a list of plugins. |
720 | */ | 721 | */ |
721 | OPluginItem::List OPluginManager::managedPlugins()const { | 722 | OPluginItem::List OPluginManager::managedPlugins()const { |
722 | return m_plugins; | 723 | return m_plugins; |
723 | } | 724 | } |
724 | 725 | ||
725 | /** | 726 | /** |
726 | * \brief Set the position of the items | 727 | * \brief Set the position of the items |
727 | * | 728 | * |
728 | * Replace the OPluginItem with the name and path and this way | 729 | * Replace the OPluginItem with the name and path and this way |
729 | * apply the new position. The search is linear and this way O(n/2) | 730 | * apply the new position. The search is linear and this way O(n/2) |
730 | * You still need to call save() to make your changes effective. After saving | 731 | * You still need to call save() to make your changes effective. After saving |
731 | * a call to OGenericPluginLoader::filtered() returns the newly configured order and items | 732 | * a call to OGenericPluginLoader::filtered() returns the newly configured order and items |
732 | * | 733 | * |
733 | * @param item The OPluginItem to be replaced internall | 734 | * @param item The OPluginItem to be replaced internall |
734 | * | 735 | * |
735 | */ | 736 | */ |
736 | void OPluginManager::setPosition( const OPluginItem& item) { | 737 | void OPluginManager::setPosition( const OPluginItem& item) { |
737 | replace( item ); | 738 | replace( item ); |
738 | } | 739 | } |
739 | 740 | ||
740 | /** | 741 | /** |
741 | * \brief Enable the item specified as argument | 742 | * \brief Enable the item specified as argument |
742 | * | 743 | * |
743 | * This will make sure that OPluginItem::setEnabled is called and then will replace | 744 | * This will make sure that OPluginItem::setEnabled is called and then will replace |
744 | * the item with one that matches name and path internally. | 745 | * the item with one that matches name and path internally. |
745 | * @see setPosition | 746 | * @see setPosition |
746 | * | 747 | * |
747 | * @param the Item to enable | 748 | * @param the Item to enable |
748 | */ | 749 | */ |
749 | void OPluginManager::enable( const OPluginItem& item ) { | 750 | void OPluginManager::enable( const OPluginItem& item ) { |
750 | setEnabled( item, true ); | 751 | setEnabled( item, true ); |
751 | } | 752 | } |
752 | 753 | ||
753 | /** | 754 | /** |
754 | * \brief disable the Item. | 755 | * \brief disable the Item. |
755 | * | 756 | * |
756 | * Disable the OPluginItem. Same applies as in | 757 | * Disable the OPluginItem. Same applies as in |
757 | * @see setPosition and @see enable | 758 | * @see setPosition and @see enable |
758 | * | 759 | * |
759 | * @param item Item to disable | 760 | * @param item Item to disable |
760 | */ | 761 | */ |
761 | void OPluginManager::disable( const OPluginItem& item) { | 762 | void OPluginManager::disable( const OPluginItem& item) { |
762 | setEnabled( item, false ); | 763 | setEnabled( item, false ); |
763 | } | 764 | } |
764 | 765 | ||
765 | /** | 766 | /** |
766 | * \brief Enable or disable the OPluginItem. | 767 | * \brief Enable or disable the OPluginItem. |
767 | * Depending on the value of the parameter this will either disable | 768 | * Depending on the value of the parameter this will either disable |
768 | * or enable the pluginitem. | 769 | * or enable the pluginitem. |
769 | * Beside that same as in @see disable, @see enable, @see setPosition | 770 | * Beside that same as in @see disable, @see enable, @see setPosition |
770 | * applies. | 771 | * applies. |
771 | * | 772 | * |
772 | * @param _item The OPluginItem to enable or to disable. | 773 | * @param _item The OPluginItem to enable or to disable. |
773 | * @param b Enable or disable the plugin. | 774 | * @param b Enable or disable the plugin. |
774 | * | 775 | * |
775 | */ | 776 | */ |
776 | void OPluginManager::setEnabled( const OPluginItem& _item, bool b ) { | 777 | void OPluginManager::setEnabled( const OPluginItem& _item, bool b ) { |
777 | OPluginItem item = _item; | 778 | OPluginItem item = _item; |
778 | item.setEnabled( b ); | 779 | item.setEnabled( b ); |
779 | replace( item ); | 780 | replace( item ); |
780 | } | 781 | } |
781 | 782 | ||
782 | /** | 783 | /** |
783 | * \brief Load necessary information after constructing the object | 784 | * \brief Load necessary information after constructing the object |
784 | * If you speified a OGenericPluginLoader you need to call this method | 785 | * If you speified a OGenericPluginLoader you need to call this method |
785 | * so that this manager knows what to manage and have a right value for \sa crashedPlugin | 786 | * so that this manager knows what to manage and have a right value for \sa crashedPlugin |
786 | * For the name and the list of plugins this does only try to find out the crashed plugin | 787 | * For the name and the list of plugins this does only try to find out the crashed plugin |
787 | */ | 788 | */ |
788 | void OPluginManager::load() { | 789 | void OPluginManager::load() { |
789 | OConfig cfg( configName() ); | 790 | OConfig cfg( configName() ); |
790 | cfg.setGroup( "General" ); | 791 | cfg.setGroup( "General" ); |
791 | QString crashedPath = cfg.readEntry( "CrashedPlugin" ); | 792 | QString crashedPath = cfg.readEntry( "CrashedPlugin" ); |