email/pop3andsmtpmtm/servermtmutils/inc/cimconvertheader.h
author Simon Howkins <simonh@symbian.org>
Mon, 22 Nov 2010 17:05:03 +0000
branchRCL_3
changeset 83 26c290f28dd1
parent 0 72b543305e3a
permissions -rw-r--r--
Removed duplicate instructions for creating some messaging MIFs

// Copyright (c) 2009 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:
// cimconvertheader.h
//
/**
 * @file
 * @internal
 * @released
 */

#if !defined(__CIMCONVERTHEADER_H__)
#define __CIMCONVERTHEADER_H__

#include <s32buf.h>
#include <s32stor.h>
#include <txtrich.h>
#include <miutatch.h>
#include <miutconv.h>
#include <miuthdr.h>
#include <mentact.h>		// CMsgActive

#include <imcvdata.h>
#include <imcvtext.h>
#include <imutdll.h>
#include <imcvcodc.h>
#ifdef SYMBIAN_ENABLE_SPLIT_HEADERS  
#include "timrfc822datefield.h"	
#include "cimconvertcharconv.h"				
#endif

/**
Maximum length allowed for an 'encoded-word' rfc2047
@internalComponent
@released
*/
const TInt KEncodedWordMaxLength = 75;

/**
All encoding information except data and charset name length. =?B?=?    => 7
@internalComponent
@released
*/
const TInt KMaxEncodedInformationLength = 7;

/**
Length of the field name, eg "Subject: ". This may change as other fields are processed.
@internalComponent
@released
*/
const TInt KMaxHeaderFieldNameLength = 12;

/**
@internalComponent
@released
*/
const TInt KImCvFinished=(-1);
const TInt KImCvAdvance=(1);

// error states involved in sending attachments etc.
/**
@internalComponent
@deprecated
*/
enum TIattErrorCode
	{
	KImAttNoError = 0,
	KImAttFinished = 1
	};


/**
@internalComponent
@released
*/
enum TImBodyConvAlgorithm
	{
	ENoAlgorithm,
	EQPEncode,
	EQPDecode,
	EBase64Encode,
	EBase64Decode,
	EUUEncode,
	EUUDecode
	};
	
// Used in CImSendConvert
/**
@internalComponent
@deprecated
*/
enum TImSendEncoding 
	{ 
	ESendNoAlgorithm,
	ESendMimeAlgorithm
	};	

struct SAttachmentInfo
/**
@internalComponent
@released
*/
	{
	TInt iSize;
	TFileName iName;
	TFileName iPath;
	TBool iComplete;
	};

class TImCodecB64WithLineBreaks : public TImCodecB64
/**
@internalComponent
@released
*/
	{
public:
	TInt Encode(const TDesC8& aSrcString, TDes8& rDestString);
	};

// For converting a text string to/from encoded form
// Note: 'Word' here has special meaning derived from the one defined in rfc2047.
// It refers to one encoding instance.

//----------------------------------------------------------------------------------------
class CImConvertHeader : public CBase
//----------------------------------------------------------------------------------------
/**
@internalTechnology
@released
*/
	{
public:
	IMPORT_C static CImConvertHeader* NewL(CImConvertCharconv& aConverter);
	~CImConvertHeader();

	IMPORT_C void SetMessageType(TBool aIsMIME); 
	IMPORT_C void DecodeAllHeaderFieldsL(CImHeader& rHeader); 

	// Functions for decoding & converting descriptors

	IMPORT_C void DecodeNonMIMEHeaderFieldL(const TDesC8& aBufIn, TDes& aBufOut); 
	IMPORT_C void DecodeHeaderFieldL(const TDesC8& aBufIn, TDes& aBufOut); 
	IMPORT_C void DecodeHeaderFieldL(const TDesC16& aBufIn, TDes& aBufOut); 
	IMPORT_C void ConvertHeaderFieldL(const TDesC16& aBufIn, RBuf8& aBufOut, TBool aIsAddressField); 
	
	// Header needed for retrieving encoding information, used in Send code.
    IMPORT_C void EncodeHeaderFieldL(const TDesC& aBufIn, RBuf8& aBufOut, 
            CArrayFix<TImHeaderEncodingInfo>* aInfoArray, TInt aState, TInt aArrayVal = 0);

	IMPORT_C void EncodeHeaderFieldL(const TDesC& aBufIn, RBuf8& aBufOut,  
		                             const TUint aCharset, const TImHeaderEncodingInfo::TEncodingType aType, TBool aIsAddressField);
	
	IMPORT_C TBool FindEncodedWord(TPtrC8& aData, TInt& aInit,TInt& rStart, TInt& rEnd);

	void Append(TDes& aBuffer, const TDesC8& aAddition);
	inline CImConvertCharconv& CharConv();

	IMPORT_C TUint OverrideCharset() const;
	IMPORT_C void SetOverrideCharset(TUint aCharset);

private:
	void ConstructL();
	CImConvertHeader(CImConvertCharconv&);
	// Functions dealing only with single 'encoded-word's
	void GetCharsetAndEncodeDataL(const TDesC& aBufIn, RBuf8& aBufOut, TImHeaderEncodingInfo& aInfo);
	void EncodeWordL(const TDesC& aBufIn, RBuf8& aBufOut, TImHeaderEncodingInfo& aInfo,
						const TDesC8& aCharsetName, RBuf8& aEncodedWord);

	TBool DecodeWordL(const TDesC8& aBufIn, TDes& aBufOut, TInt rRemainder); 
	void DecodeRecipientListL( CDesCArray& aArray);
	void DecodeFieldL(const TDesC& aField);

	TBool DoCharsetConversionL(const TDesC& aDataToConvert, RBuf8& aEncodedWord);

	void DoEncodingL(RBuf8& aEncodedWord, TImHeaderEncodingInfo& aInfo);

	TInt AddEncodedWordInfoL(const TDesC8& aEncodedWord, RBuf8& aBufOut, 
							 TImHeaderEncodingInfo& aInfo, const TDesC8& aCharsetName);

	TBool IsAscii( TUint aChar ) const;
	TBool ExtractTextToEncode(const TDesC& aBufIn, TInt& rStart, TInt& rEnd, TBool aIsAddressField);
	void Insert(TDes8& aBuffer, const TDesC16& aInsert);

private:
	TImHeaderEncodingInfo iEncodingInfo;
	CImConvertCharconv& iCharConv;

	// Get access to QP/ Base64 encoding/decoding functions
	TImCodecB64	 iB64Codec;
	TImCodecQP	 iQPCodec;

	// Need in the narrow build, to check if possible to convert to/from
	// the machines character set.
	TUint iCharacterSetId; 

	CImHeader* iHeader;	

	// Converted static variables used in EncodeWordL()
	TBool	isMIMEMessageHeader;
	TUint   iOverrideCharset;
	};

#include <imcvcodc.inl>

#endif //__CIMCONVERTHEADER_H__