/*
* Copyright (c) 2003-2005 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "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:       Declares custom ECom resolver.
*
*/






#ifndef _LIW_RESOLVER_H
#define _LIW_RESOLVER_H

#include "liwuids.hrh"
#include <ecom/resolver.h>
#include <ecom/publicregistry.h>
#include <ecom/implementationproxy.h>

// FORWARD DECLARATIONS
class TEComResolverParams;

// DynFeature resolver's UID
const TUid KLiwResolverImplUid = { KLiwResolverImplUidValue };

/**
 * Implements a non-default resolver.
 *
 * This controls the identification, (resolution), of which implementation
 * will be used to satisfy an interface implementation instantiation.
 */
class CLiwResolver : public CResolver
    {
    public:

        /**
        * Factory function
        * @param aRegistry <add description>
        */
        static CLiwResolver* NewL(MPublicRegistry& aRegistry);

        /**
        * Destructor.
        */
        virtual ~CLiwResolver();

        /**
        * Request that the resolver identify the most appropriate interface implementation.
        * 
        * @param aInterfaceUid          The interface for which implementations are requested.
        * @param aAdditionalParameters  Data to be used to refine the search further.
        * @return                       The Uid of the best fit interface implementation - 
        *                               KNullUid if no match is found.
        */
        TUid IdentifyImplementationL(TUid aInterfaceUid, 
            const TEComResolverParams& aAdditionalParameters) const;

        /**
        * List all the implementations which satisfy the specified interface.
        *
        * @param aInterfaceUid          The interface for which implementations are requested
        * @param aAdditionalParameters  Data to be used to refine the search further
        * @return                       Pointer to an array of suitable implementations. 
        *                               Ownership of this array is passed to the calling function.
        */
        RImplInfoArray* ListAllL(TUid aInterfaceUid, 
            const TEComResolverParams& aAdditionalParameters) const;

    private:

        /**
        * Constructor.
        * @param aRegistry <add description>
        */
        explicit CLiwResolver(MPublicRegistry& aRegistry);

        /**
        * Called by IdentifyImplementationL to select an appropriate implementation from a 
        * list of possibles.
        *
        * @param aImplementationsInfo   Information on the potential implementations
        * @param aAdditionalParameters  The data to match against to detemine the implementation
        * @return                       The Uid of the selected implementation - 
        *                               KNullUid if no match is found
        */
        TUid Resolve(const RImplInfoArray& aImplementationsInfo, 
            const TEComResolverParams& aAdditionalParameters) const;

        /**
        * Searches for a match of a data type on an implementation type.
        * Match returns ETrue if aMatchType is found within aImplementationType according 
        * to the following rules:
        *
        * 1) aImplementationType is treated as a series of descriptors separated by double
        * bars (||). ETrue is returned if aMatchType matches exactly any of the short
        * descriptors.  If no double bar is present then aImplementationType is treated as a
        * single descriptor.
        *
        * 2) If aUseWildcards == ETrue then a '?' in aMatchType will be matched to any single
        * character and '*' will be matched to any series of characters.
        *
        * @param aImplementationType  The implementation data type to search for a match
        * @param aMatchType           The data to search for
        * @param aUseWildcards        ETrue if wildcard matching should be allowed
        * @return                     ETrue if a match was found, EFalse otherwise
        */
        TBool Match(const TDesC8& aImplementationType, const TDesC8& aMatchType, 
            TBool aUseWildcards) const;

        TBool MatchServiceCmd(const TDesC8& aOpaqueData, const TDesC8& aServiceCmd) const;

        void ParseInput(const TDesC8& aParam, TDes8& aContent, TDes8& aOpaque) const;

    private:

        mutable RImplInfoArray* iImplementationInfoArray;
    };


#endif  // LIW_RESOLVER_H

// End of file