diff -r 3785f754ee62 -r 5360b7ddc251 upnpavcontroller/upnpavcontrollerhelper/inc/upnpabstractbrowsingsessionobserver.h --- a/upnpavcontroller/upnpavcontrollerhelper/inc/upnpabstractbrowsingsessionobserver.h Fri Sep 17 08:31:21 2010 +0300 +++ b/upnpavcontroller/upnpavcontrollerhelper/inc/upnpabstractbrowsingsessionobserver.h Mon Nov 01 12:37:49 2010 +0200 @@ -1,178 +1,173 @@ -/* -* Copyright (c) 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: An abstract browsing session observer implementation -* -*/ - - - - - - -#ifndef UPNPABSTRACTBROWSINGSESSIONOBSERVER_H -#define UPNPABSTRACTBROWSINGSESSIONOBSERVER_H - -// INCLUDES -#include -#include "upnpavbrowsingsessionobserver.h" // base class - -// FORWARD DECLARATIONS -class MUPnPAVBrowsingSession; - -// CLASS DECLARATION - -/** -* An abstract class for implementing a browsing session observer. -* This class is purposed as a base class for imnplementing a -* browsing observer. There are 2 main use cases: -* 1. reducing implementation code so that the actual observer will -* only need to write the observer methods that are really used. -* 2. implementing an observer proxy that will attach itself to a session -* and just handle some of the callbacks and forward a majority of the -* callbacks the original session observer. -* -* @lib upnpavcontrollerhelper.lib -* @since S60 3.2 -*/ -class CUPnPAbstractBrowsingSessionObserver - : public CBase - , public MUPnPAVBrowsingSessionObserver - { - -public: // construction/destruction - - /** - * default constructor. - */ - IMPORT_C CUPnPAbstractBrowsingSessionObserver(); - - /** - * destructor - */ - IMPORT_C virtual ~CUPnPAbstractBrowsingSessionObserver(); - - -public: // the abstract observer interface - - /** - * Sets the host session for the observer. This is the session where - * the observer will register for callbacks. If the session already - * has an observer, it will become the proxy observer. The default - * implementatin for all observer methods is to forward the method to - * the observer, if it exists. - * - * @since S60 3.2 - * @param aHostSession, browsing session - */ - IMPORT_C void SetSession( MUPnPAVBrowsingSession& aHostSession ); - - /** - * Enables receiving callbacks. When enabled, the abstract observer - * registers to the given session and thus starts receiving callbacks. - * Note that only those callbacks that are overwritten in the derived - * class will actually provide some value. Other will be either processed - * in an empty method, or forwarded to the observer that previously was - * registered as an observer (proxy mode) - * - * @since S60 3.2 - */ - IMPORT_C void EnableSessionObserver(); - - /** - * Disables receiving session callbacks. The observer interface is - * deregistered, and if before observer registration there was an - * original observer interface (proxy mode) the original observer - * is restored. - * - * @since S60 3.2 - */ - IMPORT_C void DisableSessionObserver(); - - /** - * Returns true if the observer is active (registered for events) - * - * @since S60 3.2 - */ - IMPORT_C TBool IsSessionObserverEnabled(); - -public: // MUPnPAVBrowsingSessionObserver - - /** - * see MUPnPAVBrowsingSessionObserver - */ - void BrowseResponse( - const TDesC8& aBrowseResponse, - TInt aError, - TInt aMatches, - TInt aTotalCount, - const TDesC8& aUpdateId ); - - /** - * see MUPnPAVBrowsingSessionObserver - */ - void SearchResponse( - const TDesC8& aSearchResponse, - TInt aError, - TInt aMatches, - TInt aTotalCount, - const TDesC8& aUpdateId ); - - /** - * see MUPnPAVBrowsingSessionObserver - */ - void SearchCapabilitiesResponse( - TInt aError, - const TDesC8& aSearchCapabilities ); - - /** - * see MUPnPAVBrowsingSessionObserver - */ - void CreateContainerResponse( TInt aError, - const TDesC8& aObjectId ); - - /** - * see MUPnPAVBrowsingSessionObserver - */ - void DeleteObjectResponse( TInt aError ); - - /** - * see MUPnPAVBrowsingSessionObserver - */ - void ReserveLocalMSServicesCompleted( TInt aError ); - - /** - * see MUPnPAVBrowsingSessionObserver - */ - void MediaServerDisappeared( - TUPnPDeviceDisconnectedReason aReason ); - - -private: // members - - // the host browsing session. Note: NOT OWNED! - MUPnPAVBrowsingSession* iObservedSession; - - // The proxy observer. Note: NOT OWNED! - MUPnPAVBrowsingSessionObserver* iProxyObserver; - - // if observer is enabled - TBool iObserverEnabled; - - }; - - -#endif // UPNPABSTRACTBROWSINGSESSIONOBSERVER_H - -// End of File - +/* +* Copyright (c) 2007-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: An abstract browsing session observer implementation +* +*/ + + + + + + +#ifndef UPNPABSTRACTBROWSINGSESSIONOBSERVER_H +#define UPNPABSTRACTBROWSINGSESSIONOBSERVER_H + +// INCLUDES +#include +#include "upnpavbrowsingsessionobserver.h" // base class + +// FORWARD DECLARATIONS +class MUPnPAVBrowsingSession; + +// CLASS DECLARATION + +/** +* An abstract class for implementing a browsing session observer. +* This class is purposed as a base class for imnplementing a +* browsing observer. There are 2 main use cases: +* 1. reducing implementation code so that the actual observer will +* only need to write the observer methods that are really used. +* 2. implementing an observer proxy that will attach itself to a session +* and just handle some of the callbacks and forward a majority of the +* callbacks the original session observer. +* +* @lib upnpavcontrollerhelper.lib +* @since S60 3.2 +*/ +class CUPnPAbstractBrowsingSessionObserver + : public CBase + , public MUPnPAVBrowsingSessionObserver + { + +public: // construction/destruction + + /** + * default constructor. + */ + IMPORT_C CUPnPAbstractBrowsingSessionObserver(); + + /** + * destructor + */ + IMPORT_C virtual ~CUPnPAbstractBrowsingSessionObserver(); + + +public: // the abstract observer interface + + /** + * Sets the host session for the observer. This is the session where + * the observer will register for callbacks. If the session already + * has an observer, it will become the proxy observer. The default + * implementatin for all observer methods is to forward the method to + * the observer, if it exists. + * + * @since S60 3.2 + * @param aHostSession, browsing session + */ + IMPORT_C void SetSession( MUPnPAVBrowsingSession& aHostSession ); + + /** + * Enables receiving callbacks. When enabled, the abstract observer + * registers to the given session and thus starts receiving callbacks. + * Note that only those callbacks that are overwritten in the derived + * class will actually provide some value. Other will be either processed + * in an empty method, or forwarded to the observer that previously was + * registered as an observer (proxy mode) + * + * @since S60 3.2 + */ + IMPORT_C void EnableSessionObserver(); + + /** + * Disables receiving session callbacks. The observer interface is + * deregistered, and if before observer registration there was an + * original observer interface (proxy mode) the original observer + * is restored. + * + * @since S60 3.2 + */ + IMPORT_C void DisableSessionObserver(); + + /** + * Returns true if the observer is active (registered for events) + * + * @since S60 3.2 + */ + IMPORT_C TBool IsSessionObserverEnabled(); + +public: // MUPnPAVBrowsingSessionObserver + + /** + * see MUPnPAVBrowsingSessionObserver + */ + void BrowseResponse( + const TDesC8& aBrowseResponse, + TInt aError, + TInt aMatches, + TInt aTotalCount, + const TDesC8& aUpdateId ); + + /** + * see MUPnPAVBrowsingSessionObserver + */ + void SearchResponse( + const TDesC8& aSearchResponse, + TInt aError, + TInt aMatches, + TInt aTotalCount, + const TDesC8& aUpdateId ); + + /** + * see MUPnPAVBrowsingSessionObserver + */ + void SearchCapabilitiesResponse( + TInt aError, + const TDesC8& aSearchCapabilities ); + + /** + * see MUPnPAVBrowsingSessionObserver + */ + void CreateContainerResponse( TInt aError, + const TDesC8& aObjectId ); + + /** + * see MUPnPAVBrowsingSessionObserver + */ + void DeleteObjectResponse( TInt aError ); + + /** + * see MUPnPAVBrowsingSessionObserver + */ + void MediaServerDisappeared( + TUPnPDeviceDisconnectedReason aReason ); + + +private: // members + + // the host browsing session. Note: NOT OWNED! + MUPnPAVBrowsingSession* iObservedSession; + + // The proxy observer. Note: NOT OWNED! + MUPnPAVBrowsingSessionObserver* iProxyObserver; + + // if observer is enabled + TBool iObserverEnabled; + + }; + + +#endif // UPNPABSTRACTBROWSINGSESSIONOBSERVER_H + +// End of File +