// Copyright (c) 2002-2009 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:

//

#include <mmf/common/mmfcontrollerpluginresolver.h>

#include <mmf/server/mmfdatabuffer.h>

#include <mmf/common/mmfutilities.h>

#include <mmf/server/mmfclip.h>

#include <mmf/server/mmffile.h>

#include <mmf/server/mmfformat.h>

//static const TUid KUidMmfPluginInterfaceFormatDecode = {KMmfUidPluginInterfaceFormatDecode};

//static const TUid KUidMmfPluginInterfaceFormatEncode = {KMmfUidPluginInterfaceFormatEncode};

const TInt KMmfHeaderBufferSize = 512 ;		//512 bytes read to parse the header

CMMFFormatDecode* CMMFFormatDecode::CreateFormatL(TUid aUid, MDataSource* aSource)

	{

	CMMFFormatDecode* s = REINTERPRET_CAST( CMMFFormatDecode*,

				REComSession::CreateImplementationL( aUid, _FOFF( CMMFFormatDecode, iDtor_ID_Key),

				STATIC_CAST( TAny*, aSource ) ) ) ;

	s->iImplementationUid = aUid;

	return s;

	}

/**

Allocates and constructs an ECom format decode object.

This is used to explicitly instantiate a format decoder where the UID is known. This method might

be used by controllers that only support one type of format such that the UID of the format is

already known. For example, if an mp3 controller has been instantiated, there is no need for any

further format recognition as this has already been performed in the controller instantiation, thus

the controller can instantiate an mp3 format directly from it’s UID.

@param  aUid 

        The implementation UID. This is used by Com to create the plugin.

@param  aSource 

        The controller MDataSource and is the source of the data for the format decode plugin. The 

        format decode plugin is the sink of data for the MDataSource.

@return If successful, returns the address of the format decode plugin object created. If not successful, 

        leaves with KErrNotFound.

*/

EXPORT_C CMMFFormatDecode* CMMFFormatDecode::NewL( TUid aUid, MDataSource* aSource )

	{

	return CreateFormatL(aUid, aSource);

	}

/**

Attempt to locate and instantiate a FormatDecode using a filename or an extension.

Only the extension is used.  If no extension  is supplied (no dot is present) the whole of the 

filename will be treated as the extension.

If the file already exists, the file header is scanned to find a match in the opaque_data field of 

the resource file.

@param  aFileName

        The file name of target file.  May be extension only or may include full path.

@param  aSource

        The controller's MDataSource. This is the source of the data for the format decode plugin. This must

        be a CMMFFile source when instantiating a CMMFFormatDecode using a file name.

@param  aPreferredSupplier

        If this is provided the list of matching plugins will be further searched for the latest version of a

        plugin supplied by supplier named.

@return If successful returns an instantiated CMMFFormatDecode from a plugin. If not successful, leaves with KErrNotFound.

*/

EXPORT_C CMMFFormatDecode* CMMFFormatDecode::NewL( const TDesC16& aFileName, MDataSource* aSource, const TDesC& aPreferredSupplier )

	{

	CMMFFormatDecodePluginSelectionParameters* pluginSelector = CMMFFormatDecodePluginSelectionParameters::NewLC();

	CMMFFormatSelectionParameters* formatParams = CMMFFormatSelectionParameters::NewLC();

	formatParams->SetMatchToFileNameL(aFileName);

	pluginSelector->SetRequiredFormatSupportL(*formatParams);

	if (aPreferredSupplier.Length() > 0)

		pluginSelector->SetPreferredSupplierL(aPreferredSupplier, CMMFPluginSelectionParameters::EOnlyPreferredSupplierPluginsReturned);

	// Instantiate this format

	CMMFFormatDecode* theChosenOne = 

		MMFFormatEcomUtilities::SelectFormatDecodePluginL(*pluginSelector, aSource);

	// Now clean up.

	CleanupStack::PopAndDestroy(2);//formatParams, pluginSelector

	return theChosenOne;

	}

