/*

* Copyright (c) 2008-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:  Header file for JavaVersionBackupUtil class

*

*/

#ifndef JAVAVERSIONBACKUPUTIL_H

#define JAVAVERSIONBACKUPUTIL_H

#include <e32base.h>

#include <driveinfo.h>

#include <javaenvinfo.h>

class RDesReadStream;

class RDesWriteStream;

namespace java

{

namespace backup

{

/**

 *  JavaVersionBackupUtil class is used for checking the java version

 *  during a B&R operation. This class writes the current java version

 *  while backing up and then checks whether the backed up version

 *  is compatible with the currnet version while doing a restore.

 *  If it is not compatible, then the backup process is gracefully exited.

 */

class JavaVersionBackupUtil

{

public:

    /**

     * This method writes the current java version into the SBE buffer.

     * This functions is called when a backup process is started.

     *

     * @param aBuffer the buffer which is sent by the SBE

     */

    static void WriteJavaVersionL(RDesWriteStream& aStream);

    /**

     * This method reads the java version from the stream. If there is no

     * Java version or if the Java version is not compatible with the

     * current version, then the restore process is exited gracefully.

     *

     * @param aStream an RDesReadStream on the buffer which is sent

     *        by the SBE

     * @param aDrive current drive to be backed up

     * @return status

     */

    static TUint CheckJavaVersionL(RDesReadStream& aStream, TDriveNumber aDrive, TBool versionCheck);

private:

    /**

     * This method is used to compare the current java version with the

     * one read from the stream.

     * This method is not used presently. Logic may be added in the future

     *

     * @param aVersion the java version read from the stream

     * @param aCurVersion the current java version

     */

    void CompareL(TVersion aVersion, TVersion aCurVersion);

};

} // namespace backup

} // namespace java

#endif // JAVAVERSIONBACKUPUTIL_H