// Copyright (c) 2003-2009 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 "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members

// which accompanies this distribution, and is available

// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".

//

// Initial Contributors:

// Nokia Corporation - initial contribution.

//

// Contributors:

//

// Description:

// Detailed parser information for resolution criteria in XML framework

// 

//

/**

 @file 

 @publishedAll

 @released

*/

#ifndef MATCHDATA_H

#define MATCHDATA_H

#include <e32base.h>

#include <s32strm.h>

#include <s32mem.h>

#include <ecom/implementationinformation.h>

namespace Xml

{

/**

The plugin variant string of the default Symbian-provided XML parser plugins.

@publishedAll

@released

*/

_LIT8(KXmlSymbianPluginVariant, "Symbian");		

/**

CMatchData class provides detailed parser information for XML framework.

Client application should use this class to precisely specify the plugin, 

which should be used as a parsing engine in XML framework.

@publishedAll

@released

*/

NONSHARABLE_CLASS(CMatchData) : public CBase

{

public:

	CMatchData();

	~CMatchData();

	IMPORT_C static CMatchData* NewL();

	IMPORT_C static CMatchData* NewL(const TDesC8& aPackage);

	IMPORT_C static CMatchData* NewLC();

	IMPORT_C static CMatchData* NewLC(const TDesC8& aPackage);

	IMPORT_C void SetMimeTypeL(const TDesC8& aData);

	IMPORT_C const TPtrC8 MimeType() const;

	IMPORT_C void SetVariantL(const TDesC8& aVariant);

	IMPORT_C const TPtrC8 Variant() const;

	IMPORT_C void SetLeaveOnMany(TBool aSetting);

	IMPORT_C void SetRomOnly(TBool aSetting);

	IMPORT_C void SetCaseSensitivity(TBool aSetting);

	IMPORT_C TUid ResolveL(RImplInfoArray& aImplList) const;

public:

	CMatchData& operator=(const CMatchData & aMatchData);

	TBool operator==(const CMatchData & aMatchData) const;

	HBufC8* PackToBufferL() const;

private:

	void ConstructL(const TDesC8& aPackage);

	TBool VariantMatch(const TDesC8& aOpaqueField) const;

	TBool MimeTypeMatch(const TDesC8& aDataField) const;

	TBool MatchField(const TDesC8& aField, const TDesC8& aMatchString, const TDesC8& aSeparator) const;

	TBool CaseSensitivity() const;

	TBool LeaveOnMany() const;

	TBool RomOnly() const;

	void ExternalizeL(RWriteStream& aStream) const;

	void InternalizeL(RReadStream& aStream);		

	TUid SelectSingleParserL(RImplInfoPtrArray& aImplList) const;

	TBool IsInvalidVariant() const;

	static TInt SortOrder(const CImplementationInformation &aImpInfo1, 

							const CImplementationInformation &aImpInfo2);

private:

	/** 

	Mime type requested by client

	Is matched against one of entries of data_type field in resoure information file

	*/

	HBufC8* iMimeType; 

	/**

	Variant requested by client

	Is matched against first entry in opaque_data field of resource information file

	*/

	HBufC8* iVariant;

	/**

	Additional information for resolution constrains. Bitmap.

	*/

	TUint32 iAddInfo;

};

}

#endif // MATCHDATA_H