/****************************************************************************

**

** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

** All rights reserved.

** Contact: Nokia Corporation (qt-info@nokia.com)

**

** This file is part of the Qt Mobility Components.

**

** $QT_BEGIN_LICENSE:LGPL$

** No Commercial Usage

** This file contains pre-release code and may not be distributed.

** You may use this file in accordance with the terms and conditions

** contained in the Technology Preview License Agreement accompanying

** this package.

**

** GNU Lesser General Public License Usage

** Alternatively, this file may be used under the terms of the GNU Lesser

** General Public License version 2.1 as published by the Free Software

** Foundation and appearing in the file LICENSE.LGPL included in the

** packaging of this file.  Please review the following information to

** ensure the GNU Lesser General Public License version 2.1 requirements

** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

**

** In addition, as a special exception, Nokia gives you certain additional

** rights.  These rights are described in the Nokia Qt LGPL Exception

** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

**

** If you have questions regarding the use of this file, please contact

** Nokia at qt-info@nokia.com.

**

**

**

**

**

**

**

**

** $QT_END_LICENSE$

**

****************************************************************************/

#include "databasemanager_p.h"

#include "qserviceinterfacedescriptor_p.h"

#include <QFileSystemWatcher>

#include <QHash>

QTM_BEGIN_NAMESPACE

DatabaseFileWatcher::DatabaseFileWatcher(DatabaseManager *parent)

    : QObject(parent),

      m_manager(parent),

      m_watcher(0)

{

}

QString DatabaseFileWatcher::closestExistingParent(const QString &path)

{

    if (QFile::exists(path))

        return path;

    int lastSep = path.lastIndexOf(QDir::separator());

    if (lastSep < 0)

        return QString();

    return closestExistingParent(path.mid(0, lastSep));

}

void DatabaseFileWatcher::restartDirMonitoring(const QString &dbPath, const QString &previousDirPath)

{

    if (m_watcher->files().contains(dbPath))

        return;

    QString existing = closestExistingParent(dbPath);

    if (existing.isEmpty()) {

        qWarning() << "QServiceManager: can't find existing directory for path to database" << dbPath

            << "serviceAdded() and serviceRemoved() will not be emitted";

        return;

    }

    if (existing == dbPath) {

        ServiceDatabase *db = 0;

        DatabaseManager::DbScope scope;

        if (dbPath == m_manager->m_userDb->databasePath()) {

            db = m_manager->m_userDb;

            scope = DatabaseManager::UserOnlyScope;

        } else if (dbPath == m_manager->m_systemDb->databasePath()) {

            db = m_manager->m_systemDb;

            scope = DatabaseManager::SystemScope;

        }

        if (db) {

            if (!previousDirPath.isEmpty())

                m_watcher->removePath(previousDirPath);

            QMutableListIterator<QString> i(m_monitoredDbPaths);

            while (i.hasNext()) {

                if (i.next() == dbPath)

                    i.remove();

            }

            QStringList newServices = m_manager->getServiceNames(QString(), scope);

            for (int i=0; i<newServices.count(); i++)

                emit m_manager->serviceAdded(newServices[i], scope);

            setEnabled(db, true);

        }

    } else {

        if (previousDirPath != existing) {

            if (!previousDirPath.isEmpty())

                m_watcher->removePath(previousDirPath);

            if (!m_watcher->directories().contains(existing))

                m_watcher->addPath(existing);

            if (!m_monitoredDbPaths.contains(dbPath))

                m_monitoredDbPaths << dbPath;

        }

    }

}

void DatabaseFileWatcher::setEnabled(ServiceDatabase *database, bool enabled)

{

    if (!m_watcher) {

        m_watcher = new QFileSystemWatcher(this);

        connect(m_watcher, SIGNAL(fileChanged(QString)),

            SLOT(databaseChanged(QString)));

        connect(m_watcher, SIGNAL(directoryChanged(QString)),

            SLOT(databaseDirectoryChanged(QString)));

    }

    QString path = database->databasePath();

    if (enabled) {

        if (QFile::exists(path)) {

            m_knownServices[path] = database->getServiceNames(QString());

            m_watcher->addPath(path);

        } else {

            restartDirMonitoring(path, QString());

        }

    } else {

        m_watcher->removePath(path);

        m_knownServices.remove(path);

    }

}

