/*

* 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:      Header of CUpnpContentServerSession class

 *

*/

#ifndef __UPNPCONTENTSERVERSESSION_H__

#define __UPNPCONTENTSERVERSESSION_H__

#include <e32base.h>

#include <badesca.h>

#include "upnpcontentserver.h"

#include "upnpcontentsharingobserver.h"

// CLASS FORWARDS

class CUpnpContentServer;

/**

 *  A session class which creates an instance of Upnp content server

 *  when starting,

 *  and releases used memory when closing.

 *

 *  @since S60 3.1

 */

class CUpnpContentServerSession : public CSession2,

                                  public MUpnpContentSharingObserver

    {

public:

    /**

     * 2-phased constructor.

     * @since S60 3.1

     * @param aServer Pointer to server class

     */

    static CUpnpContentServerSession* NewL( CUpnpContentServer* aServer );

    /**

     * From CSession2, passes the request forward to DispatchMessageL.

     * @since S60 3.1

     * @param aMessage Reference to processed message

     */

    void ServiceL( const RMessage2& aMessage );

    /**

     * Handles the request from client.

     * @since S60 3.1

     * @param aMessage Reference to processed message

     */

    void DispatchMessageL( const RMessage2& aMessage );

    /**

     * Processes the album / playlist query

     * @since S60 3.1

     * @param aMessage Reference to processed message

     */

    void GetSelectionContentL(

        const RMessage2& aMessage );

    /**

     * Processes the old selections query

     * @since S60 3.1

     * @param aMessage Reference to processed message

     */

    void GetSelectionIndexesL(

        const RMessage2& aMessage );

    /**

     * Processes the sharing request

     * @since S60 3.1

     * @param aMessage Reference to processed message

     */

    void ChangeShareContentL(

        const RMessage2& aMessage );

    /**

     * Completes the album / playlist query

     * @param aMessage Reference to message from client

     * @since S60 3.1

     */

    void CompleteSelectionContentL(

        const CDesCArray& aMarkedItems );

    /**

     * Processes the progress query

     * @since S60 3.1

     * @param aMessage Reference to processed message

     */

    void RequestProgressInfoL(

        const RMessage2& aMessage );

    /**

     * Processes the refresh request

     * @since S60 3.1

     * @param aMessage Reference to processed message

     */

    void RefreshShareContentL(

        const RMessage2& aMessage );

    /**

     * Start connection monitor

     * @since S60 3.1

     * @param aMessage Reference to processed message

     */

    void StartConnectionMonitorL(

        const RMessage2& aMessage );

    /**

     * Stop connection monitoring

     * @since S60 3.1

     */

    void StopConnectionMonitorL( );

private:

    /**

     * 2nd phase constructor.

     * @since S60 3.1

     * @param aServer Pointer to server class

     */

    void ConstructL( CUpnpContentServer* aServer );

    /**

     * C++ constructor.

     * @since S60 3.1

     */

    CUpnpContentServerSession();

    /**

     * C++ destructor.

     * @since S60 3.1

     */

    virtual ~CUpnpContentServerSession();

private:

    /**

     * Handle to server

     * not owned

     */

    CUpnpContentServer* iServer;

    /** 

     * Handle to handler

     * not owned

     */

    CUpnpContentServerHandler* iHandler;

    /**

     * Result buffer for client messages

     * not owned

     */

    CBufFlat* iResultBuffer;

    /**

     * Possible pending message about for content selection

     */

    RMessage2 iSelectionContentMsg;

    /**

     * Possible pending message about sharing

     */

    RMessage2 iChangeShareContentMsg;

    };

#endif // __UPNPCONTENTSERVERSESSION_H__