// Copyright (c) 2007-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:
// Location Based Services SUPL Push API
// 
//

/**
 @file
 @deprecated
*/



#include <e32base.h>
#include <lbs/lbssuplpush.h>
#include "lbsdevloggermacros.h"

#include "lbssuplpushimpl.h"


//=============================================================================
// MLbsSuplPushObserver
//=============================================================================
/**
Provides the version of the observer interface. This can be used by the library 
to determine the functionality supported by the client application.

@return Version of the observer interface.
*/  
EXPORT_C TVersion MLbsSuplPushObserver::Version() const
	{
	LBSLOG(ELogP1, "MLbsSuplPushObserver::Version() Begin\n");
	LBSLOG(ELogP1, "MLbsSuplPushObserver::Version() End\n");
	return TVersion(1, 0, 0);
	}


/**
Should not be used. Provides for future expansion of the observer interface. 
*/  
/*virtual*/ EXPORT_C TAny* MLbsSuplPushObserver::ExtendedInterface
	(
	TInt  /*aFunctionNumber*/,
	TAny* /*aPtr1*/,
	TAny* /*aPtr2*/
	)
	{
	LBSLOG(ELogP1, "MLbsSuplPushObserver::ExtendedInterface() Begin\n");
	LBSLOG(ELogP1, "MLbsSuplPushObserver::ExtendedInterface() End\n");
	return NULL;
	}


/**
Opens a new SUPL Push channel to the LBS sub-system.

@param aChannel  [In] The id of the channel to be opened.
@param aObserver [In] A reference to an observer waiting for request completion call-backs.

@return an Instance of the interface. The calling application becomes the
owner of the returned instance and is responsible for its disposal.

@capability NetworkServices
@capability ReadDeviceData
*/
EXPORT_C CLbsSuplPush* CLbsSuplPush::NewL(TLbsSuplPushChannel aChannel, MLbsSuplPushObserver& aObserver)
	{
	LBSLOG(ELogP1, "CLbsSuplPush::NewL() Begin\n");
	LBSLOG(ELogP8, "->S CLbsSuplPush::NewL() SuplPush\n");
	CLbsSuplPush* newObj = new (ELeave) CLbsSuplPush();
	CleanupStack::PushL(newObj);
	newObj->ConstructL(aChannel, aObserver);
	LBSLOG(ELogP1, "CLbsSuplPush::NewL() End\n");
	CleanupStack::Pop(newObj);
	return newObj;
	}
	
/**
Closes the interface and disposes all open or used resources.
*/
CLbsSuplPush::~CLbsSuplPush()
	{
	LBSLOG(ELogP1, "CLbsSuplPush::~CLbsSuplPush() Begin\n");
	LBSLOG(ELogP8, "->S CLbsSuplPush::~CLbsSuplPush() SuplPush\n");
	delete iImpl;
	iImpl = NULL;
	LBSLOG(ELogP1, "CLbsSuplPush::~CLbsSuplPush() End\n");
	}
	
/**
Default constructor.
@internalComponent
*/
CLbsSuplPush::CLbsSuplPush()
	{
	LBSLOG(ELogP1, "CLbsSuplPush::CLbsSuplPush() Begin\n");
	LBSLOG(ELogP1, "CLbsSuplPush::CLbsSuplPush() End\n");
	}

/**
2nd phase constructor. 
Creates and assigns all the required internal resources.

@param aChannel  The id of the channel to be opened.
@param aObserver A reference to an observer waiting for request completion call-backs.

@internalComponent
*/
void CLbsSuplPush::ConstructL(TLbsSuplPushChannel aChannel, MLbsSuplPushObserver& aObserver)
	{
	LBSLOG(ELogP1, "CLbsSuplPush::ConstructL() Begin\n");
	iImpl = CLbsSuplPushImpl::NewL(aChannel, aObserver);
	LBSLOG(ELogP1, "CLbsSuplPush::ConstructL() End\n");
	}

/**
Sends a SUPL INIT message to the LBS sub-system. If the channel is busy
sending a previous message the new one will be queued. The request completion code 
is received through a call-back.

Please note that only one thread can actively use a channel at any time. Simultaneous
use of a channel by multiple threads may cause some of the requests to time out.

A system requiring concurrent access to a channel must provide its own access 
control mechanism.

@param aReqId [Out] Channel unique request Id.
@param aMsg   [In]  A buffer containing a SUPL INIT message.
@param aReserved [In] Reserved for future use.

@return An error code related to the synchronous part of the request - KErrNone if successful, KErrArgument if 
the message has a wrong size, KErrNotReady if the LBS can't be started, KErrPermissionDenied if the calling process
has not enough capabilities, or another system error code.

@see MLbsSuplPushObserver::OnSuplInitComplete()

@capability NetworkServices
@capability ReadDeviceData
*/
EXPORT_C TInt CLbsSuplPush::SuplInit(TLbsSuplPushRequestId& aReqId, const TDesC8& aMsg, TInt aReserved)
	{
	LBSLOG(ELogP1, "CLbsSuplPush::SuplInit() Begin\n");
	LBSLOG(ELogP9, "->A CLbsSuplPush::SuplInit() SuplPush\n");
	
	TInt res = iImpl->SuplInit(aReqId, aMsg, aReserved);
	
	LBSLOG2(ELogP9, "  < TLbsSuplPushRequestId& aReqId = %d\n", aReqId);
	LBSLOG2(ELogP9, "  Return  = %d\n", res);
	LBSLOG(ELogP1, "CLbsSuplPush::SuplInit() End\n");
	return res;
	}