/*
* 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