/*
* Copyright (c) 2006-2007 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:  Server side session for thumbnail engine
 *
*/


#ifndef THUMBNAILSERVERSESSION_H
#define THUMBNAILSERVERSESSION_H

#include <e32base.h>
#include <e32capability.h>

#include "thumbnailmanagerconstants.h"

// FORWARD DECLARATIONS
class CThumbnailServer;

/**
 *  Server side session for thumbnail engine.
 *
 *  @since S60 v5.0
 */
NONSHARABLE_CLASS( CThumbnailServerSession ): public CSession2
    {
public:

    /**
     * Constructor.
     *
     * @since S60 v5.0
     * @return New CThumbnailServerSession session.
     */
    CThumbnailServerSession();

    /**
     * Destructor
     *
     * @since S60 v5.0
     */
    virtual ~CThumbnailServerSession();

public:

    /**
     * Message dispatcher.
     *
     * @since S60 v5.0
     * @param aMessage Message to be passed.
     * @return Error code.
     */
    TInt DispatchMessageL( const RMessage2& aMessage );

public:
    // Functions from base classes

    /**
     * CreateL
     *
     * @since S60 v5.0
     */
    void CreateL();

    /**
     * From CSharableSession (pure virtual).
     * Handles service request messages from clients.
     *
     * @since S60 v5.0
     * @param aMessage message from client.
     */
    void ServiceL( const RMessage2& aMessage );

public:
    // New functions

    /**
     * Returns the server pointer.
     *
     * @since S60 v5.0
     * @return Server pointer.
     */
    CThumbnailServer* Server();

    /**
     * Cancellation method.
     *
     * @since S60 v5.0
     */
    void Cancel();

    /**
     * Converts SQL error to E32 error.
     *
     * @since S60 v5.0
     * @param aReason Request message complete value which may be SQL error
     * @return Request message complete value but not SQL error
     */
    static TInt ConvertSqlErrToE32Err( TInt aReason );
    
    void ResolveMimeTypeL( RFile64* aFile );
    
    void ModifyThumbnailSize( TInt aSourceType );

private:

    /**
     * RequestThumbByFileHandleAsyncL
     *
     * @since S60 v5.0
     * @param aMessage Message.
     */
    void RequestThumbByFileHandleAsyncL( const RMessage2& aMessage );

    /**
     * RequestThumbByPathAsyncL
     *
     * @since S60 v5.0
     * @param aMessage Message.
     */
    void RequestThumbByPathAsyncL( const RMessage2& aMessage );
    
    /**
     * RequestThumbByIdAsyncL
     *
     * @since S60 v5.0
     * @param aMessage Message.
     */    
    void RequestThumbByIdAsyncL( const RMessage2& aMessage );
    
    /**
     * RequestSetThumbnailByBufferL
     *
     * @since S60 v5.0
     * @param aMessage Message.
     */        
    void RequestSetThumbnailByBufferL( const RMessage2& aMessage );

    /**
     * RequestSetThumbnailByBitmapL
     *
     * @since S60 v5.0
     * @param aMessage Message.
     */        
    void RequestSetThumbnailByBitmapL( const RMessage2& aMessage );    
    
    /**
     * Fetch thumbnail data from database.
     *
     * @since S60 v5.0
     */
    void FetchThumbnailL();

    /**
     * Create a task to generate a new thumbnail
     *
     * @since S60 v5.0
     * @param aFile File handle
     */
    void CreateGenerateTaskFromFileHandleL( RFile64* aFile);
    
    /**
     * Create a task to generate a new thumbnail
     *
     * @since S60 v5.0
     * @param aBuffer Source image buffer to be set
     */
    void CreateGenerateTaskFromBufferL( TDesC8* aBuffer );

    /**
     * Process a fetched bitmap by creating scale tasks
     * or by returning the bitmap as such.
     *
     * @since S60 v5.0
     */
    void ProcessBitmapL();

    /**
     * ReleaseBitmap()
     *
     * @since S60 v5.0
     * @param aMessage Message.
     */
    void ReleaseBitmap( const RMessage2& aMessage );

    /**
     * Cancels pending request.
     *
     * @since S60 v5.0
     * @param aMessage Message.
     * @return Error code.
     */
    TInt CancelRequest( const RMessage2& aMessage );

    /**
     * Changes priority of pending request.
     *
     * @since S60 v5.0
     * @param aMessage Message.
     * @return Error code.
     */
    TInt ChangePriority( const RMessage2& aMessage );

    /**
     * Create thumbnails.
     *
     * @since S60 v5.0
     * @param aMessage Message.
     */
    void CreateThumbnailsL( const RMessage2& aMessage );

    /**
     * Delete thumbnails.
     *
     * @since S60 v5.0
     * @param aMessage Message.
     */
    void DeleteThumbnailsL( const RMessage2& aMessage );

    /**
     * Delete thumbnails by Id.
     *
     * @since S60 v5.0
     * @param aMessage Message.
     */
    void DeleteThumbnailsByIdL( const RMessage2& aMessage );    
    
    /**
     * Get the required size (in characters) for a buffer that contains the
     * list of supported MIME types
     * 
     * @since S60 v5.0
     * @param aMessage Message.
     */
    void GetMimeTypeBufferSizeL( const RMessage2& aMessage );

    /**
     * Get the list of supported MIME types and store them in the buffer
     * allocated by the client.
     * 
     * @since S60 v5.0
     * @param aMessage Message.
     */
    void GetMimeTypeListL( const RMessage2& aMessage );
    
    /**
     * Update thumbnails by Thumbnail ID.
     * 
     * 
     * @since S60 v5.0
     * @param aMessage Message.
     */
    void UpdateThumbnailsL( const RMessage2& aMessage );
    
private:
    // data
    /**
     * Temporary store for any bitmaps fetched from the store.
     * Own.
     */
    CFbsBitmap* iBitmap;

    /**
     * Temporary store for thumbnail request parameters as received
     * from the client.
     */
    TThumbnailRequestParamsPckgBuf iRequestParams;

    /**
     * Message from client. This is kept in a member variable to make
     * sure the message is completed if a leave occurs while handling
     * the request.
     */
    RMessage2 iMessage;

    /**
     * Size of the original object. Only valid if a stored thumbnail
     * was found when processing a request.
     */
    TSize iOriginalSize;
    
    /**
     * Temporary store for any jpegs fetched from the store.
     * Own.
     */
    TDesC8* iBuffer;
    
    TInt iBitmapHandle;
};

#endif // THUMBNAILSERVERSESSION_H