epoc32/include/http/mhttpfilterbase.h
branchSymbian2
changeset 2 2fe1408b6811
parent 0 061f57f2323e
     1.1 --- a/epoc32/include/http/mhttpfilterbase.h	Tue Nov 24 13:55:44 2009 +0000
     1.2 +++ b/epoc32/include/http/mhttpfilterbase.h	Tue Mar 16 16:12:26 2010 +0000
     1.3 @@ -1,1 +1,88 @@
     1.4 -mhttpfilterbase.h
     1.5 +// Copyright (c) 2001-2009 Nokia Corporation and/or its subsidiary(-ies).
     1.6 +// All rights reserved.
     1.7 +// This component and the accompanying materials are made available
     1.8 +// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
     1.9 +// which accompanies this distribution, and is available
    1.10 +// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
    1.11 +//
    1.12 +// Initial Contributors:
    1.13 +// Nokia Corporation - initial contribution.
    1.14 +//
    1.15 +// Contributors:
    1.16 +//
    1.17 +// Description:
    1.18 +//
    1.19 +
    1.20 +
    1.21 +
    1.22 +/**
    1.23 + @file MHTTPFilterBase.h
    1.24 + @warning : This file contains Rose Model ID comments - please do not delete
    1.25 +*/
    1.26 +
    1.27 +#ifndef	__MHTTPFILTERBASE_H__
    1.28 +#define	__MHTTPFILTERBASE_H__ 
    1.29 +
    1.30 +// System includes
    1.31 +#include <e32std.h>
    1.32 +
    1.33 +// Forward declarations
    1.34 +class RHTTPTransaction;
    1.35 +class THTTPEvent;
    1.36 +class THTTPSessionEvent;
    1.37 +
    1.38 +
    1.39 +//##ModelId=3A914DF9034F
    1.40 +class MHTTPFilterBase
    1.41 +/** 
    1.42 +A HTTP Filter. This is the base class for normal filters
    1.43 +(MHTTPFilter) which adds an unload function, and
    1.44 +MHTTPTransactionCallback, which doesn't add an unload function.  
    1.45 +@publishedAll
    1.46 +@released
    1.47 +*/
    1.48 +	{
    1.49 +public:
    1.50 +	/** Called when the filter's registration conditions are satisfied for events that
    1.51 +		occur on a transaction. Any Leaves must be handled by the appropriate MHFRunError.
    1.52 +		Note that this function is not allowed to leave if called with
    1.53 +		certain events. @see THTTPEvent
    1.54 +		@param aTransaction The transaction that the event has occurred on.
    1.55 +		@param aEvent The event that has occurred.
    1.56 +	*/
    1.57 +	//##ModelId=3A914DF9035D
    1.58 +	IMPORT_C virtual void MHFRunL(RHTTPTransaction aTransaction, const THTTPEvent& aEvent);
    1.59 +
    1.60 +	/** Called when the filters registration conditions are satisfied for events that occur
    1.61 +		on the session. Any leaves must be handled by the appropriate MHFRunError.
    1.62 +		@param aEvent The session event that has occured.
    1.63 +	*/
    1.64 +	//##ModelId=3C4C37D401C1
    1.65 +	IMPORT_C virtual void MHFSessionRunL(const THTTPSessionEvent& aEvent);
    1.66 +
    1.67 +	/** Called when RunL leaves from a transaction event. This works in the same
    1.68 +		way as CActve::RunError; return KErrNone if you have handled the error.
    1.69 +		If you don't completely handle the error, a panic will occur.
    1.70 +		@param aError The leave code that RunL left with.
    1.71 +		@param aTransaction The transaction that was being processed.
    1.72 +		@param aEvent The Event that was being processed.
    1.73 +		@return KErrNone if the error has been cancelled or the code
    1.74 +		of the continuing error otherwise.
    1.75 +	*/
    1.76 +	//##ModelId=3A914DF90359
    1.77 +	IMPORT_C virtual TInt MHFRunError(TInt aError, RHTTPTransaction aTransaction, const THTTPEvent& aEvent);
    1.78 +
    1.79 +	/** Called when MHFRunL leaves from a session event. This works in the same
    1.80 +		way as CActve::RunError
    1.81 +		If you don't completely handle the error, a panic will occur.
    1.82 +		@param aError The leave code that RunL left with.
    1.83 +		@param aEvent The Event that was being processed.
    1.84 +		@return KErrNone if the error has been cancelled or the code
    1.85 +		of the continuing error otherwise.	
    1.86 +	*/
    1.87 +	//##ModelId=3C4C37D302C4
    1.88 +	IMPORT_C virtual TInt MHFSessionRunError(TInt aError, const THTTPSessionEvent& aEvent);
    1.89 + 	};
    1.90 +
    1.91 +
    1.92 +#endif //	 __MHTTPFILTERBASE_H__