/*

* 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:

*

*                predictive contact search server.

*

*/

#ifndef R_PS_SESSION_H

#define R_PS_SESSION_H

// INCLUDE FILES

// SYSTEM INCLUDES

#include <e32base.h>

#include <e32std.h>

#include <e32cmn.h>

#include <s32mem.h>

#include <e32debug.h>

#include <utf.h>

#include <s32mem.h>

#include <CPcsDefs.h>

// CLASS DECLARATION

/**

* Client side interface for predictive search server.

*/

class RPsSession : public RSessionBase

{

    public:

		/**

		* RPcsSession.

		* Constructor

		*/

		/**

		* Connect.

		* Connects to the predictive search server

		*/

		TInt Connect();

		/**

		* Version.

		* Returns the version number of predictive search server

		*

		* @return Version information

		*/

		TVersion Version() const;

	    /**

        * SetSearchSettingsL.

        * Send the search settings (databases/ display fields) to the server.

        */

	    void SetSearchSettingsL(const TDes8& aSettings);

        /**

        * SearchL.

        * Initiates a predictive search request to the server.

        * @param aSearchQuery   The search query.

        * @param aResultsBuffer Pointer to the initial results buffer.

	    * @param aStatus        Holds the completion status of request.

        */

	    void SearchL(const TDes8& aSearchQuery,

	                 TPtr8 aResultsBuffer,

					 TRequestStatus& aStatus);

	    /**

	    * CancelSearchL.

	    * Cancels a pending search request.

	    * @param aStatus        Holds the completion status of request.

	    /**

        * SearchL.

        * Initiates a predictive search request to the server.

        * @param aSearchQuery   The search query.

        * @param aSearchData    The search data.

        */

	    void SearchL(const TDes8& aSearchQuery,

	                 const TDes8& aSearchData,

	                 TPtr8 aResultsBuffer);

        * SearchMatchStringL.

        * Initiates a predictive search request to the server with result as string.

        * @param aSearchQuery   The search query.

        * @param aSearchData    The search data.

	    /**

	    * SendNewBufferL.

	    * Send a new buffer to server if a overflow occurs.

	    *

	    * @param aResultsBuffer Pointer to the new results buffer.

	    * @param aStatus        Holds the completion status of request.

	    */

	    void SendNewBufferL(TPtr8 aResultsBuffer,

	                        TRequestStatus& aStatus);

        /**

        * IsLanguageSupportedL

        * Sends a request to PS server to decide if the language

        * variant is supported or not

        *

        void IsLanguageSupportedL(const TDes8& aLanguage,

        /**

        * GetDataOrderL

        * Sends a request to PS server to get the data fields supported

        * for a data store.

        *

        * @param aURI           Data store identifier.

        void GetDataOrderL(const TDes8& aURI,

                           TPtr8 aResultsBuffer);

        /**

        * GetSortOrderL

        * supported for a data store.

        *

        * @param aURI           Data store identifier.

        void GetSortOrderL(const TDes8& aURI,

                           TPtr8 aResultsBuffer);

        /**

        * ChangeSortOrderL

        * for a data store.

        *

        void ChangeSortOrderL(const TDes8& aInput);

		/**

		* Shuts down the predictive search server

		void ShutdownServerL();

	private:

	    /**

	    * iSearchQueryBufferPtr. Pointer to the buffer holding search query.

	    */

		/**

	    * iResultsBufferPtr. Pointer to the buffer holding search results

	    */

};

#endif // R_PS_SESSION_H

// End of file