--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/applayerpluginsandutils/httpprotocolplugins/wspinc/MWspCLMethodInvoker.h Tue Feb 02 01:09:52 2010 +0200
@@ -0,0 +1,103 @@
+// Copyright (c) 2001-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:
+//
+
+/**
+ @file MWspCLMethodInvoker.h
+ @warning : This file contains Rose Model ID comments - please do not delete
+*/
+
+#ifndef __MWSPCLMETHODINVOKER_H__
+#define __MWSPCLMETHODINVOKER_H__
+
+// System includes
+#include <e32base.h>
+
+// Forward declarations
+class MWspCLMethodCallback;
+
+
+class MWspCLMethodInvoker
+/**
+@class MWspCLMethodInvoker
+@since 7.0
+The MWspCLMethodInvoker and MWspCLMethodCallback form the API that provides
+the WSP Connectionless Session Service Method Invocation facility, as
+described in the WSP Specification, July 2001.
+
+The MWspCLMethodInvoker interface is supplied by the Provider entity. The
+MWspCLMethodCallback interface is supplied by the Client entity. The
+Provider implements the communications necessary to send the primitives
+issued by the Client to the Server, and from the Server to the Client.
+
+The Client object that encapsulates a method transaction implements the call-back
+API MWspCLMethodCallback. Internally, the Provider should associate each of these
+objects with a WSP Transaction Id in order to distinguish between method transactions.
+@publishedAll
+@deprecated
+*/
+ {
+public: // Method
+
+/**
+ @fn UnitMethodInvoke(MWspCLMethodCallback& aMethodCallback, RStringF aMethod, const TUriC8& aRequestUri, const TDesC8& aRequestHeaders, const TDesC8& aRequestBody) =0
+ Intended Usage : This represents the S-Unit-MethodInvoke primitive. The
+ Provider initiates a non-confirmed method with the Server.
+ The Client expects the S-Unit-MethodResult primitive to
+ be issued from the Provider.
+ @since 7.0
+ @param aMethodCallback A refernce to an instance of the call-back
+ API MWspCLMethodCallback.It uniquely
+ identifies this method transaction for the
+ lifetime of the transaction.
+ @param aMethod An RStringF object that describes the HTTP
+ method for this transaction.
+ @param aRequestUri A URI object that specifies the resource
+ to which this operation applies.
+ @param aRequestHeaders A buffer with the encoded request header.
+ @param aRequestBody A buffer with the data associated with the
+ request. Only used if the method aMethod
+ supports an entity body.
+ @pre The underlying layers are prepared for communication.
+ @post The Provider is waiting for a S-Unit-MethodResult primitive
+ from the Server.
+ */
+ virtual void UnitMethodInvoke(
+ MWspCLMethodCallback& aMethodCallback,
+ RStringF aMethod,
+ const TUriC8& aRequestUri,
+ const TDesC8& aRequestHeader,
+ const TDesC8& aRequestBody
+ ) =0;
+
+/**
+ @fn CancelMethodInvoke(MWspCLMethodCallback& aMethodCallback) =0
+ Intended Usage : The Client wishes to cancel the method. The call-back
+ object pointed to by aMethodCallback is no longer valid.
+ The Provider ignores any method responses associated with
+ aMethodCallback.
+ @since 7.0
+ @param aMethodCallback A refernce to an instance of the call-back
+ API MWspCLMethodCallback.It uniquely
+ identifies this method transaction for the
+ lifetime of the transaction.
+ @pre There exists a Transaction Id associated with aMethodCallback.
+ @post Any received S-Unit-MethodResult primitive with a Transaction
+ Id associated with aMethodCallback is ignored.
+ */
+ virtual void CancelMethodInvoke(MWspCLMethodCallback& aMethodCallback) =0;
+
+ };
+
+#endif // __MWSPCLMETHODINVOKER_H__
\ No newline at end of file