void DatabaseFileWatcher::databaseDirectoryChanged(const QString &path)

{

    for (int i=0; i<m_monitoredDbPaths.count(); i++) {

        if (m_monitoredDbPaths[i].contains(path))

            restartDirMonitoring(m_monitoredDbPaths[i], path);

    }

}

void DatabaseFileWatcher::databaseChanged(const QString &path)

{

    if (path == m_manager->m_userDb->databasePath())

        notifyChanges(m_manager->m_userDb, DatabaseManager::UserScope);

    else if (path == m_manager->m_systemDb->databasePath())

        notifyChanges(m_manager->m_systemDb, DatabaseManager::SystemScope);

    // if database was deleted, the path may have been dropped

    if (!m_watcher->files().contains(path) && QFile::exists(path))

        m_watcher->addPath(path);

}

void DatabaseFileWatcher::notifyChanges(ServiceDatabase *database, DatabaseManager::DbScope scope)

{

    QString dbPath = database->databasePath();

    if (!QFile::exists(dbPath)) {

        m_knownServices.remove(dbPath);

        restartDirMonitoring(dbPath, QString());

        return;

    }

    QStringList currentServices = database->getServiceNames(QString());

    if (database->lastError().code() !=DBError::NoError) {

        qWarning("QServiceManager: failed to get current service names for serviceAdded() and serviceRemoved() signals");

        return;

    }

    const QStringList &knownServicesRef = m_knownServices[dbPath];

    QSet<QString> currentServicesSet = currentServices.toSet();

    QSet<QString> knownServicesSet = knownServicesRef.toSet();

    if (currentServicesSet == knownServicesSet)

        return;

    QStringList newServices;

    for (int i=0; i<currentServices.count(); i++) {

        if (!knownServicesSet.contains(currentServices[i]))

            newServices << currentServices[i];

    }

    QStringList removedServices;

    for (int i=0; i<knownServicesRef.count(); i++) {

        if (!currentServicesSet.contains(knownServicesRef[i]))

            removedServices << knownServicesRef[i];

    }

    m_knownServices[dbPath] = currentServices;

    for (int i=0; i<newServices.count(); i++)

        emit m_manager->serviceAdded(newServices[i], scope);

    for (int i=0; i<removedServices.count(); i++)

        emit m_manager->serviceRemoved(removedServices[i], scope);

}

bool lessThan(const QServiceInterfaceDescriptor &d1,

                                        const QServiceInterfaceDescriptor &d2)

{

        return (d1.majorVersion() < d2.majorVersion())

                || ( d1.majorVersion() == d2.majorVersion()

                && d1.minorVersion() < d2.minorVersion());

}

/*

    \class DatabaseManager

    The database manager is responsible for receiving queries about

    services and managing user and system scope databases in order to

    respond to those queries.

    It provides operations for

    - registering and unregistering services

    - querying for services and interfaces

    - setting and getting default interface implementations

    and provides notifications by emitting signals for added

    or removed services.

    Implementation note:

    When one of the above operations is first invoked a connection with the

    appropriate database(s) is opened.  This connection remains

    open until the DatabaseManager is destroyed.

    If the system scope database cannot be opened when performing

    user scope operations.  The operations are carried out as per normal

    but only acting on the user scope database.  Each operation invokation

    will try to open a connection with the system scope database.

    Terminology note:

    When referring to user scope regarding operations, it generally

    means access to both the user and system databases with the

    data from both combined into a single dataset.

    When referring to a user scope database it means the

    user database only.

*/

/*

   Constructor

*/

DatabaseManager::DatabaseManager()

    : m_userDb(new ServiceDatabase),

      m_systemDb(new ServiceDatabase),

      m_fileWatcher(0),

      m_hasAccessedUserDb(false),

      m_alreadyWarnedOpenError(false)

{

    initDbPath(UserScope);

    initDbPath(SystemScope);

}

/*

   Destructor

*/

DatabaseManager::~DatabaseManager()

{

    delete m_fileWatcher;

    m_fileWatcher = 0;

    //Aside: databases are implicitly closed

    //during deletion

    delete m_userDb;

    m_userDb = 0;

    delete m_systemDb;

    m_systemDb = 0;

}

