/*

* 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:

* IF implementation class for connection method plugins.

*

*/

#ifndef CMPLUGINBASEENG_H

#define CMPLUGINBASEENG_H

// INCLUDES

#include <cmconnectionmethoddef.h>

#include <e32std.h>

#include <e32base.h>

#include <ecom/ecom.h>

#include <metadatabase.h>

#include <commsdattypesv1_1.h>

#include <cmmanagerdef.h>

/**

 * Macro for getting element id from Iap Id.

 * @param iapRecId Record id of an Iap.

 */

#define IAP_ELEMENT_ID( iapRecId )  (KCDTIdIAPRecord | \

                                     KCDMaskShowFieldType | \

                                     (iapRecId << 8))

/**

 * Macros for getting/setting diffrerent type of values from/to the records(CommsDat)

 * @param record Pointer to the record which has the field requested/to be set.

 * @param fieldId Id of the field to get/set the value.

 * @param ***Val Value to be set.

 * @return Returns the requested value in get operation.

 */

#define QUERY_HBUFC_FIELD( record, fieldId ) *STATIC_CAST(CommsDat::CMDBField<HBufC*>*, record->GetFieldByIdL( fieldId ))

#define QUERY_UINT32_FIELD( record, fieldId ) *STATIC_CAST(CommsDat::CMDBField<TUint32>*, record->GetFieldByIdL( fieldId ))

#define QUERY_INT_FIELD( record, fieldId ) *STATIC_CAST(CommsDat::CMDBField<TInt>*, record->GetFieldByIdL( fieldId ))

#define SET_HBUFC_FIELD( record, fieldId, stringVal ) STATIC_CAST(CommsDat::CMDBField<TDesC>*, record->GetFieldByIdL( fieldId ))->SetL( stringVal->Des() )

#define SET_INT_FIELD( record, fieldId, intVal ) STATIC_CAST(CommsDat::CMDBField<TInt>*, record->GetFieldByIdL( fieldId ))->SetL( intVal )

#define FIELD_TO_TDESC( field ) ( (const TDesC&)( field ) )

// CONSTANTS

const TInt32 KExtensionBaseLevel = 1;

const TUint32 KMaxProxyServerNameLength = 1024;

const TUint32 KDummyBearerType = 1;

/**

 * Record indexes for generic iap records in the Client instance table.

 */

// DATA TYPES

