Package fr.dyade.aaa.util

Class JTransaction

java.lang.Object

fr.dyade.aaa.util.BaseTransaction

fr.dyade.aaa.util.JTransaction

All Implemented Interfaces:

JTransactionMBean, Transaction, TransactionMBean

@Deprecated
public final class JTransaction
extends BaseTransaction
implements JTransactionMBean

Deprecated.

The JTransaction class implements a transactionnal storage. This implementation is simple but inefficient, its main advantage is the compatibility with old JDK.

See Also:

Transaction

Field Summary

Fields

Modifier and Type	Field	Description
private int	commitCount	Deprecated. Number of commit operation since starting up.
private File	dir	Deprecated.
static String	EMPTY_STRING	Deprecated.
private Hashtable	log	Deprecated.
private static String	LOG	Deprecated.
private RandomAccessFile	logFile	Deprecated.
(package private) static int	LogThresholdOperation	Deprecated. Number of pooled operation, by default 100.
protected int	phase	Deprecated.
protected long	startTime	Deprecated.

Fields inherited from class fr.dyade.aaa.util.BaseTransaction

DEBUG, logmon

Fields inherited from interface fr.dyade.aaa.util.Transaction

BACKUP, COMMIT, FINALIZE, FREE, GARBAGE, INIT, Kb, Mb, PhaseInfo, ROLLBACK, RUN

Constructor Summary

Constructors

Constructor	Description
JTransaction()	Deprecated.

Method Summary

Modifier and Type	Method	Description
private void	_commit()	Deprecated.
String	backup(String path)	Deprecated. Backups the content of Transaction module.
void	begin()	Deprecated. Start a transaction validation, the validation phase needs 3 phases: begin, commit and release.
void	close()	Deprecated. Close the transaction module.
void	commit(boolean release)	Deprecated. Commit the current transaction.
boolean	containsOperations()	Deprecated. Indicates whether some operations have been done in this transaction.
void	create(Serializable obj, String name)	Deprecated. Register the state of a newly created object in the current transaction.
void	create(Serializable obj, String dirName, String name)	Deprecated. Register the state of a newly created object in the current transaction.
void	createByteArray(byte[] buf, String name)	Deprecated. Register a new byte array in the current transaction.
void	createByteArray(byte[] buf, String dirName, String name)	Deprecated. Register a new byte array in the current transaction.
void	delete(String name)	Deprecated. Deletes the specified object.
void	delete(String dirName, String name)	Deprecated. Deletes the specified object.
private void	deleteDir(File dir)	Deprecated. Delete the specified directory if it is empty.
int	getCommitCount()	Deprecated. Returns the number of commit operation since starting up.
File	getDir()	Deprecated.
String[]	getList(String prefix)	Deprecated. Returns an array of strings naming the objects in the component started by this prefix.
int	getOperationCount()	Deprecated. Returns the number of operations to be committed.
String	getPersistenceDir()	Deprecated. Returns the path of persistence directory.
int	getPhase()	Deprecated. Returns the transaction state.
String	getPhaseInfo()	Deprecated. Returns a string representation of the transaction state.
long	getStartTime()	Deprecated. Returns the starting time.
void	init(String path)	Deprecated. Initializes the atomic storage component.
boolean	isPersistent()	Deprecated. Tests if the Transaction component is persistent.
Object	load(String name)	Deprecated. Load the specified object.
Object	load(String dirName, String name)	Deprecated. Load the specified object.
void	loadAll(String prefix, Map map)	Deprecated. Fills the map with all objects of the component whose name begins with the prefix.
byte[]	loadByteArray(String name)	Deprecated. Load the specified byte array.
byte[]	loadByteArray(String dirName, String name)	Deprecated. Load the specified byte array.
void	release()	Deprecated. Release the mutual exclusion.
void	save(Serializable obj, String name)	Deprecated. Register the modified state of an object in the current transaction.
void	save(Serializable obj, String dirName, String name)	Deprecated. Register the modified state of an object in the current transaction.
void	save(Serializable obj, String dirName, String name, boolean first)	Deprecated. Register the state of an object in the current transaction.
void	saveByteArray(byte[] buf, String name)	Deprecated. Register a modified byte array in the current transaction.
void	saveByteArray(byte[] buf, String dirName, String name)	Deprecated. Register a modified byte array in the current transaction.
void	saveByteArray(byte[] buf, String dirName, String name, boolean copy, boolean first)	Deprecated. Register a modified byte array in the current transaction.
protected void	setPhase(int newPhase)	Deprecated.
void	stop()	Deprecated. Stops the transaction module.
boolean	useLoadAll()	Deprecated. Returns false, this Transaction implementation does not implement an optimized loadAll method.

