/*
* 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:        Preparation XOP message for HTTP transmission in case 
*				 of request	and extracting BLOBs from XOP message responsed 
*				 through HTTP channel in case of response
*
*/








#ifndef SEN_MultiPart_UTILS_H
#define SEN_MultiPart_UTILS_H

#include <e32math.h>
#include <SenSoapEnvelope2.h>
#include "senatomentry.h"
#include <RSenDocument.h>

#include <xmlengserializer.h>
#include <xmlengchunkcontainer.h>
#include <xmlengfilecontainer.h>
#include <xmlengbinarycontainer.h>
#include <xmlengnodelist.h>

// CONSTANTS
_LIT(KMultiPartNoRequestMessagePanicText, "NULL MultiPart request message");
_LIT(KMultiPartNoBlobsPanicText, "NULL MultiPart BLOB part");
_LIT(KMultiPartNoContentTypeInBlobHeaderPanicText, "NULL MultiPart ContentType in BLOB header");
_LIT(KMultiPartNoCidPanicText, "NULL MultiPart Cid");
_LIT(KMultiPartSoapVersionInvalidPanicText, "MultiPart SOAP version unknown");
_LIT(KMultiPartBlobContainerTypeInvalidPanicText, "MultiPart BLOB container type unknown");
_LIT(KMultiPartResponseBodyInvalidPanicText, "MultiPart response body doesn't conform XOP rules");
_LIT(KMultiPartCidInvalidPanicText, "MultiPart Cid doesn't conform XOP rules");

_LIT(KMultiPartPanicText, "MultiPart panic");



/** numbers 11 or 12 at the end of constant names mean SOAP versions (1.1 or 1.2) */
_LIT8(KMultiPartHeaderRootStart11, "Content-Type: application/xop+xml;charset=UTF-8;type=\"text/xml\"\r\nContent-Transfer-Encoding: 8bit\r\nContent-ID: <");
_LIT8(KMultiPartHeaderRootStart12, "Content-Type: application/xop+xml;charset=UTF-8;type=\"application/soap+xml\"\r\nContent-Transfer-Encoding: binary\r\nContent-ID: <");
_LIT8(KMultiPartAtomHeaderRootStart, "Content-Type: application/atom+xml;charset=UTF-8;type=\"text/xml\"\r\nContent-Transfer-Encoding: 8bit\r\nContent-ID: <");
_LIT8(KMultiPartHeaderRootEnd, ">\r\n\r\n");    

_LIT8(KMultiPartContentTypeName, "contentType");
_LIT8(KMultiPartDefaultBinaryContentTypeValue, "application/octet-stream)");// video/mp4 or video/x-flv
_LIT8(KMultiPartHeaderBinaryDataContentType, "Content-Type: ");
_LIT8(KMultiPartHeaderBinaryDataContentID, "\r\nContent-Transfer-Encoding: binary\r\nContent-ID: <");
_LIT8(KMultiPartHeaderBinaryDataEnd, ">\r\n\r\n"); 

const TUint KTenKBytes = 10240;
_LIT8(KNewLine, "\r\n");
_LIT8(KDush, "--");

/** the common part of file name where will be stored Blobs from Response */
_LIT(KFileName, "c:\\SenBlobResponses\\SenBlobResponse");

/**
 * Prepares XOP message with binary data to transmit it through HTTP Channel
 * and extracts BLOBs from XOP message responsed through HTTP channel 
 *
 * @lib
 * @since S60 v3.2
 */
