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