--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/baseconnectionproviders/refcpr/src/ReferenceCPR_connProv.cpp Tue Aug 31 16:25:36 2010 +0300
@@ -0,0 +1,350 @@
+// 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 Connection Provider
+//
+//
+
+/**
+ @file
+ @internalComponent
+*/
+
+#include "ReferenceCPR_connProv.h"
+
+_LIT(KPanicReferenceCPRText,"Reference CPR not filled in properly");
+
+#ifdef _DEBUG
+// Panic category for "absolutely impossible!" vanilla ASSERT()-type panics from this module
+// (if it could happen through user error then you should give it an explicit, documented, category + code)
+_LIT(KSpecAssert_RefCprConProv, "RefCprConProv");
+#endif
+
+//-=========================================================
+// Custom methods
+//-=========================================================
+CReferenceConnectionProvider* CReferenceConnectionProvider::NewL(CConnectionProviderFactoryBase& aFactory)
+ {
+ CReferenceConnectionProvider* p = new (ELeave) CReferenceConnectionProvider(aFactory);
+ return p;
+ }
+
+CReferenceConnectionProvider::CReferenceConnectionProvider(CConnectionProviderFactoryBase& aFactory)
+:CConnectionProviderBase(aFactory),
+ iNextLayer(NULL)
+ {
+ __FLOG_OPEN(KReferenceLogTag1, KReferenceLogTag2);
+ }
+
+CReferenceConnectionProvider::~CReferenceConnectionProvider()
+ {
+ __FLOG_CLOSE;
+ }
+
+
+
+//-=========================================================
+// MConnectionControlClient methods
+//-=========================================================
+void CReferenceConnectionProvider::ConnectionGoingDown(CConnectionProviderBase& aConnProvider)
+ {
+ __FLOG_2(_L("CReferenceConnectionProvider %08x:\tConnectionGoingDown(aConnProvider %08x)"), this, &aConnProvider);
+ if (&aConnProvider == iNextLayer)
+ {
+ iNextLayer = NULL;
+ DeleteMeNow();
+ }
+ }
+
+void CReferenceConnectionProvider::ProgressNotification(TInt aStage, TInt aError)
+ {
+ __FLOG_3(_L("CReferenceConnectionProvider %08x:\tProgressNotification(aStage %d aError %d)"), this, aStage, aError);
+ TInt max = iControlClients.Count();
+ for (TInt i = max - 1 ; i >= 0 ; i--)
+ {
+ iControlClients[i]->ProgressNotification(aStage, aError);
+ }
+ }
+
+void CReferenceConnectionProvider::ConnectionError(TInt aStage, TInt aError)
+ {
+ __FLOG_3(_L("CReferenceConnectionProvider %08x:\tConnectionError(aStage %d aError %d)"), this, aStage, aError);
+ TInt max = iControlClients.Count();
+ for (TInt i = max - 1 ; i >= 0 ; i--)
+ {
+ iControlClients[i]->ConnectionError(aStage, aError);
+ }
+ max = iDataClients.Count();
+ for (TInt i = max - 1 ; i >= 0 ; i--)
+ {
+ iDataClients[i]->ConnectionError(aStage, aError);
+ }
+ }
+
+void CReferenceConnectionProvider::ServiceChangeNotification(TUint32 aId, const TDesC& aType)
+ {
+ __FLOG_3(_L("CReferenceConnectionProvider %08x:\tServiceChangeNotification(aId %u aType %s)"), this, aId, &aType);
+ TInt max = iControlClients.Count();
+ for (TInt i = max - 1 ; i >= 0 ; i--)
+ {
+ iControlClients[i]->ServiceChangeNotification(aId, aType);
+ }
+ }
+
+void CReferenceConnectionProvider::SubConnectionEvent(CSubConnectionProviderBase* aSubConnNextLayerProvider, const TSubConnectionEvent& aSubConnectionEvent)
+ {
+ TInt max = iControlClients.Count();
+ for (TInt i = max - 1 ; i >= 0 ; i--)
+ {
+ iControlClients[i]->SubConnectionEvent(aSubConnNextLayerProvider, aSubConnectionEvent);
+ }
+ }
+
+void CReferenceConnectionProvider::LayerUp(TInt aError)
+ {
+ TInt max = iControlClients.Count();
+ for (TInt i = max - 1 ; i >= 0 ; --i)
+ {
+ iControlClients[i]->LayerUp(aError);
+ }
+
+ // broadcast the event to the data clients also, sideways
+ max = iDataClients.Count();
+ for (TInt j = max - 1; j >= 0 ; --j)
+ {
+ iDataClients[j]->Notify(MConnectionDataClient::ENotifyLayerUp, this, aError, NULL);
+ }
+ }
+
+MConnectionControlClient::TCtlType CReferenceConnectionProvider::CtlType() const
+ {
+ return MConnectionControlClient::ENormal;
+ }
+
+
+
+
+
+
+//-=========================================================
+// CConnectionProviderBase methods
+//-=========================================================
+void CReferenceConnectionProvider::DoDataClientJoiningL(MConnectionDataClient& /*aDataClient*/)
+ {
+ __FLOG_2(_L("CReferenceConnectionProvider %08x:\tDoDataClientJoiningL number %d"), this, iDataClients.Count());
+ //TODO: fill up with handling code if applicable.
+ }
+
+void CReferenceConnectionProvider::DoDataClientLeaving(MConnectionDataClient& /*aDataClient*/)
+ {
+ __FLOG_2(_L("CReferenceConnectionProvider %08x:\tDoDataClientLeaving number %d"), this, iDataClients.Count());
+ //TODO: fill up with handling code if applicable.
+ }
+
+void CReferenceConnectionProvider::DoControlClientJoiningL(MConnectionControlClient& /*aControlClient*/)
+ {
+ __FLOG_2(_L("CReferenceConnectionProvider %08x:\tDoControlClientJoiningL number %d"), this, iControlClients.Count());
+ //TODO: fill up with handling code if applicable.
+ }
+
+void CReferenceConnectionProvider::DoControlClientLeaving(MConnectionControlClient& /*aControlClient*/)
+ {
+ __FLOG_2(_L("CReferenceConnectionProvider %08x:\tDoControlClientLeaving number %d"), this, iControlClients.Count());
+ //TODO: fill up with handling code if applicable.
+ }
+
+void CReferenceConnectionProvider::DoStartL(Meta::SMetaData& aParams, const RMessagePtr2* aMessage)
+ {
+ //TODO: start this connection
+ if (NULL != iNextLayer)
+ {
+ iNextLayer->StartL(aParams, aMessage);
+ }
+ }
+
+TInt CReferenceConnectionProvider::DoStop(TInt aError, const RMessagePtr2* aMessage)
+ {
+ if (NULL != iNextLayer)
+ {
+ //The next layer present. We'll now stop it here and anticipate ConnectionGoingDown() called on 'this'
+ //when indeed, the connection is stopped.
+ return iNextLayer->Stop(aError, aMessage);
+ }
+ else
+ {
+ //No next layer present, we're just need to delete this connection to complete the Stop message.
+ DeleteMeNow();
+ }
+ return KErrNotReady;
+ }
+
+void CReferenceConnectionProvider::DoProgressL(Meta::SMetaData& aBuffer) const
+ {
+ //TODO: update the progress info.
+ if (NULL != iNextLayer)
+ {
+ iNextLayer->ProgressL(aBuffer);
+ }
+ }
+
+void CReferenceConnectionProvider::DoLastProgressError(Meta::SMetaData& aBuffer)
+ {
+ //TODO: return the last error actually ocurred.
+ if (NULL != iNextLayer)
+ {
+ return iNextLayer->LastProgressError(aBuffer);
+ }
+ }
+
+void CReferenceConnectionProvider::DoRequestServiceChangeNotificationL()
+ {
+ if (NULL != iNextLayer)
+ {
+ iNextLayer->RequestServiceChangeNotificationL();
+ }
+ }
+
+void CReferenceConnectionProvider::DoCancelServiceChangeNotification()
+ {
+ if (NULL != iNextLayer)
+ {
+ iNextLayer->CancelServiceChangeNotification();
+ }
+ }
+
+void CReferenceConnectionProvider::DoControlL(TUint aOptionLevel, TUint aOptionName, Meta::SMetaData& aOption, const RMessagePtr2* aMessage)
+ {
+ if (NULL != iNextLayer)
+ {
+ return iNextLayer->ControlL(aOptionLevel, aOptionName, aOption, aMessage);
+ }
+ }
+
+TInt CReferenceConnectionProvider::DoEnumerateSubConnectionsL(TUint& /*aCount*/)
+ {
+ return KErrNotReady;
+ //TODO: fill up aCount with the number of subconnections active.
+ }
+
+TUint CReferenceConnectionProvider::DoEnumerateClientsL(HBufC8*& aClientInfoBuffer, TEnumClients aClientType)
+/**
+Returns information about the clients of this Interface
+
+@param aCount on return contains the number of clients using this Interface
+@param aClientInfoBuffer on return contains a TPckg<> containing information about each client
+@exception leaves with KErrNoMemory if memory allocation fails
+*/
+ {
+ const TInt KInfoBufMaxLength = 1024; //is this large enough?
+ TBuf8<KInfoBufMaxLength> infoBuf;
+
+ TUint count = 0;
+ STypeId tid(KConnectionClientExtUid,EConnectionClientDesc);
+ TInt max = iControlClients.Count();
+ for ( TInt n = 0; n < max; n++ )
+ {
+ MConnectionClientDesc* intf = reinterpret_cast<MConnectionClientDesc*>(iControlClients[n]->FetchInterfaceInstanceL(*this,tid));
+ if ( intf )
+ {
+ TConnectionProcessInfo cinfo;
+ cinfo.GetInfoL(aClientType, count, *intf, infoBuf);
+ }
+ }
+ STypeId tid2(KConnectionClientExtUid,EConnectionEnumerateClients);
+ max = iDataClients.Count();
+ for ( TInt n = 0; n < max; n++ )
+ {
+ MConnectionEnumerateClients* intf = reinterpret_cast<MConnectionEnumerateClients*>(iDataClients[n]->FetchInterfaceInstanceL(*this,tid2));
+ if ( intf )
+ {
+ intf->EnumerateClientsL(count, infoBuf, aClientType);
+ }
+ }
+
+ aClientInfoBuffer = infoBuf.AllocL();
+ return count;
+ }
+
+void CReferenceConnectionProvider::DoConnectionControlActivityL( CConnectionProviderBase::TControlActivity /*aControlActivity*/, const Meta::SMetaData* /*aData*/, const RMessagePtr2* /*aMessage*/ )
+ {
+ //TODO:
+ }
+
+CConnectionSettings& CReferenceConnectionProvider::DoSettingsAccessL()
+ {
+ //TODO: If no lower layer, derive your own CConnectionSettings
+ //class and return a reference to an instance of it here.
+ if (NULL != iNextLayer)
+ {
+ return iNextLayer->SettingsAccessL();
+ }
+ User::Panic(KPanicReferenceCPRText, KErrNotFound);
+
+ CConnectionSettings* null = NULL;
+ return *static_cast<CConnectionSettings*>(null);
+ }
+
+TInt CReferenceConnectionProvider::DoAllSubConnectionNotificationEnable()
+ {
+ if (NULL != iNextLayer)
+ {
+ return iNextLayer->AllSubConnectionNotificationEnable();
+ }
+ return KErrNotReady;
+ }
+
+TInt CReferenceConnectionProvider::DoCancelAllSubConnectionNotification()
+ {
+ if (NULL != iNextLayer)
+ {
+ return iNextLayer->CancelAllSubConnectionNotification();
+ }
+ return KErrNotReady;
+ }
+
+void CReferenceConnectionProvider::DoSendIoctlMessageL(const RMessage2& aMessage)
+ {
+ if (NULL != iNextLayer)
+ {
+ iNextLayer->SendIoctlMessageL(aMessage);
+ }
+ }
+
+void CReferenceConnectionProvider::DoSendCancelIoctl()
+ {
+ if (NULL != iNextLayer)
+ {
+ iNextLayer->SendCancelIoctl();
+ }
+ }
+
+TInt CReferenceConnectionProvider::DoCanDoSubConnection(RSubConnection::TSubConnType /*aSubConnType*/) const
+ {
+ return ETrue;
+ }
+
+void CReferenceConnectionProvider::DoJoinNextLayerL(CConnectionProviderBase* aNextLayer)
+ {
+ __ASSERT_DEBUG(( !iNextLayer && aNextLayer), User::Panic(KSpecAssert_RefCprConProv, 1));
+ iNextLayer = aNextLayer;
+ SetConnectionInfo(iNextLayer->ConnectionInfo());
+ // join ourselves as a connection control client to the lower provider
+ iNextLayer->JoinL(*this);
+ }
+
+CConnectionProviderBase* CReferenceConnectionProvider::DoNextLayer() const
+ {
+ return iNextLayer;
+ }
+
+