class SenMultiPartUtils
	{
public:

    /**
     * different cases of panics
     */
     enum TMultiPartPanics
	    {
	    EMultiPartNoRequestMessage,
	    EMultiPartNoBlobs,
	    EMultiPartNoContentTypeInBlobHeader,
	    EMultiPartNoCid,
	    EMultiPartSoapVersionInvalid,
	    EMultiPartBlobContainerTypeInvalid,
	    EMultiPartResponseBodyInvalid,
	    EMultiPartCidInvalid
	    };

    /**
     * ContentType for MultiPart consists of 
     * FiledName = "Content-Type" FiledValue = "Multipart/Related"
     * ParamName1 = "boundary" 	  ParamValue1 = BoundaryValue
     * ParamName2 = "type"  	  ParamValue1 = TypeValue
     * ParamName1 = "start" 	  ParamValue1 = StartValue
     * ParamName1 = "start-info"  ParamValue1 = StartInfoValue
     * ParamName1 = "action" 	  ParamValue1 = ActionValue
     * This structure describes ParamName & ParamValue of ConetentType
     */ 
    struct TMultiPartContentTypeParam
        {
        TPtrC8 paramName;
        TPtrC8 paramValue;
        };	    
    
    /**
     * This structure describes FieldValue & Params of ContentType
     */
    struct TMultiPartContentType
        {
        TPtrC8 fieldValue;
        RArray<TMultiPartContentTypeParam> params;
        };

public:

    /**
     * Serializes SenMessage message in MultiPart message
     * @since S60 v5.0
     * @param aMessage The message with multiparts (usual view of message)
     * @param aMultiPartMessage The message serialized from usual view to MultiPart message
     * @param aType mode of serialization (see xmlengserializer.h)
     */	
	IMPORT_C static void SerializeMessageL(CSenFragmentBase& aMessage, 
	                                         RBuf8& aMultiPartMessage,
	                                         TXmlEngSerializerType aType = ESerializerXOPInfoset);
	
    /**
   	 * Generates random content-ID for header of XOP message and for headers of BLOBs 
     * as randomNumber@homeTime
   	 * @since S60 v3.2     
   	 * @param aRootCid Generated content-ID
   	 */
 	IMPORT_C static void GenerateRandomRootCidL(RBuf8& aRootCid);
 	
 	/**
	* Generates random boundary for mime header as randomNumber
	* @since S60 v3.2
	* @param aBoundary Generated random boundary
	*/
 	IMPORT_C static void GenerateRandomBoundaryL(RBuf8& aBoundary);
 	
 	/**
 	* Generates MimeBoundary to separate mime parts of the message as --randomNumber
 	* @since S60 v3.2
 	* @param aBoundary random boundary
 	* @param aBoundaryStart Generated MIME boundary
 	*/
 	IMPORT_C static void BoundaryLineStartL(const RBuf8& aBoundary, RBuf8& aBoundaryStart);
 	
 	/**
 	* Generates MimeBoundaryEnd to end multipart message (MultiPart) as --randomNumber--
 	* @since S60 v3.2
 	* @param aBoundary random boundary
 	* @param aBoundaryEnd Generated MIME boundary end
 	*/
  	IMPORT_C static void BoundaryLineEndL(const RBuf8& aBoundary, RBuf8& aBoundaryEnd);

    /**
     * Creates Header for Root of XOP message or other multiPart message
     * The header sould be the next:
     *
     * --MIME_boundary
     * Content-Type: application/xop+xml; 
     * charset=UTF-8; 
     * type="text/xml" (for SOAP 1.1) or "application/soap+xml" (for SOAP 1.2)
     * Content-Transfer-Encoding: 8bit
     * Content-ID: <randomNumber@homeTime>
     *
     * where "Content-ID" is the same as "start" in Header of Outer Package
     *
     * @since S60 v3.2
     * @param aMessage The message with multiparts
     * @param aRootCid The content ID for the header of XOP or other multiPart message
     * @param aHeaderRoot11  Header of root of XOP message or other multiPart message
     */
     IMPORT_C static void HeaderRootL(MSenMessage* aMessage,
    							     const RBuf8& aRootCid, RBuf8& aHeaderRoot);
	
    /**
     * Creates Header for Binary Data[aIndex] of XOP message 
     * The header sould be the next:
	 *
     * --MIME_boundary
	 * Content-Type: image/png
	 * Content-Transfer-Encoding: binary
	 * Content-ID: <randomNumber@homeTime>
	 *
	 * @since S60 v3.2
     * @param aIndex Which BLOB from array of TXmlEngDataContainer is processed, starts from 0
     * @param aBinaryDataList The list of BLOBs
     * @param aHeaderBinaryData Header of binary data[aIndex]
     */
    IMPORT_C static void HeaderBinaryDataL(TUint aIndex, 
									       RArray<TXmlEngDataContainer>& aBinaryDataList,
			 						 	   RBuf8& aHeaderBinaryData);

    /**
     * Extracts a part of BLOB (10KB) from a file
     * @since S60 v3.2
     * @param aPart Which part of BLOB should be extracted
     * @param aIndex Which BLOB from array of TXmlEngDataContainer is processed, starts from 0
     * @param aBinaryDataList The list of BLOBs
     * @param aBinaryData Part of BLOB that was extracted from a file
     */
    IMPORT_C static void FileDataPartL(TUint aPart, TUint aIndex, 
								       RArray<TXmlEngDataContainer>& aBinaryDataList,
						       	       RBuf8& aBinaryData);									 

    /**
     * Extracts the rest of BLOB (less than 10KB) from a file
     * @since S60 v3.2
     * @param aParts How many parts of BLOB has already been extracted from a file
     * @param aRest How many bytes should be exracted from a file 
     * @param aIndex Which BLOB from array of TXmlEngDataContainer is processed, starts from 0
     * @param aBinaryDataList The list of BLOBs
     * @param aBinaryData The last part of BLOB that was extracted from a file
     */
    IMPORT_C static void FileDataRestL(TUint aParts, TUint aRest, TUint aIndex, 
								       RArray<TXmlEngDataContainer>& aBinaryDataList,
						       	       RBuf8& aBinaryData);									 

    /**
     * Extracts CIDs of BLOBs from response MultiPart message
     * @since S60 v3.2
     * @param aBlobHeader Header of Blob from that should be extracted CID of BLOB
     * @param aCids Array of CIDs for all BLOBs    
     */
    IMPORT_C static void CidL(const RBuf8& aBlobHeader, RArray<RBuf8>& aCids);

    /**
     * Extracts BLOB from response MultiPart message and writes it in a file
     * @since S60 v3.2
     * @param aIndex Which BLOB from response is processed, starts from 0
     * @param aFirst Shows is it First part of BLOB or not
     * @param aBlob The part of BLOB from response that should be written in fhe file
     * @param aFileNames Array of File names for the all responsed BLOBs
     * @return size of file in order to monitor progess
     */	
    IMPORT_C static TInt SetFileL(TUint aIndex, TBool aFirst, TDesC8& aBlob, 
                                  RArray<RBuf8>& aFileNames);

private:													
		
    /**
     * Generates the file name for BLOB of response MultiPart message 
     * and collects it in array of file names for the all BLOBs
     * @since S60 v3.2
     * @param aIndex Which BLOB from response is processed, starts from 0
     * @param aFileNames Array of File names for the all responsed BLOBs
     */
     static void FileNameL(TUint aIndex, RArray<RBuf8>& aFileNames);
	};
									 
#endif // SEN_MultiPart_UTILS_H

// End of file