/*
* Copyright (c) 2005 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:  
*       CUniMimeInfo, Storage for objects mime headers.
*
*/



#ifndef __UNIMIMEINFO_H
#define __UNIMIMEINFO_H

// INCLUDES

#include <cmsvattachment.h>

// CONSTANTS

// MACROS

// FORWARD DECLARATIONS

// DATA TYPES

// FUNCTION PROTOTYPES

// CLASS DECLARATION
class MMsvAttachmentManager;
class CBaseMtm;
class CUniDataUtils;

/**
* CUniMimeInfo - Container for the MIME headers of an attachment.
* NOTE no support for X-Type-Params
*      only support for filename ContentDisposition parameter
*      only support for charset ContentTypeL parameter
*
* If some header is not set zero lenght descriptor is returned.
*
* @lib UniDataModel.lib
* @since 3.1
*/
class CUniMimeInfo : public CBase
    {
    public:

    /**
    * Constructor
    *
    * @since    3.1
    */
    CUniMimeInfo();

    /**
    * Destructor
    *
    * @since    3.1
    */
    ~CUniMimeInfo();

    //
    // Accessors/Mutators
    //

    /**
    * SetContentTypeL
    * NOTE: 8-bit
    *
    * @since    3.1
    * @param    aMimeType   IN content type
    */
    void SetContentTypeL( const TDesC8& aMimeType );

    /**
    * ContentType
    * NOTE: 8-bit
    *
    * @since    3.1
    * @return   pointer to content type buffer
    */
    inline const TPtrC8 ContentType() const;

    /**
    * SetCharset
    * As content type charset parameter
    * No other content type specific parameters supported
    * charset = 0 means no charset is set 
    * (0 is IANA reserved number, not allocated currently to any charset.)
    *
    * @since    3.1
    * @param    aCharset    IN character set as MIB enumeration
    */
    inline void SetCharset( TUint aCharset );

    /**
    * Charset
    * As content type charset parameter
    * No other content type specific parameters supported
    * charset = 0 means no charset is set 
    * (0 is IANA reserved number, not allocated currently to any charset.)
    *
    * @since    3.1
    * @return   character set MIB enumeration
    */
    inline TUint Charset() const;

    /**
    * SetContentTypeL
    * NOTE: 16-bit
    *
    * @since    3.1
    * @param    aContLoc    IN content location
    */
    void SetContentLocationL( const TDesC& aContLoc );
    
    /**
    * ContentLocation
    * NOTE: 16-bit
    *
    * @since    3.1
    * @return   pointer to content location buffer
    */
    inline const TPtrC ContentLocation() const;
        
    /**
    * SetContentIdL
    * NOTE: 8-bit
    *
    * @since    3.1
    * @param    aCid    IN content id
    */
    void SetContentIdL( const TDesC8& aCid );

    /**
    * ContentId
    * NOTE: 8-bit
    *
    * @since    3.1
    * @return   pointer to content id buffer
    */
    inline const TPtrC8 ContentId() const;

    /**
    * SetContentBaseL
    * NOTE: 8-bit
    *
    * @since    3.1
    * @param    aContBase   IN content base
    */
    void SetContentBaseL( const TDesC8& aContBase );

    /**
    * ContentBase
    * NOTE: 8-bit
    *
    * @since    3.1
    * @return   pointer to content base buffer
    */
    inline const TPtrC8 ContentBase() const;

    /**
    * SetContentDescriptionL
    * NOTE: 8-bit
    *
    * @since    3.1
    * @param    aContDesc   IN content description
    */
    void SetContentDescriptionL( const TDesC8& aContDesc );

    /**
    * ContentDescription
    * NOTE: 8-bit
    *
    * @since    3.1
    * @return   pointer to content description buffer
    */
    inline const TPtrC8 ContentDescription() const;

    /**
    * SetContentDispositionL
    * NOTE: 8-bit
    *
    * @since    3.1
    * @param    aContDesc   IN content disposition
    */
    void SetContentDispositionL( const TDesC8& aContDisp );

    /**
    * ContentDisposition
    * NOTE: 8-bit
    *
    * @since    3.1
    * @return   pointer to content disposition buffer
    */
    inline const TPtrC8 ContentDisposition() const;

    /**
    * Size
    *
    * @since    3.1
    * @return   size of the mime headers in bytes
    */
    TInt Size() const;

    /**
    * SaveMimeInfoL
    * Save objects mime info into message store
    *
    * @since    3.1
    * @param    aManager    IN reference to attachment manager
    * @param    aAttachment IN reference to attachment
    */
    void SaveMimeInfoL( MMsvAttachmentManager& aManager, CMsvAttachment& aAttachment );

    /**
    * ReadMimeInfoL
    * Reads attachments mime info from message store
    *
    * @since    3.1
    * @param    aAttachment IN reference to attachment
    */ 
    void ReadMimeInfoL( CMsvAttachment& aAttachment );

	/**
    * EnsureContentLocationL
	* Make sure that ContentLocation exists. In case it
    * doesn't one is created from the file name.
    *
    * @since    3.1
    * @param    aManager    IN reference to attachment manager
    * @param    aAttachment IN reference to attachment
    * @param    aPlainFileName   IN attachment file name
	*/
    void EnsureContentLocationL(
        MMsvAttachmentManager& aManager,
        CMsvAttachment& aAttachment,
        TDesC& aPlainFileName );

    private: // data
    
    HBufC8* iContentDescription;

    HBufC8* iContentBase;
    HBufC16* iContentLocation;
    HBufC8* iContentId;
    
    HBufC8* iContentType;
    TUint iContentTypeCharset; // As MIB enum.
    
    HBufC8* iContentDisposition;
    };

#include <unimimeinfo.inl>

#endif //__UNIMIMEINFO_H