/*

* Copyright (c) 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: This file conatins StifTfIfProt implementation.

*

*/

// INCLUDE FILES

#include <e32base.h>

#include <e32svr.h>

#include "StifTFwIfProt.h"

#include <StifLogger.h>

// EXTERNAL DATA STRUCTURES

//extern  ?external_data;

// EXTERNAL FUNCTION PROTOTYPES  

//extern ?external_function( ?arg_type,?arg_type );

// CONSTANTS

//const ?type ?constant_var = ?constant;

// MACROS

//#define DEBUG(a) RDebug::Print(a)

//#define DEBUG2(a,b) RDebug::Print(a,b)

//#define DEBUG3(a,b,c) RDebug::Print(a,b,c)

#define DEBUG(a)

#define DEBUG2(a,b)

#define DEBUG3(a,b,c)

#define ERROR RDebug::Print

// LOCAL CONSTANTS AND MACROS

//const ?type ?constant_var = ?constant;

//#define ?macro_name ?macro_def

// MODULE DATA STRUCTURES

//enum ?declaration

//typedef ?declaration

// LOCAL FUNCTION PROTOTYPES

//?type ?function_name( ?arg_type, ?arg_type );

// FORWARD DECLARATIONS

//class ?FORWARD_CLASSNAME;

// ==================== LOCAL FUNCTIONS =======================================

/*

-------------------------------------------------------------------------------

    Function: <function name>

    Description: <one line description>

    <Description of the functionality 

    description continues and...

    continues>

    Parameters:	<arg1>: <in/out/inout>: <accepted values>: <Description>

    Return Values: <value_1: Description

		            value_n: Description line 1

			                 description line 2>

    Errors/Exceptions: <description how errors and exceptions are handled>

    Status: Draft

-------------------------------------------------------------------------------

*/

/*

<type function_name(

    <arg_type arg,>  

    <arg_type arg >)  	

    {

    // <comment>

    <code> 

    // <comment>

    <code>

    }

*/

/*

-------------------------------------------------------------------------------

    DESCRIPTION

    This module contains the implementation of CStifTFwIfProt class 

	member functions.

-------------------------------------------------------------------------------

*/

// ================= MEMBER FUNCTIONS =========================================

/*

-------------------------------------------------------------------------------

    Class: CStifTFwIfProt

    Method: CStifTFwIfProt

    Description: Default constructor

    C++ default constructor can NOT contain any code, that

    might leave.

    Parameters:	none

    Return Values: None

    Errors/Exceptions: None

    Status: Draft

-------------------------------------------------------------------------------

*/

CStifTFwIfProt::CStifTFwIfProt(): iMessage(0,0)

    { 

    };

/*

-------------------------------------------------------------------------------

     Class: CStifTFwIfProt

     Method: ConstructL

     Description: Symbian OS second phase constructor

     Symbian OS default constructor can leave.

     Parameters:    None

     Return Values: None

     Errors/Exceptions: None.

     Status: Proposal

-------------------------------------------------------------------------------

*/

void CStifTFwIfProt::ConstructL()

    {        

    }

/*

-------------------------------------------------------------------------------

     Class: CStifTFwIfProt

     Method: NewL

     Description: Two-phased constructor.

     Parameters:    None

     Return Values: CStifTFwIfProt*: new object

     Errors/Exceptions: Leaves if new or ConstructL leaves and in oom.

     Status: Proposal

-------------------------------------------------------------------------------

*/

EXPORT_C CStifTFwIfProt* CStifTFwIfProt::NewL()

    {

    CStifTFwIfProt* self = new (ELeave) CStifTFwIfProt();

    CleanupStack::PushL( self );

    self->ConstructL();

    CleanupStack::Pop();

    return self;

    }

/*

-------------------------------------------------------------------------------

    Class: CStifTFwIfProt

    Method: ~CStifTFwIfProt

    Description: Destructor

    Parameters:	None

    Return Values: None

    Errors/Exceptions: None

    Status: Draft

-------------------------------------------------------------------------------

*/    

EXPORT_C CStifTFwIfProt::~CStifTFwIfProt()

    {

    delete iItem;

    delete iMessageBuf;

    iMessageBuf = NULL;

    }

/*

-------------------------------------------------------------------------------

    Class: CStifTFwIfProt

    Method: CreateL

    Description: Create new empty protocol message.

    Parameters:	TInt aLength: in: protocol message length

    Return Values: None

    Errors/Exceptions: Leave if oom.

    Status: Draft

-------------------------------------------------------------------------------

*/

EXPORT_C void CStifTFwIfProt::CreateL( TInt aLength )

    {

    // Delete previous if exists

    delete iMessageBuf;

    iMessageBuf = NULL;

    iMessage.Set( 0, 0, 0 );

    iMessageBuf = HBufC::NewL( aLength );

    iMessage.Set( iMessageBuf->Des() );

    }

/*

-------------------------------------------------------------------------------

    Class: CStifTFwIfProt

    Method: Append

    Description: Append string to protocol message.

    Parameters:	TInt aLength: in: protocol message length

    Return Values: None

    Errors/Exceptions: Leave if oom.

    Status: Draft

-------------------------------------------------------------------------------

*/   

EXPORT_C TInt CStifTFwIfProt::Append( const TDesC& aStr )

    {

    if( ( aStr.Length() + 1 ) >

        ( iMessage.MaxLength() - iMessage.Length() ) )

        {

        ERROR( _L("No space left for string") );

        return KErrOverflow;   

        }

    iMessage.Append( aStr );

    iMessage.Append( _L(" ") );

    return KErrNone;

    }    

/*

-------------------------------------------------------------------------------

    Class: CStifTFwIfProt

    Method: Append

    Description: Append hexadecimal value to protocol message.

    Parameters:	TInt aLength: in: protocol message length

    Return Values: None

    Errors/Exceptions: Leave if oom.

    Status: Draft

-------------------------------------------------------------------------------

*/   

EXPORT_C TInt CStifTFwIfProt::AppendId( TUint32 aId )

    {

     if( ( KMaxValueLength + 1 ) >

        ( iMessage.MaxLength() - iMessage.Length() ) )

        {

        ERROR( _L("No space left for string") );

        return KErrOverflow;   

        }

    iMessage.AppendNumFixedWidth( aId, EHex, KProtocolIdLength );

    iMessage.Append( _L(" ") );

    return KErrNone;

    }

/*

-------------------------------------------------------------------------------

    Class: CStifTFwIfProt

    Method: Append

    Description: Append string to protocol message.

    Parameters:	TInt aLength: in: protocol message length

    Return Values: None

    Errors/Exceptions: Leave if oom.

    Status: Draft

-------------------------------------------------------------------------------

*/   

EXPORT_C TInt CStifTFwIfProt::Append( KeywordFunc aFunc, TInt aKeyword )

    {

    if( ( aFunc( aKeyword ).Length() + 1 ) >

        ( iMessage.MaxLength() - iMessage.Length() ) )

        {

        ERROR( _L("No space left for string") );

        return KErrOverflow;   

        }

    iMessage.Append( aFunc( aKeyword ) );

    iMessage.Append( _L(" ") );

    return KErrNone;

    }

/*

-------------------------------------------------------------------------------

    Class: CStifTFwIfProt

    Method: Append

    Description: Append type-value string to protocol message.

    Parameters:	TInt aLength: in: protocol message length

    Return Values: None

    Errors/Exceptions: Leave if oom.

    Status: Draft

-------------------------------------------------------------------------------

*/   

EXPORT_C TInt CStifTFwIfProt::Append( KeywordFunc aFunc, 

                                      TInt aKeyword, 

                                      const TDesC& aStr )

    {

     if( ( aFunc( aKeyword ).Length() + 2 +  aStr.Length() ) >

        ( iMessage.MaxLength() - iMessage.Length() ) )

        {

        ERROR( _L("No space left for string") );

        return KErrOverflow;

        }

    iMessage.Append( aFunc( aKeyword ) );

    iMessage.Append( _L("=") );

    iMessage.Append( aStr );

    iMessage.Append( _L(" ") );

    return KErrNone;

    }

/*

-------------------------------------------------------------------------------

    Class: CStifTFwIfProt

    Method: Append

    Description: Append type-value string to protocol message.

    Parameters:	TInt aLength: in: protocol message length

    Return Values: None

    Errors/Exceptions: Leave if oom.

    Status: Draft

-------------------------------------------------------------------------------

*/   

EXPORT_C TInt CStifTFwIfProt::Append( KeywordFunc aFunc, 

                                      TInt aKeyword, 

                                      KeywordFunc aValueFunc, 

                                      TInt aValue )

    {

     if( ( aFunc( aKeyword ).Length() + 2 +  aValueFunc( aValue ).Length() ) >

        ( iMessage.MaxLength() - iMessage.Length() ) )

        {

        ERROR( _L("No space left for string") );

        return KErrOverflow;   

        }

    iMessage.Append( aFunc( aKeyword ) );

    iMessage.Append( _L("=") );

    iMessage.Append( aValueFunc( aValue ) );

    iMessage.Append( _L(" ") );

    return KErrNone;

    }

/*

-------------------------------------------------------------------------------

    Class: CStifTFwIfProt

    Method: Append

    Description: Append type-value string to protocol message.

    Parameters:	TInt aLength: in: protocol message length

    Return Values: None

    Errors/Exceptions: Leave if oom.

    Status: Draft

-------------------------------------------------------------------------------

*/   

EXPORT_C TInt CStifTFwIfProt::Append( KeywordFunc aFunc, 

                                       TInt aKeyword, 

                                       TInt aValue )

    {

     if( ( aFunc( aKeyword ).Length() + 2 + KMaxValueLength ) >

        ( iMessage.MaxLength() - iMessage.Length() ) )

        {

        ERROR( _L("No space left for string") );

        return KErrOverflow;   

        }

    iMessage.Append( aFunc( aKeyword ) );

    iMessage.Append( _L("=") );

    iMessage.AppendNum( aValue );

    iMessage.Append( _L(" ") );

    return KErrNone;

    }

/*

-------------------------------------------------------------------------------

    Class: CStifTFwIfProt

    Method: SetL

    Description: Set and parse protocol message.

    Parameters:	TDesC& aMessage: in: protocol message

    Return Values: Symbian OS error code: If protocol message parsing fails, 

        i.e. message prsing after header <msg type> <sdcid> <dstid>

    Errors/Exceptions: Leaves if protocol header parsing fails and oom.

    Status: Draft

-------------------------------------------------------------------------------

*/

EXPORT_C TInt CStifTFwIfProt::SetL( const TDesC& aMessage )

    {

    // Delete previous if exists

    delete iMessageBuf;

    iMessageBuf = NULL;

    iMessage.Set( 0,0,0 );

    iMessageBuf = aMessage.AllocL();

    iMessage.Set( iMessageBuf->Des() );

    return ParseMessageL();

    }

/*

-------------------------------------------------------------------------------

    Class: CStifTFwIfProt

    Method: SetL

    Description: Get protocol source identifier.

    Parameters:	None

    Return Values: Source identifier.