CMsvMimeHeaders Class Reference

#include <mw/cmsvmimeheaders.h>

class CMsvMimeHeaders : public CBase

Inherits from

CMsvMimeHeaders

Public Member Enumerations
enum	TMsvEncodingType { EEncodingTypeUnknown, EEncodingTypeNone, EEncodingType7Bit, EEncodingType8Bit, ..., EEncodingTypeUU }

Public Member Functions
	~CMsvMimeHeaders()
IMPORT_C TBool	ContainsMimeHeaders(const CMsvAttachment &)
IMPORT_C const TDesC8 &	ContentBase()
IMPORT_C const TDesC8 &	ContentDescription()
IMPORT_C const TDesC8 &	ContentDisposition()
IMPORT_C CDesC8Array &	ContentDispositionParams()
IMPORT_C const CDesC8Array &	ContentDispositionParams()
IMPORT_C const TDesC8 &	ContentId()
IMPORT_C const TDesC16 &	ContentLocation()
IMPORT_C const TDesC8 &	ContentSubType()
IMPORT_C TMsvEncodingType	ContentTransferEncoding()
IMPORT_C TMsvEncodingType	ContentTransferEncoding(TPtrC8 &)
IMPORT_C const TDesC8 &	ContentType()
IMPORT_C CDesC8Array &	ContentTypeParams()
IMPORT_C const CDesC8Array &	ContentTypeParams()
IMPORT_C const TPtrC8	GetContentTypeValue(const TDesC8 &)
IMPORT_C TUint	MimeCharset()
IMPORT_C CMsvMimeHeaders *	NewL()
IMPORT_C CMsvMimeHeaders *	NewLC()
IMPORT_C const TDesC8 &	RelativePath()
IMPORT_C void	Reset()
IMPORT_C void	RestoreL(CMsvAttachment &)
IMPORT_C void	SetContentBaseL(const TDesC8 &)
IMPORT_C void	SetContentDescriptionL(const TDesC8 &)
IMPORT_C void	SetContentDispositionL(const TDesC8 &)
IMPORT_C void	SetContentIdL(const TDesC8 &)
IMPORT_C void	SetContentLocationL(const TDesC16 &)
IMPORT_C void	SetContentSubTypeL(const TDesC8 &)
IMPORT_C void	SetContentTransferEncoding(const TDesC8 &)
IMPORT_C void	SetContentTypeL(const TDesC8 &)
IMPORT_C void	SetMimeCharset(TUint)
IMPORT_C void	SetRelativePathL(const TDesC8 &)
IMPORT_C void	SetSuggestedFilenameL(const TDesC16 &)
IMPORT_C TInt	Size()
IMPORT_C void	StoreL(CMsvAttachment &)
IMPORT_C const TDesC16 &	SuggestedFilename()
IMPORT_C CDesC8Array &	XTypeParams()
IMPORT_C const CDesC8Array &	XTypeParams()

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Detailed Description

Utility class to represent commonly used Mime Headers. This object represents a number of common Mime Headers into a single class. It is intended that this class is used to represent the Mime Headers for an attachment represented by the CMsvAttachment class when using the Attachment API. The Mime header data can be associated with an attachment and stored and restored using the StoreL and RestoreL methods.

Member Enumeration Documentation

Enum TMsvEncodingType

Messaging encoding types.

Enumerator	Value	Description
EEncodingTypeUnknown		Unknown.
EEncodingTypeNone		None.
EEncodingType7Bit		7-bit.
EEncodingType8Bit		8-bit.
EEncodingTypeBinary		Binary.
EEncodingTypeQP		QP.
EEncodingTypeBASE64		Base64.
EEncodingTypeUU		UU.

Constructor & Destructor Documentation

~CMsvMimeHeaders ( )

IMPORT_C

~CMsvMimeHeaders

(

)

Standard destructor.

Member Function Documentation

ContainsMimeHeaders ( const CMsvAttachment & )

IMPORT_C TBool

ContainsMimeHeaders

(

const CMsvAttachment &

aAttachment

)

Enquire whether a CMsvAttachment has MIME headers without restoring all the headers.

Parameter	Description
aAttachment	The attachment.

Returns: True if there is an MIME headers

ContentBase ( )

IMPORT_C const TDesC8 &

ContentBase

(

)

const

Gets the Content-Base mime header.

Returns a zero length descriptor if mime header not set.

Returns: Descriptor containing the Content-Base mime header. Zero length if the mime header not set.

ContentDescription ( )

IMPORT_C const TDesC8 &

ContentDescription

(

)

const

Gets the Content-Description mime header.

Returns a zero length descriptor if mime header not set.

Returns: Descriptor containing the Content-Description mime header. Zero length if the mime header not set.

