/*

* Copyright (c) 2005 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:  Authorization out transaction handler.

*

*/

#ifndef __CPENGAUTHORIZATIONTRANSACTIONOUT_H__

#define __CPENGAUTHORIZATIONTRANSACTIONOUT_H__

//  INCLUDES

#include <e32base.h>

#include "MPEngOutgoingTransactionHandler.h"

#include "PEngWVCspVersion.h"

// CLASS DECLARATION

class MPEngAuthorizationEngine;

class CPEngAuthorizationResponse;

class CPEngTransactionStatus;

class MPEngXMLParser;

class MPEngXMLSerializer;

class MPEngPresenceAttrManager;

/**

 * Authorization out transaction handler.

 *

 * @lib PEngListLib2

 * @since 3.0

 */

class CPEngAuthorizationTransactionOut : public CBase,

            public MPEngOutgoingTransactionHandler

    {

    public:

        /**

         * Two-phased constructor.

         */

        static CPEngAuthorizationTransactionOut* NewLC(

            MPEngAuthorizationEngine& aAuthEngine,

            MPEngPresenceAttrManager& aAttrManager,

            MPEngXMLParser& aXMLParser,

            TPEngWVCspVersion& aCSPVersion,

            TInt aOperationId );

        /**

         * Destructor.

         */

        virtual ~CPEngAuthorizationTransactionOut();

    public: // From MPEngOutgoingTransactionHandler

        /**

         * Synchronous method, get Outgoing transaction request

         * @see <MPEngOutgoingTransactionHandler.h>

         */

        void RequestL( TDes8& aSendBuffer );

        /**

         * Signals to the transaction handler thst it is last

         * @see <MPEngOutgoingTransactionHandler.h>

         */

        void LastRunningTransactionHandler();

        /**

         * Process the response to the request.

         * @see <MPEngOutgoingTransactionHandler.h>

         */

        void ProcessResponseL( const TDesC8& aResponse,

                               TRequestStatus& aStatus );

        /**

         * Cancels asynchronous processing of the request

         * @see <MPEngOutgoingTransactionHandler.h>

         */

        void CancelProcessing();

        /**

         * Support for simultaneous transaction handling

         * @see <MPEngOutgoingTransactionHandler.h>

         */

        void NewTransactionHandlersL(

            RPointerArray<MPEngOutgoingTransactionHandler>& aHandlers );

        /**

         * Function to signal completing of the transaction

         * @see <MPEngOutgoingTransactionHandler.h>

         */

        TBool TransactionCompleted();

        /**

         * Gets transaction status result class

         * @see <MPEngOutgoingTransactionHandler.h>

         */

        CPEngTransactionStatus* TransactionResult( );

        /**

         * Releases the handler

         * @see <MPEngOutgoingTransactionHandler.h>

         */

        void ReleaseHandler();

    public:  // Set authorization response

        /**

         * Set authorization response

         * Function takes ownership

         *

         * @since 3.0

         * @param aResponse authorization response

         */

        void SetAuthResponse( CPEngAuthorizationResponse* aResponse );

    private: // XML message serializers

        /**

         * Append XML request to responde to authorization

         *

         * @since 3.0

         * @param aXmlSerializer XML serializer

         */

        void AppendXMLPresenceAuthUserL( MPEngXMLSerializer& aXmlSerializer );

        /**

         * Append XML request to Cancel authorization

         *

         * @since 3.0

         * @param aXmlSerializer XML serializer

         */

        void AppendXMLCancelAuthorizationL( MPEngXMLSerializer& aXmlSerializer );

        /**

         * Append in XML message User Id

         *

         * @since 3.0

         * @param aXmlSerializer XML serializer

         */

        void AppendXMLUserIdL( MPEngXMLSerializer& aXmlSerializer );

    private: // Constructors

        /**

         * C++ constructor.

         */

        CPEngAuthorizationTransactionOut(

            MPEngAuthorizationEngine& aAuthEngine,

            MPEngPresenceAttrManager& aAttrManager,

            MPEngXMLParser& aXMLParser,

            TPEngWVCspVersion& aCSPVersion,

            TInt aOperationId );

        /**

         * Symbian constructor.

         */

        void ConstructL();

    private:    // Data

        /// REF: Authorization engine

        MPEngAuthorizationEngine&               iAuthEngine;

        /// REF: Attribute manager

        MPEngPresenceAttrManager&               iAttributeManager;

        /// REF: XML Parser

        MPEngXMLParser&                         iXMLParser;

        /// REF: CSP Version

        TPEngWVCspVersion&                      iCSPVersion;

        /// OWN: Transaction completed

        TBool                                   iTransCompleted;

        /// OWN: Authorization response

        CPEngAuthorizationResponse*             iResponse;

        /// OWN: Transaction status class

        CPEngTransactionStatus*                 iTransactionStatus;

        /// OWN: Operation Id

        TInt                                    iOperationId;

    };

#endif      //  __CPENGAUTHORIZATIONTRANSACTIONOUT_H__

//  End of File