/*
* Copyright (c) 2008-2008 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: Header declaration
*
*/
#ifndef SEN_MTOM_UTILS_H
#define SEN_MTOM_UTILS_H
#include <e32math.h>
#include <SenSoapEnvelope2.h>
#include <RSenDocument.h>
#include <xmlengserializer.h>
#include <xmlengchunkcontainer.h>
#include <xmlengfilecontainer.h>
#include <xmlengbinarycontainer.h>
#include <xmlengnodelist.h>
// CONSTANTS
_LIT(KMtomNoRequestSoapEnvelopePanicText, "NULL MTOM request soap envelope");
_LIT(KMtomNoBlobsPanicText, "NULL MTOM BLOB part");
_LIT(KMtomNoContentTypeInBlobHeaderPanicText, "NULL MTOM ContentType in BLOB header");
_LIT(KMtomNoCidPanicText, "NULL MTOM Cid");
_LIT(KMtomSoapVersionInvalidPanicText, "MTOM SOAP version unknown");
_LIT(KMtomBlobContainerTypeInvalidPanicText, "MTOM BLOB container type unknown");
_LIT(KMtomResponseBodyInvalidPanicText, "MTOM response body doesn't conform XOP rules");
_LIT(KMtomCidInvalidPanicText, "MTOM Cid doesn't conform XOP rules");
_LIT(KMtomPanicText, "MTOM panic");
const TUint KTenKBytes = 10240;
/** numbers 11 or 12 at the end of constant names mean SOAP versions (1.1 or 1.2) */
_LIT8(KHeaderRootStart11, "Content-Type: application/xop+xml;charset=UTF-8;type=\"text/xml\"\r\nContent-Transfer-Encoding: 8bit\r\nContent-ID: <");
_LIT8(KHeaderRootStart12, "Content-Type: application/xop+xml;charset=UTF-8;type=\"application/soap+xml\"\r\nContent-Transfer-Encoding: binary\r\nContent-ID: <");
_LIT8(KHeaderRootEnd, ">\r\n\r\n");
_LIT8(KContentTypeName, "contentType");
_LIT8(KHeaderBinaryDataContentType, "Content-Type: ");
_LIT8(KHeaderBinaryDataContentID, "\r\nContent-Transfer-Encoding: binary\r\nContent-ID: <");
_LIT8(KHeaderBinaryDataEnd, ">\r\n\r\n");
_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 SenMtomUtils
{
public:
/**
* different cases of panics
*/
enum TMtomPanics
{
EMtomNoRequestSoapEnvelope,
EMtomNoBlobs,
EMtomNoContentTypeInBlobHeader,
EMtomNoCid,
EMtomSoapVersionInvalid,
EMtomBlobContainerTypeInvalid,
EMtomResponseBodyInvalid,
EMtomCidInvalid
};
/**
* ContentType for MTOM 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 TMtomContentTypeParam
{
TPtrC8 paramName;
TPtrC8 paramValue;
};
/**
* This structure describes FieldValue & Params of ContentType
*/
struct TMtomContentType
{
TPtrC8 fieldValue;
RArray<TMtomContentTypeParam> params;
};
public:
/**
* Serializes SoapEnvelope message in XOP message
* @since S60 v3.2
* @param aSoapEnvelope2 The message with multiparts (usual view of Soap message)
* @param aXopEnvelope The message serialized from usual view to XOP message
*/
IMPORT_C static void SerializeEnvelope2L(CSenSoapEnvelope2& aSoapEnvelope2,
RBuf8& aXopEnvelope);
/**
* 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 (MTOM) 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
* 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 aSoapEnvelope2 The message with multiparts (usual view of Soap message)
* @param aRootCid The content ID for the header of XOP
* @param aHeaderRoot11 Header of root of XOP message
*/
IMPORT_C static void HeaderRootL(CSenSoapEnvelope2& aSoapEnvelope2,
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 MTOM 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 MTOM 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 MTOM 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_MTOM_UTILS_H
// End of file