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


/**
 @file
 @internalComponent
 @released
*/


#ifndef __F32AGENTFACTORY_H__
#define __F32AGENTFACTORY_H__

#include <caf/agentfactory.h>

namespace ContentAccess
	{
	class CAgentContent;
	class CAgentManager;
	class CAgentData;

	/** 
	 Creates products that allow access to plaintext unprotected files
	 via the Content Access Framework (CAF)
	 
	 The F32 agent is treated as a special case by CAF. It is 
	 the default agent used when no other suitable agent is found
	 for a particular operation.
	 
	 No translation of the content will occur and no access restrictions
	 will be enforced aside from the usual platform security data caging
	 rules.
	 
	 @internalComponent
	 @released
	 */
	class CF32AgentFactory : public CAgentFactory
		{
	public:
		/** Entry point for F32 Agent 
		@return a new F32AgentFactory instance
		*/
		static CAgentFactory* NewL();
		
		// From CAgentFactory
		virtual CAgentContent* CreateContentBrowserL(const TDesC& aURI, TContentShareMode aShareMode);	
		virtual CAgentContent* CreateContentBrowserL(RFile& aFile);
		virtual CAgentData* CreateDataConsumerL(const TVirtualPathPtr& aVirtualPath, TContentShareMode aShareMode);
		virtual CAgentData* CreateDataConsumerL(RFile& aFile, const TDesC& aUniqueId);
		virtual CAgentManager*  CreateManagerL();

		/** The F32 Agent cannot be used to receive files
		
		The CAF framework should know this is the F32 agent and never
		attempt to call this method
		
		@panic CAF EF32AgentImportNotSupported 
		*/
		virtual CAgentImportFile* CreateImporterL(const TDesC8& aMimeType, const CMetaDataArray& aMetaDataArray, const TDesC& aOutputDirectory, const TDesC& aSuggestedFileName);
		/** The F32 Agent cannot be used to receive files

		The CAF framework should know this is the F32 agent and never
		attempt to call this method

		@panic CAF EF32AgentImportNotSupported 
		*/
		virtual CAgentImportFile* CreateImporterL(const TDesC8& aMimeType, const CMetaDataArray& aMetaDataArray);
		/** The F32 Agent does not manage any rights

		The CAF framework should know this is the F32 agent and never
		attempt to call this method

		@panic CAF EF32AgentRightsManagerNotSupported 
		*/
		virtual CAgentRightsManager* CreateRightsManagerL();
			
		};
} // namespace ContentAccess
#endif // __F32AGENTFACTORY_H__
