Experimental Feature - Freeze and detach beans (and attach)

ebean-api/src/main/java/io/ebean/ModifyAwareType.java

@@ -16,4 +16,9 @@ public interface ModifyAwareType {
    */
   void setMarkedDirty(boolean markedDirty);
 
+  /**
+   * Return a unmodifiable version of this type.
+   */
+  Object freeze();
+
 }

ebean-api/src/main/java/io/ebean/Transaction.java

@@ -2,6 +2,7 @@
 
 import io.ebean.annotation.DocStoreMode;
 import io.ebean.annotation.PersistBatch;
+import io.ebean.bean.FrozenBeans;
 import io.ebean.config.DatabaseConfig;
 import io.ebean.config.DocStoreConfig;
 
@@ -54,6 +55,24 @@ static Transaction current() {
    */
   int SERIALIZABLE = java.sql.Connection.TRANSACTION_SERIALIZABLE;
 
+
+  /**
+   * Experimental Feature - Freeze the beans in the persistence context and detach them.
+   */
+  @Deprecated(since = "Experimental Feature")
+  default FrozenBeans freezeAndDetach() {
+    throw new UnsupportedOperationException();
+  }
+
+  /**
+   * Experimental Feature - Attach frozen beans to the persistence context so that they can be
+   * used with ORM queries (with the persistence context acting like a cache).
+   */
+  @Deprecated(since = "Experimental Feature")
+  default void attach(FrozenBeans frozenBeans) {
+    throw new UnsupportedOperationException();
+  }
+
   /**
    * Register a TransactionCallback with this transaction.
    */

ebean-api/src/main/java/io/ebean/bean/BeanCollection.java

@@ -35,6 +35,11 @@ enum ModifyListenMode {
     ALL
   }
 
+  /**
+   * Return a unmodifiable collection of the underlying entities.
+   */
+  Object freeze();
+
   /**
    * Set the disableLazyLoad state.
    */

ebean-api/src/main/java/io/ebean/bean/EntityBeanIntercept.java

@@ -552,4 +552,16 @@ public interface EntityBeanIntercept extends Serializable {
    * Update the 'next' mutable info returning the content that was obtained via dirty detection.
    */
   String mutableNext(int propertyIndex);
+
+  /**
+   * Set that lazy loading if invoked throws a PersistenceException.
+   */
+  void errorOnLazyLoad(boolean lazyLoadAsError);
+
+  /**
+   * Freeze the intercept so that it is readOnly.
+   * Lazy loading and mutation of the bean is not allowed.
+   */
+  void freeze();
+
 }

ebean-api/src/main/java/io/ebean/bean/FrozenBeans.java

@@ -0,0 +1,9 @@
+package io.ebean.bean;
+
+import java.io.Serializable;
+
+/**
+ * Holds entity beans that are frozen.
+ */
+public interface FrozenBeans extends Serializable {
+}