Added comment regarding independent nullable properties.

1 files changed, 7 insertions, 0 deletions

diff --git a/src/main/java/com/amazon/carbonado/Nullable.java b/src/main/java/com/amazon/carbonado/Nullable.java
index 4ce63ec..54932e0 100644
--- a/src/main/java/com/amazon/carbonado/Nullable.java
+++ b/src/main/java/com/amazon/carbonado/Nullable.java
@@ -36,6 +36,13 @@ import java.lang.annotation.*;
  * }

  * </pre>

  *

+ * <p>If the repository does not allow a property to be declared as nullable

+ * because the underlying schema differs, it can be also annotated as {@link

+ * Independent}. This makes it easier for a common set of Storables to interact

+ * with schemas which are slightly different. Attempting to persist null into a

+ * property for which null is not allowed will likely result in a constraint

+ * exception.

+ *

  * @author Brian S O'Neill

  */

 @Documented