/*
* 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 in transaction handler.
*
*/

#ifndef __CPENGAUTHORIZATIONTRANSACTIONIN_H__
#define __CPENGAUTHORIZATIONTRANSACTIONIN_H__

//  INCLUDES
#include <e32base.h>
#include "MPEngIncomingTransactionHandler.h"

// CPS Version
#include    "PEngWVCspVersion.h"


// FORWARD DECLARATION
class MPEngAuthorizationEngine;
class MPEngPresenceAttrManager;
class CPEngAuthorizationResponse;
class CPEngAuthorizationRequest;
class MPEngXMLParser;

// CLASS DECLARATION
/**
 * Authorization in transaction handler.
 *
 * @lib PEngListLib2
 * @since 3.0
 */
class CPEngAuthorizationTransactionIn : public CBase,
            public MPEngIncomingTransactionHandler
    {
    public: // Enumerations

        /**
         * In authorization sub types.
         */
        enum TPEngAuthorizationTransType
            {
            EPEngAuthorizationRequest   = 1,
            EPEngAuthorizationResponse  = 2
            };


    public:

        /**
         * Two-phased constructor.
         */
        static CPEngAuthorizationTransactionIn* NewL(
            MPEngAuthorizationEngine& aAuthEngine,
            MPEngPresenceAttrManager& aAttrManager,
            MPEngXMLParser& aXMLParser,
            const TDesC8& aParseBlock,
            TPEngAuthorizationTransType aType );

        /**
         *  Two-phased constructor.
         */
        static CPEngAuthorizationTransactionIn* NewLC(
            MPEngAuthorizationEngine& aAuthEngine,
            MPEngPresenceAttrManager& aAttrManager,
            MPEngXMLParser& aXMLParser,
            const TDesC8& aParseBlock,
            TPEngAuthorizationTransType aType );

        /**
         * Destructor.
         */
        virtual ~CPEngAuthorizationTransactionIn();


    public: // From MPEngIncomingTransactionHandler

        /**
         * Process the incoming request.
         * @see <MPEngIncomingTransactionHandler.h>
         */
        void ProcessRequestL( const TDesC8& aRequest,
                              TRequestStatus& aStatus );

        /**
         * Cancels asynchronous processing of the request
         * @see <MPEngIncomingTransactionHandler.h>
         */
        void CancelProcessing();

    private: // new helpers

        /**
         * Parse User id from the message
         *
         * @since 3.0
         * @return user id buffer
         */
        HBufC* ParseUserIdLC();


        /**
         * Parse Attribute list
         *
         * @since 3.0
         * @param aAuthItem authorization item to add attributes
         * @param aAddFunc function called on item to add attributes
         */
        template <class AuthItem>
        void ParseAttrListL( AuthItem& aAuthItem, void ( AuthItem::* aAddFunc )( TUint32 ) );


        /**
         * Parse authorization status
         *
         * @since 3.0
         * @param aAuthStatus authorization status
         */
        void ParseAuthorizationStatusL( CPEngAuthorizationResponse& aAuthStatus );


    private: // Constructors

        /**
         * C++ constructor.
         */
        CPEngAuthorizationTransactionIn(
            MPEngAuthorizationEngine& aAuthEngine,
            MPEngPresenceAttrManager& aAttrManager,
            MPEngXMLParser& aXMLParser,
            const TDesC8& aParseBlock,
            TPEngAuthorizationTransType aType );


        /**
         * Symbian constructor.
         */
        void ConstructL();


    private:    // Data

        /// REF: Authorization engine
        MPEngAuthorizationEngine&               iAuthEngine;

        /// REF: Attribute manager
        MPEngPresenceAttrManager&               iAttributeManager;

        /// REF: XML Parser
        MPEngXMLParser&                         iXMLParser;

        /// REF: Block to parse
        TPtrC8                                  iParseBlock;

        /// OWN: Type of response to parse
        TPEngAuthorizationTransType             iResponseType;

    };

#endif      //  __CPENGAUTHORIZATIONTRANSACTIONIN_H__




//  End of File