/*

    Initialises database path of m_userDb

    or m_systemDb, but does not open any

    database connections

*/

void DatabaseManager::initDbPath(DbScope scope)

{

    QSettings::Scope settingsScope;

    QString dbIdentifier;

    ServiceDatabase *db;

    if (scope == SystemScope) {

        settingsScope = QSettings::SystemScope;

        dbIdentifier = "_system";

        db = m_systemDb;

    } else {

        settingsScope = QSettings::UserScope;

        dbIdentifier = "_user";

        db = m_userDb;

    }

    QSettings settings(QSettings::IniFormat, settingsScope,

            QLatin1String("Nokia"), QLatin1String("QtServiceFramework"));

    QFileInfo fi(settings.fileName());

    QDir dir = fi.dir();

    QString qtVersion(qVersion());

    qtVersion = qtVersion.left(qtVersion.size() -2); //strip off patch version

    QString dbName = QString("QtServiceFramework_") + qtVersion + dbIdentifier + QLatin1String(".db");

    db->setDatabasePath(dir.path() + QDir::separator() + dbName);

}

/*

    Adds the details \a  service into the service database corresponding to

    \a scope.

    Returns true if the operation succeeded and false otherwise.

    The last error is set when this function is called.

*/

bool DatabaseManager::registerService(ServiceMetaDataResults &service, DbScope scope)

{

    if (scope == DatabaseManager::SystemScope) {

        if(!openDb(DatabaseManager::SystemScope)) {

            return false;

        }  else {

            if (!m_systemDb->registerService(service)) {

                m_lastError = m_systemDb->lastError();

                return false;

            } else { //must be successful registration

                m_lastError.setError(DBError::NoError);

                return true;

            }

        }

    } else { //must  be registering service at user scope

        if (!openDb(DatabaseManager::UserScope)) {

            return false;

        } else {

            if (!m_userDb->registerService(service)) {

                m_lastError = m_userDb->lastError();

                return false;

            } else { //must be successful registration

                m_lastError.setError(DBError::NoError);

                return true;

            }

        }

    }

}

/*

    Removes the details of \serviceName from the database corresponding to \a

    scope.

    Returns true if the operation succeeded, false otherwise.

    The last error is set when this function is called.

*/

bool DatabaseManager::unregisterService(const QString &serviceName, DbScope scope)

{

    if(scope == DatabaseManager::SystemScope) {

        if (!openDb(DatabaseManager::SystemScope))

            return false;

   else {

            if (!m_systemDb->unregisterService(serviceName)) {

                m_lastError = m_systemDb->lastError();

                return false;

            } else { //must be successful unregistration

                m_lastError.setError(DBError::NoError);

                return true;

            }

        }

    } else {

        if (!openDb(DatabaseManager::UserScope)) {

            return false;

        } else {

            if (!m_userDb->unregisterService(serviceName)){

                m_lastError = m_userDb->lastError();

                return false;

            } else { //must be successful unregistration

                m_lastError.setError(DBError::NoError);

                return true;

            }

        }

    }

}

/*

    Retrieves a list of interface descriptors that fulfill the constraints specified

    by \a filter at a given \a scope.

    The last error is set when this function is called.

*/

QList<QServiceInterfaceDescriptor>  DatabaseManager::getInterfaces(const QServiceFilter &filter, DbScope scope)

{

    QList<QServiceInterfaceDescriptor> descriptors;

    int userDescriptorCount = 0;

    if (scope == UserScope) {

        if (!openDb(UserScope))

            return descriptors;

        descriptors =  m_userDb->getInterfaces(filter);

        if (m_userDb->lastError().code() != DBError::NoError ) {

            descriptors.clear();

            m_lastError = m_userDb->lastError();

            return descriptors;

        }

        userDescriptorCount = descriptors.count();

        for (int i=0; i < userDescriptorCount; ++i) {

            descriptors[i].d->scope = QService::UserScope;

        }

    }

    if (openDb(SystemScope)) {

        descriptors.append(m_systemDb->getInterfaces(filter));

        if (m_systemDb->lastError().code() != DBError::NoError) {

            descriptors.clear();

            m_lastError = m_systemDb->lastError();

            return descriptors;

        }

        for (int i = userDescriptorCount; i < descriptors.count(); ++i) {

            descriptors[i].d->scope = QService::SystemScope;

        }

    } else {

        if ( scope == SystemScope) {

            //openDb() should already have handled lastError

            descriptors.clear();

            return descriptors;

        }

    }

    m_lastError.setError(DBError::NoError);

    return descriptors;

}

