/*

* Copyright (c) 2008-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:   Definition of CGlxtnVolumeDatabase

*

*/

/**

 * @internal reviewed 30/07/2007 by Simon Brooks

 */

#ifndef M_GLXTNVOLUMEDATABASEOBSERVER_H

#define M_GLXTNVOLUMEDATABASEOBSERVER_H

#include "glxtnstd.h"   // For TGlxImageDataFormat

/**

 * Typesafe thumbnail ID.

 */

class TGlxtnThumbnailIdTypeBase {};     // Don't use this

typedef TGlxId<TGlxtnThumbnailIdTypeBase> TGlxtnThumbnailId;    // Use this

/**

 * Interface to receive callbacks from a CGlxtnVolumeDatabase.

 *

 * @author Dan Rhodes

 * @ingroup glx_thumbnail_creator

 */

class MGlxtnVolumeDatabaseObserver

    {

public:

    /**

    * Called when a database operation cannot be completed.

    * @param aError Error code.

    */

    virtual void HandleDatabaseError(TInt aError) = 0;

    /**

    * Called when a thumbnail ID has been found in the Ids table.

    * @param aThumbId Thumbnail ID for the media item.

    */

    virtual void HandleThumbnailIdFromMediaIdL(

                                    const TGlxtnThumbnailId& aThumbId ) = 0;

    /**

    * Called when a thumbnail ID has been found in the Items table.

    * @param aThumbId Thumbnail ID for the media item.

    */

    virtual void HandleThumbnailIdFromFilenameL(

                                    const TGlxtnThumbnailId& aThumbId ) = 0;

    /**

    * Called when a thumbnail ID has been saved in the Ids table.

    */

    virtual void HandleThumbnailIdStoredL() = 0;

    /**

    * Called when a thumbnail has been found in the Thumbnails table.

    * @param aFormat Thumbnail data format.

    * @param aData Thumbnail binary data (ownership passed).

    */

    virtual void HandleThumbnail(TGlxImageDataFormat aFormat, HBufC8* aData) = 0;

    /**

    * Called when a thumbnail has been saved in the Thumbnails table.

    */

    virtual void HandleThumbnailStored() = 0;

    /**

    * Called when a record has been deleted from a Ids table.

    */

    virtual void HandleMediaIdDeletedL() = 0;

    /**

    * Called when records have been deleted from a Thumbnails table.

    */

    virtual void HandleThumbnailsDeletedL() = 0;

    /**

    * Called when a record has been deleted from a Items table.

    */

    virtual void HandleItemDeletedL() = 0;

    /**

    * Called when availability has been chaecked.

    * @param aResult The result of the check.

    */

    virtual void HandleAvailabilityChecked(TInt aResult) = 0;

    /**

    * Called after the database has been cleaned up.

    */

    virtual void HandleDatabaseCleanedL() = 0;

    };

#endif  // M_GLXTNVOLUMEDATABASEOBSERVER_H