/*
* Copyright (c) 2006 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:    
*
*/



#ifndef CMCEMSRPSOURCE_H
#define CMCEMSRPSOURCE_H

// INCLUDES
#include <mcemediasource.h>
#include <e32std.h>
#include <bamdesca.h>
#include<uri8.h>
#include<e32des8.h>
#include <mcemessagestream.h>
#include <badesca.h>

// CONSTANTS
const TMceSourceType KMceMSRPSource = 5;

// CLASS DECLARATION
/**
* Class representing a MSRP source (RFC 4975).
* 
*  @lib mceclient.lib
*/
class CMceMsrpSource: public CMceMediaSource
    {
    public: // Constructors and destructor

        /**
        * Two-phased constructor.        
        */
        IMPORT_C static CMceMsrpSource* NewL();
	
		/**
        * Two-phased constructor.
        */
		IMPORT_C static CMceMsrpSource* NewLC();

        /**
        * Destructor.
        */
        IMPORT_C ~CMceMsrpSource();

    public: // From CMceMediaSource

        /**
        * Sets the source enabled.
        */
        IMPORT_C void EnableL(); 

        /**
        * Sets the source disabled.
        */
        IMPORT_C void DisableL();

    public: // New functions

        /**
            * Gets the value for "path" attribute.
            */
            IMPORT_C RPointerArray<TUriC8>& Path();

        /**
            * Sets the value for "path" attribute.
            */
            IMPORT_C void SetPathL( const RPointerArray<TUriC8>& aPath );

        /**
            * Gets the values for "accept-types" attribute.
            */
            IMPORT_C void AcceptTypesL(CDesC8ArrayFlat& aAcceptTypes); 

        /**
            * Sets the values for "accept-types" attribute.
            */
            IMPORT_C void SetAcceptTypesL( const MDesC8Array& aAcceptTypes );
            
            /**
             * Gets the values for "accept-wrapped-types" attribute
             */
            
            IMPORT_C TDes8& AcceptWrappedTypesL();
            
            /**
             * Sets the values for "accept-wrapped-types" attribute.
             * @param aAcceptWrappedTypes list of MIME types that are allowed inside compound types 
             */
            
            IMPORT_C void SetAcceptWrappedTypesL ( const TDes8& aAcceptWrappedTypes );
            
            /**
             * Sets the values for file-selector attributes ('name', 'type', 'size').
             * @param aName name of the file to be transferred
             * @param aPath path of the file to be transferred
             */            
            IMPORT_C void SetFileSelectorL(const TDesC& aName = KNullDesC,
                                           const TDesC8& aFileType = KNullDesC8,
                                           const TUint aSize = 0 );
            
            /**
             * Sets the value for file-disposition attribute.
             * @param aVar indicate a preferred disposition of the file to be transferred
             */            
            IMPORT_C void SetFileDispositionL (const TDes8& aDispositionValue);
            
            /**
             * Sets the value for file-transfer-id attribute.
             * @returns the value of the file-transfer-id
             */
            IMPORT_C void SetFileTransferIdL (TDes8& aId);
            
            /**
             * Sets the information attribue.
             * @param aInfo information to be set 
             */
            IMPORT_C void SetInformationAttrL(const TDes8& aInfo);
            
            /**
             * Set the path to save the received file in file sharing use case
             * It is mandatory for the clients to set this path to let
             * the MCE know the path where the received file will be saved
             * 
             * @Param aFilePath Holds the path to save the received file
             */
            IMPORT_C void SetPathToSaveReceivedFile(const TDesC16& aFilePath);
            
            /*
             * Used to get the file transfer progress notifications like transferred x bytes 
             * out of total y file size. This is true by default. 
             * @param enableFlag Default value is ETrue. 
             */
            IMPORT_C void EnableFileTransferProgressNotifications(TBool enableFlag = ETrue);
            
    public: // for internal purpose
        /**
         * Calls to set the local media port from the MSRP URI
         * @return Symtem wide error if the path attribute is not set for the aParent
         */
        void InitializeL( CMceMediaStream& aParent );
      
      private: 
		
		/**
	     * C++ default constructor.
	     */
        CMceMsrpSource();		
		
		/**
	     * Second phase constructior.
	     */
		 void ConstructL();
	 
		 /**
		  * Sets the local media port form the MSRP path attribute
		  * @par aMsrpUri The Uri from which the port has to be extracted
		  * @aStream  Sets the local media port with the port extracted form the aMsrpUri 
		  */
		 void SetPortFromPathAttrL(TUriC8& aMsrpUri, CMceMessageStream& aStream);
		 
		 //for testing

		 MCE_UNIT_TEST_DEFS  

    };


#endif // CMCEMSRPSOURCE_H