ContentDisposition ( )

IMPORT_C const TDesC8 &

ContentDisposition

(

)

const

Gets the Content-Disposition mime header.

Returns a zero length descriptor if mime header not set.

Returns: Descriptor containing the Content-Disposition mime header. Zero length if the mime header not set.

ContentDispositionParams ( )

IMPORT_C CDesC8Array &

ContentDispositionParams

(

)

Returns a modifiable descriptor array containing the Content-Disposition parameters.

Returns: A modifiable descriptor array.

ContentDispositionParams ( )

IMPORT_C const CDesC8Array &

ContentDispositionParams

(

)

const

Returns a non-modifiable descriptor array containing the Content-Disposition parameters.

Returns: A non-modifiable descriptor array.

ContentId ( )

IMPORT_C const TDesC8 &

ContentId

(

)

const

Gets the Content-Id mime header.

Returns a zero length descriptor if mime header not set.

Returns: Descriptor containing the Content-Id mime header. Zero length if the mime header not set.

ContentLocation ( )

IMPORT_C const TDesC16 &

ContentLocation

(

)

const

Gets the Content-Location mime header.

Returns a zero length descriptor if mime header not set.

Returns: Descriptor containing the Content-Location mime header. Zero length if the mime header not set.

ContentSubType ( )

IMPORT_C const TDesC8 &

ContentSubType

(

)

const

Gets the Content-SubType mime header.

Returns a zero length descriptor if mime header not set. This mime header contains the end part of the mime-type, eg. the 'plain' part of 'text/plain'.

Returns: Descriptor containing the Content-SubType mime header. Zero length if the mime header not set.

ContentTransferEncoding ( )

IMPORT_C TMsvEncodingType

ContentTransferEncoding

(

)

const

Gets the Content-Transfer Encoding mime header.

ContentTransferEncoding ( TPtrC8 & )

IMPORT_C TMsvEncodingType

ContentTransferEncoding

(

TPtrC8 &

aEncodingType

)

const

Gets the Content-Transfer Encoding mime header.

Also provides a descriptor that contains a textual representation of the content-transfer encoding header.

Parameter	Description
aEncodingType	This desriptor is set to a textual representation of the mime header. Returns a zero-length

ContentType ( )

IMPORT_C const TDesC8 &

ContentType

(

)

const

Gets the Content-Type mime header.

Returns a zero length descriptor if mime header not set. This mime header contains the beginning part of the mime-type, eg. the 'text' part of 'text/plain'.

Returns: Descriptor containing the Content-Type mime header. Zero length if the mime header not set.

ContentTypeParams ( )

IMPORT_C CDesC8Array &

ContentTypeParams

(

)

Returns a modifiable descriptor array containing the Content-Type parameters.

Returns: A modifiable descriptor array.

ContentTypeParams ( )

IMPORT_C const CDesC8Array &

ContentTypeParams

(

)

const

Returns a non-modifiable descriptor array containing the Content-Type parameters.

Returns: A non-modifiable descriptor array.

GetContentTypeValue ( const TDesC8 & )

IMPORT_C const TPtrC8

GetContentTypeValue

(

const TDesC8 &

aContentTypeParameter

)

const

Gets the Content-Type mime header parameter value.

This method finds the specifed parameter and extracts the value for it.

Parameter	Description
aContentTypeParameter	The Content-Type parameter to get the value for.

Returns: The Content-Type parameter value requested. Returns a zero-length if the paramter cannot be found.

MimeCharset ( )

IMPORT_C TUint

MimeCharset

(

)

const

Gets the mime charset header.

Returns: An integer representing the mime charset.

NewL ( )

IMPORT_C CMsvMimeHeaders *

NewL

(

)

[static]

Standard 2-phase construction, creates the mime headers object.

Creates and initailises the mime headers with no data.

Returns: Pointer to the created mime headers object.

NewLC ( )

IMPORT_C CMsvMimeHeaders *

NewLC

(

)

[static]

Standard 2-phase construction, creates the mime headers object.

Creates and initailises the mime headers with no data. Leaves a pointer on the cleanup stack.

Returns: Pointer to the created mime headers object.

RelativePath ( )

IMPORT_C const TDesC8 &

RelativePath

(

)

const

Gets the relative path mime header.

Returns a zero length descriptor if header is not set.

Returns: Descriptor containing the relative path mime header. Zero length if the header not set.

Reset ( )

IMPORT_C void

Reset

(

)

Resets the mime headers.

Resets and removes all the mime headers and data that has been set.

RestoreL ( CMsvAttachment & )

IMPORT_C void

RestoreL

(

CMsvAttachment &

aAttachment

)

Restores the mime header data.