/**

Attempt to locate and instantiate a FormatDecode using a filename or an extension.

Only the extension is used.  If no extension  is supplied (no dot is present) the whole of the 

filename will be treated as the extension.

If the file already exists, the file header is scanned to find a match in the opaque_data field of 

the resource file.

@param  aFileName

        The file name of target file.  May be extension only or may include full path.

@param  aSource

        The controller's MDataSource. This is the source of the data for the format decode plugin. This must

        be a CMMFFile source when instantiating a CMMFFormatDecode using a file name.

@param  aPreferredSupplier

        If this is provided the list of matching plugins will be further searched for the latest version of a

        plugin supplied by supplier named.

@param  aSupportsCustomInterfaces

		Indicates whether the instantiated FormatDecode supports custom interfaces.

@return If successful returns an instantiated CMMFFormatDecode from a plugin. If not successful, leaves with KErrNotFound.

*/

EXPORT_C CMMFFormatDecode* CMMFFormatDecode::NewL( const TDesC16& aFileName, MDataSource* aSource, const TDesC& aPreferredSupplier, TBool& aSupportsCustomInterfaces )

	{

	CMMFFormatDecodePluginSelectionParameters* pluginSelector = CMMFFormatDecodePluginSelectionParameters::NewLC();

	CMMFFormatSelectionParameters* formatParams = CMMFFormatSelectionParameters::NewLC();

	formatParams->SetMatchToFileNameL(aFileName);

	pluginSelector->SetRequiredFormatSupportL(*formatParams);

	if (aPreferredSupplier.Length() > 0)

		pluginSelector->SetPreferredSupplierL(aPreferredSupplier, CMMFPluginSelectionParameters::EOnlyPreferredSupplierPluginsReturned);

	// Instantiate this format

	CMMFFormatDecode* theChosenOne = 

		MMFFormatEcomUtilities::SelectFormatDecodePluginL(*pluginSelector, aSource, aSupportsCustomInterfaces);

	// Now clean up.

	CleanupStack::PopAndDestroy(2);//formatParams, pluginSelector

	return theChosenOne;

	}

/**

Attempts to locate and instantiate a CMMFFormatDecode using data in a buffer.  The buffer is expected to contain 

header data (from a file, stream or descriptor).

Signatures (supplied by the plugin registry information) are sought in aSourceHeader.

This function uses the match string as a resolver parameter. The format base class uses the match string

to find a match to the match string defined in the opaque_data field of the resource file. The

match string would typically be a signature for a particular format usually defined in the format header.

@param  aSourceHeader

        The data which is searched for matching signatures.

@param  aSource

        The controller's MDataSource and the source of the data for the format decode plugin.

@param  aPreferredSupplier

        If this is provided the list of matching plugins will be further searched for the latest version of a

        plugin supplied by the specified supplier.

@return If successful returns an instantiated CMMFFormatDecode from a plugin.  If not successful, leaves with KErrNotFound.

*/

EXPORT_C CMMFFormatDecode* CMMFFormatDecode::NewL( const TDesC8& aSourceHeader, MDataSource* aSource, const TDesC& aPreferredSupplier )

	{

	CMMFFormatDecodePluginSelectionParameters* pluginSelector = CMMFFormatDecodePluginSelectionParameters::NewLC();

	CMMFFormatSelectionParameters* formatParams = CMMFFormatSelectionParameters::NewLC();

	formatParams->SetMatchToHeaderDataL(aSourceHeader);

	pluginSelector->SetRequiredFormatSupportL(*formatParams);

	if (aPreferredSupplier.Length() > 0)

		pluginSelector->SetPreferredSupplierL(aPreferredSupplier, CMMFPluginSelectionParameters::EOnlyPreferredSupplierPluginsReturned);

	// Instantiate this format

	CMMFFormatDecode* theChosenOne = 

		MMFFormatEcomUtilities::SelectFormatDecodePluginL(*pluginSelector, aSource);

	// Now clean up.

	CleanupStack::PopAndDestroy(2);//formatParams, pluginSelector

	return theChosenOne;

	}

