utilities/serviceipcclient/serviceipc_p.h
author hgs
Fri, 15 Oct 2010 17:30:59 -0400
changeset 16 3c88a81ff781
permissions -rw-r--r--
201041
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
16
hgs
parents:
diff changeset
     1
/**
hgs
parents:
diff changeset
     2
   This file is part of CWRT package **
hgs
parents:
diff changeset
     3
hgs
parents:
diff changeset
     4
   Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies). **
hgs
parents:
diff changeset
     5
hgs
parents:
diff changeset
     6
   This program is free software: you can redistribute it and/or modify
hgs
parents:
diff changeset
     7
   it under the terms of the GNU (Lesser) General Public License as
hgs
parents:
diff changeset
     8
   published by the Free Software Foundation, version 2.1 of the License.
hgs
parents:
diff changeset
     9
   This program is distributed in the hope that it will be useful, but
hgs
parents:
diff changeset
    10
   WITHOUT ANY WARRANTY; without even the implied warranty of
hgs
parents:
diff changeset
    11
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
hgs
parents:
diff changeset
    12
   (Lesser) General Public License for more details. You should have
hgs
parents:
diff changeset
    13
   received a copy of the GNU (Lesser) General Public License along
hgs
parents:
diff changeset
    14
   with this program. If not, see <http://www.gnu.org/licenses/>.
hgs
parents:
diff changeset
    15
*/
hgs
parents:
diff changeset
    16
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
#ifndef serviceipc_p_h
hgs
parents:
diff changeset
    19
#define serviceipc_p_h
hgs
parents:
diff changeset
    20
hgs
parents:
diff changeset
    21
#include "serviceipc.h"
hgs
parents:
diff changeset
    22
#include <QtCore>
hgs
parents:
diff changeset
    23
#include <QByteArray>
hgs
parents:
diff changeset
    24
hgs
parents:
diff changeset
    25
