/** @file
* Copyright (c) 2005-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:  Declares ProtocolInfo field wrapper. 
*
*/


#ifndef C_CUPNPPROTOCOLINFOLOCAL_H
#define C_CUPNPPROTOCOLINFOLOCAL_H

#include <e32base.h>
#include "upnpdlnaprotocolinfo.h"

	_LIT8( KOneChar, "1" );
	_LIT8( KZeroChar, "0" );

	_LIT8( KDEFAULT_1ST_PARAM, "http-get");
	_LIT8( KDEFAULT_STAR_PARAM, "*");

	const char KDlnaDelimeter = ';';
	const char KDlnaTokenizer = '=';
	const char KDlnaAllStar = '*';

	//Length of string from which should be serialized TInt into iDlnaFlags
	const TInt KMAX_INT_LENGTH_STRING = 8 ;

	// There are only 4 TInt32 or TUint32 flags serialized in DLNA.ORG_FLAGS parameter.
	const TInt KDLNA_FLAGS_NUMBER = 4; 
	//to represent the 32-byte-size of TUIn32
	const TInt K32BIT = 32;
	//number of all flags
	const TInt KDLNA_FLAGS_QUANTITY = KDLNA_FLAGS_NUMBER * K32BIT;
	
	_LIT8(KAllValues, "*");

	_LIT8( KDLNA_PN, "DLNA.ORG_PN");
	_LIT8( KDLNA_OP, "DLNA.ORG_OP");
	_LIT8( KDLNA_PS, "DLNA.ORG_PS");
	_LIT8( KDLNA_CI, "DLNA.ORG_CI");
	_LIT8( KDLNA_FLAGS, "DLNA.ORG_FLAGS");

	const char KDLNA_BOOLEAN_FALSE = '0';
	const char KDLNA_BOOLEAN_TRUE = '1';

	enum ADDITIONAL_INFO
		{
		NO_DLNA_DATA = -1,
		NO_ADDITIONAL_INFO = 0,
		JPEG_SM = 1, 
		JPEG_MED, 
		JPEG_LRG,
		JPEG_TN,	
		JPEG_SM_ICO,
		JPEG_LRG_ICO,
		PNG_TN, 
		PNG_SM_ICO,
		PNG_LRG_ICO,
		PNG_LRG, 
		MP3, 
		};

	_LIT8(KMT_IMAGE_JPEG, "image/jpeg");
	_LIT8(KMT_IMAGE_PNG, "image/png");
	_LIT8(KMT_IMAGE_GIF, "image/gif");
	_LIT8(KMT_IMAGE_BMP, "image/bmp");
	_LIT8(KMT_AUDIO_MP3, "audio/mpeg");
	_LIT8(KMT_TEXT_PLAIN, "text/plain");

	_LIT8( KMimeImage,      "image" );		
	_LIT8( KMimeAudio,      "audio" );
	_LIT8( KMimeVideo,      "video" );

	_LIT8(KDEFAULT_FOURTH_FIELD_OP_PATTERN, "*DLNA.ORG_OP=??*");
	_LIT8(KDEFAULT_FOURTH_FIELD_AVIMAGE_PATTERN, "*DLNA.ORG_FLAGS=????????????????????????????????*");
	
class CUpnpProtocolInfoLocal: public CUpnpDlnaProtocolInfo
{
	
	private:
    	 /** 
    	 * Constructor of the class     	 
    	 */
    	 CUpnpProtocolInfoLocal();

	
	public: 
	
    	 /**
    	 * Destructor of the class. 
    	 */
    	 virtual ~CUpnpProtocolInfoLocal();	
    	 
    	 /**
    	 * Method for creating instance of class. 
    	 * aInputString has to contain protocolInfo string. 
    	 */
    	IMPORT_C static CUpnpProtocolInfoLocal* NewL(const TDesC8& aInputString);
    	 
    	 /**
    	 * Creates Default value of ProtocolInfo containing DLNA.ORG_PN specific data. 
    	 * aMimeType - name of mime type for file. 
    	 * aAdditionalInfo - additional information about what DLNA.ORG_PN type should be used. 
    	 * Default behaviour is choosen according to aMimeType, when aAdditionalInfo is equal to NO_ADDITIONAL_INFO.
    	 * image/jpeg 	---- JPEG_LRG
    	 * image/png  	---- PNG_LRG
    	 * audio/mp3	---- MP3
    	 * rest not defined. 
    	 */
    	IMPORT_C static CUpnpProtocolInfoLocal* NewL(const TDesC8& aMimeType, TInt aAdditionalInfo);
    	IMPORT_C static CUpnpProtocolInfoLocal* NewL(const TDesC8& aMimeType, const TDesC8& aDlnaPn);
	
    //MEMBER METHODS used internally 	
	private: 
	
    	 /**
    	 *  Method for creating instance of class. 
    	 * aInputString has to contain protocolInfo string. 
    	 */
    	 void ConstructL(const TDesC8& aInputString);	 	 
    	 void ConstructFromDlnaPnL(const TDesC8& aMimeType, const TDesC8& aDlnaPn);	 
    	 
    	 /**
    	 * Creates object for further use. 
    	 * uses DefaultValue. 
    	 * aMimeType - mime type will be compared case insensitive. 
    	 * aAdditionalInfo - flag saying which specific DLNA.ORG_PN should be used. 
    	 *   values taken from ADDITIONAL_INFO
    	 */  
    	 void ConstructL(const TDesC8& aMimeType, TInt aAdditionalInfo);
	 
	 private:
	 
    	 /**
    	 * Main function for creating from mime type. 
    	 * See ConstructL(TDesC8&, TInt)
    	 */
    	 void ChooseDlnaL(const TDesC8& aMimeType, TInt aAdditionalInfo);
    	 		 
    	 /**
    	 * Fills up default values to create protocolInfo in form: "http-get:*:*:*"
    	 */
    	 void DefaultValuesL();
    	 
    	 /**
    	 * Fills dlna parameters according only to additionalInfo which is int value. 
    	 * aAdditionalInfo - int value denoting value which should be taken into consideration.
    	 */
    	 void FillAccordingToAddInfoL(TInt aAdditionalInfo);

    	 /**
    	 * Fills dlna parameters according only to info in mime type. 
    	 * aMimeType - name of a mime type.
    	 */
    	 void FillAccordingToMimeL(const TDesC8& aMimeType);
    	 
    	 /**
    	 * Does nothing.
    	 */
    	 void ZeroParameters();    
    	 
    	 /**
    	 * This member function sets defult values for optional parameters 
    	 * of 4-th field of protocolInfo 
    	 * Value for Audio/Video:
    	 * DLNA.ORG_OP=01;DLNA.ORG_FLAGS=01500000000000000000000000000000
    	 * Value for Image :
    	 * DLNA.ORG_OP=01;DLNA.ORG_FLAGS=00D00000000000000000000000000000
    	 *
    	 */
    	 void SetDefaultFourthField();     	     	 	 	 	 	 
    	 
    	 /**
         * This function produces a string containing all info taken from fourth ProtocolInfo field    	 
         * aBuffer - on this variable values are appended. 
         */
         virtual void GetFourthParameterInternalL(TDes8& aBuffer);     	 	 	 	 	 
};

#endif // C_CUPNPPROTOCOLINFOLOCAL_H
// End of file