/*
* Copyright (c) 2006-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: implements a session towards a media server
*
*/
#ifndef C_UPNPAVBROWSINGSESSIONIMPL_H
#define C_UPNPAVBROWSINGSESSIONIMPL_H
// INCLUDE FILES
#include <e32std.h>
#include <e32base.h>
#include "upnpavbrowsingsession.h"
#include "upnpavdeviceobserver.h"
#include "upnpavbrowserespparams.h"
// FORWARD DECLARATIONS
class CUpnpAVDevice;
class MUPnPAVBrowsingSessionObserver;
class RUPnPAVControllerClient;
//class CUPnPXMLParser;
class CUPnPAVDeviceActive;
/**
* AV Controller browsing session implementation.
*
* This class implements the browsing interface of AV Controller. Includes
* operations to search, browse, copy, create container, delete object and
* to get search capabilities.
*
* @lib upnpavcontrollerclient.lib
* @since S60 v3.1
*/
class CUPnPAVBrowsingSessionImpl : public CActive,
public MUPnPAVBrowsingSession,
public MUPnPAVDeviceObserver
{
private:
/**
* Defines internal state of operation
*/
enum TPendingOperation
{
ENone = 0,
EBrowseSize,
ESearchSize,
EGetSearchCapabilities,
ECreateContainer,
EDeleteObject
};
public:
/**
* Static constructor
*
* @param aServer handle to AV Controller server
* @param aDevice target device
* @return a new browsing session implementation instance
*/
static CUPnPAVBrowsingSessionImpl* NewL( RUPnPAVControllerClient&
aServer, const CUpnpAVDevice& aDevice );
/**
* Destructor
*/
virtual ~CUPnPAVBrowsingSessionImpl();
private:
/**
* 2nd phase construct
*/
CUPnPAVBrowsingSessionImpl( RUPnPAVControllerClient& aServer );
/**
* 2nd phase construct
*/
void ConstructL();
protected: // From CActive
void RunL();
void DoCancel();
TInt RunError( TInt aError );
protected: // From MUPnPAVBrowser
/**
* See upnpavbrowsingsession.h
*/
void SetObserver( MUPnPAVBrowsingSessionObserver& aObserver);
/**
* See upnpavbrowsingsession.h
*/
void RemoveObserver();
/**
* See upnpavbrowsingsession.h
*/
MUPnPAVBrowsingSessionObserver* Observer() const;
/**
* See upnpavbrowsingsession.h
*/
const CUpnpAVDevice& Device() const;
/**
* See upnpavbrowsingsession.h
*/
void BrowseL( const TDesC8& aId,
const TDesC8& aFilter,
TBrowseFlag aBrowseFlag,
TInt aStartIndex,
TInt aRequestedCount,
const TDesC8& aSortCriteria );
/**
* See upnpavbrowsingsession.h
*/
void CancelBrowse();
/**
* See upnpavbrowsingsession.h
*/
void SearchL( const TDesC8& aId,
const TDesC8& aSearchCriteria,
const TDesC8& aFilter,
TInt aStartIndex,
TInt aRequestedCount,
const TDesC8& aSortCriteria );
/**
* See upnpavbrowsingsession.h
*/
void CancelSearch();
/**
* See upnpavbrowsingsession.h
*/
void GetSearchCapabilitiesL();
/**
* See upnpavbrowsingsession.h
*/
void CreateContainerL( const TDesC8& aTitle, const TDesC8& aParentId,
TContainerType aContainerType );
/**
* See upnpavbrowsingsession.h
*/
void DeleteObjectL( const TDesC8& aId );
public: // From MUPnPAVDeviceObserver
/**
* See upnpavdeviceobserver.h
*/
void UPnPDeviceDiscovered( const CUpnpAVDevice& aDevice );
/**
* See upnpavdeviceobserver.h
*/
void UPnPDeviceDisappeared( const CUpnpAVDevice& aDevice );
/**
* See upnpavdeviceobserver.h
*/
void WLANConnectionLost();
private: // Internal methods
/**
* Handles browse
*/
void BrowseSizeCompletedL();
/**
* Handles browse
*/
void BrowseResultCompletedL();
/**
* Handles search
*/
void SearchSizeCompletedL();
/**
* Handles search
*/
void SearchResultCompletedL();
/**
* Handles search capabilities
*/
void SearchCapabilitiesCompletedL();
/**
* Handles create container
*/
void CreateContainerCompletedL();
/**
* Handles delete object
*/
void DeleteObjectCompletedL();
/**
* Handles media server start
*/
void StartMediaServerCompleteL();
/**
* Reset
*/
void ResetL();
private:
MUPnPAVBrowsingSessionObserver* iObserver; // not owned
RUPnPAVControllerClient& iServer; // not owned
CUpnpAVDevice* iDevice; // owned
// Buffer to pass data to server
HBufC8* iBuffer; // owned
TPtr8 iBufferPtr;
// Buffer to pass data to server
HBufC8* iBuffer2; // owned
TPtr8 iBufferPtr2;
// Buffer to pass data to server
HBufC8* iBuffer3; // owned
TPtr8 iBufferPtr3;
CUPnPAVDeviceActive* iDeviceActive; // owned
TInt iRespBufSize;
TPckg<TInt> iRespBufSizePkg;
TUpnpAVBrowseRespParams iRespParams;
TPckg<TUpnpAVBrowseRespParams> iRespParamsPkg;
TPendingOperation iPendingOperation;
TBool iAlive;
};
#endif // C_UPNPAVBROWSERIMPL_H