/*
* Copyright (c) 2007-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:  common email address object
*
*/



#ifndef CFSMAILADDRESS_H
#define CFSMAILADDRESS_H

#include <e32std.h>
#include <e32base.h>

//<cmail>
#include "CFSMailCommon.h"
//</cmail>

//<qmail>
#include <QExplicitlySharedDataPointer>

class NmAddressPrivate;
class NmAddress;
//</qmail>

/**
 *  email address handling
 *
 *  @lib FSFWCommonLib
 *  @since S60 v3.1
 */

NONSHARABLE_CLASS ( CFSMailAddress ) : public CBase
{
    public:

    /**
     * Two-phased constructor.
     *
     */
    IMPORT_C static CFSMailAddress* NewL();

    /**
     * Two-phased constructor.
     *
     * @param aNmAddress address with data to be shared
     */
    // <qmail>
    IMPORT_C static CFSMailAddress* NewL( const NmAddress& aNmAddress );
    // </qmail>
    /**
     * Two-phased constructor.
     *
     */
    IMPORT_C static CFSMailAddress* NewLC();

    /**
     * destructor
     */
    IMPORT_C ~CFSMailAddress();
        
    /**
     * email address accessor
     *
     * @return email address owned by class
     */
    IMPORT_C TDesC& GetEmailAddress() const;
        
    /**
     * email address mutator
     *
     * @param aAddress email address to be stored
     */
    IMPORT_C void SetEmailAddress( const TDesC& aAddress );
     
    /**
     * display name accessor
     *
     * @return stored display name owned by class
     */
    IMPORT_C TDesC& GetDisplayName() const;
        
    /**
     * display name mutator
     *
     * @param aDisplayName display name to be stored
     */
    IMPORT_C void SetDisplayName( const TDesC& aDisplayName );

    /**
     * returns the NmAddress object
     *
     * @return NmAddress
     */
    // <qmail>
    IMPORT_C NmAddress GetNmAddress();
    // </qmail>
    
    private:
    // <qmail>        
     /**
      * constructor
      */
     CFSMailAddress();
    // </qmail> 
 
  /**
     * Two-phased constructor
     */
     void ConstructL();

    /**
     * Two-phased constructor
     */
    // <qmail>
    void ConstructL( const NmAddress& aNmAddress );
    // </qmail>    

 private: // data

    /**
     * email address - pointer descriptor to access QString object
     */
    mutable TPtrC  iEmailAddressPtr;

    /**
     * display name - pointer descriptor to access QString object
     */
    mutable TPtrC  iDisplayNamePtr;

    /**
     * Reference to QT side of the address data object.
     */
    // <qmail>
    QExplicitlySharedDataPointer<NmAddressPrivate> iNmPrivateAddress;
    // </qmail>
};

#endif