/*
* Copyright (c) 2002 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 MCoreDbSyncRecoveryHandler provides means to restore the database
*                synchronisation between Speech Recognition DB (SR DB) and VAS DB.
*
*                Training a new name saves stuff to SR DB. The SaveTag() call saves
*                stuff to VAS DB. If the client decides after training not to save, or
*                battery is removed between training the name and saving it, then the
*                two databases are out of sync.
*                These functions add to VAS DB enough information for proper rollback.
*                If they are called before changing SR DB, the databases will always
*                stay in sync.
*
*
*/


#ifndef MNSSCORERECOVERYHANDLER_H
#define MNSSCORERECOVERYHANDLER_H

class CNssTag;

/**
* The MNssCoreSrsDBEventHandler provides interface to handle events
* from Save and Delete utterance data into SRS.
*
*  @lib NssVasApi.lib
*  @since 2.0
*/
class MNssCoreSyncRecoveryHandler
{
public:

   /**
   * Recovery functions.
   * These are called, before changing the speech recognition database.
   * They save enough information to clean up and fall back, if:
   * (a) The client changes SR DB, but doesn't save the tag.
   * (b) A crash happens during operation.
   */

   /**
   * Callback
   * @return None
   */
   virtual void PrepareRecoveryInTraining( const RPointerArray<CNssSpeechItem>& anArray,
                                           const CNssContext* aContext )=0;

   /**
   * Callback
   * @return None
   */
   virtual void PrepareRecoveryInChanging(const RPointerArray<CNssSpeechItem>& anArray)=0;

   /**
   * Callback
   * @return None
   */
   virtual void PrepareRecoveryInDeleting(const RPointerArray<CNssSpeechItem>& anArray)=0;


};

#endif