--- a/cmmanager/cmmgr/cmmplugins/cmpluginpacketdata/inc/cmpluginpacketdata.h Tue Aug 31 15:35:44 2010 +0300
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,455 +0,0 @@
-/*
-* Copyright (c) 2009-2010 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:
-* Declaration of packetdata interface implementation
-* for "Packetdata" plugin
-*
-*/
-
-#ifndef PACKETDATA_PLUGIN_H
-#define PACKETDATA_PLUGIN_H
-
-#include <cmpluginbaseeng.h>
-#include <cmpluginpacketdatadef.h>
-
-/**
-* CCmPluginPacketData defines the functionality of packetdata bearer support.
-* Most of the API is inherited from CCmPluginBaseEng class.
-*/
-NONSHARABLE_CLASS( CCmPluginPacketData ) : public CCmPluginBaseEng
- {
-
- public:
- /**
- * Two phased constructor.
- * @return Returns the packetdata plugin object.
- */
- static CCmPluginPacketData* NewL( TCmPluginInitParam* aInitParam );
-
- /**
- * Destructor.
- */
- virtual ~CCmPluginPacketData();
-
- public: // From CCmPluginBaseEng
- /**
- * Creates a new instance of packetdata bearer plugin. The instance
- * created represents a bearer, not a connection method.
- * @param aInitParam Initialization data.
- * @return Returns CCmPluginBaseEng type pointer which represents pure
- * bearer instance for the cmm server.
- */
- virtual CCmPluginBaseEng* CreateInstanceL(
- TCmPluginInitParam& aInitParam ) const;
-
- /**
- * Following GetBearerInfoXXXL methods return the values of the
- * requested attributes. These values are packetdata specific
- * so they don't vary between packetdata Connection Methods.
- * @param aAttribute An attribute identifier.
- * @return Returns the value requested. If not found leaves with
- * KErrNotFound error code.
- */
-
- virtual TUint32 GetBearerInfoIntL( TUint32 aAttribute ) const;
-
- virtual TBool GetBearerInfoBoolL( TUint32 aAttribute ) const;
-
- virtual HBufC* GetBearerInfoStringL( TUint32 aAttribute ) const;
-
- virtual HBufC8* GetBearerInfoString8L( TUint32 aAttribute ) const;
-
- /**
- * Checks if the plug-in can handle the Connection Method identified
- * with parameter aIapId.
- * @param aIapId IAPId of the Connection Method to be checked.
- * @return ETrue if plug-in can handle the IAP, otherwise EFalse.
- */
- virtual TBool CanHandleIapIdL( TUint32 aIapId ) const;
-
- /**
- * 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.
- */
- virtual TBool CanHandleIapIdL(
- CommsDat::CCDIAPRecord *aIapRecord ) const;
-
- public: // From CCmPluginBaseEng concerning a Connection Method
- /**
- * Before generic side starts to request plugins to load records
- * it calls this to give a possibility make some preparations
- * if needed.
- */
- virtual void PreparePluginToLoadRecordsL();
-
- /**
- * Before generic side starts to request plugins to update records
- * it calls this to give a possibility make some preparations
- * if needed.
- * @param aGenRecordArray An array of generic records to be updated.
- * @param aBearerSpecRecordArray An array of bearer specific records
- * to be updated.
- */
- virtual void PreparePluginToUpdateRecordsL(
- RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,
- RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray );
-
- /**
- * Creates the CCDWCDMAPacketServiceRecord type service record.
- */
- virtual void CreateServiceRecordL();
-
- /**
- * Loads the service record. Service record pointer is stored to
- * plugins generic side implementation(CCmPluginBaseEng).
- */
- virtual void LoadServiceRecordL();
-
- /**
- * Returns the service record id of this Connection Method.
- * @return Returns the id of the service record id of this Connection Method.
- */
- virtual TUint32 ServiceRecordId() const;
-
- /**
- * Returns the service record name of the Connection Method.
- * @param aServiceName Name of the service record which CM's iap record
- * points to.
- */
- virtual void ServiceRecordNameLC( HBufC* &aServiceName );
-
- /**
- * Writes the service record data to CommsDat.
- * @param aGenRecordArray An array containing pointers to service
- * record of the Connection Method.
- * @param aBearerSpecRecordArray An array containing pointers to bearer
- * specific records of the Connection Method.
- */
- virtual void UpdateServiceRecordL(
- RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,
- RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray );
-
- /**
- * Creates packetdata specific default records.
- */
- virtual void CreateBearerRecordsL();
-
- /**
- * Loads packetdata specific records of the Connection Method.
- */
- virtual void LoadBearerRecordsL();
-
- /**
- * Returns the bearer record id of the Connection Method.
- * @param aRecordId Id of the bearer record this CM's iap record
- * points to.
- */
- virtual void BearerRecordIdL( TUint32& aRecordId );
-
- /**
- * Returns the bearer record name of the Connection Method.
- * @param aBearerName Name of the bearer record this CM's iap record
- * points to.
- */
- virtual void BearerRecordNameLC( HBufC* &aBearerName );
-
- /**
- * Writes packetdata specific record data to CommsDat.
- * @param aGenRecordArray An array containing pointers to generic records
- * of the Connection Method.
- * @param aBearerSpecRecordArray An array containing pointers to bearer
- * specific records to be written.
- */
- virtual void UpdateBearerRecordsL(
- RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,
- RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray );
-
- /**
- * Deletes packetdata specific records of the Connection Method.
- */
- void DeleteBearerRecordsL();
-
- /**
- * Releases the memory reserved by the packetdata specific records
- * of the Connection Method.
- */
- virtual void ResetBearerRecords();
-
- /**
- * Creates a copy of packetdata specific records and adds them to
- * aRecordArray.
- */
- virtual void GetBearerSpecificRecordsL(
- RPointerArray<CommsDat::CCDRecordBase>& aRecordArray );
-
- /**
- * Following GetBearerXXXXAttribute methods get only the
- * fields in records in pointer arrays(parameters).
- * @param aAttribute Identifier of the requested value.
- * @param aGenRecordArray An array containing pointers to generic
- * 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)
- * in one of these records.
- * @return Returns the requested value. In error case leaves with
- * system-wide error code.
- */
-
- virtual TUint32 GetBearerIntAttributeL(
- TUint32 aAttribute,
- RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,
- RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray );
-
- virtual TBool GetBearerBoolAttributeL(
- TUint32 aAttribute,
- RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,
- RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray );
-
-
- virtual HBufC* GetBearerStringAttributeL(
- TUint32 aAttribute,
- RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,
- RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray );
-
- virtual HBufC8* GetBearerString8AttributeL(
- TUint32 aAttribute,
- RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,
- RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray );
-
- /**
- * Following SetBearerXXXXAttribute methods set only the
- * fields in records in pointer arrays(parameters). They are not
- * allowed to update the original records in plugins.
- * @param aAttribute Identifier of the field to set.
- * @param aValue The value to set.
- * @param aGenRecordArray An array containing pointers to generic
- * 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)
- * in one of these records.
- * @return None.
- */
-
- virtual void SetBearerIntAttributeL(
- TUint32 aAttribute, TUint32 aValue,
- RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,
- RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray );
-
- virtual void SetBearerBoolAttributeL(
- TUint32 aAttribute, TBool aValue,
- RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,
- RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray );
-
- virtual void SetBearerStringAttributeL(
- TUint32 aAttribute, const TDesC16& aValue,
- RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,
- RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray );
-
- virtual void SetBearerString8AttributeL(
- TUint32 aAttribute, const TDesC8& aValue,
- RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,
- RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray );
-
- /**
- * Bearer is requested by the server if it uses CommsDat tables which
- * should be observed for possible changes to be able to keep the
- * data in memory in up to date.
- * @param aTableIdArray A reference to an array where to add those
- * table ids.
- */
- virtual void GetBearerTableIdsToBeObservedL(
- RArray<TUint32>& aTableIdArray ) const;
-
- private: // Constructors
-
- /**
- * Constructor
- */
- CCmPluginPacketData(
- TCmPluginInitParam* aInitParam,
- TBool aOutgoing );
-
- /**
- * Second phase constructor
- */
- void ConstructL();
-
- private:
- /**
- * Adds Service record with default values to record array.
- * @param aRecordArray The array where to add the service record.
- */
- void GetDefaultServiceRecordL(
- RPointerArray<CommsDat::CCDRecordBase>& aRecordArray );
-
- /**
- * Adds QoS record with default values to record array.
- * @param aRecordArray The array where to add the QoS record.
- */
- void GetDefaultQosRecordL(
- RPointerArray<CommsDat::CCDRecordBase>& aRecordArray );
-
- /**
- * Returns a reference to service record of the Connection Method.
- */
- CommsDat::CCDWCDMAPacketServiceRecord& ServiceRecord() const;
-
- /**
- * Makes needed preparations before copying records.
- * @param aCopyInstance Instance of the plugin where to copy.
- */
- virtual void PrepareToCopyDataL( CCmPluginBaseEng* aCopyInstance );
-
- /**
- * Copies the service record.
- * @return Returns a pointer to service record created.
- */
- CommsDat::CCDRecordBase* CopyServiceRecordL();
-
- /**
- * Copies the bearer specific records to copy instance.
- * @param aCopyInstance Instance of the plugin where to copy.
- */
- virtual void CopyBearerRecordsL( CCmPluginBaseEng* aCopyInstance );
-
-
- /**
- * Gets an integer value from service record.
- * @param aAttribute An indentifier to know the field in the record.
- * @param aGenRecordArray Array of records where the service record
- * can be found.
- * @return Returns an integer if the requested attribute
- * is found. Otherwise leaves with error code KErrNotFound.
- */
- TUint32 GetServiceIntAttributeL(
- TUint32 aAttribute,
- RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray );
-
- /**
- * Gets a string value from service record. Ownership of the return
- * value is passed to the caller.
- * @param aAttribute An indentifier to know the field in the record.
- * @param aGenRecordArray Array of records where the service record
- * can be found.
- * @return Returns a pointer to an buffer if the requested attribute
- * is found. Otherwise leaves with error code KErrNotFound.
- */
- HBufC* GetServiceStringAttributeL(
- TUint32 aAttribute,
- RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray );
-
- /**
- * Sets integer value to service record.
- * @param aAttribute An indentifier to know the field in the record.
- * @param aValue A value to set.
- * @param aGenRecordArray Array of records where the service record
- * can be found.
- */
- void SetServiceIntAttributeL(
- TUint32 aAttribute,
- TUint32 aValue,
- RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray );
-
- /**
- * Gets an integer value from packetdata specific record.
- * @param aAttribute An indentifier to know the field in the record.
- * @param aBearerSpecRecordArray Array of records where the service
- * record can be found.
- * @return Returns an integer if the requested attribute
- * is found. Otherwise leaves with error code KErrNotFound.
- */
- TUint32 GetQosIntAttributeL(
- TUint32 aAttribute,
- RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray );
-
- /**
- * Sets an integer value to packetdata specific record.
- * @param aAttribute An indentifier to know the field in the record.
- * @param aValue The value to be set.
- * @param aBearerSpecRecordArray Array of records where the service
- * record can be found.
- * @return Returns an integer if the requested attribute
- * is found. Otherwise leaves with error code KErrNotFound.
- */
- void SetQosIntAttributeL(
- TUint32 aAttribute,
- TUint32 aValue,
- RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray );
-
- /**
- * Sets the PDP-type.
- * @param aPdpType Pdp type to set.
- * @param aServiceRecord Pointer to the service record where to save the
- * pdp type.
- */
- void SetPDPTypeL(
- RPacketContext::TProtocolType aPdpType,
- CommsDat::CCDWCDMAPacketServiceRecord* aServiceRecord );
-
- /**
- * Sets the daemon name for the Connection Method.
- * @param aGenRecordArray An array containing pointers to generic records
- * of the Connection Method.
- * @param aBearerSpecRecordArray An array containing pointers to bearer
- * specific records of the Connection Method.
- */
- void SetDaemonNameL(
- RPointerArray<CommsDat::CCDRecordBase>& aGenRecordArray,
- RPointerArray<CommsDat::CCDRecordBase>& aBearerSpecRecordArray );
-
- /**
- * Returns the default priority value identified with the parameter.
- * @param aAttribute Indentifies the default priority value requested.
- */
- TUint32 GetDefPriorityL( const TUint32 aAttribute ) const;
-
- private:
- /**
- * Checks if the packetdata network is available.
- * @return Returns ETrue if the network is available. Otherwise returns
- * EFalse.
- */
- TBool CheckNetworkCoverageL() const;
-
- private: // Data
- /**
- * Boolean to define if this is outgoing or incoming packetdata cm.
- */
- TBool iOutgoing;
-
- /**
- * ID of the bearer record of the IAP.
- */
- TUint32 iBearerRecordId;
-
- /**
- * Name of the bearer record of the IAP.
- */
- HBufC* iBearerRecordName;
-
- /**
- * Pointer to the QoS record of the IAP.
- */
- CommsDat::CCDUmtsR99QoSAndOnTableRecord* iPacketDataQoSRecord;
-
- /**
- * Bearer priority table ID.
- */
- CommsDat::TMDBElementId iBearerPriorityTableId;
- };
-
-#endif // PACKETDATA_PLUGIN_H