--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/webservices/wsframework/inc/senmtomutils.h Thu Jan 07 16:19:19 2010 +0200
@@ -0,0 +1,259 @@
+/*
+* 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 <imcvcodc.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
+
+