locationcentre/lcservice/src/lcservice.cpp
changeset 0 522cd55cc3d7
child 9 91123d004e8f
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/locationcentre/lcservice/src/lcservice.cpp	Tue Feb 02 00:16:03 2010 +0200
@@ -0,0 +1,358 @@
+/*
+* Copyright (c) 2007 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:  Location Centre API interface.
+*
+*/
+
+
+// SYSTEM INCLUDES
+
+// USER INCLUDES
+#include "lcservice.h"
+#include "lcserviceimpl.h"
+#include "lclocationappfilter.h"
+#include "lcappexitobserver.h"
+#include "lcnotification.h"
+
+// ---------- Member funtions for CLcService::CLcLaunchParam -----------------
+
+// ---------------------------------------------------------------------------
+// CLcService::CLcLaunchParam::CLcLaunchParam
+// ---------------------------------------------------------------------------
+//
+CLcService::CLcLaunchParam::CLcLaunchParam( 
+					CLcLocationAppInfo::TLcLaunchMode aLaunchMode)
+	:iLaunchMode( aLaunchMode )
+	{
+	}
+
+// ---------------------------------------------------------------------------
+// CLcService::CLcLaunchParam::~CLcLaunchParam
+// ---------------------------------------------------------------------------
+//	
+CLcService::CLcLaunchParam::~CLcLaunchParam()
+	{
+	delete iId;
+	}
+
+// ---------------------------------------------------------------------------
+// CLcService::CLcLaunchParam::NewL
+// ---------------------------------------------------------------------------
+//
+EXPORT_C CLcService::CLcLaunchParam* CLcService::CLcLaunchParam::NewL( 
+							const TDesC&     						aAppId,
+								  CLcLocationAppInfo::TLcLaunchMode aLaunchMode )
+	{
+	CLcService::CLcLaunchParam* self = NewLC( aAppId, aLaunchMode );
+	CleanupStack::Pop( self );
+	return self;
+	}
+
+// ---------------------------------------------------------------------------
+// CLcService::CLcLaunchParam::NewLC
+// ---------------------------------------------------------------------------
+//
+EXPORT_C CLcService::CLcLaunchParam* CLcService::CLcLaunchParam::NewLC( 
+						const TDesC&     					    aAppId,
+						   	  CLcLocationAppInfo::TLcLaunchMode aLaunchMode )
+	{
+	CLcService::CLcLaunchParam* self = new ( ELeave )CLcService::CLcLaunchParam( aLaunchMode );
+	CleanupStack::PushL( self );
+	self->ConstructL( aAppId );
+	return self;
+	}
+
+// ---------------------------------------------------------------------------
+// TPtrC  CLcService::CLcLaunchParam::Id
+// ---------------------------------------------------------------------------
+//
+TPtrC  CLcService::CLcLaunchParam::Id() const
+	{
+    // Check whether the application id exists, incase it doesnt exist then
+    // return a NULL string.
+    if( !iId )
+        {
+        return TPtrC();
+        }
+    // Return the Application Id.
+    return *iId;	
+	}
+
+// ---------------------------------------------------------------------------
+// CLcLocationAppInfo::TLcLaunchMode  CLcLaunchParam::LaunchMode
+// ---------------------------------------------------------------------------
+//	
+CLcLocationAppInfo::TLcLaunchMode  CLcService::CLcLaunchParam::LaunchMode() const
+	{
+	return iLaunchMode;
+	}
+	
+// ---------------------------------------------------------------------------
+// void CLcService::CLcLaunchParam::ConstructL
+// ---------------------------------------------------------------------------
+//	
+void CLcService::CLcLaunchParam::ConstructL( const TDesC& 	aAppId )
+	{
+	iId = aAppId.AllocL();
+	}
+	
+// ---------- Member funtions for CLcService ---------------------------------
+
+// ---------------------------------------------------------------------------
+// CLcService::CLcService
+// ---------------------------------------------------------------------------
+//
+CLcService::CLcService()
+    {
+    // C++ Default constructor. No allocations or functions which can Leave
+    // should be called from here.
+    }
+         
+// ---------------------------------------------------------------------------
+// CLcService::~CLcService
+// ---------------------------------------------------------------------------
+//
+CLcService::~CLcService()
+    {
+    // C++ Destructor. Free all resources associated with this class.
+    
+    delete iImplementation;
+    }
+        
+// ---------------------------------------------------------------------------
+// CLcService* CLcService::NewL
+// ---------------------------------------------------------------------------
+//
+EXPORT_C CLcService* CLcService::NewL()
+    {
+    CLcService* self = NewLC();
+    CleanupStack::Pop( self );
+    return self;         
+    }
+
+// ---------------------------------------------------------------------------
+// CLcService* CLcService::NewLC
+// ---------------------------------------------------------------------------
+//
+EXPORT_C CLcService* CLcService::NewLC()
+    {
+    // Symbian Two phased constructor. Leaves the object on the Clean-up
+    // stack.
+    CLcService* self = 
+                new ( ELeave )CLcService();
+    CleanupStack::PushL( self );
+    self->ConstructL();
+    return self;         
+    }
+
+// ---------------------------------------------------------------------------
+// void CLcService::ConstructL
+// ---------------------------------------------------------------------------
+//
+void CLcService::ConstructL()
+    {
+    // Second phase of the two phase constructor.
+    
+    // Create the Location Centre API implementation
+    iImplementation = CLcServiceImpl::NewL();
+    }
+
+// ---------------------------------------------------------------------------
+// void CLcService::LaunchLocationCentreL
+// ---------------------------------------------------------------------------
+//
+EXPORT_C void CLcService::LaunchLocationCentreL(
+            CLcLocationAppInfo::TLcLaunchMode   aLaunchMode,                        
+            MLcAppExitObserver*                 aChainedAppExitObserver )
+    {
+    // The Filter construction without any arguments will act as no filtering
+    // applied on the list of Location based Applications and Contents/Services.
+    TLcLocationAppFilter filter; 
+        
+    iImplementation->LaunchLocationCentreL( filter,
+                                            aLaunchMode,
+                                            aChainedAppExitObserver );
+    }
+                    
+// ---------------------------------------------------------------------------
+// void CLcService::LaunchLocationCentreL
+// ---------------------------------------------------------------------------
+//
+EXPORT_C void CLcService::LaunchLocationCentreL( 
+              const TLcLocationAppFilter&             aLocationAppFilter,
+                    CLcLocationAppInfo::TLcLaunchMode aLaunchMode,                        
+                    MLcAppExitObserver*               aChainedAppExitObserver )
+    {
+    iImplementation->LaunchLocationCentreL( aLocationAppFilter,
+                                            aLaunchMode,
+                                            aChainedAppExitObserver );
+    }
+    
+// ---------------------------------------------------------------------------
+// void CLcService::LaunchLocationCentreL
+// ---------------------------------------------------------------------------
+//
+EXPORT_C void CLcService::LaunchLocationCentreL(
+                  const RPointerArray<CLcLaunchParam>& aIncludeAppArray,
+                  MLcAppExitObserver*           aChainedAppExitObserver )
+    {
+    iImplementation->LaunchLocationCentreL( aIncludeAppArray,
+                                            aChainedAppExitObserver );
+    }
+    
+// ---------------------------------------------------------------------------
+// void CLcService::LaunchLocationCentreL
+// ---------------------------------------------------------------------------
+//
+EXPORT_C void CLcService::LaunchLocationCentreL( 
+                    const RArray<TPtrC>&              aExcludeAppArray,
+                    CLcLocationAppInfo::TLcLaunchMode aLaunchMode,
+                    MLcAppExitObserver*               aChainedAppExitObserver )
+    {
+    iImplementation->LaunchLocationCentreL( aExcludeAppArray,
+                                            aLaunchMode,
+                                            aChainedAppExitObserver );    
+    }
+
+// ---------------------------------------------------------------------------
+// void CLcService::SelectLocationApplicationL
+// ---------------------------------------------------------------------------
+//
+EXPORT_C TPtrC CLcService::SelectLocationApplicationL()
+    {
+    // The Filter construction without any arguments will act as no filtering
+    // applied on the list of Location based Applications and Contents/Services.
+    TLcLocationAppFilter filter;    
+    return iImplementation->SelectLocationApplicationL( filter );
+    }
+
+// ---------------------------------------------------------------------------
+// void CLcService::SelectLocationApplicationL
+// ---------------------------------------------------------------------------
+//
+EXPORT_C TPtrC CLcService::SelectLocationApplicationL(
+                        const TLcLocationAppFilter& aLocationAppFilter )
+    {
+    return iImplementation->SelectLocationApplicationL( aLocationAppFilter );      
+    }
+    
+// ---------------------------------------------------------------------------
+// void CLcService::SelectLocationApplicationL
+// ---------------------------------------------------------------------------
+//
+EXPORT_C TPtrC CLcService::SelectLocationApplicationL(
+                            const RArray<TPtrC>&    aAppArray,
+                                  TBool             aIncludeFlag )
+    {
+    return iImplementation->SelectLocationApplicationL( aAppArray,
+                                                        aIncludeFlag );        
+    }
+
+// ---------------------------------------------------------------------------
+// CLcLocationAppInfoArray* CLcService::GetLocationApplicationsL
+// ---------------------------------------------------------------------------
+//    
+EXPORT_C CLcLocationAppInfoArray* CLcService::GetLocationApplicationsL()
+    {
+    // The Get Location Applications call is implemented as a Get Location
+    // based Applications function which doesn't have any filtering. So, we
+    // need to create an empty filter and pass it to this function.
+    
+    // The Filter construction without any arguments will act as no filtering
+    // applied on the list of Location based Applications and Contents/Services.
+    TLcLocationAppFilter filter;
+    return iImplementation->GetLocationApplicationsL( filter );
+    }
+
+// ---------------------------------------------------------------------------
+// void CLcService::GetLocationApplications
+// ---------------------------------------------------------------------------
+//    
+EXPORT_C void CLcService::GetLocationApplications(
+            TRequestStatus&             aStatus,
+            CLcLocationAppInfoArray*&   aAppInfoArray )
+    {
+    TLcLocationAppFilter filter;    
+    iImplementation->GetLocationApplications( aStatus,
+    										  filter,
+    										  aAppInfoArray );
+    }
+    
+// ---------------------------------------------------------------------------
+// CLcLocationAppInfoArray* CLcService::GetLocationApplicationsL
+// ---------------------------------------------------------------------------
+//    
+EXPORT_C CLcLocationAppInfoArray* CLcService::GetLocationApplicationsL(
+            const TLcLocationAppFilter&     aLocationAppFilter )
+    {
+    return iImplementation->GetLocationApplicationsL( aLocationAppFilter );
+    }
+    
+// ---------------------------------------------------------------------------
+// void CLcService::GetLocationApplicationsL
+// ---------------------------------------------------------------------------
+//    
+EXPORT_C void CLcService::GetLocationApplications(
+                            TRequestStatus&             aStatus,
+                      const TLcLocationAppFilter&       aLocationAppFilter,
+                            CLcLocationAppInfoArray*&   aAppInfoArray )
+    {
+    iImplementation->GetLocationApplications( aStatus,
+                                              aLocationAppFilter,
+                                              aAppInfoArray );
+    }
+
+// ---------------------------------------------------------------------------
+// void CLcService::CancelGetLocationApplications
+// ---------------------------------------------------------------------------
+//     
+EXPORT_C void CLcService::CancelGetLocationApplications()
+    {
+    iImplementation->CancelGetLocationApplications(); 
+    }
+
+// ---------------------------------------------------------------------------
+// void CLcService::LaunchLocationApplicationL
+// ---------------------------------------------------------------------------
+// 
+EXPORT_C void CLcService::LaunchLocationApplicationL( 
+                const TDesC&                      aAppIdentifier,
+                CLcLocationAppInfo::TLcLaunchMode aLaunchMode,
+                MLcAppExitObserver*               aChainedAppExitObserver )
+    {
+    iImplementation->LaunchLocationApplicationL( aAppIdentifier,
+                                                 aLaunchMode,
+                                                 aChainedAppExitObserver );
+    }
+
+// ---------------------------------------------------------------------------
+// void CLcService::SetObserverL
+// ---------------------------------------------------------------------------
+// 
+EXPORT_C void CLcService::SetObserverL( MLcNotification&    aObserver )
+    {
+    iImplementation->SetObserverL( aObserver );
+    }
+
+// ---------------------------------------------------------------------------
+// TInt CLcService::RemoveObserver
+// ---------------------------------------------------------------------------
+//                                         
+EXPORT_C TInt CLcService::RemoveObserver()
+    {
+    return iImplementation->RemoveObserver();
+    }
+                                                           
+// End of File
+