/*

    Retrieves a list of the names of services that provide the interface

    specified by \a interfaceName.

    The last error is set when this function is called.

*/

QStringList DatabaseManager::getServiceNames(const QString &interfaceName, DatabaseManager::DbScope scope)

{

    QStringList serviceNames;

    if (scope == UserScope || scope == UserOnlyScope) {

        if(!openDb(DatabaseManager::UserScope))

            return serviceNames;

        serviceNames = m_userDb->getServiceNames(interfaceName);

        if(m_userDb->lastError().code() != DBError::NoError) {

            serviceNames.clear();

            m_lastError = m_userDb->lastError();

            return serviceNames;

        }

        if (scope == UserOnlyScope) {

            m_lastError.setError(DBError::NoError);

            return serviceNames;

        }

    }

    if(openDb(DatabaseManager::SystemScope)) {

        QStringList systemServiceNames;

        systemServiceNames = m_systemDb->getServiceNames(interfaceName);

        if(m_systemDb->lastError().code() != DBError::NoError) {

            serviceNames.clear();

            m_lastError = m_systemDb->lastError();

            return serviceNames;

        }

        foreach(const QString &systemServiceName, systemServiceNames) {

            if(!serviceNames.contains(systemServiceName, Qt::CaseInsensitive))

                serviceNames.append(systemServiceName);

        }

    } else {

        if ( scope == SystemScope) {

            //openDb() should have already handled lastError

            serviceNames.clear();

            return serviceNames;

        }

    }

    m_lastError.setError(DBError::NoError);

    return serviceNames;

}

/*

    Returns the default interface implementation descriptor for a given

    \a interfaceName and \a scope.

    The last error is set when this function is called.

*/

QServiceInterfaceDescriptor DatabaseManager::interfaceDefault(const QString &interfaceName, DbScope scope)

{

    QServiceInterfaceDescriptor descriptor;

    if (scope == UserScope) {

        if (!openDb(UserScope))

            return QServiceInterfaceDescriptor();

        QString interfaceID;

        descriptor = m_userDb->interfaceDefault(interfaceName, &interfaceID);

        if (m_userDb->lastError().code() == DBError::NoError) {

            descriptor.d->scope = QService::UserScope;

            return descriptor;

        } else if (m_userDb->lastError().code() == DBError::ExternalIfaceIDFound) {

            //default hasn't been found in user db, but we have found an ID

            //that may refer to an interface implementation in the system db

            if (!openDb(SystemScope)) {

                QString errorText("No default service found for interface: \"%1\"");

                m_lastError.setError(DBError::NotFound, errorText.arg(interfaceName));

                return QServiceInterfaceDescriptor();

            }

            descriptor = m_systemDb->getInterface(interfaceID);

            //found the service from the system database

            if (m_systemDb->lastError().code() == DBError::NoError) {

                m_lastError.setError(DBError::NoError);

                descriptor.d->scope = QService::SystemScope;

                return descriptor;

            } else if(m_systemDb->lastError().code() == DBError::NotFound){

                //service implementing interface doesn't exist in the system db

                //so the user db must contain a stale entry so remove it

                m_userDb->removeExternalDefaultServiceInterface(interfaceID);

                QList<QServiceInterfaceDescriptor> descriptors;

                //make the latest interface implementation the new

                //default if there is one

                if (descriptors.count() > 0 ) {

                    descriptor = latestDescriptor(descriptors);

                    setInterfaceDefault(descriptor, UserScope);

                    m_lastError.setError(DBError::NoError);

                    return descriptor;

                } else {

                    QString errorText("No default service found for interface: \"%1\"");

                    m_lastError.setError(DBError::NotFound, errorText.arg(interfaceName));

                    return QServiceInterfaceDescriptor();

                }

            } else {