/*
* Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:      Metadata Harvester server executable header file
*
*/







#ifndef MDHSERVER_H
#define MDHSERVER_H

//  INCLUDES
#include <e32base.h>
#include <f32file.h>
#include "mdhmediaservercontainer.h"

// ---------------------------------------------------------------
// Server's policy
// ---------------------------------------------------------------

//Total number of ranges
const TUint KCmMdhServerRangeCount = 2;

//Definition of the ranges of IPC numbers
const TInt KCmMdhServerRanges[KCmMdhServerRangeCount] = 
        {
        0,
        3
        };

//Policy to implement for each of the above ranges        
const TUint8 KCmMdhServerElementsIndex[KCmMdhServerRangeCount] = 
        {
        1, //applies to 1st range
        CPolicyServer::ENotSupported
        };

//Specific capability checks
const CPolicyServer::TPolicyElement KCmMdhServerElements[] = 
        {
        {_INIT_SECURITY_POLICY_C3(ECapabilityNetworkServices,
            ECapabilityReadUserData, ECapabilityWriteUserData ),
            CPolicyServer::EFailClient },
        {_INIT_SECURITY_POLICY_C1(ECapabilityNetworkServices),
            CPolicyServer::EFailClient}
        };

//Package all the above together into a policy
const CPolicyServer::TPolicy KCmMdhServerPolicy =
        {
        //specifies all connect attempts should pass
        CPolicyServer::EAlwaysPass, 
        KCmMdhServerRangeCount,
        KCmMdhServerRanges,
        KCmMdhServerElementsIndex,
        KCmMdhServerElements
        };


// DATA TYPES

enum TCmMdhServerState
        {
        ECmMdhServerStateIdle = 0,
        ECmMdhServerStateSearching,
        ECmMdhServerStateHarvesting
        };

// FORWARD DECLARATIONS

// FUNCTION PROTOTYPES

// Method to panic server in case of serious error
void PanicServer( TInt aPanic );
// Method to panic client if e.g. message is malformed
void PanicClient( const RMessage2& aMessage, TInt aPanic );


// CLASS DECLARATION

/**
*  Dummy Server Core class
*
*  @lib CmMdhServer
*  @since Series 60 3.1
*/
class CCmMdhServer : public CPolicyServer
    {

    public:  // Constructors and destructor
        
        /**
        * Two-phased constructor.
        */
        static CCmMdhServer* NewLC();
        
        /**
        * Destructor.
        */
        virtual ~CCmMdhServer();

    public: // New functions
    
        /**
        * Sets server's state
        * @since S60 3.1 
        * @param aServerState, server state
        * @param aErrCode error code.
        */
        void SetServerStateL( TCmMdhServerState aServerState, 
                              TInt aErrCode = KErrNone );

        /**
        * Decrement server sessions
        * @since S60 3.1 
        */        
        void DecrementSessions();

        /**
        * Returns server's current state
        * @since S60 3.1
        * @return server state
        */         
        TCmMdhServerState ServerState();
 
         /**
        * Set current asyncronous message
        * @since S60 3.1
        * @param aMessage, message
        */        
        void SetCurrentAsyncMsg( const RMessage2& aMessage );
    
         /**
        * Creates media server container instance
        * @since S60 3.1
        */         
        void CreateMediaserverContainerL();
        
         /**
        * Destroys media server container instance
        * @since S60 3.1
        */        
        void DestroyMediaserverContainer();   
                
         /**
        * Returns media server container reference
        * @since S60 3.1
        * @return media server container
        */        
        CCmMdhMediaserverContainer& MediaserverContainer();
    
        /**
        * Increments sessions
        * @since S60 3.1
        */ 
        void IncrementSessions();             
    
    private:

        /**
        * C++ default constructor.
        */
        CCmMdhServer();

        /**
        * By default Symbian 2nd phase constructor is private.
        */
        void ConstructL();

    private: // Functions from base classes
        
        CSession2* NewSessionL( const TVersion& aVersion,
                                const RMessage2& aMessage ) const;
    

    private:    // Data
        
        /** Current asyncronous message */
        RMessage2                   iCurrentAsyncMsg;
        
        /** Media server container ( owned ) */
        CCmMdhMediaserverContainer* iMediaserverContainer; 
        
        /** Server state */
        TCmMdhServerState           iServerState;
        
        /** Count of sessions */
        TInt                       iSessionCount;
        
    };


#endif // MDHSERVER_H
           
// End of File