Methods inherited from class fr.dyade.aaa.util.BaseTransaction

dumpObjectList, freeze, getBoolean, getInteger, getInteger, getObject, getObjectList, getProperty, getProperty, loadProperties, saveProperties

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface fr.dyade.aaa.util.TransactionMBean

dumpObjectList, getObject, getObjectList

Field Detail

startTime

protected long startTime

Deprecated.

commitCount

private int commitCount

Deprecated.

Number of commit operation since starting up.

EMPTY_STRING

public static final String EMPTY_STRING

Deprecated.

LogThresholdOperation

static int LogThresholdOperation

Deprecated.

Number of pooled operation, by default 100. This value can be adjusted for a particular server by setting LogThresholdOperation specific property.

These property can be fixed either from java launching command, or in a3servers.xml configuration file.

dir

private File dir

Deprecated.

LOG

private static final String LOG

Deprecated.

See Also:

Constant Field Values

logFile

private RandomAccessFile logFile

Deprecated.

log

private Hashtable log

Deprecated.

phase

protected int phase

Deprecated.

Constructor Detail

JTransaction

public JTransaction()

Deprecated.

Method Detail

getStartTime

public long getStartTime()

Deprecated.

Returns the starting time.

Specified by:

getStartTime in interface TransactionMBean

Returns:

The starting time.

getCommitCount

public final int getCommitCount()

Deprecated.

Returns the number of commit operation since starting up.

Specified by:

getCommitCount in interface Transaction

Specified by:

getCommitCount in interface TransactionMBean

Returns:

The number of commit operation.

isPersistent

public boolean isPersistent()

Deprecated.

Tests if the Transaction component is persistent.

Specified by:

isPersistent in interface Transaction

Specified by:

isPersistent in interface TransactionMBean

Returns:

true.

init

public void init(String path)
          throws IOException

Deprecated.

Description copied from interface: Transaction

Initializes the atomic storage component.

Specified by:

init in interface Transaction

Parameters:

path - the path of storage directory.

Throws:

IOException - an error occurs.

getDir

public File getDir()

Deprecated.

getPersistenceDir

public String getPersistenceDir()

Deprecated.

Returns the path of persistence directory.

Returns:

The path of persistence directory.

getPhase

public final int getPhase()

Deprecated.

Description copied from interface: TransactionMBean

Returns the transaction state.

Specified by:

getPhase in interface Transaction

Specified by:

getPhase in interface TransactionMBean

Returns:

the transaction state.

getPhaseInfo

public final String getPhaseInfo()

Deprecated.

Description copied from interface: TransactionMBean

Returns a string representation of the transaction state.

Specified by:

getPhaseInfo in interface Transaction

Specified by:

getPhaseInfo in interface TransactionMBean

Returns:

the string representation of the transaction state.

setPhase

protected void setPhase(int newPhase)
                 throws IOException

Deprecated.

Throws:

IOException

begin

public final void begin()
                 throws IOException

Deprecated.

Description copied from interface: Transaction

Start a transaction validation, the validation phase needs 3 phases: begin, commit and release. The begin ensure the mutual exclusion of the current transaction.

Specified by:

begin in interface Transaction

Throws:

IOException - an error occurs.

getList

public String[] getList(String prefix)

Deprecated.

Description copied from interface: Transaction

Returns an array of strings naming the objects in the component started by this prefix.

Specified by:

getList in interface Transaction

Parameters:

