diff -r 000000000000 -r b16258d2340f applayerprotocols/wappushsupport/inc/MDataProviderObserver.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/applayerprotocols/wappushsupport/inc/MDataProviderObserver.h Tue Feb 02 01:09:52 2010 +0200 @@ -0,0 +1,117 @@ +// Copyright (c) 1997-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: +// Definition of the data provider observer abstract class +// It is anticipated that this class will be used as a mixin for +// those objects which wish to provide services for an MDataProvider +// plugin. +// +// + + +#ifndef __MDATAPROVIDEROBSERVER_H__ +#define __MDATAPROVIDEROBSERVER_H__ + +// System includes +// +#include + +//##ModelId=3B712B2B01C2 +class MDataProviderObserver +/** +MDataProviderObserver provides a virtual interface for any class to observe +any MDataProvider, and provide data receiving services. +@publishedAll +@deprecated +*/ + { +public: // Methods + +/** + Intended Usage : Called by the data provider to request processing of + the data within the buffer. + @since 6.0 + @param aBuffer A reference to the buffer with the data to process + */ + //##ModelId=3B712B2B0209 + virtual void ProcessDataL(HBufC8& aBuffer) = 0; + +/** + Intended Usage : Called by the data provider to report its status to + its observer. A status code which is either a standard error condition, + (i.e. < 0), a percentage complete value, ( 0 > aStatus < 100), OR a + TPluginStatus value. + @since 6.0 + @param aStatusCode The status of the data provider + */ + //##ModelId=3B712B2B0203 + virtual void SetStatus(TInt aStatusCode = KErrNone) = 0; + +/** + Intended Usage : The request to construct a CDataHandler to process data + of aDataType, where aDataType is a string to match against some plugins + declared data handling ability. + @since 6.0 + @param aDataType A reference to a descriptor with the data type + */ + //##ModelId=3B712B2B01FE + virtual void SetDocumentTypeL(const TDesC& aDataType) = 0; + +/** + Intended Usage : The request to construct a CDataHandler for aDataType with + non default document encoding where aDataType is a string to match against + some plugins declared data handling ability. + @since 6.0 + @param aDataType A reference to a descriptor with the data type + @param aContentType A reference to a descriptor with the content type + */ + //##ModelId=3B712B2B0200 + virtual void SetDocumentTypeL(const TDesC& aDataType, const TDesC& aContentType) = 0; + +/** + Intended Usage : The report of how many bytes of data is expected to be + passed to ProcessDataL, enabling %age reporting capabilities. + @since 6.0 + @param aAmountExpected An integer value of the expected amount + */ + //##ModelId=3B712B2B01EC + virtual void SetDataExpected(TInt aAmountExpected) = 0; + +/** + Intended Usage : Set the URI that the DataProvider considers the base + URI for the current data. + @since 6.0 + @param aBaseUri A const pointer to the uri + */ + //##ModelId=3B712B2B01EA + virtual void SetBaseUriL(const TDesC* aBaseUri) = 0; + +private: + +/** + Intended Usage : Reserved for future expansion. + @since 6.0 + */ + //##ModelId=3B712B2B01E1 + virtual void MDataProviderObserverReserved1() =0; + +/** + Intended Usage : Reserved for future expansion. + @since 6.0 + */ + //##ModelId=3B712B2B01E0 + virtual void MDataProviderObserverReserved2() =0; + + }; // MDataProviderObserver + +#endif // __MDATAPROVIDEROBSERVER_H__