org.codehaus.activemq.store.jdbm
Class JdbmPersistenceAdapter

java.lang.Object
  extended byorg.codehaus.activemq.service.impl.PersistenceAdapterSupport
      extended byorg.codehaus.activemq.store.jdbm.JdbmPersistenceAdapter
All Implemented Interfaces:
PersistenceAdapter, Service

public class JdbmPersistenceAdapter
extends PersistenceAdapterSupport

A PersistenceAdapter implementation for JDBM

Version:
$Revision: 1.6 $

Constructor Summary
JdbmPersistenceAdapter()
           
JdbmPersistenceAdapter(File directory)
           
JdbmPersistenceAdapter(jdbm.RecordManager manager)
           
 
Method Summary
 void beginTransaction()
          This method starts a transaction on the persistent storage - which is nothing to do with JMS or XA transactions - its purely a mechanism to perform multiple writes to a persistent store in 1 transaction as a performance optimisation.
 void commitTransaction()
          Commit a persistence transaction
 jdbm.btree.BTree createDatabase(String name)
           
 PreparedTransactionStore createPreparedTransactionStore()
          Factory method to create a new persistent prepared transaction store for XA recovery
 MessageStore createQueueMessageStore(String destinationName)
          Factory method to create a new queue message store with the given destination name
 TopicMessageStore createTopicMessageStore(String destinationName)
          Factory method to create a new topic message store with the given destination name
 File getDirectory()
           
 Map getInitialDestinations()
          Returns a map, indexed by String name, of all the Destination objects active on startup.
 jdbm.RecordManager getManager()
           
static JdbmPersistenceAdapter newInstance(File directory)
          Factory method to create an instance using the defaults
 void rollbackTransaction()
          Rollback a persistence transaction
 void setDirectory(File directory)
           
 void setManager(jdbm.RecordManager manager)
           
 void start()
          Called to start the service
 void stop()
          Called to shutdown the service
 
Methods inherited from class org.codehaus.activemq.service.impl.PersistenceAdapterSupport
createQueueMessageContainer, createTopicMessageContainer
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

JdbmPersistenceAdapter

public JdbmPersistenceAdapter()

JdbmPersistenceAdapter

public JdbmPersistenceAdapter(File directory)

JdbmPersistenceAdapter

public JdbmPersistenceAdapter(jdbm.RecordManager manager)
Method Detail

newInstance

public static JdbmPersistenceAdapter newInstance(File directory)
                                          throws JMSException
Factory method to create an instance using the defaults

Parameters:
directory - the directory in which to store the persistent files
Returns:
Throws:
JMSException

getInitialDestinations

public Map getInitialDestinations()
Description copied from interface: PersistenceAdapter
Returns a map, indexed by String name, of all the Destination objects active on startup.

Returns:

createQueueMessageStore

public MessageStore createQueueMessageStore(String destinationName)
                                     throws JMSException
Description copied from interface: PersistenceAdapter
Factory method to create a new queue message store with the given destination name

Throws:
JMSException

createTopicMessageStore

public TopicMessageStore createTopicMessageStore(String destinationName)
                                          throws JMSException
Description copied from interface: PersistenceAdapter
Factory method to create a new topic message store with the given destination name

Throws:
JMSException

createPreparedTransactionStore

public PreparedTransactionStore createPreparedTransactionStore()
                                                        throws JMSException
Description copied from interface: PersistenceAdapter
Factory method to create a new persistent prepared transaction store for XA recovery

Throws:
JMSException

beginTransaction

public void beginTransaction()
Description copied from interface: PersistenceAdapter
This method starts a transaction on the persistent storage - which is nothing to do with JMS or XA transactions - its purely a mechanism to perform multiple writes to a persistent store in 1 transaction as a performance optimisation.

Typically one transaction will require one disk synchronization point and so for real high performance its usually faster to perform many writes within the same transaction to minimise latency caused by disk synchronization. This is especially true when using tools like Berkeley Db or embedded JDBC servers.


commitTransaction

public void commitTransaction()
                       throws JMSException
Description copied from interface: PersistenceAdapter
Commit a persistence transaction

Throws:
JMSException
See Also:
PersistenceAdapter.beginTransaction()

rollbackTransaction

public void rollbackTransaction()
Description copied from interface: PersistenceAdapter
Rollback a persistence transaction

See Also:
PersistenceAdapter.beginTransaction()

start

public void start()
           throws JMSException
Description copied from interface: Service
Called to start the service

Throws:
JMSException

stop

public void stop()
          throws JMSException
Description copied from interface: Service
Called to shutdown the service

Throws:
JMSException

getManager

public jdbm.RecordManager getManager()

setManager

public void setManager(jdbm.RecordManager manager)

getDirectory

public File getDirectory()

setDirectory

public void setDirectory(File directory)

createDatabase

public jdbm.btree.BTree createDatabase(String name)
                                throws IOException,
                                       AlreadyClosedException
Throws:
IOException
AlreadyClosedException


Copyright © 2004 Protique, Ltd.. All Rights Reserved.