From c90dfdf1c79371fd2102dd83c01503572a373518 Mon Sep 17 00:00:00 2001
From: "Brian S. O'Neill" <bronee@gmail.com>
Date: Thu, 29 Mar 2007 17:23:05 +0000
Subject: Update comments.

---
 src/main/java/com/amazon/carbonado/spi/LobEngineTrigger.java | 4 +++-
 src/main/java/com/amazon/carbonado/spi/MasterFeature.java    | 5 ++++-
 src/main/java/com/amazon/carbonado/spi/StoredSequence.java   | 1 +
 3 files changed, 8 insertions(+), 2 deletions(-)

(limited to 'src/main/java/com/amazon/carbonado/spi')

diff --git a/src/main/java/com/amazon/carbonado/spi/LobEngineTrigger.java b/src/main/java/com/amazon/carbonado/spi/LobEngineTrigger.java
index 2e42d8e..4b5ac5f 100644
--- a/src/main/java/com/amazon/carbonado/spi/LobEngineTrigger.java
+++ b/src/main/java/com/amazon/carbonado/spi/LobEngineTrigger.java
@@ -70,7 +70,9 @@ class LobEngineTrigger<S extends Storable> extends Trigger<S> {
     }
 
     public void afterInsert(S storable, Object state) throws PersistException {
-        // Save user lob value contents into new lobs.
+        // Save user lob value contents into new lobs. This is done after the
+        // insert of the enclosing record to avoid an expensive rollback if a
+        // constraint violation is detected.
         Object[] userLobs = (Object[]) state;
         int length = mLobProperties.length;
         for (int i=0; i<length; i++) {
diff --git a/src/main/java/com/amazon/carbonado/spi/MasterFeature.java b/src/main/java/com/amazon/carbonado/spi/MasterFeature.java
index f1d68f7..1ec1fc3 100644
--- a/src/main/java/com/amazon/carbonado/spi/MasterFeature.java
+++ b/src/main/java/com/amazon/carbonado/spi/MasterFeature.java
@@ -39,7 +39,10 @@ public enum MasterFeature {
     /** Insert operation applies any sequences to unset properties */
     INSERT_SEQUENCES,
 
-    /** Insert operation checks that all required data properties have been set */
+    /**
+     * Insert operation checks that all required data properties have been set,
+     * excluding automatic properties and version property.
+     */
     INSERT_CHECK_REQUIRED,
 
     /** Ensure insert operation always is in a transaction */
diff --git a/src/main/java/com/amazon/carbonado/spi/StoredSequence.java b/src/main/java/com/amazon/carbonado/spi/StoredSequence.java
index 97f18ab..023bca5 100644
--- a/src/main/java/com/amazon/carbonado/spi/StoredSequence.java
+++ b/src/main/java/com/amazon/carbonado/spi/StoredSequence.java
@@ -28,6 +28,7 @@ import com.amazon.carbonado.Storable;
  * Stores data for {@link SequenceValueGenerator}.
  *
  * @author Brian S O'Neill
+ * @deprecated Replaced by {@link com.amazon.carbonado.sequence.StoredSequence}
  */
 @PrimaryKey("name")
 @Authoritative
-- 
cgit v1.2.3