typedef enum

    {

    ECmBool,

    ECmInt,

    ECmText,

    ECmText8

// Attributes that are related to bearer plugin creation

enum TBearerCreationCommonAttributes

    {

    ECmBearerCreationCommonAttributes = 9000,   /**<

                                                * Marks the beginning of

                                                * bearer creation related

                                                * attributes

                                                */

    ECmExtensionLevel,          /**<

                                * bearer type. 1 means the level 1st.

                                * (TUint32 - default: none - read only)

                                */

    ECmBearerCreationCommonAttributesEnd = 9999 /**<

                                                * Marks the end of bearer

                                                * creation related attributes

                                                */

    };

/**

 * Flags for Iap metadata to indicate:

 * EMetaHighlight: If it's set it indicates that a connection method is

 *                 method can have this flag set.

 *                   hidden connection method in Agent dialog.

 */

enum TCmMetaDataFields

    {

    EMetaHighlight    = 0x00000001,

    EMetaHiddenAgent  = 0x00000002

    };

// FORWARD DECLARATIONS

class CCmPluginBaseEng;

class CCDIAPMetadataRecord;

// CLASS DECLARATION

/**

 * Initialisation instance for plugin creation. Used in plugin

 * construction phase.

 */

NONSHARABLE_CLASS(TCmPluginInitParam)

    {

    public:

        /**

         * Constructor.

         * @param aSessionRef Reference for open Session handle to CommsDat.

         */

        IMPORT_C TCmPluginInitParam( CommsDat::CMDBSession& aSessionRef );

    public:

        /**

         * Reference to CommsDat session handle.

         */

        CommsDat::CMDBSession& iSessionRef;

        /**

         * Reserved for future.

         */

    };

// CLASS DECLARATION

/**

 * This defines the data object used for moving data between

 * cmm server and plugins.

 */

NONSHARABLE_CLASS( CCmClientPluginInstance ): public CBase

    {

    public:

        /**

         * Two-phase constructor. Returns pointer to the new

         * CCmClientPluginInstance object.

         */

        IMPORT_C static CCmClientPluginInstance* NewL();

        /**

         * Two-phase constructor. Returns pointer to the new

         * CCmClientPluginInstance object.

         */

        IMPORT_C static CCmClientPluginInstance* NewLC();

        /**

         * Destructor

         */

        IMPORT_C ~CCmClientPluginInstance();

    private:

        /**

         * Default constructor.

         */

        CCmClientPluginInstance();

        /**

         * Second phase constructor.

         */

        void ConstructL();

    public:

        /**

         * Pointer array for generic record pointers. Those are copies

         */

        RPointerArray<CommsDat::CCDRecordBase> iGenRecordArray;

        /**

         * Pointer array for bearer specific record pointers. Those are copies

         * from CommsDat versions for the client usage. These are asked from

         * the different plugins.

         */

        RPointerArray<CommsDat::CCDRecordBase> iBearerSpecRecordArray;

        /** Naming way of the CM. e.g. ENamingUnique */

        /** Boolean to keep the information if location is enabled */

        /** Iap Record id of this Connection Method */

    };

/**

 *  CCmPluginBaseEng is base class for every connection method plugin.

 *  It handles all the generic iap informations e.g. record handling

 *  and attribute reaquests to generic records.

 *

 *  @lib cmmpluginbase.lib

 *  @since S60 v5.2

 */

class CCmPluginBaseEng : public CBase

    {

    public:

        * Destructor.

        */

       IMPORT_C virtual ~CCmPluginBaseEng();

        /**

         * Create a new instance of the given bearer type plugin.

         * Used from CMM server to avoid using slow ECom framework.

         * @param aInitParam initialization data

         * @return Returns CCmPluginBaseEng type pointer which represents pure

         * bearer instance for the CMM server.

         */

        /**

         * requested attributes. These values are bearerspecific so they

         * don't vary between CMs with same bearer type.

         * @param aAttribute An attribute identifier.

         * @return Returns the value requested. If not found leaves with

         */

        /**

         * Checks if the plug-in can handle the Connection Method identified

         * with parameter aIapId.

         * @param aIapId IAPId of the AP to be checked

         * @return ETrue if plug-in can handle the IAP, otherwise EFalse.

         */

        virtual TBool CanHandleIapIdL( TUint32 aIapId ) const = 0;

        /**

         * Checks if the plug-in can handle the given IAP record.

         * @param aIapRecord IAP record to be checked

         * @return ETrue if plug-in can handle the IAP, otherwise EFalse.

         */

    public: // Client interface

        /**

         * Loads all the records belonging to this Connection Method.

         * @param aIapId Id of the IAP record. Identifies the CM

         * related records to load.

         */

        IMPORT_C void LoadL( TUint32 aIapId );

        /**

         * Resets and loads all the records belonging to this Connection Method.

         */

        IMPORT_C void ReLoadL();

        /**

         * it in CommsDat. No CommsDat transaction operation is needed for this.

         *       0 means that CommsDat gives the id.

         */

        IMPORT_C void CreateNewL( TUint32 aCmId );

        /**

         * Creates a copy of an existing Connection Method.

         * @param aClientPluginInstance The source data to create the copy from.

         * @return CCmPluginBaseEng type pointer to an object which represents

         * the new plugin to the CMM server.

         */

        /**

         * Updates all records to commsdat. Data is copied from the client's copy

         * to the original data.

         * Caller must handle transactions.

         */

                CCmClientPluginInstance* aClientPluginInstance );

        /*

         * Caller must handle transactions.

        IMPORT_C virtual void DeleteL();

        /**

         * Creates a copy of all plugin data( most of them are CommsDat data ) for a client.

         * @param aClientPluginInstance An object where to copy the data.

         */

        IMPORT_C void GetPluginDataL( CCmClientPluginInstance* aClientPluginInstance );

        /**

         * requested attributes. Attributes are returned from the client's

         * copy of the data. These values are CM specific.

         * @param aAttribute An attribute identifier.

         * @param aClientPluginInstance Client's copy of the data where

         * to get the return value.

         * @return Returns the value requested. If not found leaves with

         */

        /**

         * client's copy of the data.

         * @param aAttribute An attribute identifier.

         * @param aValue Value to set.

         * @param aClientPluginInstance Client's copy of the data where

         * to set the given value.

         */

        /**

         * Requests CommsDat table ids to be observed for changes by the cmm

         * server. This is only for generic iap related tables.

         * @param aTableIdArray A reference to an array where iap related generic

         * table ids are added.

         */

        IMPORT_C void GetGenericTableIdsToBeObserved( RArray<TUint32>& aTableIdArray ) const;

        /**

         * Requests CommsDat table ids to be observed for changes by the cmm

         * server. If a table used is not mentioned to be modified a bearer

         * shouldn't return this. Bearers do not reset the array before adding

         * ids.

         * @param aTableIdArray A reference to an array where plugin must add

         * the ids of the tables it want's to be observed.

         */

                RArray<TUint32>& aTableIdArray ) const = 0;

    public: // plugin interface

        /**

         * Creates a copy of all bearer specific CommsDat data for the client.

         * Called as result of GetPluginDataL().

         * the bearer specific implementation knows the amount and order

         * of these records in the array.

         */

                RPointerArray<CommsDat::CCDRecordBase>& aRecordArray ) = 0;

        /**

         * Following GetBearerXXXXAttribute methods get only the

         * fields in records in pointer arrays(parameters).

         * @param aAttribute Identifier of the requested value.

         * records of the Connection Method.

         * @param aBearerSpecRecordArray An array containing pointers to bearer

         * specific records of the Connection Method. aAttribute

         * parameter should identify one field(integer, boolean string)

         * system-wide error code.

         */

                RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,

                RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray ) = 0;

                RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,

                RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray ) = 0;

                RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,

                RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray ) = 0;

                RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,

                RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray ) = 0;

        /**

         * Following SetBearerXXXXAttribute methods set only the

         * allowed to update the original records in plugins.

         * @param aAttribute Identifier of the field to set.

         * @param aValue The value to set.

         * records of the Connection Method.

         * @param aBearerSpecRecordArray An array containing pointers to bearer

         * specific records of the Connection Method. aAttribute

         * parameter should identify one field(integer, boolean string)

         * @return None.

         */

                RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,

                RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray ) = 0;

                TBool aValue,

                RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,

                RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray ) = 0;

                const TDesC16& aValue,

                RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,

                RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray ) = 0;

                RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,

                RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray ) = 0;

        /**

         * would start loading bearer specific records.

         */

        virtual void PreparePluginToLoadRecordsL() = 0;

        /**

         * Gives the plugin a possibility to do some preparing operations

         * if needed.