Restores all the mime header data from an existing attachment object. This restores mime headers that was stored using the StoreL method. If the attachment does not contain any mime headers, this object is reset.

Parameter	Description
aAttachment	The attachment object to restore the mime header data from.

SetContentBaseL ( const TDesC8 & )

IMPORT_C void

SetContentBaseL

(

const TDesC8 &

aContentBase

)

Sets the Content-Base mime header.

Over-writes any existing data.

Parameter	Description
aContentBase	Descriptor conatining the Content-Base mime header.

SetContentDescriptionL ( const TDesC8 & )

IMPORT_C void

SetContentDescriptionL

(

const TDesC8 &

aContentDescription

)

Sets the Content-Description mime header.

Over-writes any existing data.

Parameter	Description
aContentDescription	Descriptor conatining the Content-Description mime header.

SetContentDispositionL ( const TDesC8 & )

IMPORT_C void

SetContentDispositionL

(

const TDesC8 &

aContentDisposition

)

Sets the Content-Disposition mime header.

Over-writes any existing data.

SetContentIdL ( const TDesC8 & )

IMPORT_C void

SetContentIdL

(

const TDesC8 &

aContentId

)

Sets the Content-Id mime header.

Over-writes any existing data.

Parameter	Description
aContentId	Descriptor conatining the Content-Id mime header.

SetContentLocationL ( const TDesC16 & )

IMPORT_C void

SetContentLocationL

(

const TDesC16 &

aContentLocation

)

Sets the Content-Location mime header.

Over-writes any existing data.

Parameter	Description
aContentLocation	Descriptor conatining the Content-Base mime header.

SetContentSubTypeL ( const TDesC8 & )

IMPORT_C void

SetContentSubTypeL

(

const TDesC8 &

aSubContentType

)

Sets the Content-SubType mime header.

Over-writes any existing data. This mime header contains the end part of the mime-type, eg. the 'plain' part of 'text/plain'.

Parameter	Description
aSubContentType	Descriptor conatining the Content-SubType mime header.

SetContentTransferEncoding ( const TDesC8 & )

IMPORT_C void

SetContentTransferEncoding

(

const TDesC8 &

aEncodingType

)

Sets the Content-Transfer Encoding mime header.

Over-writes any existing data.

Parameter	Description
aEncodingType	Descriptor conatining the Content-Transfer Encoding mime header.

SetContentTypeL ( const TDesC8 & )

IMPORT_C void

SetContentTypeL

(

const TDesC8 &

aContentType

)

Sets the Content-Type mime header.

Over-writes any existing data. This mime header contains the beginning part of the mime-type, eg. the 'text' part of 'text/plain'.

Parameter	Description
aContentType	Descriptor conatining the Content-Type mime header.

SetMimeCharset ( TUint )

IMPORT_C void

SetMimeCharset

(

TUint

aMimeCharset

)

Sets the mime charset header.

Over-writes any existing data.

SetRelativePathL ( const TDesC8 & )

IMPORT_C void

SetRelativePathL

(

const TDesC8 &

aRelativePath

)

Sets the relative path header.

Over-writes any existing data.

SetSuggestedFilenameL ( const TDesC16 & )

IMPORT_C void

SetSuggestedFilenameL

(

const TDesC16 &

aSuggestedFilename

)

Sets the suggested filename mime header.

Over-writes any existing data.

Parameter	Description
aSuggestedFilename	Descriptor containing the suggested filename mime header data.

Size ( )

IMPORT_C TInt

Size

(

)

const

Returns the size of all the mime header data.

Returns the approximate size in bytes of all the mime header data stored by this object. The returned value is a sum of the lengths of all the string data and the size of an integer for each integer type data.

Returns: The size in bytes of all the mime header data.

StoreL ( CMsvAttachment & )

IMPORT_C void

StoreL

(

CMsvAttachment &

aAttachment

)

const

Stores the mime header data.

Associated and stores all the mime header data stored in this object as an attribute of an attachment object. The RestoreL method should be used to restore the data from the attachment.

Parameter	Description
aAttachment	The attachment object to store the mime header data to.

SuggestedFilename ( )

IMPORT_C const TDesC16 &

SuggestedFilename

(

)

const

Gets the suggested filename mime header.

Returns a zero length descriptor if header is not set.

Returns: Descriptor containing the suggested filename mime header. Zero length if the header not set.

XTypeParams ( )

IMPORT_C CDesC8Array &

XTypeParams

(

)

Returns a non-modifiable descriptor array containing the X-Type parameters.

Returns: A non-modifiable descriptor array.

XTypeParams ( )

IMPORT_C const CDesC8Array &

XTypeParams

(

)

const

Returns a modifiable descriptor array containing the X-Type parameters.

Returns: A modifiable descriptor array.