1 // Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).

     2 // All rights reserved.

     3 // This component and the accompanying materials are made available

     4 // under the terms of "Eclipse Public License v1.0"

     5 // which accompanies this distribution, and is available

     6 // at the URL "http://www.eclipse.org/legal/epl-v10.html".

     7 //

     8 // Initial Contributors:

     9 // Nokia Corporation - initial contribution.

    10 //

    11 // Contributors:

    12 //

    13 // Description:

    14 // Reference Connection Provider Factory class definition.

    15 // 

    16 //

    17 

    18 /**

    19  @file

    20  @internalComponent

    21 */

    22 

    23 #if !defined(__REFERENCECPR_CONNPROVFACTORY_H__)

    24 #define __REFERENCECPR_CONNPROVFACTORY_H__

    25 

    26 

    27 #include <comms-infras/ss_connprov.h>

    28 #include <ss_select.h>

    29 

    30 

    31 //phony protocol family id, replace with the actual

    32 const TUint KReferenceConnectionProviderFactoryId = 0xF0F0; 

    33 

    34 class CReferenceProviderFactory : public CConnectionProviderFactoryBase

    35 /**This is a sample/reference derivation of the connection provider factory.

    36 Each such derivation should be able to produce a specific type of connection providers,

    37 where the type usually denotes a particular technology (e.g.: IP, UMTS, SIP).

    38 A connection provider factory is also responsible for handling selection,

    39 i.e.: given or having access to all sorts of input (connection preferences, policies, 

    40 bearer availablity) the factory should be able to select the provider on the given 

    41 level and select the provider type on the level below.

    42 

    43 @internalComponent

    44 @released since v9.2

    45 */

    46  	{

    47 public:

    48 

    49 	static CReferenceProviderFactory* NewL(TAny* aParentContainer);

    50 

    51 protected:   

    52 	CReferenceProviderFactory(TUint aFactoryId, CConnectionFactoryContainer& aParentContainer);

    53 	virtual CConnectionProviderBase* DoCreateProviderL();	

    54 	virtual MProviderSelector* DoSelectProvider( Meta::SMetaData& aPreferences, ISelectionNotify& aSelectionNotify, const RMessagePtr2* aMessage );

    55 	virtual MProviderSelector* DoSelectNextLayerProvider( Meta::SMetaData& aPreferences, ISelectionNotify& aSelectionNotify, const RMessagePtr2* aMessage );

    56 	virtual void DoEnumerateConnectionsL(RPointerArray<TConnectionInfo>& aConnectionInfoPtrArray);

    57 	};

    58 

    59 

    60 

    61 

    62 class XConnectionFindSameLowerLayerQuery : public MCommsFactoryQuery

    63 /**

    64 

    65 @internalComponent

    66 @released since v9.2

    67 */

    68  	{

    69 public:

    70 	XConnectionFindSameLowerLayerQuery( CConnectionProviderBase* aConnectionProviderBase ) :

    71 		iConnectionProviderBase( aConnectionProviderBase )

    72 		{

    73 		}

    74 

    75 protected:

    76 	CConnectionProviderBase* iConnectionProviderBase;

    77 

    78 public:

    79 	virtual TMatchResult Match( TFactoryObjectInfo& aConnectionInfo );

    80 	};

    81 

    82 

    83 

    84 

    85 

    86 class CReferenceSelector : public CBase, public MProviderSelector

    87 /**

    88 

    89 @internalComponent

    90 @released since v9.2

    91 */

    92 	{

    93 public:	

    94 	CReferenceSelector(ISelectionNotify& aNotify, CReferenceProviderFactory& aFactory);

    95 

    96 	TInt Select(Meta::SMetaData& aPreferences, const RMessagePtr2* aMessage);

    97 	void SelectComplete(CConnectionProviderBase* aConnProvider, TInt aError);

    98 	void ProgressNotification(TInt aStage, TInt aError);

    99 	void LayerUp(TInt aError);

   100 	void ServiceChangeNotification(TUint32 aId, const TDesC& aType);

   101 	void SubConnectionEvent(CSubConnectionProviderBase* aSubConnNextLayerProvider, const TSubConnectionEvent& aSubConnectionEvent);

   102 	void Detach();

   103 	

   104 	virtual TInt Cancel();

   105 	virtual TInt Cancel(TInt aReason, const RMessage2* aMessage);

   106 	

   107 protected:

   108     	

   109 	virtual ~CReferenceSelector();	

   110 private:

   111     //ISelectionNotify must be stored by value, cos' it's just a short-lived wrapper class.

   112     //It doesn't exist as a someone that waits for the completion, but stores refereneces

   113     //to the one that does.

   114     ISelectionNotify iNotify;

   115     CReferenceProviderFactory& iFactory;

   116     MProviderSelector* iNextLayerSelector;

   117 	};

   118 

   119 

   120 #endif // __REFERENCECPR_CONNPROVFACTORY_H__