utilities/serviceipcserver/serviceipcserver_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 serviceipcserver_p_h
hgs
parents:
diff changeset
    19
#define serviceipcserver_p_h
hgs
parents:
diff changeset
    20
hgs
parents:
diff changeset
    21
#include <QtCore>
hgs
parents:
diff changeset
    22
#include "serviceipcserver_p.h"
hgs
parents:
diff changeset
    23
#include "serviceipcserver.h"
hgs
parents:
diff changeset
    24
#include "sessionidtable.h"
hgs
parents:
diff changeset
    25
hgs
parents:
diff changeset
    26
namespace WRT {
hgs
parents:
diff changeset
    27
    
hgs
parents:
diff changeset
    28
    class ServiceFwIPCServer;
hgs
parents:
diff changeset
    29
    class ServiceIPCSession;
hgs
parents:
diff changeset
    30
    class MServiceIPCObserver;
hgs
parents:
diff changeset
    31
    
hgs
parents:
diff changeset
    32
    /**
hgs
parents:
diff changeset
    33
     *  Private implementation interface for service framework server
hgs
parents:
diff changeset
    34
     *  This class is the abstract interface for all server backends
hgs
parents:
diff changeset
    35
     */
hgs
parents:
diff changeset
    36
    class ServiceFwIPCServerPrivate
hgs
parents:
diff changeset
    37
    {
hgs
parents:
diff changeset
    38
    public:
hgs
parents:
diff changeset
    39
        /**
hgs
parents:
diff changeset
    40
        * Virtual destructor
hgs
parents:
diff changeset
    41
        */
hgs
parents:
diff changeset
    42
        virtual ~ServiceFwIPCServerPrivate() {};
hgs
parents:
diff changeset
    43
hgs
parents:
diff changeset
    44
    public:
hgs
parents:
diff changeset
    45
    
hgs
parents:
diff changeset
    46
        /**
hgs
parents:
diff changeset
    47
         * Start listening for new service requests
hgs
parents:
diff changeset
    48
         * @param aServerName name of the server
hgs
parents:
diff changeset
    49
         * @return true if listen was successful
hgs
parents:
diff changeset
    50
         */
hgs
parents:
diff changeset
    51
        virtual bool listen(const QString& aServerName) = 0;
hgs
parents:
diff changeset
    52
    
hgs
parents:
diff changeset
    53
        /**
hgs
parents:
diff changeset
    54
         * Shutdown the server and stop serving clients 
hgs
parents:
diff changeset
    55
         * @return void
hgs
parents:
diff changeset
    56
         */
hgs
parents:
diff changeset
    57
        virtual void disconnect() = 0;
hgs
parents:
diff changeset
    58
    
hgs
parents:
diff changeset
    59
        /**
hgs
parents:
diff changeset
    60
         * IPC server lifetime should be configurable 
hgs
parents:
diff changeset
    61
         * @param aKeepServer to keep or disconnect IPC server when all clients are shutdown.
hgs
parents:
diff changeset
    62
         * @return void
hgs
parents:
diff changeset
    63
         */
hgs
parents:
diff changeset
    64
        virtual void configIpcServerLifetime(bool aKeepServer) = 0;
hgs
parents:
diff changeset
    65
        
hgs
parents:
diff changeset
    66
        //Keep session handle at high level, platform independent.
hgs
parents:
diff changeset
    67
        inline QHash<int, ServiceIPCSession*> getBroadcastSessions() { return m_broadcastSessions; }
hgs
parents:
diff changeset
    68
        
hgs
parents:
diff changeset
    69
        
hgs
parents:
diff changeset
    70
        inline void appendBroadcastList(int aSessionId, ServiceIPCSession * aSession) 
hgs
parents:
diff changeset
    71
        { 
hgs
parents:
diff changeset
    72
            m_broadcastSessions.insert(aSessionId, aSession); 
hgs
parents:
diff changeset
    73
        };
hgs
parents:
diff changeset
    74
        
hgs
parents:
diff changeset
    75
        inline void removeBroadcastList(int aSessionId) 
hgs
parents:
diff changeset
    76
        { 
hgs
parents:
diff changeset
    77
            m_broadcastSessions.remove(aSessionId); 
hgs
parents:
diff changeset
    78
        };
hgs
parents:
diff changeset
    79
        /*
hgs
parents:
diff changeset
    80
         Release session ID from iSessionIdTable
hgs
parents:
diff changeset
    81
         @param aSession
hgs
parents:
diff changeset
    82
         */   
hgs
parents:
diff changeset
    83
        inline void releaseSessionId(int aSessionId)
hgs
parents:
diff changeset
    84
        {
hgs
parents:
diff changeset
    85
            m_sessionIdTable->release(aSessionId);
hgs
parents:
diff changeset
    86
        };
hgs
parents:
diff changeset
    87
        
hgs
parents:
diff changeset
    88
        /*
hgs
parents:
diff changeset
    89
         Allocate session ID from iSessionIdTable
hgs
parents:
diff changeset
    90
         @return new Session ID
hgs
parents:
diff changeset
    91
         */   
hgs
parents:
diff changeset
    92
        inline int allocateSessionId()
hgs
parents:
diff changeset
    93
        {
hgs
parents:
diff changeset
    94
            return m_sessionIdTable->allocate();
hgs
parents:
diff changeset
    95
        };
hgs
parents:
diff changeset
    96
    
hgs
parents:
diff changeset
    97
    protected:
hgs
parents:
diff changeset
    98
    
hgs
parents:
diff changeset
    99
        /**
hgs
parents:
diff changeset
   100
         * Get the server observer
hgs
parents:
diff changeset
   101
         * @return MServiceIPCObserver* observer to this server
hgs
parents:
diff changeset
   102
         */
hgs
parents:
diff changeset
   103
        inline MServiceIPCObserver* Observer()
hgs
parents:
diff changeset
   104
        {
hgs
parents:
diff changeset
   105
            return q->m_Observer;
hgs
parents:
diff changeset
   106
        };
hgs
parents:
diff changeset
   107
        
hgs
parents:
diff changeset
   108
        inline void startExitTimer()
hgs
parents:
diff changeset
   109
        {
hgs
parents:
diff changeset
   110
            return q->startTimer();
hgs
parents:
diff changeset
   111
        };
hgs
parents:
diff changeset
   112
        
hgs
parents:
diff changeset
   113
        inline void stopExitTimer()
hgs
parents:
diff changeset
   114
        {
hgs
parents:
diff changeset
   115
            return q->stopTimer();
hgs
parents:
diff changeset
   116
        };
hgs
parents:
diff changeset
   117
           
hgs
parents:
diff changeset
   118
    
hgs
parents:
diff changeset
   119
    protected:
hgs
parents:
diff changeset
   120
        QList<ServiceIPCSession*> m_Sessions;
hgs
parents:
diff changeset
   121
        
hgs
parents:
diff changeset
   122
        //use for broadcast message to clients
hgs
parents:
diff changeset
   123
        QHash<int, ServiceIPCSession*> m_broadcastSessions;
hgs
parents:
diff changeset
   124
        
hgs
parents:
diff changeset
   125
        SessionIdTable* m_sessionIdTable;
hgs
parents:
diff changeset
   126
    
hgs
parents:
diff changeset
   127
    private:
hgs
parents:
diff changeset
   128
        friend class ServiceFwIPCServer;
hgs
parents:
diff changeset
   129
        ServiceFwIPCServer* q;
hgs
parents:
diff changeset
   130
    };
hgs
parents:
diff changeset
   131
hgs
parents:
diff changeset
   132
}
hgs
parents:
diff changeset
   133
#endif // serviceipcserver_p_h