/*

* Copyright (c) 2004-2006 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:  The CNssSpeechItemBuilder provides methods to create SpeechItem object.

*

*/

#ifndef NSSVASCSPEECHITEMBUILDER_H

#define NSSVASCSPEECHITEMBUILDER_H

#include "nssvasccontext.h"

#include "nssvascspeechitem.h"

#include "nssvascspeechitemtrainer.h"

#include "nssvasmcoresyncrecoveryhandler.h"

// FORWARD DECLARATIONS

class CNssVASDatabase;

/**

* The CNssSpeechItemBuilder class builds SpeechItem instances when requested.

*

*  @lib NssVASApi.lib

*  @since 2.8

*/

class CNssSpeechItemBuilder : public CBase

{

  public:

    /**

    * Destructor.

    * The CNssSpeechItemBuilder destructor

    * Destroys the speech item builder. In addition, this must set the

    * state of the speech item portal termination state to termination pending.

    */   

    ~CNssSpeechItemBuilder();

    /**

    * Creates SpeechItemBuilder.  In addition, this must also create the

    * Speech Item Portal and Speech Item Trainer.

    * @since 2.0

    * @param aDatabase - interface to database

    * @return 

    */       

    static CNssSpeechItemBuilder* NewL( CNssVASDatabase* aDatabase );

    /**

    * 2 phase construction

    * @since 2.0

    * @param aDatabase - interface to database

    * @return 

    */      

    static CNssSpeechItemBuilder* NewLC( CNssVASDatabase* aDatabase );

    /**

    * Create SpeechItem object given a Context

    * @since 2.0

    * @param aContext - reference of Contaxt object  

    * @return *CNssSpeechItem - a pointer to a SpeechItem object

    */      

    CNssSpeechItem* CreateEmptySpeechItemL(CNssContext& aContext);

    /**

    * Create SpeechItem object given most of its data members.

    * @since 2.0

    * @param aContext - reference of Contaxt object  

    * @param aText - a text description

    * @param aTagID - a TagID 

    * @return *CNssSpeechItem - a pointer to a SpeechItem object

    */   

    CNssSpeechItem* CreateSpeechItemL(CNssContext& aContext,

        TUint32 aRuleID,const TDesC& aText, TInt aTagID,

        TNssVasCoreConstant::TNssTrainedType aTrainedType );

  private: //function

   /**

    * C++ constructor

    */ 

    CNssSpeechItemBuilder();

    /**

    * Symbian 2nd phase constructor 

    */      

    void ConstructL( CNssVASDatabase* aDatabase );

  private: //data

    // Pointer to SRS Portal object.

    // The SpeechItemBuilder own the SpeechItemPortal

    CNssSpeechItemSrsPortal* iPortal; 

    CNssSpeechItemTrainer*  iTrainer;

};

#endif // NSSVASCSPEECHITEMBUILDER_H

// End of file