• Skip to content
  • Skip to link menu
KDE 4.1 API Reference
  • KDE API Reference
  • kdelibs
  • Sitemap
  • Contact Us
 

KDECore

kservicefactory.cpp

Go to the documentation of this file.
00001 /*  This file is part of the KDE libraries
00002  *  Copyright (C) 1999-2006 David Faure <faure@kde.org>
00003  *
00004  *  This library is free software; you can redistribute it and/or
00005  *  modify it under the terms of the GNU Library General Public
00006  *  License version 2 as published by the Free Software Foundation;
00007  *
00008  *  This library is distributed in the hope that it will be useful,
00009  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
00010  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00011  *  Library General Public License for more details.
00012  *
00013  *  You should have received a copy of the GNU Library General Public License
00014  *  along with this library; see the file COPYING.LIB.  If not, write to
00015  *  the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
00016  *  Boston, MA 02110-1301, USA.
00017  **/
00018 
00019 #include "kservicefactory.h"
00020 #include "ksycoca.h"
00021 #include "ksycocatype.h"
00022 #include "ksycocadict.h"
00023 #include "kservice.h"
00024 
00025 #include <QtCore/QCharRef>
00026 
00027 #include <klocale.h>
00028 #include <kdebug.h>
00029 #include <kglobal.h>
00030 #include <kstandarddirs.h>
00031 
00032 KServiceFactory::KServiceFactory()
00033     : KSycocaFactory( KST_KServiceFactory )
00034 {
00035     m_offerListOffset = 0;
00036     m_nameDictOffset = 0;
00037     m_relNameDictOffset = 0;
00038     m_menuIdDictOffset = 0;
00039     if (m_str)
00040     {
00041         // Read Header
00042         qint32 i;
00043         (*m_str) >> i;
00044         m_nameDictOffset = i;
00045         (*m_str) >> i;
00046         m_relNameDictOffset = i;
00047         (*m_str) >> i;
00048         m_offerListOffset = i;
00049         (*m_str) >> i;
00050         m_menuIdDictOffset = i;
00051 
00052         const int saveOffset = m_str->device()->pos();
00053         // Init index tables
00054         m_nameDict = new KSycocaDict(m_str, m_nameDictOffset);
00055         // Init index tables
00056         m_relNameDict = new KSycocaDict(m_str, m_relNameDictOffset);
00057         // Init index tables
00058         m_menuIdDict = new KSycocaDict(m_str, m_menuIdDictOffset);
00059         m_str->device()->seek(saveOffset);
00060     }
00061     else
00062     {
00063         // Build new database
00064         m_nameDict = new KSycocaDict();
00065         m_relNameDict = new KSycocaDict();
00066         m_menuIdDict = new KSycocaDict();
00067     }
00068     _self = this;
00069 }
00070 
00071 KServiceFactory::~KServiceFactory()
00072 {
00073     _self = 0;
00074     delete m_nameDict;
00075     delete m_relNameDict;
00076     delete m_menuIdDict;
00077 }
00078 
00079 KServiceFactory * KServiceFactory::self()
00080 {
00081     if (!_self) {
00082         _self = new KServiceFactory();
00083     }
00084     return _self;
00085 }
00086 
00087 KService::Ptr KServiceFactory::findServiceByName(const QString &_name)
00088 {
00089     if (!sycocaDict()) return KService::Ptr(); // Error!
00090 
00091     // Warning : this assumes we're NOT building a database
00092     // But since findServiceByName isn't called in that case...
00093     // [ see KServiceTypeFactory for how to do it if needed ]
00094 
00095     int offset = sycocaDict()->find_string( _name );
00096     if (!offset) return KService::Ptr(); // Not found
00097 
00098     KService::Ptr newService(createEntry(offset));
00099 
00100     // Check whether the dictionary was right.
00101     if (newService && (newService->name() != _name)) {
00102         // No it wasn't...
00103         return KService::Ptr();
00104     }
00105     return newService;
00106 }
00107 
00108 KService::Ptr KServiceFactory::findServiceByDesktopName(const QString &_name)
00109 {
00110     if (!m_nameDict) return KService::Ptr(); // Error!
00111 
00112     // Warning : this assumes we're NOT building a database
00113     // KBuildServiceFactory reimplements it for the case where we are building one
00114 
00115     int offset = m_nameDict->find_string( _name );
00116     if (!offset) return KService::Ptr(); // Not found
00117 
00118     KService::Ptr newService(createEntry(offset));
00119 
00120     // Check whether the dictionary was right.
00121     if (newService && (newService->desktopEntryName() != _name)) {
00122         // No it wasn't...
00123         return KService::Ptr();
00124     }
00125     return newService;
00126 }
00127 
00128 KService::Ptr KServiceFactory::findServiceByDesktopPath(const QString &_name)
00129 {
00130     if (!m_relNameDict) return KService::Ptr(); // Error!
00131 
00132     // Warning : this assumes we're NOT building a database
00133     // KBuildServiceFactory reimplements it for the case where we are building one
00134 
00135     int offset = m_relNameDict->find_string( _name );
00136     if (!offset) {
00137         qDebug( "findServiceByDesktopPath: %s not found", qPrintable( _name ) );
00138         return KService::Ptr(); // Not found
00139     }
00140 
00141     KService::Ptr newService(createEntry(offset));
00142     if ( !newService )
00143         qDebug( "findServiceByDesktopPath: createEntry failed!" );
00144     // Check whether the dictionary was right
00145     // It's ok that it's wrong, for the case where we're looking up an unknown service,
00146     // and the hash value gave us another one.
00147     if (newService && (newService->entryPath() != _name)) {
00148         // No it wasn't...
00149         return KService::Ptr();
00150     }
00151     return newService;
00152 }
00153 
00154 KService::Ptr KServiceFactory::findServiceByMenuId(const QString &_menuId)
00155 {
00156     if (!m_menuIdDict) return KService::Ptr(); // Error!
00157 
00158     // Warning : this assumes we're NOT building a database
00159     // KBuildServiceFactory reimplements it for the case where we are building one
00160 
00161     int offset = m_menuIdDict->find_string( _menuId );
00162     if (!offset) return KService::Ptr(); // Not found
00163 
00164     KService::Ptr newService(createEntry(offset));
00165 
00166     // Check whether the dictionary was right.
00167     if (newService && (newService->menuId() != _menuId)) {
00168         // No it wasn't...
00169         return KService::Ptr();
00170     }
00171     return newService;
00172 }
00173 
00174 KService* KServiceFactory::createEntry(int offset) const
00175 {
00176     KService * newEntry = 0L;
00177     KSycocaType type;
00178     QDataStream *str = KSycoca::self()->findEntry(offset, type);
00179     switch(type) {
00180     case KST_KService:
00181         newEntry = new KService(*str, offset);
00182         break;
00183 
00184     default:
00185         kError(7011) << QString("KServiceFactory: unexpected object entry in KSycoca database (type = %1)").arg((int)type) << endl;
00186         return 0;
00187     }
00188     if (!newEntry->isValid())
00189     {
00190         kError(7011) << "KServiceFactory: corrupt object in KSycoca database!\n" << endl;
00191         delete newEntry;
00192         newEntry = 0;
00193     }
00194     return newEntry;
00195 }
00196 
00197 KService::List KServiceFactory::allServices()
00198 {
00199     KService::List result;
00200     const KSycocaEntry::List list = allEntries();
00201     KSycocaEntry::List::const_iterator it = list.begin();
00202     const KSycocaEntry::List::const_iterator end = list.end();
00203     for( ; it != end; ++it ) {
00204         const KSycocaEntry::Ptr entry = *it;
00205         if ( entry->isType( KST_KService ) )
00206             result.append( KService::Ptr::staticCast( entry ) );
00207     }
00208     return result;
00209 }
00210 
00211 QList<KServiceOffer> KServiceFactory::offers( int serviceTypeOffset, int serviceOffersOffset )
00212 {
00213     QList<KServiceOffer> list;
00214 
00215     // Jump to the offer list
00216     m_str->device()->seek( m_offerListOffset + serviceOffersOffset );
00217 
00218     qint32 aServiceTypeOffset, aServiceOffset, initialPreference, mimeTypeInheritanceLevel;
00219     while (true)
00220     {
00221         (*m_str) >> aServiceTypeOffset;
00222         if ( aServiceTypeOffset ) {
00223             (*m_str) >> aServiceOffset;
00224             (*m_str) >> initialPreference;
00225             (*m_str) >> mimeTypeInheritanceLevel;
00226             if ( aServiceTypeOffset == serviceTypeOffset ) {
00227                 // Save stream position !
00228                 const int savedPos = m_str->device()->pos();
00229                 // Create Service
00230                 KService * serv = createEntry( aServiceOffset );
00231                 if (serv) {
00232                     KService::Ptr servPtr( serv );
00233                     list.append( KServiceOffer( servPtr, initialPreference, mimeTypeInheritanceLevel, servPtr->allowAsDefault() ) );
00234                 }
00235                 // Restore position
00236                 m_str->device()->seek( savedPos );
00237             } else
00238                 break; // too far
00239         }
00240         else
00241             break; // 0 => end of list
00242     }
00243     return list;
00244 }
00245 
00246 KService::List KServiceFactory::serviceOffers( int serviceTypeOffset, int serviceOffersOffset )
00247 {
00248     KService::List list;
00249 
00250     // Jump to the offer list
00251     m_str->device()->seek( m_offerListOffset + serviceOffersOffset );
00252 
00253     qint32 aServiceTypeOffset, aServiceOffset, initialPreference, mimeTypeInheritanceLevel;
00254     while (true) {
00255         (*m_str) >> aServiceTypeOffset;
00256         if ( aServiceTypeOffset )
00257         {
00258             (*m_str) >> aServiceOffset;
00259             (*m_str) >> initialPreference;
00260             (*m_str) >> mimeTypeInheritanceLevel;
00261             if ( aServiceTypeOffset == serviceTypeOffset )
00262             {
00263                 // Save stream position !
00264                 const int savedPos = m_str->device()->pos();
00265                 // Create service
00266                 KService * serv = createEntry( aServiceOffset );
00267                 if (serv)
00268                     list.append( KService::Ptr( serv ) );
00269                 // Restore position
00270                 m_str->device()->seek( savedPos );
00271             } else
00272                 break; // too far
00273         }
00274         else
00275             break; // 0 => end of list
00276     }
00277     return list;
00278 }
00279 
00280 bool KServiceFactory::hasOffer( int serviceTypeOffset, int serviceOffersOffset, int testedServiceOffset )
00281 {
00282     // Save stream position
00283     const int savedPos = m_str->device()->pos();
00284 
00285     // Jump to the offer list
00286     m_str->device()->seek( m_offerListOffset + serviceOffersOffset );
00287     bool found = false;
00288     qint32 aServiceTypeOffset, aServiceOffset, initialPreference, mimeTypeInheritanceLevel;
00289     while (!found)
00290     {
00291         (*m_str) >> aServiceTypeOffset;
00292         if ( aServiceTypeOffset ) {
00293             (*m_str) >> aServiceOffset;
00294             (*m_str) >> initialPreference;
00295             (*m_str) >> mimeTypeInheritanceLevel;
00296             if ( aServiceTypeOffset == serviceTypeOffset )
00297             {
00298                 if( aServiceOffset == testedServiceOffset )
00299                     found = true;
00300             } else
00301                 break; // too far
00302         }
00303         else
00304             break; // 0 => end of list
00305     }
00306     // Restore position
00307     m_str->device()->seek( savedPos );
00308     return found;
00309 }
00310 
00311 KServiceFactory *KServiceFactory::_self = 0;
00312 
00313 void KServiceFactory::virtual_hook( int id, void* data )
00314 { KSycocaFactory::virtual_hook( id, data ); }
00315 

KDECore

Skip menu "KDECore"
  • Main Page
  • Modules
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

kdelibs

Skip menu "kdelibs"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • Kate
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • KIO
  • KIOSlave
  • KJS
  •   KJS-API
  •   WTF
  • kjsembed
  • KNewStuff
  • KParts
  • Kross
  • KUtils
  • Nepomuk
  • Solid
  • Sonnet
  • ThreadWeaver
Generated for kdelibs by doxygen 1.5.4
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal