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

/**
 @file
 @internalTechnology
 
*/
#ifndef SUPL_ASN1_DECODER_H
#define SUPL_ASN1_DECODER_H

#include <e32base.h>

// forward declarations
class CSuplMessageBase;
class CSuplAsn1DecoderImpl;

/**
The CSuplAsn1Decoder class provides an interface to the SUPL Protocol Module
enabling the decoding of ASN1 encoded SUPL messages. Such messages arrive through
either via SMS or WAP push protocols in the case of SUPL INIT messages, or via 
a TCP/IP connection once a SUPL session has been established.

The decoder provides synchronous methods for decoding received messages. Once
Decode() has been called passing the input buffer, the buffer may be re-used as
the decoded data is fully extracted to objects owned by the CSuplMessageBase
derived classes.

On completion of the Decode() operation, the appropriate CSuplMessageBase object
is constructed, encapsulating the decoded message. Ownership of this object is
passed to the calling function.

@internalTechnology
@see CSuplMessageBase
*/
NONSHARABLE_CLASS(CSuplAsn1Decoder) : public CBase
	{
public:
	IMPORT_C static CSuplAsn1Decoder* NewL();
	virtual ~CSuplAsn1Decoder();
	
public:
	IMPORT_C CSuplMessageBase* DecodeL(const TPtrC8* aBuf, TInt& aError);
	
private:
	CSuplAsn1Decoder();
	void ConstructL();
	
	/** Prohibit copy constructor */
	CSuplAsn1Decoder(const CSuplAsn1Decoder&);
	/** Prohibit assigment operator */
	CSuplAsn1Decoder& operator= (const CSuplAsn1Decoder&);

private:
	/** Handle to the Implementation */
	CSuplAsn1DecoderImpl* iImpl;
	};

#endif // SUPL_ASN1_DECODER_H