namespace WRT {
hgs
parents:
diff changeset
    26
hgs
parents:
diff changeset
    27
    /**
hgs
parents:
diff changeset
    28
     *  Private implementation class for IPC
hgs
parents:
diff changeset
    29
     */
hgs
parents:
diff changeset
    30
    class ServiceFwIPC;
hgs
parents:
diff changeset
    31
    class ServiceFwIPCPrivate
hgs
parents:
diff changeset
    32
    {
hgs
parents:
diff changeset
    33
    public:
hgs
parents:
diff changeset
    34
        /**
hgs
parents:
diff changeset
    35
         * Virtual destructor
hgs
parents:
diff changeset
    36
         */
hgs
parents:
diff changeset
    37
        virtual ~ServiceFwIPCPrivate() {};
hgs
parents:
diff changeset
    38
hgs
parents:
diff changeset
    39
    
hgs
parents:
diff changeset
    40
        // Virtual functions 
hgs
parents:
diff changeset
    41
    
hgs
parents:
diff changeset
    42
        /**
hgs
parents:
diff changeset
    43
         * Connect to the server
hgs
parents:
diff changeset
    44
         * @param aServerName name of the server to connect to
hgs
parents:
diff changeset
    45
         * @return true if connected, false if not
hgs
parents:
diff changeset
    46
         */
hgs
parents:
diff changeset
    47
        virtual bool connect(const QString& aServerName) = 0;
hgs
parents:
diff changeset
    48
    
hgs
parents:
diff changeset
    49
        /**
hgs
parents:
diff changeset
    50
         * Disconnect from the server
hgs
parents:
diff changeset
    51
         */
hgs
parents:
diff changeset
    52
        virtual void disconnect() = 0;
hgs
parents:
diff changeset
    53
    
hgs
parents:
diff changeset
    54
        /**
hgs
parents:
diff changeset
    55
         * Starts the service
hgs
parents:
diff changeset
    56
         * @note: refer to public API ServiceFwIPC
hgs
parents:
diff changeset
    57
         */
hgs
parents:
diff changeset
    58
        virtual bool startServer(const QString& aServerName,
hgs
parents:
diff changeset
    59
                                 const QString& aExeName) = 0;
hgs
parents:
diff changeset
    60
    
hgs
parents:
diff changeset
    61
        /**
hgs
parents:
diff changeset
    62
         * Send a request synchronously
hgs
parents:
diff changeset
    63
         * @note: refer to public API ServiceFwIPC
hgs
parents:
diff changeset
    64
         */
hgs
parents:
diff changeset
    65
        virtual bool sendSync(const QString& aRequestType,
hgs
parents:
diff changeset
    66
                              const QByteArray& aData) = 0;
hgs
parents:
diff changeset
    67
    
hgs
parents:
diff changeset
    68
        /**
hgs
parents:
diff changeset
    69
         * Send a request asynchronously
hgs
parents:
diff changeset
    70
         * @note: refer to public API ServiceFwIPC
hgs
parents:
diff changeset
    71
         */
hgs
parents:
diff changeset
    72
        virtual void sendAsync(const QString& aRequestType,
hgs
parents:
diff changeset
    73
                               const QByteArray& aData) = 0;
hgs
parents:
diff changeset
    74
    
hgs
parents:
diff changeset
    75
        /**
hgs
parents:
diff changeset
    76
         * Reads all data pending in the buffer
hgs
parents:
diff changeset
    77
         * @note: refer to public API ServiceFwIPC
hgs
parents:
diff changeset
    78
         */
hgs
parents:
diff changeset
    79
        virtual QByteArray readAll() = 0;
hgs
parents:
diff changeset
    80
    
hgs
parents:
diff changeset
    81
        /**
hgs
parents:
diff changeset
    82
         * Waits until data is available for reading 
hgs
parents:
diff changeset
    83
         * @note: refer to public API ServiceFwIPC
hgs
parents:
diff changeset
    84
         */
hgs
parents:
diff changeset
    85
        virtual bool waitForRead() = 0;
hgs
parents:
diff changeset
    86
hgs
parents:
diff changeset
    87
        /**
hgs
parents:
diff changeset
    88
         * Retrieves the session id synchronously
hgs
parents:
diff changeset
    89
         * @note: refer to public API ServiceFwIPC
hgs
parents:
diff changeset
    90
         */
hgs
parents:
diff changeset
    91
        bool getSessionId(int& aSessionId);
hgs
parents:
diff changeset
    92
hgs
parents:
diff changeset
    93
        /**
hgs
parents:
diff changeset
    94
         * Sets the session id
hgs
parents:
diff changeset
    95
         * @note: refer to public API ServiceFwIPC
hgs
parents:
diff changeset
    96
         */
hgs
parents:
diff changeset
    97
        bool setSessionId(int aSessionId);
hgs
parents:
diff changeset
    98
hgs
parents:
diff changeset
    99
    protected:
hgs
parents:
diff changeset
   100
        // TODO: Move to inl file
hgs
parents:
diff changeset
   101
        inline void emitReadyRead()
hgs
parents:
diff changeset
   102
        {
hgs
parents:
diff changeset
   103
            if (q->m_AsyncRequestPending) {
hgs
parents:
diff changeset
   104
                q->m_AsyncRequestPending = false;
hgs
parents:
diff changeset
   105
                emit q->readyRead();
hgs
parents:
diff changeset
   106
            }
hgs
parents:
diff changeset
   107
        };
hgs
parents:
diff changeset
   108
    
hgs
parents:
diff changeset
   109
        inline void emitError(int aError)
hgs
parents:
diff changeset
   110
        {
hgs
parents:
diff changeset
   111
            emit q->error(aError);
hgs
parents:
diff changeset
   112
        };
hgs
parents:
diff changeset
   113
    
hgs
parents:
diff changeset
   114
        inline bool asyncPending()
hgs
parents:
diff changeset
   115
        {
hgs
parents:
diff changeset
   116
            return q->requestPending();
hgs
parents:
diff changeset
   117
        }
hgs
parents:
diff changeset
   118
    private:
hgs
parents:
diff changeset
   119
        friend class ServiceFwIPC;
hgs
parents:
diff changeset
   120
        ServiceFwIPC* q;  // not owned
hgs
parents:
diff changeset
   121
    };
hgs
parents:
diff changeset
   122
hgs
parents:
diff changeset
   123
}
hgs
parents:
diff changeset
   124
#endif // serviceipc_p_h