diff -r 9d7ce34704c8 -r b564fb5fd78b baseconnectionproviders/refscpr/src/ReferenceSCPR_subconnProv.cpp --- a/baseconnectionproviders/refscpr/src/ReferenceSCPR_subconnProv.cpp Tue Aug 31 16:25:36 2010 +0300 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,348 +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: -// Reference (empty) implementation file for a SubConnection Provider -// -// - -/** - @file - @internalComponent -*/ - - -#include "ReferenceSCPR_subconnProv.h" - - - - -//-========================================================= -// Custom methods -//-========================================================= -CReferenceSubConnectionProvider::CReferenceSubConnectionProvider( - 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 CReferenceSubConnectionProvider constructor - and ConstructL on the constructed instance. - -@param aFactory - the subconnection provider factory the new CReferenceSubConnectionProvider - 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 CReferenceSubConnectionProvider. -*/ -CReferenceSubConnectionProvider* CReferenceSubConnectionProvider::NewL( - CSubConnectionProviderFactoryBase& aFactory, - CConnectionProviderBase& aConnProvider) - { - CReferenceSubConnectionProvider* provider = - new(ELeave)CReferenceSubConnectionProvider(aFactory, aConnProvider); - CleanupStack::PushL(provider); - provider->ConstructL(); - CleanupStack::Pop(); - return provider; - } - - -/** ConstructL for the two stage construction -*/ -void CReferenceSubConnectionProvider::ConstructL() - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%x]::ConstructL()"), this); - //TODO: perform 2nd stage construction, if needed. - } - - -CReferenceSubConnectionProvider::~CReferenceSubConnectionProvider() -/** -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 CReferenceSubConnectionProvider::Notify(MConnectionDataClient::TNotify /*aNotifyType*/, CConnectionProviderBase* /*aConnProvider*/, TInt /*aError*/, const CConNotificationEvent* /*aConNotificationEvent*/) - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%x]::Notify()"), this); - //TODO: - } - - -/** Called to associate 'this' with a lower layer subconnection provider. - -@param aSubConnProvider to be the lower layer for 'this' -*/ -void CReferenceSubConnectionProvider::AttachToNext(CSubConnectionProviderBase* /*aSubConnProvider*/) - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%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 CReferenceSubConnectionProvider::ConnectionGoingDown(CConnectionProviderBase& /*aConnProvider*/) - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%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 CReferenceSubConnectionProvider::ConnectionError(TInt /*aStage*/, TInt /*aError*/) - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%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 CReferenceSubConnectionProvider::DoDataClientJoiningL(MSubConnectionDataClient& /*aDataClient*/) - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%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 CReferenceSubConnectionProvider::DoDataClientLeaving(MSubConnectionDataClient& /*aDataClient*/) - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%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 CReferenceSubConnectionProvider::DoControlClientJoiningL(MSubConnectionControlClient& /*aControlClient*/) - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%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 CReferenceSubConnectionProvider::DoControlClientLeaving(MSubConnectionControlClient& /*aControlClient*/) - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%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 CReferenceSubConnectionProvider::DoSourceAddressUpdate(MSubConnectionDataClient& /*aDataClient*/, const TSockAddr& /*aSource*/) - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%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 CReferenceSubConnectionProvider::DoDestinationAddressUpdate(MSubConnectionDataClient& /*aDataClient*/, const TSockAddr& /*aDestination*/) - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%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 CReferenceSubConnectionProvider::DoDataClientRouted(MSubConnectionDataClient& /*aDataClient*/, const TSockAddr& /*aSource*/, const TSockAddr& /*aDestination*/, const TDesC8& /*aConnectionInfo*/) - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%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 CReferenceSubConnectionProvider::DoParametersAboutToBeSetL(CSubConParameterBundle& /*aParameterBundle*/) - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%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 CReferenceSubConnectionProvider::DoControl(TUint /*aOptionLevel*/, TUint /*aOptionName*/, TDes8& /*aOption*/) - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%x]::DoControl()"), this); - //TODO: - - return KErrNotSupported; - } - - - - -/** DoDataTransferL -*/ -CConnDataTransfer& CReferenceSubConnectionProvider::DoDataTransferL() - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%x]::DoDataTransferL()"), this); - //TODO: - User::Leave(KErrNotSupported); - CConnDataTransfer* null = NULL; - return *static_cast(null); - } - - - - -/** DoSelfConnectionDataClient -*/ -MConnectionDataClient* CReferenceSubConnectionProvider::DoSelfConnectionDataClient() - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%x]::DoSelfConnectionDataClient()"), this); - //CReferenceSubConnectionProvider is a MConnectionDataClient, hence returning 'this' - return this; - } - - - -/** Called to start 'this'. - -*/ -void CReferenceSubConnectionProvider::DoStartL() - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%x]::DoStartL()"), this); - //TODO: - } - - -/** Called to stop 'this'. - -*/ -void CReferenceSubConnectionProvider::DoStop() - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%x]::DoStop()"), this); - //TODO: - } - - -/** Called to retrieve the lower subconnection provider of 'this' - - @return the subconnection provider below 'this' -*/ -CSubConnectionProviderBase* CReferenceSubConnectionProvider::DoNextLayer() - { - __FLOG_1(_L("CReferenceSubConnectionProvider[%x]::DoNextLayer()"), this); - return iNextLayer; - }