prefix - the prefix of searched objects.

Returns:

an array of strings naming the objects in the component started by this prefix.

create

public final void create(Serializable obj,
                         String name)
                  throws IOException

Deprecated.

Description copied from interface: Transaction

Register the state of a newly created object in the current transaction.

Specified by:

create in interface Transaction

Parameters:

obj - the object to store.

name - the name of the object.

Throws:

IOException - an error occurs.

create

public final void create(Serializable obj,
                         String dirName,
                         String name)
                  throws IOException

Deprecated.

Description copied from interface: Transaction

Register the state of a newly created object in the current transaction.

Specified by:

create in interface Transaction

Parameters:

obj - the object to store.

dirName - the directory name of the object.

name - the name of the object.

Throws:

IOException - an error occurs.

save

public final void save(Serializable obj,
                       String name)
                throws IOException

Deprecated.

Description copied from interface: Transaction

Register the modified state of an object in the current transaction.

Specified by:

save in interface Transaction

Parameters:

obj - the object to store.

name - the name of the object.

Throws:

IOException - an error occurs.

save

public final void save(Serializable obj,
                       String dirName,
                       String name)
                throws IOException

Deprecated.

Description copied from interface: Transaction

Register the modified state of an object in the current transaction.

Specified by:

save in interface Transaction

Parameters:

obj - the object to store.

dirName - the directory name of the object.

name - the name of the object.

Throws:

IOException - an error occurs.

save

public void save(Serializable obj,
                 String dirName,
                 String name,
                 boolean first)
          throws IOException

Deprecated.

Description copied from interface: Transaction

Register the state of an object in the current transaction.

Specified by:

save in interface Transaction

Parameters:

obj - the object to store.

dirName - the directory name of the object.

name - the name of the object.

first - the object is a new one.

Throws:

IOException - an error occurs.

createByteArray

public final void createByteArray(byte[] buf,
                                  String name)
                           throws IOException

Deprecated.

Description copied from interface: Transaction

Register a new byte array in the current transaction.

Specified by:

createByteArray in interface Transaction

Parameters:

buf - the byte array to store.

name - the name of the object.

Throws:

IOException - an error occurs.

createByteArray

public final void createByteArray(byte[] buf,
                                  String dirName,
                                  String name)
                           throws IOException

Deprecated.

Description copied from interface: Transaction

Register a new byte array in the current transaction.

Specified by:

createByteArray in interface Transaction

Parameters:

buf - the byte array to store.

dirName - the directory name of the object.

name - the name of the object.

Throws:

IOException - an error occurs.

saveByteArray

public final void saveByteArray(byte[] buf,
                                String name)
                         throws IOException

Deprecated.

Description copied from interface: Transaction

Register a modified byte array in the current transaction.

Specified by:

saveByteArray in interface Transaction

Parameters:

buf - the byte array to store.

name - the name of the object.

Throws:

IOException - an error occurs.

saveByteArray

public final void saveByteArray(byte[] buf,
                                String dirName,
                                String name)
                         throws IOException

Deprecated.

Description copied from interface: Transaction

Register a modified byte array in the current transaction.

Specified by:

saveByteArray in interface Transaction

Parameters:

buf - the byte array to store.

dirName - the directory name of the object.

name - the name of the object.

Throws:

IOException - an error occurs.

saveByteArray

public void saveByteArray(byte[] buf,
                          String dirName,
                          String name,
                          boolean copy,
                          boolean first)
                   throws IOException

Deprecated.

Description copied from interface: Transaction

Register a modified byte array in the current transaction.

Specified by:

saveByteArray in interface Transaction

Parameters:

buf - the byte array to store.

dirName - the directory name of the object.

name - the name of the object.

copy - the byte array can be modified, copy it.

first - the object is a new one.

Throws:

IOException - an error occurs.

load

public final Object load(String name)
                  throws IOException,
                         ClassNotFoundException

Deprecated.

Description copied from interface: Transaction

Load the specified object.

Specified by:

load in interface Transaction

Parameters:

name - the name of the object.

Returns:

the loaded object.

Throws:

IOException - an error occurs.

ClassNotFoundException - an error occurs.

load

public final Object load(String dirName,
                         String name)
                  throws IOException,
                         ClassNotFoundException

Deprecated.

Description copied from interface: Transaction

Load the specified object.

Specified by:

load in interface Transaction

Parameters:

dirName - the directory name of the object.

name - the name of the object.

Returns:

the loaded object.

Throws:

IOException - an error occurs.

ClassNotFoundException - an error occurs.

useLoadAll

public boolean useLoadAll()

Deprecated.

Returns false, this Transaction implementation does not implement an optimized loadAll method.

Specified by:

useLoadAll in interface Transaction

Specified by:

useLoadAll in interface TransactionMBean

Returns:

false.

loadAll

public void loadAll(String prefix,
                    Map map)

Deprecated.

Fills the map with all objects of the component whose name begins with the prefix.

Specified by:

loadAll in interface Transaction

Parameters:

prefix - The prefix of searched objects.

map - The map of corresponding objects.

loadByteArray

public final byte[] loadByteArray(String name)
                           throws IOException

Deprecated.

Description copied from interface: Transaction

Load the specified byte array.

Specified by:

loadByteArray in interface Transaction

Parameters:

name - the name of the object.

Returns:

the loaded byte array.

Throws:

IOException - an error occurs.

loadByteArray

public byte[] loadByteArray(String dirName,
                            String name)
                     throws IOException

Deprecated.

Description copied from interface: Transaction

Load the specified byte array.

Specified by:

loadByteArray in interface Transaction

Parameters:

dirName - the directory name of the object.

name - the name of the object.

Returns:

the loaded byte array.

Throws:

IOException - an error occurs.

delete

public final void delete(String name)

Deprecated.

Description copied from interface: Transaction

Deletes the specified object.

Specified by:

delete in interface Transaction

Parameters:

name - the name of the object.

delete

public void delete(String dirName,
                   String name)

Deprecated.

Description copied from interface: Transaction

Deletes the specified object.

Specified by:

delete in interface Transaction

Parameters:

dirName - the directory name of the object.

name - the name of the object.

deleteDir

private void deleteDir(File dir)

Deprecated.

Delete the specified directory if it is empty. Also recursively delete the parent directories if they are empty.

Parameters:

dir - the directory to delete.

commit

public void commit(boolean release)
            throws IOException

Deprecated.

Description copied from interface: Transaction

Commit the current transaction.

Specified by:

commit in interface Transaction

Parameters:

release - if true releases the transaction at the end of the commit.

Throws:

IOException - an error occurs.

_commit

private void _commit()
              throws IOException

Deprecated.

Throws:

IOException

release

public void release()
             throws IOException

Deprecated.

Description copied from interface: Transaction

Release the mutual exclusion.

Specified by:

release in interface Transaction

Throws:

IOException - an error occurs.

stop

public void stop()

Deprecated.

Stops the transaction module. It waits all transactions termination, then the module is kept in a FREE 'ready to use' state.

Specified by:

stop in interface Transaction

close

public void close()

Deprecated.

Close the transaction module. It waits all transactions termination, the module will be initialized anew before reusing it.

Specified by:

close in interface Transaction

containsOperations

public boolean containsOperations()

Deprecated.

Indicates whether some operations have been done in this transaction.

Specified by:

containsOperations in interface Transaction

Returns:

true if some operations are waiting for commit in this transaction.

getOperationCount

public int getOperationCount()

Deprecated.

Returns the number of operations to be committed.

Specified by:

getOperationCount in interface Transaction

Returns:

the number of operations to be committed.

backup

public String backup(String path)
              throws Exception

Deprecated.

Backups the content of Transaction module. Produces a generic Backup/Restore file containing all living objects. Currently not implemented, throws an UnsupportedOperationException.

Specified by:

backup in interface Transaction

Specified by:

backup in interface TransactionMBean

Parameters:

path - Directory path to store the backup.

Returns:

the name of created backup file.

Throws:

Exception - An error occurs during backup.