Java Doc for TransactionalMapWrapper.java in  » Database-JDBC-Connection-Pool » Apache-commons-transaction-1.2 » org » apache » commons » transaction » memory » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Java Source Code / Java Documentation
1. 6.0 JDK Core
2. 6.0 JDK Modules
3. 6.0 JDK Modules com.sun
4. 6.0 JDK Modules com.sun.java
5. 6.0 JDK Modules sun
6. 6.0 JDK Platform
7. Ajax
8. Apache Harmony Java SE
9. Aspect oriented
10. Authentication Authorization
11. Blogger System
12. Build
13. Byte Code
14. Cache
15. Chart
16. Chat
17. Code Analyzer
18. Collaboration
19. Content Management System
20. Database Client
21. Database DBMS
22. Database JDBC Connection Pool
23. Database ORM
24. Development
25. EJB Server geronimo
26. EJB Server GlassFish
27. EJB Server JBoss 4.2.1
28. EJB Server resin 3.1.5
29. ERP CRM Financial
30. ESB
31. Forum
32. GIS
33. Graphic Library
34. Groupware
35. HTML Parser
36. IDE
37. IDE Eclipse
38. IDE Netbeans
39. Installer
40. Internationalization Localization
41. Inversion of Control
42. Issue Tracking
43. J2EE
44. JBoss
45. JMS
46. JMX
47. Library
48. Mail Clients
49. Net
50. Parser
51. PDF
52. Portal
53. Profiler
54. Project Management
55. Report
56. RSS RDF
57. Rule Engine
58. Science
59. Scripting
60. Search Engine
61. Security
62. Sevlet Container
63. Source Control
64. Swing Library
65. Template Engine
66. Test Coverage
67. Testing
68. UML
69. Web Crawler
70. Web Framework
71. Web Mail
72. Web Server
73. Web Services
74. Web Services apache cxf 2.0.1
75. Web Services AXIS2
76. Wiki Engine
77. Workflow Engines
78. XML
79. XML UI
Java
Java Tutorial
Java Open Source
Jar File Download
Java Articles
Java Products
Java by API
Photoshop Tutorials
Maya Tutorials
Flash Tutorials
3ds-Max Tutorials
Illustrator Tutorials
GIMP Tutorials
C# / C Sharp
C# / CSharp Tutorial
C# / CSharp Open Source
ASP.Net
ASP.NET Tutorial
JavaScript DHTML
JavaScript Tutorial
JavaScript Reference
HTML / CSS
HTML CSS Reference
C / ANSI-C
C Tutorial
C++
C++ Tutorial
Ruby
PHP
Python
Python Tutorial
Python Open Source
SQL Server / T-SQL
SQL Server / T-SQL Tutorial
Oracle PL / SQL
Oracle PL/SQL Tutorial
PostgreSQL
SQL / MySQL
MySQL Tutorial
VB.Net
VB.Net Tutorial
Flash / Flex / ActionScript
VBA / Excel / Access / Word
XML
XML Tutorial
Microsoft Office PowerPoint 2007 Tutorial
Microsoft Office Excel 2007 Tutorial
Microsoft Office Word 2007 Tutorial
Java Source Code / Java Documentation » Database JDBC Connection Pool » Apache commons transaction 1.2 » org.apache.commons.transaction.memory 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.lang.Object
   org.apache.commons.transaction.memory.TransactionalMapWrapper

All known Subclasses:   org.apache.commons.transaction.memory.PessimisticMapWrapper,  org.apache.commons.transaction.memory.OptimisticMapWrapper,
TransactionalMapWrapper
public class TransactionalMapWrapper implements Map,Status(Code)
Wrapper that adds transactional control to all kinds of maps that implement the Map interface. This wrapper has rather weak isolation, but is simply, neven blocks and commits will never fail for logical reasons.
Start a transaction by calling TransactionalMapWrapper.startTransaction() . Then perform the normal actions on the map and finally either call TransactionalMapWrapper.commitTransaction() to make your changes permanent or TransactionalMapWrapper.rollbackTransaction() to undo them.
Caution: Do not modify values retrieved by TransactionalMapWrapper.get(Object) as this will circumvent the transactional mechanism. Rather clone the value or copy it in a way you see fit and store it back using TransactionalMapWrapper.put(Object,Object) .
Note: This wrapper guarantees isolation level READ COMMITTED only. I.e. as soon a value is committed in one transaction it will be immediately visible in all other concurrent transactions.
version:
   $Id: TransactionalMapWrapper.java 493628 2007-01-07 01:42:48Z joerg $