/**

Attempts to locate and instantiate a CMMFFormatDecode using data in a buffer.  The buffer is expected to contain 

header data (from a file, stream or descriptor).

Signatures (supplied by the plugin registry information) are sought in aSourceHeader.

This function uses the match string as a resolver parameter. The format base class uses the match string

to find a match to the match string defined in the opaque_data field of the resource file. The

match string would typically be a signature for a particular format usually defined in the format header.

@param  aSourceHeader

        The data which is searched for matching signatures.

@param  aSource

        The controller's MDataSource and the source of the data for the format decode plugin.

@param  aPreferredSupplier

        If this is provided the list of matching plugins will be further searched for the latest version of a

        plugin supplied by the specified supplier.

@param  aSupportsCustomInterfaces

		Indicates whether the instantiated FormatDecode supports custom interfaces.

@return If successful returns an instantiated CMMFFormatDecode from a plugin.  If not successful, leaves with KErrNotFound.

*/

EXPORT_C CMMFFormatDecode* CMMFFormatDecode::NewL( const TDesC8& aSourceHeader, MDataSource* aSource, const TDesC& aPreferredSupplier, TBool& aSupportsCustomInterfaces )

	{

	CMMFFormatDecodePluginSelectionParameters* pluginSelector = CMMFFormatDecodePluginSelectionParameters::NewLC();

	CMMFFormatSelectionParameters* formatParams = CMMFFormatSelectionParameters::NewLC();

	formatParams->SetMatchToHeaderDataL(aSourceHeader);

	pluginSelector->SetRequiredFormatSupportL(*formatParams);

	if (aPreferredSupplier.Length() > 0)

		pluginSelector->SetPreferredSupplierL(aPreferredSupplier, CMMFPluginSelectionParameters::EOnlyPreferredSupplierPluginsReturned);

	// Instantiate this format

	CMMFFormatDecode* theChosenOne = 

		MMFFormatEcomUtilities::SelectFormatDecodePluginL(*pluginSelector, aSource, aSupportsCustomInterfaces);

	// Now clean up.

	CleanupStack::PopAndDestroy(2);//formatParams, pluginSelector

	return theChosenOne;

	}

/**

Attempts to locate and instantiate a CMMFFormatDecode using data from MDataSource.  

The data is expected to contain header data (from a file, stream or descriptor). Signatures 

(supplied by the plugin registry information) are sought in aSource.

@param  aSource

        Header data. Must be derived from CMMFClip.

@param  aPreferredSupplier

        If this is provided, the list of matching plugins will be further searched for the latest version of a

        plugin supplied by the specified supplier.

@return If successful returns an instantiated CMMFFormatDecode from a plugin. If not successful, leaves with KErrNotFound.

*/

EXPORT_C CMMFFormatDecode* CMMFFormatDecode::NewL( MDataSource* aSource, const TDesC& aPreferredSupplier )

	{

	// Read header data from aSource.  Call source header version

	if ( !( (aSource->DataSourceType() == KUidMmfFileSource ) || ( aSource->DataSourceType() == KUidMmfDescriptorSource) ) )

		User::Leave( KErrNotSupported ) ;

	CMMFDataBuffer* buffer = CMMFDataBuffer::NewL(KMmfHeaderBufferSize) ;

	CleanupStack::PushL( buffer ) ;

	aSource->SourcePrimeL();

	TCleanupItem srcCleanupItem(DoDataSourceStop, aSource);

	CleanupStack::PushL(srcCleanupItem);

	STATIC_CAST( CMMFClip*, aSource )->ReadBufferL( buffer, 0 ) ;

	CleanupStack::Pop();

	aSource->SourceStopL();

	// attempt to instantiate the format by header data

	// if this fails, try using the file extension

	CMMFFormatDecode* ret = NULL;

	TInt err, errFile;

	TRAP(err, ret = NewL( buffer->Data(), aSource, aPreferredSupplier ));

	if (err != KErrNone && aSource->DataSourceType() == KUidMmfFileSource)

		{

		CMMFFile* mmfFile = static_cast<CMMFFile*> (aSource);

		TRAP(errFile, ret = NewL( mmfFile->FullName(), aSource, aPreferredSupplier ));

		if (errFile == KErrNone)

			err = errFile;

		}

	User::LeaveIfError(err);

	CleanupStack::PopAndDestroy() ; // buffer

	return ret ;

	}

