diff -r f742655b05bf -r d38647835c2e voipplugins/sipconnectionprovider/inc/scpservicemanager.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/voipplugins/sipconnectionprovider/inc/scpservicemanager.h Wed Sep 01 12:29:57 2010 +0100 @@ -0,0 +1,377 @@ +/* +* Copyright (c) 2006-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: +* +*/ + + +#ifndef C_CSCPSERVICEMANAGER_H +#define C_CSCPSERVICEMANAGER_H + +#include + +#include "scpdefs.h" +#include "scpstatecontainer.h" + +class CScpSettingHandler; +class CScpProfileHandler; +class CScpServiceStorage; +class CScpService; +class CScpSubService; +class CScpSipConnection; + +/** +* CScpServiceManager class +* @lib sipconnectionprovider.dll +*/ +class CScpServiceManager : public CBase + { +public: + + /** + * Two-phased constructor + */ + static CScpServiceManager* NewL( MCchServiceObserver& aServiceObserver ); + + /** + * Destructor. + */ + virtual ~CScpServiceManager(); + +public: // New functions + + /** + * Client enables service. CCHService implementation + * should use MCCHServiceObserver for service state notifications. + * @see MCCHServiceObserver + * @param aServiceId + */ + void EnableServiceL( TUint aServiceId, + TCCHSubserviceType aSubServiceType ); + + /** + * Client enables service. CCHService implementation + * should use MCCHServiceObserver for service state notifications. + * @see MCCHServiceObserver + * @param aServiceId + * @param aIapId + */ + void EnableServiceL( TUint aServiceId, + TCCHSubserviceType aSubServiceType, + TUint aIapId ); + + /** + * Client disables service. + * @param aServiceId + */ + void DisableServiceL( TUint aServiceId, + TCCHSubserviceType aSubServiceType ); + + /** + * Client checks is the service available by the IAP id array. + * CCHService implementation should return ETrue if service is + * registrable by the (some) IAP, array contains. + * @param aServiceId + * @param aIapIdArray Id array of the currently available iaps. + * @return ETrue if service is available. + */ + TBool IsAvailableL( TUint aServiceId, + TCCHSubserviceType aSubServiceType, + const RArray& aIapIdArray ) const; + + /** + * Get service state information. + * @param aServiceId + * @param aState Current service state. + * @return General symbian error code. + */ + TInt GetServiceState( TUint aServiceId, + TCCHSubserviceType aSubServiceType, + TCCHSubserviceState& aState ) const; + + /** + * Get service network information. + * @param aServiceId + * @param aSnapId Used Snap id (should be set as null if + * not in use) + * @param aIapId Used IAP id (should be set as null if + * not in use) + * @param aSnapLocked Is snap locked or not. + * @param aPasswordSet Is password set or not. + * @return General symbian error code. + */ + TInt GetServiceNetworkInfo( TUint aServiceId, + TCCHSubserviceType aSubServiceType, + TUint32& aSnapId, + TUint32& aIapId, + TBool& aSnapLocked, + TBool& aPasswordSet ) const; + + /** + * Set Snap id for service. + * @param aServiceId + * @param aSnapId + * @return General symbian error code. + */ + TInt SetSnapId( TUint aServiceId, + TCCHSubserviceType aSubServiceType, + TUint aSnapId ); + + /** + * Set IAP id for service. + * @param aServiceId + * @param aSnapId + * @return General symbian error code. + */ + TInt SetIapId( TUint aServiceId, + TCCHSubserviceType aSubServiceType, + TUint aIapId ); + + /** + * Get service specifics information about service and protocol + * @param aServiceId + * @param aSubservice + * @param aBuffer + */ + void GetServiceInfoL( TUint aServiceId, + TCCHSubserviceType aSubServiceType, + RBuf& aBuffer ) const; + + /** + * Sets service reserved or unreserved + * @param aReserved Reserved + * @param aServiceId + * @param aSubServiceType Sub service type + * @return Symbian error codes + */ + TInt SetServiceReserved( TBool aReserved, + TUint aServiceId, + TCCHSubserviceType aSubServiceType ); + + /** + * Returns service reserved info + * @param aServiceId + * @param aSubServiceType Sub service type + * @return ETrue if reserved + */ + TBool IsReserved( TUint aServiceId, + TCCHSubserviceType aSubServiceType ) const; + + + /** + * Returns the connection parameters + * @since S60 3.2.3 + * @param aServiceSelection Selected service, ID and type + * @param aParameter Connection parameter of the service + * @param aValue Value of the parameter + * @leave Symbian error code + */ + void GetConnectionParameterL( const TServiceSelection& aServiceSelection, + TCchConnectionParameter aParameter, + TInt& aValue ) const; + + /** + * Returns the connection parameters + * @since S60 3.2.3 + * @param aServiceSelection Selected service, ID and type + * @param aParameter Connection parameter of the service + * @param aValue Value of the parameter + * @leave Symbian error code + */ + void GetConnectionParameterL( const TServiceSelection& aServiceSelection, + TCchConnectionParameter aParameter, + RBuf& aValue ) const; + + /** + * Sets the connection parameters + * @since S60 3.2.3 + * @param aServiceSelection Selected service, ID and type + * @param aParameter Connection parameter of the service + * @param aValue Value of the parameter + * @leave Symbian error code + */ + void SetConnectionParameterL( const TServiceSelection& aServiceSelection, + TCchConnectionParameter aParameter, + TInt aValue ); + + /** + * Sets the connection parameters + * @since S60 3.2.3 + * @param aServiceSelection Selected service, ID and type + * @param aParameter Connection parameter of the service + * @param aValue Value of the parameter + * @leave Symbian error code + */ + void SetConnectionParameterL( const TServiceSelection& aServiceSelection, + TCchConnectionParameter aParameter, + const TDesC& aValue ); + + + +private: + + /** + * Default constructor + * @param aStateObserver State Observer + */ + CScpServiceManager( MCchServiceObserver& aServiceObserver ); + + /** + * 2nd phase constructor + */ + void ConstructL(); + + /** + * Get service network information. Leaves on failure. + * @param aServiceId + * @param a Sub service type + * @param aSnapId Used Snap id (should be set as null if + * not in use) + * @param aIapId Used IAP id (should be set as null if + * not in use) + * @param aSnapLocked Snap locked + */ + void GetServiceNetworkInfoL( TUint aServiceId, + TCCHSubserviceType aSubServiceType, + TUint32& aSnapId, + TUint32& aIapId, + TBool& aSnapLocked, + TBool& aPasswordSet ) const; + + /** + * Handles ALR events. + * @param aServiceId Service Id + * @param a Sub service type + * @param aConnectionCreated ETrue if connection was created + * @return SipConnection if exists + */ + CScpSipConnection* GetSipConnectionL( TUint aServiceId, + TCCHSubserviceType aSubServiceType, + TBool& aConnectionCreated ) const; + + /** + * Gets and updates a service + * @param aServiceId Service Id + * @param a Sub service type + * @return Service, NULL if failed + */ + CScpService* GetServiceL( TUint aServiceId, + TCCHSubserviceType aSubServiceType ); + + /** + * Creates and updates a service. The service is saved to + * service storage. + * @param aServiceId Service Id + * @param a Sub service type + * @return Service + */ + CScpService* CreateServiceL( TUint aServiceId, + TCCHSubserviceType aSubServiceType ); + + /** + * Creates and updates a temporary service. The service is not + * saved to service storage. These use cases are due to network + * info queries. + * @param aServiceId Service Id + * @param a Sub service type + * @return Service + */ + CScpService* CreateTemporaryServiceL( TInt aServiceId, + TCCHSubserviceType aSubServiceType ) const; + + /** + * Set access point for a service + * @param aServiceId Service Id + * @param aSubServiceType Sub service type + * @param aAccessPointType Access point type + * @param aAccessPointId Id + * @return Error code + */ + TInt SetAccessPointId( TUint aServiceId, + TCCHSubserviceType aSubServiceType, + TScpAccessPointType aAccessPointType, + TInt aAccessPointId ); + + /** + * Updates the prfile handler's user agent header. Use before. + * @param aServiceId Service Id + * @param a SubServiceType sub service type + */ + void UpdateProfileValuesL( TUint aServiceId, TCCHSubserviceType aSubServiceType ) const; + + /** + * Updates username/password to XDM-setting + * @param aServiceId Service Id + * @param aUsername username + * @param aSetUsername ETrue if username wish to be set + * @param aPassword password + * @param aSetPassword ETrue if username wish to be set + */ + void SetUsernameAndPasswordToXdmL( + TUint aServiceId, + const TDesC8& aUsername, + TBool aSetUsername, + const TDesC8& aPassword, + TBool aSetPassword ); + + /** + * Checks restricted connections. In case where voip is not + * allowed via 3g and 3g ap is first ap, leave with error + * KCCHErrorAccessPointNotDefined so user can select another ap. + * @param aServiceId Service Id + */ + void CheckRestrictedConnectionsL( TUint aServiceId ); + +private: + + /** + * Observer for state changes + */ + MCchServiceObserver& iServiceObserver; + + /** + * Setting handler. Own. + */ + CScpSettingHandler* iSettingHandler; + + /** + * Setting handler. Own. + */ + CScpProfileHandler* iProfileHandler; + + /** + * Service settings storage. Own. + */ + CScpServiceStorage* iServiceStorage; + + /** + * Service state container. Singleton. + */ + TScpStateContainer iStateContainer; + +private: + +#ifdef _DEBUG + friend class T_CScpServiceManager; + friend class T_CScpSipHelper; + friend class T_CScpService; + friend class T_CScpSettingHandler; +#endif + + }; + +#endif // C_CSCPSERVICEMANAGER_H + +// End of file +