See Also:   OptimisticMapWrapper
See Also:   PessimisticMapWrapper

Inner Class :protected static class HashEntry implements Map.Entry
Inner Class :public class TxContext

Field Summary
protected  MapFactorymapFactory
     Factory to be used to create temporary maps for transactions.
protected  SetFactorysetFactory
     Factory to be used to create temporary sets for transactions.
protected  Mapwrapped
     The map wrapped.

Constructor Summary
public  TransactionalMapWrapper(Map wrapped)
     Creates a new transactional map wrapper.
public  TransactionalMapWrapper(Map wrapped, MapFactory mapFactory, SetFactory setFactory)
     Creates a new transactional map wrapper.

Method Summary
public  voidclear()
    
public  voidcommitTransaction()
     Commits all changes made in the current transaction and deletes the association between the current thread and the transaction.
public  booleancontainsKey(Object key)
    
public  booleancontainsValue(Object value)
    
public  SetentrySet()
    
public  Objectget(Object key)
    
protected  TxContextgetActiveTx()
    
public  intgetTransactionState()
     Returns the state of the current transaction.
public  booleanisEmpty()
    
public  booleanisReadOnly()
     Checks if any write operations have been performed inside this transaction.
public  booleanisTransactionMarkedForRollback()
     Checks whether this transaction has been marked to allow a rollback as the only valid outcome.
public  SetkeySet()
    
public  voidmarkTransactionForRollback()
     Marks the current transaction to allow only a rollback as valid outcome.
public  Objectput(Object key, Object value)
    
public  voidputAll(Map map)
    
public  Objectremove(Object key)
    
public  voidresumeTransaction(TxContext suspendedTx)
     Resumes a transaction in the current thread that has previously been suspened by TransactionalMapWrapper.suspendTransaction() .
public  voidrollbackTransaction()
     Discards all changes made in the current transaction and deletes the association between the current thread and the transaction.
protected  voidsetActiveTx(TxContext txContext)
    
public  intsize()
    
public  voidstartTransaction()
     Starts a new transaction and associates it with the current thread.
public  TxContextsuspendTransaction()
     Suspends the transaction associated to the current thread.
public  Collectionvalues()
    

Field Detail
mapFactory
protected MapFactory mapFactory(Code)
Factory to be used to create temporary maps for transactions.



setFactory
protected SetFactory setFactory(Code)
Factory to be used to create temporary sets for transactions.



wrapped
protected Map wrapped(Code)
The map wrapped.




Constructor Detail
TransactionalMapWrapper
public TransactionalMapWrapper(Map wrapped)(Code)
Creates a new transactional map wrapper. Temporary maps and sets to store transactional data will be instances of java.util.HashMap and java.util.HashSet .
Parameters:
  wrapped - map to be wrapped



TransactionalMapWrapper
public TransactionalMapWrapper(Map wrapped, MapFactory mapFactory, SetFactory setFactory)(Code)
Creates a new transactional map wrapper. Temporary maps and sets to store transactional data will be created and disposed using MapFactory and SetFactory .
Parameters:
  wrapped - map to be wrapped
Parameters:
  mapFactory - factory for temporary maps
Parameters:
  setFactory - factory for temporary sets




Method Detail
clear
public void clear()(Code)

See Also:   Map.clear
See Also:   



commitTransaction
public void commitTransaction()(Code)
Commits all changes made in the current transaction and deletes the association between the current thread and the transaction.
See Also:   TransactionalMapWrapper.startTransaction()
See Also:   TransactionalMapWrapper.rollbackTransaction()



containsKey
public boolean containsKey(Object key)(Code)

See Also:   Map.containsKey(java.lang.Object)
See Also:   



containsValue
public boolean containsValue(Object value)(Code)

See Also:   Map.containsValue(java.lang.Object)
See Also:   



entrySet
public Set entrySet()(Code)

See Also:   Map.entrySet
See Also:   



get
public Object get(Object key)(Code)

See Also:   Map.get(java.lang.Object)
See Also:   



getActiveTx
protected TxContext getActiveTx()(Code)



