diff -r 9d7ce34704c8 -r b564fb5fd78b baseconnectionproviders/refscpr/src/ReferenceSCPR_defaultSubconnProv.cpp --- a/baseconnectionproviders/refscpr/src/ReferenceSCPR_defaultSubconnProv.cpp Tue Aug 31 16:25:36 2010 +0300 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,347 +0,0 @@ -// Copyright (c) 2005-2009 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: -// Implementation file for the Default Reference SubConnection Provider -// -// - -/** - @file - @internalComponent -*/ - -#include "ReferenceSCPR_defaultSubconnProv.h" - - -//-========================================================= -// Custom methods -//-========================================================= -CReferenceDefaultSubConnectionProvider::CReferenceDefaultSubConnectionProvider( - CSubConnectionProviderFactoryBase& aFactory, - CConnectionProviderBase& aConnProvider) -:CSubConnectionProviderBase(aFactory, aConnProvider) -/** - -@param aFactory CSubConnectionProviderFactoryBase that should own the reference to 'this' -@param aConnProvider a connection that 'this' subconnection belongs to -*/ - { - __FLOG_OPEN(KReferenceLogTag1, KReferenceLogTag2); - } - - -/** NewL for the two stage construction. Calls the CReferenceDefaultSubConnectionProvider constructor - and ConstructL on the constructed instance. - -@param aFactory - the subconnection provider factory the new CReferenceDefaultSubConnectionProvider - will belong to and is to be instantiated by. -@param aConnProvider - the connection (represented by a connection provieder) the new - CReferenceSubConnectionProvider will belong to. -@return - a new, constructed instance of CReferenceDefaultSubConnectionProvider. -*/ -CReferenceDefaultSubConnectionProvider* CReferenceDefaultSubConnectionProvider::NewL( - CSubConnectionProviderFactoryBase& aFactory, - CConnectionProviderBase& aConnProvider) - { - CReferenceDefaultSubConnectionProvider* provider = - new(ELeave)CReferenceDefaultSubConnectionProvider(aFactory, aConnProvider); - CleanupStack::PushL(provider); - provider->ConstructL(); - CleanupStack::Pop(); - return provider; - } - - -/** ConstructL for the two stage construction -*/ -void CReferenceDefaultSubConnectionProvider::ConstructL() - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::ConstructL()"), this); - //TODO: perform 2nd stage construction, if needed. - } - - -CReferenceDefaultSubConnectionProvider::~CReferenceDefaultSubConnectionProvider() -/** -Destroys 'this' -*/ - { - __FLOG_CLOSE; - } - - - -//-========================================================= -// MConnectionDataClient methods -//-========================================================= - -/** Called by the connection provider, of which 'this' is a data client and to which - 'this' belongs. The connection provider will call this method to notify its data clients. - -@param aNotifyType - one of MConnectionDataClient::TNotify enums indicating the notification type. -@param aConnProvider - the connection provider originating this notification. -@param aError - the error indication -@param aConNotificationEvent - the actual event. -*/ -void CReferenceDefaultSubConnectionProvider::Notify(MConnectionDataClient::TNotify /*aNotifyType*/, CConnectionProviderBase* /*aConnProvider*/, TInt /*aError*/, const CConNotificationEvent* /*aConNotificationEvent*/) - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::Notify()"), this); - //TODO: - } - - -/** Called to associate 'this' with a lower layer subconnection provider. - -@param aSubConnProvider to be the lower layer for 'this' -*/ -void CReferenceDefaultSubConnectionProvider::AttachToNext(CSubConnectionProviderBase* /*aSubConnProvider*/) - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::AttachToNext()"), this); - //TODO: - } - - - -/** Called to inform 'this' that the connection, to which 'this' belongs, is going down. - -@param aConnProvider - the connection going down. -*/ -void CReferenceDefaultSubConnectionProvider::ConnectionGoingDown(CConnectionProviderBase& /*aConnProvider*/) - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::ConnectionGoingDown()"), this); - //TODO: - } - -/** Called to inform 'this' about a generic connection error. - -@param aStage - stage at which the error has occured (currently as specified by NIFVAR.H) -@param aError - the error indication. -*/ -void CReferenceDefaultSubConnectionProvider::ConnectionError(TInt /*aStage*/, TInt /*aError*/) - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::ConnectionError()"), this); - //TODO: - } - - - - - - - -//-========================================================= -// CSubConnectionProviderBase methods -//-========================================================= - - - -/** Override this if you observe data clients joining the sub-connection - provider. This method is called before the data client is added to - the lists, so if you wish to stop it being added, leave with an - appropriate System wide error - -@param aDataClient Data client wishing to join the sub-connection provider -@exception If the specific sub-connection provider does not want the data client to join -*/ -void CReferenceDefaultSubConnectionProvider::DoDataClientJoiningL(MSubConnectionDataClient& /*aDataClient*/) - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::DoDataClientJoiningL()"), this); - //TODO: - } - - - -/** Override this if you observe data clients leaving the sub-connection - provider. This method is called before the data client leaves the - the. Please note that it is not possible to to stop a data client - from leaving. - -@param aDataClient Data client about to leave the sub-connection provider -*/ -void CReferenceDefaultSubConnectionProvider::DoDataClientLeaving(MSubConnectionDataClient& /*aDataClient*/) - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::DoDataClientLeaving()"), this); - //TODO: - } - - - -/** Override this if you observe control clients leaving the sub-connection - provider. This method is called before the control client leaves the - the. Please note that it is not possible to to stop a control client - from leaving. - -@param aDataClient Data client about to leave the sub-connection provider -*/ -void CReferenceDefaultSubConnectionProvider::DoControlClientJoiningL(MSubConnectionControlClient& /*aControlClient*/) - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::DoControlClientJoiningL()"), this); - //TODO: - } - - - - -/** Override this if you observe control clients leaving the sub-connection - provider. This method is called before the control client leaves the - the. Please note that it is not possible to to stop a control client - from leaving. - -@param aDataClient Data client about to leave the sub-connection provider -*/ -void CReferenceDefaultSubConnectionProvider::DoControlClientLeaving(MSubConnectionControlClient& /*aControlClient*/) - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::DoControlClientLeaving()"), this); - //TODO: - } - - - - -/** Override this if you observe a data client receiving a new source - address. - -@param aDataClient Data client about to leave the sub-connection provider -@param aSource New source address -*/ -void CReferenceDefaultSubConnectionProvider::DoSourceAddressUpdate(MSubConnectionDataClient& /*aDataClient*/, const TSockAddr& /*aSource*/) - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::DoSourceAddressUpdate()"), this); - //TODO: - } - - - - -/** Override this if you observe a data client receiving a new destination - address. - -@param aDataClient Data client about to leave the sub-connection provider -@param aDestination New destination address -*/ -void CReferenceDefaultSubConnectionProvider::DoDestinationAddressUpdate(MSubConnectionDataClient& /*aDataClient*/, const TSockAddr& /*aDestination*/) - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::DoDestinationAddressUpdate()"), this); - //TODO: - } - - - - -/** Override this if you observe a data client receiving all its address - address information. - -@param aDataClient Data client about to leave the sub-connection provider -@param aSource New source address -@param aDestination New destination address -@param aConnectionInfo Connection Information (including IAP) -*/ -void CReferenceDefaultSubConnectionProvider::DoDataClientRouted(MSubConnectionDataClient& /*aDataClient*/, const TSockAddr& /*aSource*/, const TSockAddr& /*aDestination*/, const TDesC8& /*aConnectionInfo*/) - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::DoDataClientRouted()"), this); - //TODO: - } - - - - -/** Override this if you observe a data client about to receive new paramaters. - This method is called before the parameters are associated with the sub-connection - provider, so it is possible to abort this by leaving from this method with - an appropriate system wide error code. - -@param aParameterBundle Parameters received from the control client -@exception If the specific sub-connection provider does not want the parameters to be set -*/ -void CReferenceDefaultSubConnectionProvider::DoParametersAboutToBeSetL(CSubConParameterBundle& /*aParameterBundle*/) - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::DoParametersAboutToBeSetL()"), this); - //TODO: - } - - - - -/** Override this to implement specific control behaviour request by the client - -@param aOptionLevel Control Option level -@param aOptionName Control Option name -@param aOption Control Option value -@return KErrNone if successful, otherwise system error code -*/ -TInt CReferenceDefaultSubConnectionProvider::DoControl(TUint /*aOptionLevel*/, TUint /*aOptionName*/, TDes8& /*aOption*/) - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::DoControl()"), this); - //TODO: - - return KErrNotSupported; - } - - - - -/** DoDataTransferL -*/ -CConnDataTransfer& CReferenceDefaultSubConnectionProvider::DoDataTransferL() - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::DoDataTransferL()"), this); - //TODO: - User::Leave(KErrNotSupported); - CConnDataTransfer* null = NULL; - return *static_cast(null); - } - - - - -/** DoSelfConnectionDataClient -*/ -MConnectionDataClient* CReferenceDefaultSubConnectionProvider::DoSelfConnectionDataClient() - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::DoSelfConnectionDataClient()"), this); - //CReferenceDefaultSubConnectionProvider is a MConnectionDataClient, hence returning 'this' - return this; - } - - - -/** Called to start 'this'. - -*/ -void CReferenceDefaultSubConnectionProvider::DoStartL() - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::DoStartL()"), this); - //TODO: - } - - -/** Called to stop 'this'. - -*/ -void CReferenceDefaultSubConnectionProvider::DoStop() - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::DoStop()"), this); - //TODO: - } - - -/** Called to retrieve the lower subconnection provider of 'this' - - @return the subconnection provider below 'this' -*/ -CSubConnectionProviderBase* CReferenceDefaultSubConnectionProvider::DoNextLayer() - { - __FLOG_1(_L("CReferenceDefaultSubConnectionProvider[%x]::DoNextLayer()"), this); - return iNextLayer; - } -