contentstorage/caclient/src/cahandlerproxy.cpp
author hgs
Mon, 18 Oct 2010 10:44:15 +0300
changeset 127 7b66bc3c6dc9
parent 116 305818acdca4
permissions -rw-r--r--
201041
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
96
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
 * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
 * All rights reserved.
hgs
parents:
diff changeset
     4
 * This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
 * under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
 * which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
 *
hgs
parents:
diff changeset
     9
 * Initial Contributors:
hgs
parents:
diff changeset
    10
 * Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
 *
hgs
parents:
diff changeset
    12
 * Contributors:
hgs
parents:
diff changeset
    13
 *
hgs
parents:
diff changeset
    14
 * Description:
hgs
parents:
diff changeset
    15
 *
hgs
parents:
diff changeset
    16
 */
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
#include <caentry.h>
hgs
parents:
diff changeset
    19
hgs
parents:
diff changeset
    20
#include "cahandler.h"
hgs
parents:
diff changeset
    21
#include "cahandlerproxy.h"
hgs
parents:
diff changeset
    22
#include "cahandlerloader.h"
hgs
parents:
diff changeset
    23
#include "caobjectadapter.h"
127
hgs
parents: 116
diff changeset
    24
#include "cahandlerspreloader.h"
hgs
parents: 116
diff changeset
    25
#include "caclient_defines.h"
96
hgs
parents:
diff changeset
    26
hgs
parents:
diff changeset
    27
/*!
hgs
parents:
diff changeset
    28
    \class CaHandlerProxy
hgs
parents:
diff changeset
    29
    \ingroup
hgs
parents:
diff changeset
    30
    \brief Forwards execute request to an implemenation provided by specific handler loader.
hgs
parents:
diff changeset
    31
hgs
parents:
diff changeset
    32
    \sa CaHandlerLoader
hgs
parents:
diff changeset
    33
*/
hgs
parents:
diff changeset
    34
hgs
parents:
diff changeset
    35
/*!
hgs
parents:
diff changeset
    36
  Destructor.
hgs
parents:
diff changeset
    37
*/
hgs
parents:
diff changeset
    38
CaHandlerProxy::~CaHandlerProxy()
hgs
parents:
diff changeset
    39
{
127
hgs
parents: 116
diff changeset
    40
    delete mHandlersPreloader;
96
hgs
parents:
diff changeset
    41
}
hgs
parents:
diff changeset
    42
hgs
parents:
diff changeset
    43
hgs
parents:
diff changeset
    44
/*!
hgs
parents:
diff changeset
    45
  Constructs handler proxy.
hgs
parents:
diff changeset
    46
  \param loader Provides handler implementations. It has to be pointer to a valid object.
hgs
parents:
diff changeset
    47
*/
hgs
parents:
diff changeset
    48
CaHandlerProxy::CaHandlerProxy(const QSharedPointer<CaHandlerLoader> &loader):
127
hgs
parents: 116
diff changeset
    49
    mLoader(loader),
hgs
parents: 116
diff changeset
    50
    mHandlersPreloader(NULL)
96
hgs
parents:
diff changeset
    51
{
hgs
parents:
diff changeset
    52
    Q_ASSERT(!mLoader.isNull());
hgs
parents:
diff changeset
    53
}
hgs
parents:
diff changeset
    54
hgs
parents:
diff changeset
    55
/*!
hgs
parents:
diff changeset
    56
  Forwards execute request to an appropriate handler if found otherwise ignores the request.
hgs
parents:
diff changeset
    57
  \param entry Subject for the requested command.
hgs
parents:
diff changeset
    58
  \param commandName Name of the command to be executed.
116
hgs
parents: 99
diff changeset
    59
  \param receiver QObject class with slot.
hgs
parents: 99
diff changeset
    60
  \param member Slot from QObject class.
98
hgs
parents: 96
diff changeset
    61
  \retval KErrNone on succes, error code otherwise.
96
hgs
parents:
diff changeset
    62
  \sa e32err.h for KErrNone definition.
hgs
parents:
diff changeset
    63
*/
116
hgs
parents: 99
diff changeset
    64
