/*

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

* All rights reserved.

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU Lesser General Public License as published by

* the Free Software Foundation, version 2.1 of the License.

* 

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

* GNU Lesser General Public License for more details.

*

* You should have received a copy of the GNU Lesser General Public License

* along with this program.  If not, 

* see "http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html/".

*

* Description:

*

*/

#include "xqservicelog.h"

#include "xqappmgr.h"

#include <xqaiwrequest.h>

#include <xqaiwinterfacedescriptor.h>

#include <QList>

#include "xqappmgr_p.h"

XQApplicationManager::XQApplicationManager()

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::XQApplicationManager");

    d = new XQApplicationManagerPrivate();

}

XQApplicationManager::~XQApplicationManager()

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::~XQApplicationManager");

    delete d;

};

/*!

    you shall first list() implementations and use the overloaded create() with XQAiwInterfaceDescriptor

    \param operation The function signature to be called via the interface.

                     Can be set later via XQAiwRequest::setOperation.

    \return The application interworking request instance, NULL if no service is available

    Example usage:

    \code

    if (req)

    {

        // There was service available

        QList<QVariant> args;

        args << folder;

        args << previewOn;

        req->setArguments(args);

        connect(req, SIGNAL(requestOk(const QVariant&)), this, SLOT(handleOk(const QVariant&)));

        connect(req, SIGNAL(requestError(int,const QString&)), this, SLOT(handleError(int,const QString&)));

        req->send();

    }

    \endcode

*/

XQAiwRequest* XQApplicationManager::create(

    const QString &interface, const QString &operation, bool embedded)

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::create(interface)");

    return d->create(interface, operation, embedded);

}

/*!

    The descriptor is got from the list() call.

    As combination [service,interface,version] shall be unique,

    the descriptor points to one implementation and thus selects correct

    implementation.

    \param implementation Valid interface descriptor obtained by the "list" call.

    \param operation The function signature to be called via the interface.

                     Can be set later via XQAiwRequest::setOperation.

    \param embedded True if embedded call, false otherwise

                     Can be set later via XQAiwRequest::setEmbedded.

    Example usage:

    \code

    XQApplicationManager appMgr;  // Prefer one instance only 

    //

    // Populate a user interface widget and select proper implementation via descriptor

    // ... 

    //

    // ... the rest as usual...

    //

    \endcode

*/

XQAiwRequest* XQApplicationManager::create(

    const XQAiwInterfaceDescriptor &implementation, const QString &operation, bool embedded)

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::create (impl.)");

    return d->create(implementation, operation, embedded);

}

/*!

    implementation.

    \param service Service name as mentioned in the service registry file

    \param interface Interface name as mentioned in the service registry file

    \param operation The function signature to be called via the interface.

                     Can be set later via XQAiwRequest::setOperation.

                     Can be set later via XQAiwRequest::setEmbedded.

    Example usage:

    \code

    #include <xqappmgr.h>;

    #include "componentglobal.h";

    // XQApplicationManager mAppMgr;  // manager as class member

    if (req)

    {

        ...

    }

    \endcode

*/

XQAiwRequest* XQApplicationManager::create(

    const QString &service, const QString &interface, const QString &operation, bool embedded)

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::create(service+interface)");

    return d->create(service, interface, operation, embedded);

}

/*!

    List implementation descriptors by interface name.

    \param interface Interface name as mentioned in the service registry file

    \param operation The operation signature to be called.  Reserved for future use.

    Example usage:

    \code

    //

    // Populate a user interface widget and select proper implementation via descriptor

    // ... 

    //

    // ... the rest as usual...

    //

    \endcode

*/

QList<XQAiwInterfaceDescriptor> XQApplicationManager::list(const QString &interface, const QString &operation)

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::list");

    return d->list(interface, operation);

}

/*!

    List implementation(s) descriptors by service and interface name.

*/

