mmsharing/livecommsui/lcui/tsrc/mustester/Stubs/sipclientstub/inc/siptransactionbase.h
branchRCL_3
changeset 22 73a1feb507fb
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mmsharing/livecommsui/lcui/tsrc/mustester/Stubs/sipclientstub/inc/siptransactionbase.h	Tue Aug 31 15:12:07 2010 +0300
@@ -0,0 +1,228 @@
+/*
+* Copyright (c) 2003 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: 
+*
+*/
+
+
+#ifndef CSIPTRANSACTIONBASE_H
+#define CSIPTRANSACTIONBASE_H
+
+//  INCLUDES
+
+#include <e32base.h>
+#include <stringpool.h>
+
+// FORWARD DECLARATIONS
+class CSIPResponseElements;
+class MTransactionAssociation;
+
+/**
+*  Base class for managing SIP transactions.
+*  It provides services for quering transaction
+*  type and its state.
+*
+*  This class is an abstract class and cannot be
+*  instantiated.
+*  @lib sipclient
+*/
+class CSIPTransactionBase: public CBase
+	{
+	public:
+		/** SIP transaction state */
+		enum TState
+			{
+			/** Trying state */
+			ETrying,
+			/** Calling state */
+			ECalling,
+			/** Proceeding state */
+			EProceeding,
+			/** Completed state */
+			ECompleted,
+			/** Confirmed state */
+			EConfirmed,
+			/** Terminated state */
+			ETerminated
+			};
+
+	public:
+
+        /**
+        * Destructor
+		*/
+
+		virtual ~CSIPTransactionBase();
+		
+		
+	public:
+        /**
+        * Gets the SIP transaction type
+        * @return SIP transaction type
+        */
+
+		IMPORT_C RStringF Type() const;
+
+
+		/**
+		* Gets SIP transaction state
+		* @return SIP transaction state
+		*/
+
+		IMPORT_C CSIPTransactionBase::TState StateL();
+
+
+		/**
+		* Checks the if the actual object
+		* is of type CSIPClientTransaction.
+		* @return ETrue if object is of type CSIPClientTransaction and
+		*         EFalse otherwise
+		*/
+
+		IMPORT_C TBool IsSIPClientTransaction() const;
+
+
+		/**
+		* Compares this object to another object also having
+		* CSIPTransactionBase base class
+		* The function has to be implemented in each of the sub-classes.
+		* @param aTransaction a CSIPTransactionBase object to compare
+		* @return ETrue if the objects are equal otherwise EFalse
+		*/
+
+        IMPORT_C TBool
+            operator==(const CSIPTransactionBase& aTransaction) const;
+
+        /**
+		* Obtains the RequestId of the transaction.
+		*
+        * @return RequestId
+		*/
+
+        TUint32 RequestId() const;
+
+
+        /**
+		* Clears the MTransactionAssociation. After this the object can't be
+        * used anymore and it is expected that user will delete it soon.
+        *
+        * @param aAssociation Object requesting the detach
+		*/
+
+        virtual void Detach(const MTransactionAssociation& aAssociation);
+
+
+        /**
+		* Changes the transaction state.
+        *
+        * @param aNextState State into which transaction moves
+		*/
+
+        void ChangeState(CSIPTransactionBase::TState aNextState);
+
+
+        /**
+        * Determines whether this transaction has an effect on the associated
+        * dialog's state.
+        *
+		* @return ETrue if transaction has an effect on the dialog's state,
+        *   EFalse otherwise.
+		*/
+
+        TBool AffectsDialogState() const;
+
+
+        /**
+		* Sets this transaction to affect the dialog state.
+		*/
+
+        void SetAffectsDialogState();
+
+
+        /**
+		* Determines whether the transaction type is a target refresh request.
+        *
+        * @param aType Type of transaction
+        * @return ETrue If the transaction is a target refresh request, EFalse
+        *   otherwise.
+		*/
+
+        static TBool IsTargetRefresh(RStringF aType);
+
+
+        /**
+		* Stores response elements. Depending on the status code, transaction
+        * may enter another state.
+        *
+        * @param aElements Response elements, ownership is transferred.
+		*/
+
+        void SetResponseElements(CSIPResponseElements* aElements);
+       
+
+    protected:
+        CSIPTransactionBase( RStringF aType, TBool aIsCliTrx );
+
+        void ConstructL();
+
+
+        /**
+		* Checks that iAssociation is available (not NULL). If iAssociation is
+        * NULL, it means user has deleted a resource needed by
+        * CSIPTransactionBase, and this function leaves.
+		*/
+
+        void CheckAssociationL() const;
+
+
+        /**
+		* Gets response elements.
+        *
+		* @return Response elements. Ownership isn't transferred.
+		*/
+
+        const CSIPResponseElements* ResponseElements() const;
+
+
+        //RequestId received from SIP client        
+        TUint32 iRequestId;
+
+        //Every transaction is associated to exactly one other object:
+        //CSIP, CSIPConnection, CSIPRegistrationBinding or CSIPDialogAssocBase
+        MTransactionAssociation* iAssociation;
+
+    public:
+    
+				RStringF iType;
+
+        //ETrue is the transaction is a client transaction, EFalse otherwise
+        TBool iIsClientTransaction;
+
+        
+        //ETrue if the transaction has an effect on the dialog state in case
+        //the transaction is associated with a dialog.
+        //EFalse otherwise.
+        TBool iAffectsDialogState;
+
+        //SIP response elements
+        CSIPResponseElements* iResponseElements;
+
+    public:
+        //Current transaction state
+        TState iState;
+        	
+        
+    };
+
+#endif