int CaHandlerProxy::execute(const CaEntry &entry, const QString &commandName,
127
hgs
parents: 116
diff changeset
    65
    QObject* receiver, const char* member)
96
hgs
parents:
diff changeset
    66
{
99
hgs
parents: 98
diff changeset
    67
    int result = -1;
127
hgs
parents: 116
diff changeset
    68
    CaHandler *const handler = getHandler(entry.entryTypeName());
96
hgs
parents:
diff changeset
    69
hgs
parents:
diff changeset
    70
    if (handler) {
127
hgs
parents: 116
diff changeset
    71
        result = handler->execute(entry, commandName, receiver, member);
96
hgs
parents:
diff changeset
    72
    }
hgs
parents:
diff changeset
    73
    return result;
hgs
parents:
diff changeset
    74
}
hgs
parents:
diff changeset
    75
hgs
parents:
diff changeset
    76
/*!
127
hgs
parents: 116
diff changeset
    77
  Looks for handler implementation in local cache or if not found,
hgs
parents: 116
diff changeset
    78
  request it from handler loader.
96
hgs
parents:
diff changeset
    79
  \param entry The entry being a subject for the requested command.
hgs
parents:
diff changeset
    80
  \param commandName Name of the command to be executed.
hgs
parents:
diff changeset
    81
  \return Pointer to a handler instance if available, NULL otherwise.
hgs
parents:
diff changeset
    82
*/
127
hgs
parents: 116
diff changeset
    83
CaHandler *CaHandlerProxy::getHandler(const QString &entryTypeName)
96
hgs
parents:
diff changeset
    84
{
hgs
parents:
diff changeset
    85
    CaHandler *implementation(0);
127
hgs
parents: 116
diff changeset
    86
    QString typeName(entryTypeName);
hgs
parents: 116
diff changeset
    87
    if (entryTypeName == WIDGET_ENTRY_TYPE_NAME
hgs
parents: 116
diff changeset
    88
        || entryTypeName == PACKAGE_ENTRY_TYPE_NAME) {
hgs
parents: 116
diff changeset
    89
        typeName = QString(APPLICATION_ENTRY_TYPE_NAME);
hgs
parents: 116
diff changeset
    90
    }
96
hgs
parents:
diff changeset
    91
hgs
parents:
diff changeset
    92
    const ImplementationMapIterator it(
127
hgs
parents: 116
diff changeset
    93
        mImplementationMap.find(typeName));
96
hgs
parents:
diff changeset
    94
hgs
parents:
diff changeset
    95
    if (it != mImplementationMap.end()) {
hgs
parents:
diff changeset
    96
        implementation = it->data();
hgs
parents:
diff changeset
    97
    } else {
127
hgs
parents: 116
diff changeset
    98
        implementation = mLoader->loadHandler(typeName);
hgs
parents: 116
diff changeset
    99
        mImplementationMap[typeName] =
hgs
parents: 116
diff changeset
   100
            QSharedPointer<CaHandler>(implementation);
96
hgs
parents:
diff changeset
   101
    }
hgs
parents:
diff changeset
   102
hgs
parents:
diff changeset
   103
    return implementation;
hgs
parents:
diff changeset
   104
}
127
hgs
parents: 116
diff changeset
   105
hgs
parents: 116
diff changeset
   106
/*!
hgs
parents: 116
diff changeset
   107
  Preload handlers during the idle time.
hgs
parents: 116
diff changeset
   108
 */
hgs
parents: 116
diff changeset
   109
void CaHandlerProxy::preloadHandlers()
hgs
parents: 116
diff changeset
   110
{
hgs
parents: 116
diff changeset
   111
    mHandlersPreloader = new CaHandlersPreloader(this);
hgs
parents: 116
diff changeset
   112
}