Changes to the Java directory structure.
git-svn-id: https://svn.code.sf.net/p/flaim/code/trunk@247 0109f412-320b-0410-ab79-c3e0c5ffbbe6
This commit is contained in:
ahodgkinson
195
xflaim/java/xflaim/Backup.java
Normal file
195
xflaim/java/xflaim/Backup.java
Normal file
@@ -0,0 +1,195 @@
|
||||
//------------------------------------------------------------------------------
|
||||
// Desc: Backup
|
||||
//
|
||||
// Tabs: 3
|
||||
//
|
||||
// Copyright (c) 2003-2006 Novell, Inc. All Rights Reserved.
|
||||
//
|
||||
// This program is free software; you can redistribute it and/or
|
||||
// modify it under the terms of version 2 of the GNU General Public
|
||||
// License as published by the Free Software Foundation.
|
||||
//
|
||||
// This program is distributed in the hope that it will be useful,
|
||||
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
// GNU General Public License for more details.
|
||||
//
|
||||
// You should have received a copy of the GNU General Public License
|
||||
// along with this program; if not, contact Novell, Inc.
|
||||
//
|
||||
// To contact Novell about this file by physical or electronic mail,
|
||||
// you may find current contact information at www.novell.com
|
||||
//
|
||||
// $Id: Backup.java 3109 2006-01-19 13:07:07 -0700 (Thu, 19 Jan 2006) dsanders $
|
||||
//------------------------------------------------------------------------------
|
||||
|
||||
package xflaim;
|
||||
import java.io.FileNotFoundException;
|
||||
|
||||
/**
|
||||
* This classes provides methods to back up an XFlaim database
|
||||
*/
|
||||
public class Backup
|
||||
{
|
||||
// This constructor doesn't need to do much of anything; it's here mostly
|
||||
// to ensure that Backup does NOT have a public constructor. (The
|
||||
// application is not supposed to call new on Backup; Backup objects
|
||||
// are created by a call to Db.backupBegin
|
||||
|
||||
Backup(
|
||||
long lThis,
|
||||
Db jdb)
|
||||
{
|
||||
m_this = lThis;
|
||||
m_jdb = jdb;
|
||||
}
|
||||
|
||||
/**
|
||||
* Finalize method used to release native resources on garbage collection.
|
||||
*/
|
||||
public void finalize()
|
||||
{
|
||||
if (m_this != 0)
|
||||
{
|
||||
_release( m_this);
|
||||
m_this = 0;
|
||||
}
|
||||
|
||||
m_jdb = null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the transaction ID for this backup operation
|
||||
* @return Returns the transaction ID for this backup operation.
|
||||
*/
|
||||
public long getBackupTransId()
|
||||
{
|
||||
return _getBackupTransId( m_this);
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the transaction ID for the last backup job run on this database.
|
||||
* @return returns the transaction ID for the last backup job run on this
|
||||
* database.
|
||||
*/
|
||||
public long getLastBackupTransId()
|
||||
{
|
||||
return _getLastBackupTransId( m_this);
|
||||
}
|
||||
|
||||
/**
|
||||
* Performs the backup operation. <code>sBackupPath</code> and <code>
|
||||
* Client</code> are mutually exclusive. If <code>Client</code> is null,
|
||||
* then an instance of <code>DefaultBackupClient</code> will be created
|
||||
* and <code>sBackupPath</code> passed into its constructor. If <code>
|
||||
* Client</code> is non-null, <code>sBackupPath</code> is ignored.
|
||||
* @param sBackupPath Optional. The full pathname of a file to store the
|
||||
* backed up data.
|
||||
* @param Client Optional. If non-null, then it will be used as the backup
|
||||
* client.
|
||||
* @param Status Optional. If non-null, then <code>Status.backupStatus
|
||||
* </code> will be called periodicly to inform the application about the
|
||||
* progress of the backup operation.
|
||||
* @return Returns the sequence number of this backup. (This is for
|
||||
* informational purposes only; for instance, users can use it to label
|
||||
* their backup tapes.)
|
||||
* @throws XFlaimException
|
||||
*/
|
||||
public long backup(
|
||||
String sBackupPath,
|
||||
String sPassword,
|
||||
BackupClient Client,
|
||||
BackupStatus Status) throws XFlaimException
|
||||
{
|
||||
BackupClient BackupClient;
|
||||
|
||||
if (Client == null)
|
||||
{
|
||||
try
|
||||
{
|
||||
BackupClient = new DefaultBackupClient( sBackupPath);
|
||||
}
|
||||
catch (FileNotFoundException e)
|
||||
{
|
||||
throw new XFlaimException( xflaim.RCODE.NE_XFLM_OPENING_FILE,
|
||||
"IOException opening " + sBackupPath + ". Message from JVM was" +
|
||||
e.getMessage());
|
||||
}
|
||||
}
|
||||
else
|
||||
{
|
||||
BackupClient = Client;
|
||||
}
|
||||
|
||||
return _backup( m_this, sBackupPath, sPassword, BackupClient, Status);
|
||||
}
|
||||
|
||||
/**
|
||||
* Desc:
|
||||
*/
|
||||
public void endBackup() throws XFlaimException
|
||||
{
|
||||
_endBackup( m_this);
|
||||
}
|
||||
|
||||
// Reassigns the object to "point" to a new F_Backup instance and a new
|
||||
// Db. Called by any of the member functions that take a
|
||||
// Db.backupBegin parameter. Shouldn't be called by outsiders, so it's
|
||||
// not public, but it must be callable for other instances of this class.
|
||||
// NOTE: This function does not result in a call to F_Backup::Release()
|
||||
// because that is done by the native code when the F_Backup object is
|
||||
// reused. Calling setRef() in any case except from within
|
||||
// Db.backupBegin will result in a memory leak on the native side!
|
||||
void setRef(
|
||||
long lBackupRef,
|
||||
Db jdb)
|
||||
{
|
||||
m_this = lBackupRef;
|
||||
m_jdb = jdb;
|
||||
}
|
||||
|
||||
/**
|
||||
* Desc:
|
||||
*/
|
||||
long getRef()
|
||||
{
|
||||
return m_this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Desc:
|
||||
*/
|
||||
private native long _backup(
|
||||
long lThis,
|
||||
String sBackupPath,
|
||||
String sPassword,
|
||||
BackupClient Client,
|
||||
BackupStatus Status) throws XFlaimException;
|
||||
|
||||
/**
|
||||
* Desc:
|
||||
*/
|
||||
private native void _endBackup(
|
||||
long lThis) throws XFlaimException;
|
||||
|
||||
/**
|
||||
* Desc:
|
||||
*/
|
||||
private native long _getBackupTransId(
|
||||
long lThis);
|
||||
|
||||
/**
|
||||
* Desc:
|
||||
*/
|
||||
private native long _getLastBackupTransId(
|
||||
long lThis);
|
||||
|
||||
/**
|
||||
* Desc:
|
||||
*/
|
||||
private native void _release(
|
||||
long lThis);
|
||||
|
||||
private long m_this;
|
||||
private Db m_jdb;
|
||||
}
|
||||
Reference in New Issue
Block a user