Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Javadoc changes

  • Loading branch information...
commit 860c44c1311ebc014599bf41c5d2772183504c35 1 parent 0aa4a3e
@TheNavigateur TheNavigateur authored
View
2  CHANGES.txt
@@ -19,7 +19,7 @@ Transactions can now be executed directly
Transactions can now allow references passed in to be used naturally, allowing
their contents to change as with Java methods. Previous versions allowed only
-a freshly deserialized copy to be executed.
+a deep copy to be executed.
It is activated via:
View
6 factory/src/main/java/org/prevayler/PrevaylerFactory.java
@@ -34,7 +34,7 @@
* <br>
* <br>By default, the Prevayler instances created by this class will write their Transactions to .journal files before executing them. The FileDescriptor.sync() method is called to make sure the Java file write-buffers have been written to the operating system. Many operating systems, including most recent versions of Linux and Windows, allow the hard-drive's write-cache to be disabled. This guarantees no executed Transaction will be lost in the event of a power shortage, for example.
* <br>
- * <br>Also by default, the Prevayler instances created by this class will execute freshly deserialized copies of transactions, not the transactions themselves, so that unrecoverable changes to the prevalent system and unrecoverable uses of reference equality inside transactions fail fast as they would upon recovery.
+ * <br>Also by default, the Prevayler instances created by this class will execute deep copies of transactions, not the transactions themselves, so that unrecoverable changes to the prevalent system and unrecoverable uses of reference equality inside transactions fail fast as they would upon recovery.
* @param <P> The type of object you intend to persist as a Prevalent System. <br>
* @see Prevayler
*/
@@ -165,13 +165,13 @@ public void configurePrevalenceDirectory(String prevalenceDirectory) {
}
/**
- * Configures whether freshly deserialized copies of transactions are executed instead of the transactions themselves, upon calling ".execute" on the created Prevayler. The default is <code>true</code>.
+ * Configures whether deep copies of transactions are executed instead of the transactions themselves, upon calling ".execute" on the created Prevayler. The default is <code>true</code>.
*
* @param transactionDeepCopyMode
* <br>
* <br>If <code>false</code>, references passed in to transactions are used naturally, as they are during ordinary Java method calls, allowing their underlying objects to be changed inside transactions. However, any unrecoverable changes to the prevalent system and unrecoverable uses of reference equality inside transactions will not fail fast as they would upon recovery.
* <br>
- * <br>If <code>true</code> (default), a freshly deserialized copy of the transaction is executed each time. This allows any unrecoverable changes to the prevalent system and unrecoverable uses of reference equality inside transactions to fail fast as they would upon recovery. However, it only allows changes to freshly deserialized copies of the objects passed in, not the original objects.
+ * <br>If <code>true</code> (default), a deep copy of the transaction is executed each time. This allows any unrecoverable changes to the prevalent system and unrecoverable uses of reference equality inside transactions to fail fast as they would upon recovery. However, it only allows changes to deep copies of the objects passed in, not the original objects.
*
*/
public void configureTransactionDeepCopy(boolean transactionDeepCopyMode){
Please sign in to comment.
Something went wrong with that request. Please try again.