/*
* Copyright (c) 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:  Converts PIM Event items and native calendar day notes
 *
*/


#ifndef CPIMAGNMEMOADAPTER_H
#define CPIMAGNMEMOADAPTER_H

// INCLUDES
#include "cpimagneventadapter.h"

// FORWARD DECLARATIONS
class MPIMEventItem;

// CLASS DECLARATION
/**
 * Day note Item Adapter
 * Converts PIM Event items and native calendar day notes
 */
NONSHARABLE_CLASS(CPIMAgnMemoAdapter) : public CPIMAgnEventAdapter
{
public: // Constructor and destructor

    /**
     * Two-phased constructor.
     */
    static CPIMAgnMemoAdapter* NewL(java::util::FunctionServer* aFuncServer);

    /**
     * Destructor.
     */
    virtual ~CPIMAgnMemoAdapter();

public: // new methods

    /**
     * Constructs a Agenda Model entry from the framework PIM item.
     *
     * @param aItem The item to convert
     *
     * @return A CCalEntry constructed according to framework item.
     * The \b ownership of the card is transferred to the caller.
     *
     * @par Leaving:
     * This method may leave.
     */
    CCalEntry* CreateItemToAgnL(const MPIMEventItem& aItem);

    /**
     * Converts from Agenda Model entry to the framework PIM item.
     *
     * @param aItem PIM Item data container store the entry data.
     * @param aEntry Agenda Model entry to convert.
     *
     * @par Leaving:
     * This method may leave.
     */
    void ReadAgnToItemL(MPIMEventItem& aItem,
                        CCalEntry& aEntry);

    /**
     * Updates the Agenda Model entry according to the framework PIM item.
     *
     * @param aItem PIM Item with the current data.
     * @param aEntry Agenda Model entry to update.
     *
     * @par Leaving:
     * This method may leave.
     */
    void UpdateItemToAgnL(const MPIMEventItem& aItem,
                          CCalEntry& aEntry);

private:

    /**
     * C++ constructor.
     */
    CPIMAgnMemoAdapter(java::util::FunctionServer* aFuncServer);

    /**
     * Converts the start field of an Agenda Model entry into
     * the framework PIM item field.
     * Implements the pure virtual method from the base class.
     *
     * @param aItem Framework PIM Item.
     * @param aEntry Agenda Model entry
     *
     * @par Leaving:
     * This method may leave.
     */
    void ReadStartFromAgnL(MPIMEventItem& aItem,
                           CCalEntry& aEntry);

    /**
     * Converts the end field of an Agenda Model entry into
     * the framework PIM item field.
     * Implements the pure virtual method from the base class.
     *
     * @param aItem Framework PIM Item.
     * @param aEntry Agenda Model entry
     *
     * @par Leaving:
     * This method may leave.
     */
    void ReadEndFromAgnL(MPIMEventItem& aItem,
                         CCalEntry& aEntry);

    /**
     * Adds default values to the native entry. This function MUST call
     * the version from the base class since it adds common values for all
     * event entries in the native database.
     *
     * @param aItem PIM API Event item
     * @param aEntry Native entry which will contain PIM data
     */
    void AddDefaultValuesToEntryL(
        const MPIMEventItem& aItem,
        CCalEntry& aEntry) const;

protected:

    void ConstructL();

};

#endif // CPIMAGNMEMOADAPTER_H
// End of file