getTransactionState
public int getTransactionState()(Code)
Returns the state of the current transaction. state of the current transaction as decribed in the Status interface.



isEmpty
public boolean isEmpty()(Code)

See Also:   Map.isEmpty
See Also:   



isReadOnly
public boolean isReadOnly()(Code)
Checks if any write operations have been performed inside this transaction. true if no write opertation has been performed inside the current transaction,false otherwise



isTransactionMarkedForRollback
public boolean isTransactionMarkedForRollback()(Code)
Checks whether this transaction has been marked to allow a rollback as the only valid outcome. This can be set my method TransactionalMapWrapper.markTransactionForRollback() or might be set internally be any fatal error. Once a transaction is marked for rollback there is no way to undo this. A transaction that is marked for rollback can not be committed, also rolled back. true if this transaction has been marked for a roll back
See Also:   TransactionalMapWrapper.markTransactionForRollback()



keySet
public Set keySet()(Code)

See Also:   Map.keySet
See Also:   



markTransactionForRollback
public void markTransactionForRollback()(Code)
Marks the current transaction to allow only a rollback as valid outcome.
See Also:   TransactionalMapWrapper.isTransactionMarkedForRollback()



put
public Object put(Object key, Object value)(Code)

See Also:   Map.put(java.lang.Objectjava.lang.Object)



putAll
public void putAll(Map map)(Code)

See Also:   Map.putAll(java.util.Map)
See Also:   



remove
public Object remove(Object key)(Code)

See Also:   Map.remove(java.lang.Object)
See Also:   



resumeTransaction
public void resumeTransaction(TxContext suspendedTx)(Code)
Resumes a transaction in the current thread that has previously been suspened by TransactionalMapWrapper.suspendTransaction() .
Parameters:
  suspendedTx - the identifier for the transaction to be resumed, delivered by TransactionalMapWrapper.suspendTransaction()
See Also:   TransactionalMapWrapper.suspendTransaction()



rollbackTransaction
public void rollbackTransaction()(Code)
Discards all changes made in the current transaction and deletes the association between the current thread and the transaction.
See Also:   TransactionalMapWrapper.startTransaction()
See Also:   TransactionalMapWrapper.commitTransaction()



setActiveTx
protected void setActiveTx(TxContext txContext)(Code)



size
public int size()(Code)

See Also:   Map.size
See Also:   



startTransaction
public void startTransaction()(Code)
Starts a new transaction and associates it with the current thread. All subsequent changes in the same thread made to the map are invisible from other threads until TransactionalMapWrapper.commitTransaction() is called. Use TransactionalMapWrapper.rollbackTransaction() to discard your changes. After calling either method there will be no transaction associated to the current thread any longer.

Caution: Be careful to finally call one of those methods, as otherwise the transaction will lurk around for ever.
See Also:   TransactionalMapWrapper.commitTransaction()
See Also:   TransactionalMapWrapper.rollbackTransaction()



suspendTransaction
public TxContext suspendTransaction()(Code)
Suspends the transaction associated to the current thread. I.e. the associated between the current thread and the transaction is deleted. This is useful when you want to continue the transaction in another thread later. Call TransactionalMapWrapper.resumeTransaction(TxContext) - possibly in another thread than the current - to resume work on the transaction.

Caution: When calling this method the returned identifier for the transaction is the only remaining reference to the transaction, so be sure to remember it or the transaction will be eventually deleted (and thereby rolled back) as garbage. an identifier for the suspended transaction, will be needed to later resume the transaction byTransactionalMapWrapper.resumeTransaction(TxContext)
See Also:   TransactionalMapWrapper.resumeTransaction(TxContext)



values
public Collection values()(Code)

See Also:   Map.values
See Also:   



Methods inherited from java.lang.Object
native protected Object clone() throws CloneNotSupportedException(Code)(Java Doc)
public boolean equals(Object obj)(Code)(Java Doc)
protected void finalize() throws Throwable(Code)(Java Doc)
final native public Class getClass()(Code)(Java Doc)
native public int hashCode()(Code)(Java Doc)
final native public void notify()(Code)(Java Doc)
final native public void notifyAll()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final native public void wait(long timeout) throws InterruptedException(Code)(Java Doc)
final public void wait(long timeout, int nanos) throws InterruptedException(Code)(Java Doc)
final public void wait() throws InterruptedException(Code)(Java Doc)

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.