diff -r 000000000000 -r f5a58ecadc66 upnp/upnpstack/serviceframework/inc/upnpargumentlistcontenthandler.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/upnp/upnpstack/serviceframework/inc/upnpargumentlistcontenthandler.h Tue Feb 02 01:12:20 2010 +0200 @@ -0,0 +1,101 @@ +/** @file +* 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: Declares the CUpnpArgumentListContentHandler class + * +*/ + + +#ifndef __UPNPARGUMENTLISTCONTENTHANDLER_H__ +#define __UPNPARGUMENTLISTCONTENTHANDLER_H__ + +#include "upnpcontenthandler.h" + +class CUpnpService; +class CUpnpAction; + +using namespace Xml; + +/** + * This class handles argument list subtree of service descriptions + * It extends CUpnpContentHandler class, thus it is subsequent implementation of MContentHandler interface + * It is designed to be used by upnp controler that delegates to it events from xml sax parser + * + * @since Series60 2.6 + */ +NONSHARABLE_CLASS(CUpnpArgumentListContentHandler) : public CUpnpContentHandler + { +public: + + /** + * Two-phased constructor + * @since Series60 3.2 + * @return instance of CUpnpArgumentListContentHandler class + */ + static CUpnpArgumentListContentHandler* NewL( + CUpnpContentHandlersController& aController, + CUpnpService& aResultService, CUpnpAction& aResultAction ); + + /** + * Two-phased constructor. Leaves the object on CleanupStack + * @since Series60 3.2 + * @return instance of CUpnpArgumentListContentHandler class + */ + static CUpnpArgumentListContentHandler* NewLC( + CUpnpContentHandlersController& aController, + CUpnpService& aResultService, CUpnpAction& aResultAction ); + + /** + * Destructor of CUpnpArgumentListContentHandler class + * @since Series60 3.2 + */ + virtual ~CUpnpArgumentListContentHandler(); + +public: // from MContentHandler + + /** + * This method is a callback to indicate an element has been parsed. + * @param aElement is a handle to the element's details. + * @param aAttributes contains the attributes for the element. + */ + virtual void OnStartElementL( const RTagInfo& aElement, + const RAttributeArray& aAttributes ); + + /** + This method is a callback to indicate the end of the element has been reached. + @param aElement is a handle to the element's details. + */ + virtual void OnEndElementL( const RTagInfo& aElement ); + + /** + This method is a callback that sends the content of the element. + @param aBytes is the raw content data for the element in one chunk + */ + virtual void OnContentL( const TDesC8& aBytes ); + +protected: + + /** + * Default C++ constructor + * @since Series60 3.2 + */ + CUpnpArgumentListContentHandler( CUpnpContentHandlersController& aController, + CUpnpService& aResultService, CUpnpAction& aResultAction ); + +private: + CUpnpService& iResultService; + CUpnpAction& iResultAction; + + }; + +#endif //__UPNPARGUMENTLISTCONTENTHANDLER_H__