1 /*

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

     3  * All rights reserved.

     4  * This component and the accompanying materials are made available

     5  * under the terms of "Eclipse Public License v1.0"

     6  * which accompanies this distribution, and is available

     7  * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8  *

     9  * Initial Contributors:

    10  * Nokia Corporation - initial contribution.

    11  *

    12  * Contributors:

    13  *

    14  * Description:  ?Description

    15  *

    16  */

    17 #include <QtGlobal>

    18 #include <QMetaType>

    19 #include <QString>

    20 

    21 

    22 #include "casoftwareregistry.h"

    23 #include "casoftwareregistry_p.h"

    24 

    25 

    26 // ======== MEMBER FUNCTIONS ========

    27 

    28 /*!

    29 

    30  \class CaSoftwareRegistry.

    31  \brief This class provides access to USIF provided data and converting

    32  them from Symbian to Qt types.

    33 

    34  CaSoftwareRegistry class provides a factory method which returns smart pointer

    35  to CaSoftwareRegistry instnce to ensure

    36  automatical memory cleanup once the reference count drops to 0.

    37 

    38  \code

    39  QSharedPointer<CaSoftwareRegistry> service = CaSoftwareRegistry::create();

    40  \endcode

    41 

    42  Subsequent calls to CaSoftwareRegistry::create() may return pointers to different

    43  instances. It is a case when between the calls instance counter of the created

    44  object dropped to 0 and it was deleted.

    45  

    46  */

    47 

    48 /*! \typedef typedef QHash<QString, QString> DetailMap;

    49  * Defines map type for component details.

    50  * 

    51  */

    52 

    53 /*!

    54  \var CaSoftwareRegistryPrivate::m_q

    55  Points to the CaSoftwareRegistry instance that uses this private implementation.

    56  */

    57 

    58 

    59 // Initialization of a static member variable.

    60 QWeakPointer<CaSoftwareRegistry> CaSoftwareRegistry::m_instance = 

    61     QWeakPointer<CaSoftwareRegistry>();

    62 

    63 

    64 /*!

    65  Constructor.

    66  \param parent pointer to a parent. It defaults to NULL.

    67  */

    68 CaSoftwareRegistry::CaSoftwareRegistry(QObject *parent) :

    69     QObject(parent), m_d(new CaSoftwareRegistryPrivate(this))

    70 {

    71 

    72 }

    73 

    74 /*!

    75  Returns a pointer to an instance of the CaSoftwareRegistry class.

    76  \retval A pointer to an instance of the CaSoftwareRegistry class.

    77  */

    78 QSharedPointer<CaSoftwareRegistry> CaSoftwareRegistry::create()

    79 {

    80     QSharedPointer<CaSoftwareRegistry> service(m_instance);

    81     if (!service) {

    82         service = QSharedPointer<CaSoftwareRegistry>(new CaSoftwareRegistry);

    83         m_instance = service.toWeakRef();

    84     }

    85     return service;

    86 }

    87 

    88 /*!

    89  Destructor.

    90  */

    91 CaSoftwareRegistry::~CaSoftwareRegistry()

    92 {

    93     delete m_d;

    94 }

    95 

    96 /*!

    97  The method provides component details from USIF for a given component id.

    98  \code

    99  QSharedPointer<CaSoftwareRegistry> service = CaSoftwareRegistry::create();

   100  CaSoftwareRegistry::DetailMap detailMap = service->entryDetails(5);

   101  QString appName = detailMap[CaSoftwareRegistry::componentNameKey()];

   102  \endcode

   103  \param componentId Component id of the entry details are requested for.

   104  \return Map of the component details if component id was greater than 0 or

   105  empty map otherwise. 

   106 

   107  */

   108 CaSoftwareRegistry::DetailMap CaSoftwareRegistry::entryDetails(

   109     int componentId) const

   110 {

   111     return m_d->entryDetails(componentId);

   112 }

   113 

   114 /*!

   115  * \return Component name key in CaSoftwareRegistry::DetailMap.

   116  */

   117 QString CaSoftwareRegistry::componentNameKey()

   118 {

   119     static const QString key("name");

   120     return key;

   121 }

   122 

   123 /*!

   124  * \return Component version key in CaSoftwareRegistry::DetailMap.

   125  */

   126 QString CaSoftwareRegistry::componentVersionKey()

   127 {

   128     static const QString key("version");

   129     return key;

   130 }

   131 

   132 /*!

   133  * \return Component vendor key in CaSoftwareRegistry::DetailMap.

   134  */

   135 QString CaSoftwareRegistry::componentVendorKey()

   136 {

   137     static const QString key("vendor");

   138     return key;

   139 }

   140 

   141 /*!

   142  * \return Component drive info key in CaSoftwareRegistry::DetailMap.

   143  */

   144 QString CaSoftwareRegistry::componentDriveInfoKey()

   145 {

   146     static const QString key("driveInfo");

   147     return key;

   148 }

   149 

   150 /*!

   151  * \return Component size info key in CaSoftwareRegistry::DetailMap.

   152  */

   153 QString CaSoftwareRegistry::componentSizeKey()

   154 {

   155     static const QString key("size");

   156     return key;

   157 }

   158 

   159 /*!

   160  * \return Component type key in CaSoftwareRegistry::DetailMap.

   161  */

   162 QString CaSoftwareRegistry::componentTypeKey()

   163 {

   164     static const QString key("type");

   165     return key;

   166 }

   167 

   168 

   169