/**

Attempts to locate and instantiate a CMMFFormatDecode using data from MDataSource.  

The data is expected to contain header data (from a file, stream or descriptor). Signatures 

(supplied by the plugin registry information) are sought in aSource.

@param  aSource

        Header data. Must be derived from CMMFClip.

@param  aPreferredSupplier

        If this is provided, the list of matching plugins will be further searched for the latest version of a

        plugin supplied by the specified supplier.

@param  aSupportsCustomInterfaces

		Indicates whether the instantiated FormatDecode supports custom interfaces.

@return If successful returns an instantiated CMMFFormatDecode from a plugin. If not successful, leaves with KErrNotFound.

*/

EXPORT_C CMMFFormatDecode* CMMFFormatDecode::NewL( MDataSource* aSource, const TDesC& aPreferredSupplier, TBool& aSupportsCustomInterfaces )

	{

	// Read header data from aSource.  Call source header version

	if ( !( (aSource->DataSourceType() == KUidMmfFileSource ) || ( aSource->DataSourceType() == KUidMmfDescriptorSource) ) )

		User::Leave( KErrNotSupported ) ;

	CMMFDataBuffer* buffer = CMMFDataBuffer::NewL(KMmfHeaderBufferSize) ;

	CleanupStack::PushL( buffer ) ;

	aSource->SourcePrimeL();

	TCleanupItem srcCleanupItem(DoDataSourceStop, aSource);

	CleanupStack::PushL(srcCleanupItem);

	STATIC_CAST( CMMFClip*, aSource )->ReadBufferL( buffer, 0 ) ;

	CleanupStack::Pop();

	aSource->SourceStopL();

	// attempt to instantiate the format by header data

	// if this fails, try using the file extension

	CMMFFormatDecode* ret = NULL;

	TInt err, errFile;

	TRAP(err, ret = NewL( buffer->Data(), aSource, aPreferredSupplier, aSupportsCustomInterfaces ));

	if (err != KErrNone && aSource->DataSourceType() == KUidMmfFileSource)

		{

		CMMFFile* mmfFile = static_cast<CMMFFile*> (aSource);

		TRAP(errFile, ret = NewL( mmfFile->FullName(), aSource, aPreferredSupplier, aSupportsCustomInterfaces ));

		if (errFile == KErrNone)

			err = errFile;

		}

	User::LeaveIfError(err);

	CleanupStack::PopAndDestroy() ; // buffer

	return ret ;

	}

CMMFFormatEncode* CMMFFormatEncode::CreateFormatL(TUid aUid, MDataSink* aSink)

	{

	CMMFFormatEncode* s = REINTERPRET_CAST( CMMFFormatEncode*,

									REComSession::CreateImplementationL( aUid, _FOFF( CMMFFormatEncode, iDtor_ID_Key ),

									STATIC_CAST( TAny*, aSink ) ) ) ;

	s->iImplementationUid = aUid;

	return s;

	}

/**

Allocates and constructs an ECom format encode object.

@param  aUid

        The implementation UID.

@param  aSink

        The data sink.

@return If successful, returns the address of the format decode plugin object created. If not successful,

        leaves with KErrNotFound.

*/

EXPORT_C CMMFFormatEncode* CMMFFormatEncode::NewL( TUid aUid, MDataSink* aSink )

	{

	return CreateFormatL(aUid, aSink);

	}

/**

Attempts to locate and instantiate a CMMFFormatEncode using a filename or an extension.

Only the extension of the supplied file name is used. If no extension is supplied (ie. no dot is present)

the whole of the filename will be treated as the extension.

@param  aFileName

        File name of target file. May be extension only or may include the full path.

@param  aSink

		The data source.

@param  aPreferredSupplier

        If this is provided, the list of matching plugins will be further searched for the latest version of a

        plugin supplied by supplier named.

@return If successful, returns the address of the format decode plugin object created. If not successful,

        leaves with KErrNotFound.

*/