QList<XQAiwInterfaceDescriptor> XQApplicationManager::list(

    const QString &service, const QString &interface, const QString &operation)

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::list");

    return d->list(service, interface, operation);

}

/*!

    A service declares support for scheme(s) (CSV list) by adding the custom property key

    (see the constant XQCUSTOM_PROP_SCHEMES value) to the service XML.

    By default, the operation name declared by constant XQOP_URI_VIEW is used.

*/

XQAiwRequest* XQApplicationManager::create( const QUrl &uri, bool embedded)

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::create(url)");

    return d->create(uri, NULL, embedded);

}

XQAiwRequest* XQApplicationManager::create(

    const QUrl &uri, const XQAiwInterfaceDescriptor& implementation, bool embedded)

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::create(uri+impl)");

    return d->create(uri, &implementation, embedded);

}

/*!

    The interface name applied implicitly is declared by the constant XQI_FILE_VIEW

*/

XQAiwRequest* XQApplicationManager::create( const QFile &file, bool embedded)

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::create(file)");

    return d->create(file, NULL, embedded);

}

XQAiwRequest* XQApplicationManager::create(

    const QFile &file, const XQAiwInterfaceDescriptor& implementation, bool embedded)

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::create(file+impl)");

    return d->create(file, &implementation, embedded);

}

/*!

    List implementations that support handling the URI scheme of the given uri

    The interface name applied implicitly is declared by the constant XQI_URI_VIEW

*/

QList<XQAiwInterfaceDescriptor> XQApplicationManager::list(const QUrl &uri)

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::list(uri)");

    return d->list(uri);

}

/*!

    List implementations that support handling the MIME type of of the given file

    The interface name applied implicitly is declared by the constant XQI_FILE_VIEW

*/

QList<XQAiwInterfaceDescriptor> XQApplicationManager::list(const QFile &file)

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::list(file)");

    return d->list(file);

}

/*!

    List implementations that support handling the MIME type of of the given sharable file

    The interface name applied implicitly is declared by the constant XQI_FILE_VIEW

*/

QList<XQAiwInterfaceDescriptor> XQApplicationManager::list(const XQSharableFile &file)

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::list(XQSharableFile)");

    return d->list(file);

}

/*!

    Create AIW request for the given file and the MIME type attached to the sharable file

    The interface name applied implicitly is declared by the constant XQI_FILE_VIEW

    By default, the operation name declared by constant XQOP_FILE_VIEW_SHARABLE is used.

*/

XQAiwRequest* XQApplicationManager::create(const XQSharableFile &file, bool embedded)

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::create(XQSharableFile)");

    return d->create(file, NULL, embedded);

}

XQAiwRequest* XQApplicationManager::create(

    const XQSharableFile &file, const XQAiwInterfaceDescriptor& implementation, bool embedded)

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::create(XQSharableFile+impl)");

    return d->create(file, &implementation, embedded);

}

int XQApplicationManager::lastError() const

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::lastError");

    return d->lastError();

}

bool XQApplicationManager::isRunning(const XQAiwInterfaceDescriptor& implementation) const

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::isRunning");

    return d->isRunning(implementation);

}

bool XQApplicationManager::getDrmAttributes(const QFile &file, const QList<int> &attributeNames, QVariantList &attributeValues)

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::drmAttributes (file)");

    return d->getDrmAttributes(file, attributeNames, attributeValues);

}

bool XQApplicationManager::getDrmAttributes(const XQSharableFile &file, const QList<int> &attributeNames, QVariantList &attributeValues)

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::drmAttributes (XQSharableFile)");

    return d->getDrmAttributes(file, attributeNames, attributeValues);

}

XQApplicationManager::ServiceStatus XQApplicationManager::status(const XQAiwInterfaceDescriptor& implementation)

{

    XQSERVICE_DEBUG_PRINT("XQApplicationManager::status");

    return (ServiceStatus)d->status(implementation);

}