/*
* Copyright (c) 2008 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:  client class to connect to server
*
*/



#ifndef __CIMCACHECLIENT_H__
#define __CIMCACHECLIENT_H__

#include <e32base.h>
#include <imcachedefs.h>
#include "mimcacheclient.h"

class MIMCacheEventHandler;
class CIMCacheEventHandler;
class MIMCacheEventHandler;
class CIMCacheAccessEventHandler;
/**
 * CIMCacheClient ClientServer 
  */
class CIMCacheClient : public CBase,
					   public RSessionBase,
					   public MIMCacheClient
    {
    
    public:     // Constructor and destructor
    	/*
    	* CIMCacheClient
       	*/
         CIMCacheClient();
        
        /*
    	* ~CIMCacheClient
       	*/
        ~CIMCacheClient();


    public:     // New methods

		/**
    	* Connect
       	*/
        TInt Connect();      
       
       	/**
    	* Register to observer converstaionitems data updates
    	* @param aObserver the observer interface
    	*/
        void RegisterUpdateObserverL( MIMCacheEventHandler& aObserver );

    	/**
    	* Unregister a converstaionitems data update observer
    	* @param aObserver the observer interface
    	*/
        void UnRegisterUpdateObserver( MIMCacheEventHandler& aObserver );
		/**
    	* Register to observer converstaionitems data access
    	* @param aObserver the observer interface
    	*/
        void RegisterAccessObserverL( MIMCacheEventHandler& aObserver );

    	/**
    	* Unregister a converstaionitems data access observer
    	* @param aObserver the observer interface
    	*/
        void UnRegisterAccessObserver( MIMCacheEventHandler& aObserver);

		/**
    	* start the transaction and perform the operation
    	* @param aOperationType , operation to perform
    	*/
        TInt StartTransactionL( EIMCacheOperations aOperationType );
        
		/**
    	* start the transaction and perform the operation 
    	* @param aText ,text to send to server
		* @param aOperationType operation to perform
    	*/
		void StartTransactionL( EIMCacheOperations aOperationType,
								const TDesC& aText
								) ;
									   
		/**
    	* start the transaction and perform the operation 
    	* @param aServiceId service id to use
		* @param aUserId user id to use
		* @param aOperationType operation to perform
    	*/
		void StartTransactionL(	EIMCacheOperations aOperationType ,
								TInt aServiceId,
								const TDesC& aText
								);
        
       	/**
    	* start the transaction and perform the operation 
    	* @param aServiceId service id to use
		* @param aSender user id to use
		* @param aRecipient,recipient user id
		* @param aOperationType operation to perform
    	*/						
		void StartTransactionL( EIMCacheOperations aOperationType,
								TInt aServiceId,
								const TDesC& aText1 ,
						   	  	const TDesC& aText2
						   		) ;
									   		
		 
		/**
    	* to get the all unread message count from server
    	* @param , aOwnUserId logged in user id
    	* @return number of unread msg count
    	*/
		TInt GetInformationL(EIMCacheOperations aOperationType , TInt aServiceId,const TDesC& aBuddyId );
		
	   /**
    	* to get the count from server
        * @param aOperationType operation to perform
    	* @param aServiceId, service id used
    	* @param , aOwnUserId logged in user id
    	* @return number of all unread msg count
    	*/
        TInt GetInformationL(EIMCacheOperations aOperationType, TInt aServiceId );	
      
		
		/**
    	* to get the list of availabe chats from server
       	* @param aServiceId, service id used
       	* @return list buffer
    	*/
	    TPtr8 GetChatListL( const TInt& aServiceId = -1);
									   										   		
private: 
		
		/**
    	* CreateArgumentsL pack the given parameters 
    	* @param aServiceId service id to use
		* @param aUserId user id to use
		* @param aText,a text to send 
		* @return TIpcArgs, packed arguments
	   	*/									   		
		TIpcArgs CreateArgumentsL( TInt aServiceId, const TDesC& aText1  ,
									   const TDesC& aText2  );
									   
	   	/**
    	* CreateArgumentsL pack the given parameters  
    	* @param aServiceId service id to use
		* @param aUserId user id to use
		* @return TIpcArgs, packed arguments
    	*/	
        TIpcArgs CreateArgumentsL( TInt aServiceId ,
								  const TDesC& aText  );
		



public: // MIMCacheClient

		/**
    	* Registeres the cache update observer to server
    	* @param aStatus status message to regisetr
		* @param aRight,right is operations
    	*/
        void RegisterObserverToServerL( TRequestStatus& aStatus,EIMCacheOperations aRight ) ;
        
       
        /**
    	* unRegisteres the cache update  observer to server
    	* @param aStatus status message to regisetr
		* @param aRight,right is operations
    	*/
        void UnRegisterObserverToServerL(  TRequestStatus& aStatus, EIMCacheOperations aRight ) ;
        
        /**
         * cancels any outstanding requests pending from the server
         * @param aStatus status message to regisetr
         * @param aRight,right is operations
         */
        void CancelRequestL( TRequestStatus& aStatus, EIMCacheOperations aRight);
         
        /**
        * Gets called when data update is available.
        * Client can then decide wether to use the old one
        * @param aRight, operations
        * @param abuuferptr 
        */
        TPtr8 GetBufferedDataL(EIMCacheOperations aOperationType );
       
	private:
		
		 // owned , a array for all client who has 
		 // register update data change event 
		 CIMCacheEventHandler* iUpdateObserver;
		 // owned , a array for all client who has 
		 // register update data change event 
		 CIMCacheAccessEventHandler* iAccessObserver;
		 //owned buffer to get chats from server.
		 HBufC8* iChatBuffer;
		
    };

#endif      //  __CIMCACHECLIENT_H__


//  END OF FILE