/*

* 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:      content fetching engine active object class defition

*

*/

#ifndef __UPNPCONTENTREQUESTAO_H__

#define __UPNPCONTENTREQUESTAO_H__

// Include Files

#include <e32base.h>

#include <badesca.h>  //for CDesCArray

#include "upnpcontentserverclient.h"

// FORWARD DECLARATIONS

class CUPnPFileSharingEngine;

// CLASS DECLARATION

/**

 *  Active object class for querying shared content from upnpcontentserver

 *  @lib upnpapplicationengine.lib

 *  @since S60 3.1

 */

NONSHARABLE_CLASS( CUpnpContentRequestAO ): public CActive

    {

public: // Constructors and destructor

    /**

     * C++ default constructor.

     * @since S60 3.1

     * @param aEngine File sharing engine

     * @param aContentServer Handle to upnpcontentserver

     */

    CUpnpContentRequestAO(

        CUPnPFileSharingEngine& aEngine, 

        RUpnpContentServerClient& aContentServer );

    /**

     * Destructor.

     */

    virtual ~CUpnpContentRequestAO();

public: // new functions

    /**

     * Request playlist or album names for UI from server, asynchronous

     * @since S60 3.1

     * @param aType Type of selections to request

     */

    void RequestSelectionContentL( UpnpContentServer::TUpnpMediaType aType );

    /**

     * Get playlist or album names for UI after request, synchronous

     * @since S60 3.1

     * @param aArray Array for albums / playlist names

     */

    void GetSelectionContentL( CDesCArray& aArray );

    /**

     * Request selected items for UI from server, asynchronous

     * @since S60 3.1

     * @param aType Type of selections to request

     */

    void RequestSelectionIndexesL(

        UpnpContentServer::TUpnpMediaType aType );

    /**

     * Get the selected items for UI after request, synchronous

     * @since S60 3.1

     * @param aCurrentSelection Array for selection indexes

     */

    void GetSelectionIndexesL( CArrayFix<TInt>& aCurrentSelection );

private: // from CActive

    /**

     * Function is called when active request is ready

     * @since S60 3.1

     */

    virtual void RunL();

    /**

     * Cancels active request

     * @since S60 3.1

     */

    virtual void DoCancel();

private: // data

    /**

     * file sharing engine

     */

    CUPnPFileSharingEngine& iEngine;

    /**

     * Content server session handle

     */

    RUpnpContentServerClient& iContentServer;

    /**

     * Current state

     */

    enum TState

        {

        ENone = 0,

        ERequestContent,

        ERequestIndexes

        };

    TState iState;

    };

#endif  // __UPNPCONTENTREQUESTAO_H__

// End of file