upnpavcontroller/upnpavcontrollerserver/inc/upnpavcontrolpoint.h
branchIOP_Improvements
changeset 40 08b5eae9f9ff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/upnpavcontroller/upnpavcontrollerserver/inc/upnpavcontrolpoint.h	Wed Nov 03 11:45:09 2010 +0200
@@ -0,0 +1,146 @@
+/** @file
+* Copyright (c) 2005-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:  Control point with some basic AV services
+*
+*/
+
+
+
+#ifndef C_CUPNPAVCONTROLPOINT_H
+#define C_CUPNPAVCONTROLPOINT_H
+
+
+//  INCLUDES
+#include "upnpcontrolpoint.h"
+
+// FORWARD DECLARATIONS
+class MUpnpAVControlPointObserver;
+
+// CLASS DECLARATION
+
+/**
+* Control point services.
+* This class inherits control point base class and provides just a little
+* added value on top of that. Some default construction has been taken
+* care of, and some low level messaging is taken care of. Everything else
+* is up to the client.
+* 
+* @lib - 
+* @since S60 5.2
+*/
+NONSHARABLE_CLASS ( CUpnpAVControlPoint ): public CUpnpControlPoint
+    {
+public:  // Constructors and destructor
+    
+    /** static constructor. */
+    static CUpnpAVControlPoint* NewL(
+        MUpnpAVControlPointObserver& aAVControlPointObserver            
+        );
+    
+    /** Destructor. */
+    virtual ~CUpnpAVControlPoint();
+
+private: // private construction part
+
+    /** constructor */
+    CUpnpAVControlPoint(MUpnpAVControlPointObserver& aAVControlPointObserver);
+
+    /** 2nd phase constructor */
+    void ConstructL();
+
+public: // services
+
+    /**
+    * Returns the internally cached service for given device and 
+    * service type.
+    * 
+    * @since S60 5.2
+    * @param aDevice the device for which service is requested for.
+    * @param aServiceType the upnp service required, for instance CDS.
+    * @return Cached service.
+    */
+    CUpnpService* Service( 
+            const CUpnpDevice* aDevice, 
+            const TDesC8& aServiceType );
+    
+    /**
+    * Helper method to create new action with given action name.
+    * 
+    * New action is created by internally cached service. The service is
+    * identified with given device and service type.
+    * 
+    * @since S60 5.2
+    * @param aDevice the device for which service is requested for
+    * @param aServiceType the upnp service required, for instance CDS
+    * @param aActionName Name of the action.
+    * @return New action object
+    * @leave KErrUnknown if internally cached service could not be found.
+    *        KErrGeneral if service doesn't support action.
+    *        Systemwide error code otherwise.
+    */
+    CUpnpAction* CreateActionLC( 
+            const CUpnpDevice* aDevice, 
+            const TDesC8& aServiceType,
+            const TDesC8& aActionName );
+    
+    /**
+     * Starts up the av control point by creating SSDP search.
+     * 
+     * @param None.
+     * @return None.
+     */
+    void StartUpL();
+    
+private:  // Virtual method overrides from base classes
+    
+    /**
+    * From CUpnpControlPoint Device discovery handler.
+    */
+    void DeviceDiscoveredL( CUpnpDevice* aDevice );
+
+    /**
+    * From CUpnpControlPoint Device dissappear handler.
+    */
+    void DeviceDisappearedL( CUpnpDevice* aDevice );
+
+    /**
+    * From CUpnpControlPoint Action response handler function.
+    */
+    void ActionResponseReceivedL( CUpnpAction* aAction );
+
+    /**
+    * From CUpnpControlPoint State update handler.
+    */
+    void StateUpdatedL( CUpnpService* aService );
+
+    /**
+    * From CUpnpControlPoint HTTP message handler function.
+    */
+    void HttpResponseReceivedL( CUpnpHttpMessage* aMessage );
+
+    /**
+    * This function will be invoke if some network event will occure
+    * for example IP Address of UPnP changes
+    */
+    void NetworkEvent( CUpnpNetworkEventBase* aEvent );
+
+private:    // Data
+
+    //AV control point observer (engine)
+    MUpnpAVControlPointObserver& iAVControlPointObserver;
+    };
+
+#endif      // C_CUPNPAVCONTROLPOINT_H
+            
+// End of File