/*

* Copyright (c) 2002-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:  Phonebook 2 contact find policy.

*

*/

#ifndef CPBK2CONTACTFINDPOLICY_H

#define CPBK2CONTACTFINDPOLICY_H

// INCLUDES

#include <e32base.h>

#include <CVPbkContactFindPolicy.h>

#include <bamdesca.h>

#include <badesca.h>

// FORWARD DECLARATIONS

class CFindUtil;

class CPbk2SortOrderManager;

class MPbk2ContactNameFormatter;

class CVPbkFieldTypeRefsList;

// CLASS DECLARATION

/**

 * Phonebook 2 contact find policy.

 * Responsible for implementing Virtual Phonebook defined contact

 * find policy so that the find is done according to the rules specified

 * in the UI level specifications.

 */

class CPbk2ContactFindPolicy : public CVPbkContactFindPolicy

    {

    public: // Constructors and destructor

        /**

         * Two-phased constructor.

         * @param aParam Find policy parameter

         * @return  A new instance of this class.

         */

        static CPbk2ContactFindPolicy* NewL( TParam* aParam );

        /**

         * Destructor.

         */

        ~CPbk2ContactFindPolicy();

    public: // From CVPbkContactFindPolicy

        TBool Match( const TDesC& aText,

                     const TDesC& aSearchString );

        TBool MatchRefineL( const TDesC& aText,

                            const TDesC &aSearchString );

        TBool MatchContactNameL( const MDesCArray& aFindWords,

                                 const MVPbkBaseContact& aContact );

        TBool MatchChineseContactNameL( const MDesCArray& aFindWords,

                                 const MVPbkBaseContact& aContact );

        TBool IsWordValidForMatching( const TDesC& aWord );

    private: // Implementation

        CPbk2ContactFindPolicy();

        void ConstructL( TParam* aParam );

        void SplitContactFieldTextIntoArrayL(

        		CDesCArray* aArray,

                const TDesC& aText );

        MDesCArray* SplitContactFieldTextIntoArrayL( const TDesC& aText );

        /**

         * If FDN contact, no name, use phonenumber as title if exists.

         * @aContact a contact with no name

         * @aAllNamesArray an array to contain name.

         */

        void GetTitleFromFDNNumberL( const MVPbkBaseContact& aContact, CDesC16Array& aAllNamesArray );

    private: // Data

        /// Own: Find util

        CFindUtil* iFindUtil;

        /// Own: Sort order manager

        CPbk2SortOrderManager* iSortOrderManager;

        /// Own: Contact name formatter

        MPbk2ContactNameFormatter* iNameFormatter;

        /// Own: a field type list for name formatter

        CVPbkFieldTypeRefsList* iFieldTypeRefsList;

    };

#endif // CPBK2CONTACTFINDPOLICY_H

// End of File