EXPORT_C CMMFFormatEncode* CMMFFormatEncode::NewL( const TDesC16& aFileName, MDataSink* aSink, const TDesC& aPreferredSupplier )

	{

	CMMFFormatEncodePluginSelectionParameters* pluginSelector = CMMFFormatEncodePluginSelectionParameters::NewLC();

	CMMFFormatSelectionParameters* formatParams = CMMFFormatSelectionParameters::NewLC();

	formatParams->SetMatchToFileNameL(aFileName);

	pluginSelector->SetRequiredFormatSupportL(*formatParams);

	if (aPreferredSupplier.Length() > 0)

		pluginSelector->SetPreferredSupplierL(aPreferredSupplier, CMMFPluginSelectionParameters::EOnlyPreferredSupplierPluginsReturned);

	TUid chosenUid = MMFFormatEcomUtilities::SelectFormatPluginL(*pluginSelector);

	// Instantiate this format

	CMMFFormatEncode* theChosenOne = CreateFormatL(chosenUid, aSink);

	// Now clean up.

	CleanupStack::PopAndDestroy(2);//formatParams, pluginSelector

	return theChosenOne;

	}

/**

Attempts to locate and instantiate a CMMFFormatEncode using data in the specified buffer.

The buffer is expected to contain header data (from a file, stream or descriptor).

Signatures (supplied by the plugin registry information) are sought in aSourceHeader.

@param  aSourceHeader

        The data which is searched for matching signatures.

@param  aSink

        The data sink.

@param  aPreferredSupplier

        If this is provided the list of matching plugins will be further searched for the latest version of a

        plugin supplied by supplier named.

@return If successful, returns the address of the format decode plugin object created. If not successful,

        leaves with KErrNotFound.

*/

EXPORT_C CMMFFormatEncode* CMMFFormatEncode::NewL( const TDesC8& aSourceHeader, MDataSink* aSink,  const TDesC& aPreferredSupplier )

	{

	CMMFFormatEncodePluginSelectionParameters* pluginSelector = CMMFFormatEncodePluginSelectionParameters::NewLC();

	CMMFFormatSelectionParameters* formatParams = CMMFFormatSelectionParameters::NewLC();

	formatParams->SetMatchToHeaderDataL(aSourceHeader);

	pluginSelector->SetRequiredFormatSupportL(*formatParams);

	if (aPreferredSupplier.Length() > 0)

		pluginSelector->SetPreferredSupplierL(aPreferredSupplier, CMMFPluginSelectionParameters::EOnlyPreferredSupplierPluginsReturned);

	TUid chosenUid = MMFFormatEcomUtilities::SelectFormatPluginL(*pluginSelector);

	// Instantiate this format

	CMMFFormatEncode* theChosenOne = CreateFormatL(chosenUid, aSink);

	// Now clean up.

	CleanupStack::PopAndDestroy(2);//formatParams, pluginSelector

	return theChosenOne;

	}

/**

Attempts to locate and instantiate a CMMFFormatEncode using data from aSink.

The data is expected to contain header data (from a file, stream or descriptor).

Signatures (supplied by the plugin registry information) are sought in the source header.

@param  aSink

        The header data. Must be derived from CMMFClip.

@param  aPreferredSupplier

        If this is provided, the list of matching plugins will be further searched for the latest version of a

        plugin supplied by supplier specified.

@return If successful, returns the address of the format decode plugin object created. If not successful,

        leaves with KErrNotFound.

*/

