diff -r 000000000000 -r 094583676ce7 IMPSengine/imapi/Inc/imconnectionimpl.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/IMPSengine/imapi/Inc/imconnectionimpl.h Thu Dec 17 08:41:52 2009 +0200 @@ -0,0 +1,205 @@ +/* +* Copyright (c) 2005 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 of the CImConnection interface (imconnection.h) +* +*/ + + + +#ifndef IMCONNECTIONIMPL_H +#define IMCONNECTIONIMPL_H + +// INCLUDES +#include +#include +#include + + + +// FORWARD DECLARATIONS +class CContactDBReader; + +// CLASS DECLARATION + +/** +* Implementation of the MImConnection interface +* +* @lib imclient.lib +* @since 3.0 +*/ +class CImConnectionImpl : public CImConnection, + public MImpsAccessHandler2, + public MImpsErrorHandler2, + public MImpsStatusHandler2 + { + public: // Constructors and destructor + + /** + * Two-phased constructor. + */ + static CImConnectionImpl* NewL( TDesC& aApplicationId ); + + /** + * Destructor. + */ + virtual ~CImConnectionImpl(); + + public: // New functions + + /** + * Return the IMPS engine + * @since 3.0 + * @return the IMPS engine + */ + RImpsEng& ImpsEngine(); + + /** + * Return the Contact DB reader + * @since 3.0 + * @return the reader + */ + CContactDBReader& ContactDBReader(); + + /** + * Returns the Application ID with which the client connected + * @since 3.0 + * @return ClientId + */ + const TDesC& ApplicationId(); + + /** + * Converts the error code returned by the IMPS engine to API error code. + * @since 3.0 + * @param aErroCode ImpsEngine error code + * @return API error code + */ + TInt ConvertImpsEngineErrorCode( TInt aErrorCode ); + + + public: // Functions from base classes + /** + * From MImConnection + */ + MImClient* CreateImClientL(); + + /** + * From MImConnection + */ + void RegisterObserverL( + MImConnectionObserver* aObserver ); + + /** + * From MImConnection + */ + void UnregisterObserver(); + + /** + * From MImConnection + */ + TImConnectionStatus ImConnectionStatus(); + + /** + * From MImConnection + */ + void LoginL( + const TDesC& aServer, + const TDesC& aUserID, + const TDesC& aPassword, + const TUint32 aAP ); + + /** + * From MImConnection + */ + void CancelLoginL( ); + + /** + * From MImConnection + */ + void LogoutL( ); + + public: // from MImpsAccessHandler2 + + void HandleLoginL( + TInt aId, + TImpsCspIdentifier& aCspId ); + + void HandleLoginCancelL( + TInt aCancelledOpId, + TImpsCspIdentifier& aCspId ); + + void HandleLogoutL( + TInt aId, + TImpsCspIdentifier& aCspId ); + + + void HandleNbrSessionsL( + TInt aId, + TInt aNbr, + TImpsCspIdentifier& aCspId + ); + + void HandleErrorL( + TInt aStatus, + TInt aOpId, + const TDesC* aDescription, + const CImpsDetailed* aDetailedRes, + TImpsCspIdentifier& aCspId ); + + public: // from MImpsStatusHandler + void HandleStatusChangeL( + TImpsServiceStatus aStatus, + TImpsCspIdentifier& aCspId ); + + + private: + + enum TConnectionState + { + EImNotLogged = 0, + EImLoggingIn, + EImCancelingLogin, + EImLoggingOut, + EImLoggedIn + }; + /** + * C++ default constructor. + */ + CImConnectionImpl(); + + /** + * By default Symbian 2nd phase constructor is private. + */ + void ConstructL( TDesC& aApplicationId ); + + /** + * Changes the current state + */ + void SetState( TConnectionState aNewState ); + + private: // Data + RImpsEng iEngine; // IMP engine + RImpsAccessClient2 iAccessClient; // IMPS access client + MImConnectionObserver* iClientObserver; // Client observer + CContactDBReader* iContactReader; // Contact DB reader + HBufC* iApplicationId;// Application ID of the + // 3rd party app (owned) + TReal iCspVersion; // the CSP version + TInt iCurrentOpId; + TConnectionState iState; + + }; + +#endif // IMCONNECTIONIMPL_H + +// End of File