EXPORT_C CMMFFormatEncode* CMMFFormatEncode::NewL( MDataSink* aSink, const TDesC& aPreferredSupplier )

	{

	// Read header data from aSource.  Call source header version if there is header data, file name version otherwise.

	if ( !( (aSink->DataSinkType() == KUidMmfFileSink ) || ( aSink->DataSinkType() == KUidMmfDescriptorSink) ) )

		User::Leave( KErrNotSupported ) ;

	CMMFDataBuffer* buffer = CMMFDataBuffer::NewL(KMmfHeaderBufferSize) ;

	CleanupStack::PushL( buffer ) ;

	aSink->SinkPrimeL();

	TCleanupItem sinkCleanupItem(DoDataSinkStop, aSink);

	CleanupStack::PushL(sinkCleanupItem);

	STATIC_CAST( CMMFClip*, aSink )->ReadBufferL( buffer, 0 ) ;

	CleanupStack::Pop();

	aSink->SinkStopL();

	CMMFFormatEncode* ret = NULL ;  // set to null to avoid compiler warning.

	// Check for data in the buffer

	if (  buffer->BufferSize() != 0 )

		ret = NewL( buffer->Data(), aSink, aPreferredSupplier ) ;

	else if ( aSink->DataSinkType() == KUidMmfFileSink )

		ret = NewL( STATIC_CAST(CMMFFile*, aSink)->Extension(), aSink, aPreferredSupplier ) ;

	else

		User::Leave( KErrNotSupported ) ;

	CleanupStack::PopAndDestroy() ; // buffer

	return ret ;

	}

TUid MMFFormatEcomUtilities::SelectFormatPluginL(const CMMFFormatPluginSelectionParameters& aSelectParams)

	{

	RMMFFormatImplInfoArray pluginArray;

	CleanupResetAndDestroyPushL(pluginArray);

	aSelectParams.ListImplementationsL(pluginArray);

	// Just leave if no implementations were found

	if (pluginArray.Count() == 0)

		User::Leave(KErrNotSupported);

	// Return the uid of the first plugin in the list

	TUid ret = pluginArray[0]->Uid();

	CleanupStack::PopAndDestroy();//pluginArray

	return ret;

	}

/*

 * instantiate each format decode plugin in turn until we find one that works

 */

CMMFFormatDecode* MMFFormatEcomUtilities::SelectFormatDecodePluginL(const CMMFFormatPluginSelectionParameters& aSelectParams, MDataSource* aSource)

	{

	RMMFFormatImplInfoArray pluginArray;

	CleanupResetAndDestroyPushL(pluginArray);

	aSelectParams.ListImplementationsL(pluginArray);

	TInt pluginCount = pluginArray.Count();

	CMMFFormatDecode* theChosenOne = NULL;

	TInt err = KErrNotSupported;

	for (TInt n=0; n<pluginCount; n++)

		{

		// Try to instantiate this format

		TRAP(err, theChosenOne = CMMFFormatDecode::NewL(pluginArray[n]->Uid(), aSource));

		// Ensure OOM or any unexpected error is caught immediately 

		// i.e. don't try the next plugin

		if (err != KErrNotSupported && err != KErrCorrupt && err != KErrArgument)

			break;

		}

	User::LeaveIfError(err);

	CleanupStack::PopAndDestroy(&pluginArray);

	return theChosenOne;

	}

/*

 * instantiate each format decode plugin in turn until we find one that works

 */

CMMFFormatDecode* MMFFormatEcomUtilities::SelectFormatDecodePluginL(const CMMFFormatPluginSelectionParameters& aSelectParams, MDataSource* aSource, TBool& aSupportsCustomInterfaces)

	{

	RMMFFormatImplInfoArray pluginArray;

	CleanupResetAndDestroyPushL(pluginArray);

	aSelectParams.ListImplementationsL(pluginArray);

	TInt pluginCount = pluginArray.Count();

	CMMFFormatDecode* theChosenOne = NULL;

	TInt err = KErrNotSupported;

	CMMFFormatImplementationInformation* implInfo = NULL;

	for (TInt n=0; n<pluginCount; n++)

		{

		implInfo = pluginArray[n];

		// Try to instantiate this format

		TRAP(err, theChosenOne = CMMFFormatDecode::NewL(implInfo->Uid(), aSource));

		// Ensure OOM or any unexpected error is caught immediately 

		// i.e. don't try the next plugin

		if (err != KErrNotSupported && err != KErrCorrupt && err != KErrArgument)

			break;

		}

	User::LeaveIfError(err);

	aSupportsCustomInterfaces = implInfo->SupportsCustomInterfaces();

	CleanupStack::PopAndDestroy(&pluginArray);

	return theChosenOne;

	}