Repair the copyright per Casser author's request. Also fix DOS line endings.

Delegate-based delete-tracking cache implementation, fixes to javax.cache.Cache implementation, and unit tests

.gitignore

@@ -1,3 +1,8 @@
+.gradle/
+build/
+gradle/
+gradlew
+gradlew.bat
 *.iml
 .idea
 infer-out

.idea/eclipseCodeFormatter.xml

@@ -3,7 +3,6 @@
   <component name="EclipseCodeFormatterProjectSettings">
     <option name="projectSpecificProfile">
       <ProjectSpecificProfile>
-        <option name="formatter" value="ECLIPSE" />
         <option name="pathToConfigFileJava" value="$PROJECT_DIR$/../newton/formatting/onshape-eclipse-general-preferences.epf" />
       </ProjectSpecificProfile>
     </option>

NOTES

@@ -0,0 +1,202 @@
+Operation/
+|-- AbstractStatementOperation
+|   |-- AbstractOperation
+|   |   |-- AbstractFilterOperation
+|   |   |   |-- CountOperation
+|   |   |   |-- DeleteOperation
+|   |   |   `-- UpdateOperation
+|   |   |-- BoundOperation
+|   |   `-- InsertOperation
+|   |-- AbstractOptionalOperation
+|   |   |-- AbstractFilterOptionalOperation
+|   |   |   |-- SelectFirstOperation
+|   |   |   `-- SelectFirstTransformingOperation
+|   |   `-- BoundOptionalOperation
+|   `-- AbstractStreamOperation
+|       |-- AbstractFilterStreamOperation
+    |       |   |-- SelectOperation
+|       |   `-- SelectTransformingOperation
+|       `-- BoundStreamOperation
+|-- PreparedOperation
+|-- PreparedOptionalOperation
+`-- PreparedStreamOperation
+
+
+----
+@CompoundIndex()
+create a new col in the same table called __idx_a_b_c that the hash of the concatenated values in that order is stored, create a normal index for that (CREATE INDEX ...)
+if a query matches that set of columns then use that indexed col to fetch the desired results from that table
+could also work with .in() query if materialized view exists
+----
+
+
+    // TODO(gburd): create a statement that matches one that wasn't prepared
+    //String key =
+    //    "use " + preparedStatement.getQueryKeyspace() + "; " + preparedStatement.getQueryString();
+    //for (Object param : params) {
+    //  key = key.replaceFirst(Pattern.quote("?"), param.toString());
+    //}
+
+
+
+
+primitive types have default values, (e.g. boolean, int, ...) but primative wrapper classes do not and can be null (e.g. Boolean, Integer, ...)
+
+create table wal {
+  id timeuuid,
+  follows timeuuid,
+  read <Counting Quotient Filter, Set<{keyspace, col, schema generation, timestamp}>>
+  write <Counting Quotient Filter, Set<{keyspace, col, schema generation, timestamp}>>
+  primary key (id, follows)
+}
+begin:
+  - insert into wal (timeuuid, parent timeuuid,
+
+
+
+        // NOTE: Update operations have no meaning when they only contain primary key components, so
+        // given that `properties` is ordered with the keys first if we find that the last element
+        // is either a partition key or clustering column then we know we should just skip this operation.
+        ColumnType ct = ((HelenusProperty) properties.toArray()[properties.size() - 1]).getColumnType();
+        if (ct != ColumnType.PARTITION_KEY && ct != ColumnType.CLUSTERING_COLUMN) {
+            return;
+        }
+
+
+
+	public Stream<E> sync() {
+	    ListenableFuture<Stream<E>> future = async();
+        Futures.addCallback(future, new FutureCallback<String>() {
+            @Override
+            public void onSuccess(String contents) {
+                //...process web site contents
+            }
+
+            @Override
+            public void onFailure(Throwable throwable) {
+                log.error("Exception in task", throwable);
+            }
+        });
+	}
+-------
+  private mergeCache(Map<String, Set<Object>>
+
+  private static <E> Iterable<E> concat(
+          Iterable<? extends E> i1,
+          Iterable<? extends E> i2) {
+    return new Iterable<E>() {
+      public Iterator<E> iterator() {
+        return new Iterator<E>() {
+          Iterator<? extends E> listIterator = i1.iterator();
+          Boolean checkedHasNext;
+          E nextValue;
+          private boolean startTheSecond;
+
+          void theNext() {
+            if (listIterator.hasNext()) {
+              checkedHasNext = true;
+              nextValue = listIterator.next();
+            } else if (startTheSecond)
+              checkedHasNext = false;
+            else {
+              startTheSecond = true;
+              listIterator = i2.iterator();
+              theNext();
+            }
+          }
+
+          public boolean hasNext() {
+            if (checkedHasNext == null)
+              theNext();
+            return checkedHasNext;
+          }
+
+          public E next() {
+            if (!hasNext())
+              throw new NoSuchElementException();
+            checkedHasNext = null;
+            return nextValue;
+          }
+
+          public void remove() {
+            listIterator.remove();
+          }
+        };
+      }
+    };
+  }
+----------------------------------
+      if ("ttl".equals(methodName) && method.getParameterCount() == 1 && method.getReturnType() == int.class) {
+          Getter getter = (Getter) args[0];
+          if (getter == null) {
+              return false;
+          }
+          HelenusProperty prop = MappingUtil.resolveMappingProperty(getter).getProperty();
+          String getterName = prop.getPropertyName();
+          String ttlKeyForProperty = prop.getColumnName().toCql() + "_ttl";
+          if (src.containsKey(ttlKeyForProperty)) {
+              return src.get(ttlKeyForProperty);
+          } else {
+              return 0;
+          }
+      }
+
+      if ("written".equals(methodName) && method.getParameterCount() == 1 && method.getReturnType() == int.class) {
+          Getter getter = (Getter) args[0];
+          if (getter == null) {
+              return false;
+          }
+          HelenusProperty prop = MappingUtil.resolveMappingProperty(getter).getProperty();
+          String getterName = prop.getPropertyName();
+          String ttlKeyForProperty = prop.getColumnName().toCql() + "_ttl";
+          if (src.containsKey(ttlKeyForProperty)) {
+              return src.get(ttlKeyForProperty);
+          } else {
+              return 0;
+          }
+      }
+
+
+
+-----------------
+
+
+/*else {
+			    Cache<String, Object> cache = session.getSessionCache();
+				Map<String, Object> rowMap = this.cache.rowMap();
+				for (String rowKey : rowMap.keySet()) {
+					String keys = flattenFacets(facets);
+					for (String key : keys) {
+						Object value = cache.getIfPresent(key);
+						if (value != null) {
+							result = Optional.of(value);
+							break;
+						}
+					}
+				}
+			    cache.put
+            }
+			*/
+------------------
+
+InsertOperation
+
+
+		Class<?> iface = entity.getMappingInterface();
+		boolean includesNonIdentityValues = values.stream().map(t -> {
+					ColumnType type = t._1.getProperty().getColumnType();
+					return !((type == ColumnType.PARTITION_KEY) || (type == ColumnType.CLUSTERING_COLUMN));
+				})
+				.reduce(false, (acc, t) -> acc || t);
+		if (resultType == iface) {
+			if (values.size() > 0 && includesNonIdentityValues) {
+				boolean immutable = iface.isAssignableFrom(Drafted.class);
+-------------------
+
+    final Object value;
+    if (method.getParameterCount() == 1 && args[0] instanceof Boolean && src instanceof ValueProviderMap) {
+      value = ((ValueProviderMap)src).get(methodName, (Boolean)args[0]);
+    } else {
+      value = src.get(methodName);
+    }
+--------------------

README.md

@@ -1,5 +1,5 @@
 # Helenus
-Fast and easy, functional style cutting edge Java 8 and Scala 2.11 Cassandra client for C* 3.x
+Fast and easy, functional style cutting edge Java 8 Cassandra client for C* 3.x
 
 
 ### Features
@@ -9,14 +9,13 @@ Fast and easy, functional style cutting edge Java 8 and Scala 2.11 Cassandra cli
 * Reactive asynchronous and synchronous API
 * Provides Java mapping for Tables, Tuples, UDTs (User Defined Type), Collections, UDT Collections, Tuple Collections
 * Uses lazy mapping in all cases where possible
-* Supports Guava ListenableFuture and Scala Future
+* Supports Java 8 Futures and Guava ListenableFuture
 
 ### Requirements
 
 * JVM 8
 * Datastax Driver 3.x
 * Cassandra 3.x
-* Scala 2.11+
 * Maven
 
 ### Maven
@@ -32,27 +31,6 @@ Latest release dependency:
 </dependencies>
 ```
 
-Active development dependency for Scala 2.11:
-```
-<dependencies>
-	<dependency>
-		<groupId>net.helenus</groupId>
-		<artifactId>helenus-core</artifactId>
-		<version>1.2.0_2.11-SNAPSHOT</version>
-	</dependency>
-</dependencies>
-
-<repositories>
-    <repository>
-        <id>oss-sonatype</id>
-        <name>oss-sonatype</name>
-        <url>https://oss.sonatype.org/content/repositories/snapshots/</url>
-        <snapshots>
-            <enabled>true</enabled>
-        </snapshots>
-    </repository>
-</repositories>
-```
 
 ### Simple Example
 
@@ -132,7 +110,6 @@ public interface AbstractRepository {
 
 Account repository:
 ```
-import scala.concurrent.Future;
 
 public interface AccountRepository extends AbstractRepository {
 

bin/deploy.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+
+mvn clean jar:jar javadoc:jar source:jar deploy -Prelease

bin/format.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+
+if [ "X$1" == "Xall" ]; then
+  for f in $(find ./src -name \*.java); do
+    echo Formatting $f
+    java -jar ./lib/google-java-format-1.3-all-deps.jar --replace $f
+  done
+else
+  for file in $(git status --short | awk '{print $2}'); do
+    echo $file
+    java -jar ./lib/google-java-format-1.3-all-deps.jar --replace $file
+  done
+fi
+

bin/sign.sh

@@ -1,3 +1,3 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 mvn clean jar:jar javadoc:jar source:jar install -Prelease

deploy.sh

@@ -1,3 +0,0 @@
-#!/bin/bash
-
-mvn clean jar:jar javadoc:jar source:jar deploy -Prelease 

helenus-core.iml

@@ -11,16 +11,12 @@
     </content>
     <orderEntry type="inheritedJdk" />
     <orderEntry type="sourceFolder" forTests="false" />
-    <orderEntry type="library" name="Maven: io.dropwizard.metrics:metrics-core:3.2.2" level="project" />
-    <orderEntry type="library" scope="TEST" name="Maven: com.github.ben-manes.caffeine:caffeine:2.2.6" level="project" />
-    <orderEntry type="library" name="Maven: org.scala-lang:scala-library:2.13.0-M1" level="project" />
-    <orderEntry type="library" name="Maven: com.datastax.cassandra:cassandra-driver-core:3.3.0" level="project" />
+    <orderEntry type="library" name="Maven: com.datastax.cassandra:cassandra-driver-core:3.3.2" level="project" />
     <orderEntry type="library" name="Maven: io.netty:netty-handler:4.0.47.Final" level="project" />
     <orderEntry type="library" name="Maven: io.netty:netty-buffer:4.0.47.Final" level="project" />
     <orderEntry type="library" name="Maven: io.netty:netty-common:4.0.47.Final" level="project" />
     <orderEntry type="library" name="Maven: io.netty:netty-transport:4.0.47.Final" level="project" />
     <orderEntry type="library" name="Maven: io.netty:netty-codec:4.0.47.Final" level="project" />
-    <orderEntry type="library" name="Maven: io.dropwizard.metrics:metrics-core:3.2.2" level="project" />
     <orderEntry type="library" name="Maven: com.github.jnr:jnr-ffi:2.0.7" level="project" />
     <orderEntry type="library" name="Maven: com.github.jnr:jffi:1.2.10" level="project" />
     <orderEntry type="library" scope="RUNTIME" name="Maven: com.github.jnr:jffi:native:1.2.10" level="project" />
@@ -32,12 +28,15 @@
     <orderEntry type="library" name="Maven: com.github.jnr:jnr-x86asm:1.0.2" level="project" />
     <orderEntry type="library" name="Maven: com.github.jnr:jnr-posix:3.0.27" level="project" />
     <orderEntry type="library" name="Maven: com.github.jnr:jnr-constants:0.9.0" level="project" />
-    <orderEntry type="library" name="Maven: org.aspectj:aspectjrt:1.8.10" level="project" />
+    <orderEntry type="library" name="Maven: com.datastax.cassandra:cassandra-driver-extras:3.3.2" level="project" />
+    <orderEntry type="library" name="Maven: com.diffplug.durian:durian:3.4.0" level="project" />
     <orderEntry type="library" name="Maven: org.aspectj:aspectjweaver:1.8.10" level="project" />
     <orderEntry type="library" name="Maven: org.apache.commons:commons-lang3:3.6" level="project" />
     <orderEntry type="library" name="Maven: org.springframework:spring-core:4.3.10.RELEASE" level="project" />
     <orderEntry type="library" name="Maven: commons-logging:commons-logging:1.2" level="project" />
+    <orderEntry type="library" name="Maven: javax.cache:cache-api:1.1.0" level="project" />
     <orderEntry type="library" name="Maven: com.google.guava:guava:20.0" level="project" />
+    <orderEntry type="library" name="Maven: io.dropwizard.metrics:metrics-core:3.2.2" level="project" />
     <orderEntry type="library" name="Maven: javax.validation:validation-api:2.0.0.CR3" level="project" />
     <orderEntry type="library" scope="TEST" name="Maven: org.codehaus.jackson:jackson-mapper-asl:1.9.13" level="project" />
     <orderEntry type="library" scope="TEST" name="Maven: com.anthemengineering.mojo:infer-maven-plugin:0.1.0" level="project" />
@@ -115,9 +114,9 @@
     <orderEntry type="library" scope="TEST" name="Maven: org.caffinitas.ohc:ohc-core:0.4.4" level="project" />
     <orderEntry type="library" scope="TEST" name="Maven: com.github.ben-manes.caffeine:caffeine:2.2.6" level="project" />
     <orderEntry type="library" scope="TEST" name="Maven: org.jctools:jctools-core:1.2.1" level="project" />
+    <orderEntry type="library" scope="TEST" name="Maven: ca.exprofesso:guava-jcache:1.0.4" level="project" />
     <orderEntry type="library" scope="TEST" name="Maven: commons-io:commons-io:2.5" level="project" />
     <orderEntry type="library" scope="TEST" name="Maven: junit:junit:4.12" level="project" />
-    <orderEntry type="library" scope="TEST" name="Maven: com.github.stephenc:jamm:0.2.5" level="project" />
     <orderEntry type="library" scope="TEST" name="Maven: org.hamcrest:hamcrest-library:1.3" level="project" />
     <orderEntry type="library" scope="TEST" name="Maven: org.hamcrest:hamcrest-core:1.3" level="project" />
     <orderEntry type="library" scope="TEST" name="Maven: org.mockito:mockito-core:2.8.47" level="project" />

pom.xml

@@ -4,8 +4,8 @@
 
     <modelVersion>4.0.0</modelVersion>
     <groupId>net.helenus</groupId>
-    <artifactId>helenus-core</artifactId>
-    <version>2.0.5-SNAPSHOT</version>
+    <artifactId>helenus-net-core</artifactId>
+    <version>2.1</version>
     <packaging>jar</packaging>
 
     <name>helenus</name>
@@ -40,6 +40,9 @@
     <properties>
         <dist.id>helenus</dist.id>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
+        <maven.compiler.target>1.8</maven.compiler.target>
+        <maven.compiler.source>1.8</maven.compiler.source>
     </properties>
 
     <repositories>
@@ -104,21 +107,21 @@
     <dependencies>
 
         <dependency>
-            <groupId>org.scala-lang</groupId>
-            <artifactId>scala-library</artifactId>
-            <version>2.13.0-M1</version>
+            <groupId>com.datastax.cassandra</groupId>
+            <artifactId>cassandra-driver-core</artifactId>
+            <version>3.3.2</version>
         </dependency>
 
         <dependency>
             <groupId>com.datastax.cassandra</groupId>
-            <artifactId>cassandra-driver-core</artifactId>
-            <version>3.3.0</version>
+            <artifactId>cassandra-driver-extras</artifactId>
+            <version>3.3.2</version>
         </dependency>
 
         <dependency>
-            <groupId>org.aspectj</groupId>
-            <artifactId>aspectjrt</artifactId>
-            <version>1.8.10</version>
+            <groupId>com.diffplug.durian</groupId>
+            <artifactId>durian</artifactId>
+            <version>3.4.0</version>
         </dependency>
 
         <dependency>
@@ -139,12 +142,25 @@
             <version>4.3.10.RELEASE</version>
         </dependency>
 
+        <dependency>
+            <groupId>javax.cache</groupId>
+            <artifactId>cache-api</artifactId>
+            <version>1.1.0</version>
+        </dependency>
+
         <dependency>
             <groupId>com.google.guava</groupId>
             <artifactId>guava</artifactId>
             <version>20.0</version>
         </dependency>
 
+        <!-- Metrics -->
+        <dependency>
+            <groupId>io.dropwizard.metrics</groupId>
+            <artifactId>metrics-core</artifactId>
+            <version>3.2.2</version>
+        </dependency>
+
         <!-- Validation -->
         <dependency>
             <groupId>javax.validation</groupId>
@@ -195,6 +211,24 @@
             <scope>test</scope>
         </dependency>
 
+
+        <dependency>
+            <groupId>ca.exprofesso</groupId>
+            <artifactId>guava-jcache</artifactId>
+            <version>1.0.4</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>com.google.guava</groupId>
+                    <artifactId>guava</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>javax.cache</groupId>
+                    <artifactId>cache-api</artifactId>
+                </exclusion>
+            </exclusions>
+            <scope>test</scope>
+        </dependency>
+
         <dependency>
             <groupId>commons-io</groupId>
             <artifactId>commons-io</artifactId>
@@ -209,13 +243,6 @@
             <scope>test</scope>
         </dependency>
 
-        <dependency>
-            <groupId>com.github.stephenc</groupId>
-            <artifactId>jamm</artifactId>
-            <version>0.2.5</version>
-            <scope>test</scope>
-        </dependency>
-
         <dependency>
             <groupId>org.hamcrest</groupId>
             <artifactId>hamcrest-library</artifactId>
@@ -250,7 +277,6 @@
             <version>1.7.1</version>
             <scope>runtime</scope>
         </dependency>
-
     </dependencies>
 
     <build>

src/main/java/com/datastax/driver/core/DefaultMetadata.java

@@ -5,18 +5,19 @@ import java.util.List;
 
 public class DefaultMetadata extends Metadata {
 
-    public DefaultMetadata() { super(null); }
+  public DefaultMetadata() {
+    super(null);
+  }
 
-    private DefaultMetadata(Cluster.Manager cluster) {
-        super(cluster);
-    }
+  private DefaultMetadata(Cluster.Manager cluster) {
+    super(cluster);
+  }
 
-    public TupleType newTupleType(DataType... types) {
-        return newTupleType(Arrays.asList(types));
-    }
-
-    public TupleType newTupleType(List<DataType> types) {
-        return new TupleType(types, ProtocolVersion.NEWEST_SUPPORTED, CodecRegistry.DEFAULT_INSTANCE);
-    }
+  public TupleType newTupleType(DataType... types) {
+    return newTupleType(Arrays.asList(types));
+  }
 
+  public TupleType newTupleType(List<DataType> types) {
+    return new TupleType(types, ProtocolVersion.NEWEST_SUPPORTED, CodecRegistry.DEFAULT_INSTANCE);
+  }
 }

src/main/java/com/datastax/driver/core/querybuilder/IsNotNullClause.java

@@ -0,0 +1,49 @@
+/*
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+package com.datastax.driver.core.querybuilder;
+
+import com.datastax.driver.core.CodecRegistry;
+import java.util.List;
+
+public class IsNotNullClause extends Clause {
+
+  final String name;
+
+  public IsNotNullClause(String name) {
+    this.name = name;
+  }
+
+  @Override
+  String name() {
+    return name;
+  }
+
+  @Override
+  Object firstValue() {
+    return null;
+  }
+
+  @Override
+  void appendTo(StringBuilder sb, List<Object> variables, CodecRegistry codecRegistry) {
+    Utils.appendName(name, sb).append(" IS NOT NULL");
+  }
+
+  @Override
+  boolean containsBindMarker() {
+    return false;
+  }
+}

src/main/java/com/datastax/driver/core/schemabuilder/CreateCustomIndex.java

@@ -1,132 +1,155 @@
 package com.datastax.driver.core.schemabuilder;
 
+import static com.datastax.driver.core.schemabuilder.SchemaStatement.*;
+
 import com.google.common.base.Optional;
 
-import static com.datastax.driver.core.schemabuilder.SchemaStatement.STATEMENT_START;
-import static com.datastax.driver.core.schemabuilder.SchemaStatement.validateNotEmpty;
-import static com.datastax.driver.core.schemabuilder.SchemaStatement.validateNotKeyWord;
-
 public class CreateCustomIndex extends CreateIndex {
 
-    private String indexName;
-    private boolean ifNotExists = false;
-    private Optional<String> keyspaceName = Optional.absent();
-    private String tableName;
-    private String columnName;
-    private boolean keys;
+  private String indexName;
+  private boolean ifNotExists = false;
+  private Optional<String> keyspaceName = Optional.absent();
+  private String tableName;
+  private String columnName;
+  private boolean keys;
 
-    CreateCustomIndex(String indexName) {
-        super(indexName);
-        validateNotEmpty(indexName, "Index name");
-        validateNotKeyWord(indexName, String.format("The index name '%s' is not allowed because it is a reserved keyword", indexName));
-        this.indexName = indexName;
+  CreateCustomIndex(String indexName) {
+    super(indexName);
+    validateNotEmpty(indexName, "Index name");
+    validateNotKeyWord(
+        indexName,
+        String.format(
+            "The index name '%s' is not allowed because it is a reserved keyword", indexName));
+    this.indexName = indexName;
+  }
+
+  /**
+   * Add the 'IF NOT EXISTS' condition to this CREATE INDEX statement.
+   *
+   * @return this CREATE INDEX statement.
+   */
+  public CreateIndex ifNotExists() {
+    this.ifNotExists = true;
+    return this;
+  }
+
+  /**
+   * Specify the keyspace and table to create the index on.
+   *
+   * @param keyspaceName the keyspace name.
+   * @param tableName the table name.
+   * @return a {@link CreateIndex.CreateIndexOn} that will allow the specification of the column.
+   */
+  public CreateIndex.CreateIndexOn onTable(String keyspaceName, String tableName) {
+    validateNotEmpty(keyspaceName, "Keyspace name");
+    validateNotEmpty(tableName, "Table name");
+    validateNotKeyWord(
+        keyspaceName,
+        String.format(
+            "The keyspace name '%s' is not allowed because it is a reserved keyword",
+            keyspaceName));
+    validateNotKeyWord(
+        tableName,
+        String.format(
+            "The table name '%s' is not allowed because it is a reserved keyword", tableName));
+    this.keyspaceName = Optional.fromNullable(keyspaceName);
+    this.tableName = tableName;
+    return new CreateCustomIndex.CreateIndexOn();
+  }
+
+  /**
+   * Specify the table to create the index on.
+   *
+   * @param tableName the table name.
+   * @return a {@link CreateIndex.CreateIndexOn} that will allow the specification of the column.
+   */
+  public CreateIndex.CreateIndexOn onTable(String tableName) {
+    validateNotEmpty(tableName, "Table name");
+    validateNotKeyWord(
+        tableName,
+        String.format(
+            "The table name '%s' is not allowed because it is a reserved keyword", tableName));
+    this.tableName = tableName;
+    return new CreateCustomIndex.CreateIndexOn();
+  }
+
+  String getCustomClassName() {
+    return "";
+  }
+
+  String getOptions() {
+    return "";
+  }
+
+  @Override
+  public String buildInternal() {
+    StringBuilder createStatement =
+        new StringBuilder(STATEMENT_START).append("CREATE CUSTOM INDEX ");
+
+    if (ifNotExists) {
+      createStatement.append("IF NOT EXISTS ");
+    }
+
+    createStatement.append(indexName).append(" ON ");
+
+    if (keyspaceName.isPresent()) {
+      createStatement.append(keyspaceName.get()).append(".");
+    }
+    createStatement.append(tableName);
+
+    createStatement.append("(");
+    if (keys) {
+      createStatement.append("KEYS(");
+    }
+
+    createStatement.append(columnName);
+
+    if (keys) {
+      createStatement.append(")");
+    }
+    createStatement.append(")");
+
+    createStatement.append(" USING '");
+    createStatement.append(getCustomClassName());
+    createStatement.append("' WITH OPTIONS = {");
+    createStatement.append(getOptions());
+    createStatement.append(" }");
+
+    return createStatement.toString();
+  }
+
+  public class CreateIndexOn extends CreateIndex.CreateIndexOn {
+    /**
+     * Specify the column to create the index on.
+     *
+     * @param columnName the column name.
+     * @return the final CREATE INDEX statement.
+     */
+    public SchemaStatement andColumn(String columnName) {
+      validateNotEmpty(columnName, "Column name");
+      validateNotKeyWord(
+          columnName,
+          String.format(
+              "The column name '%s' is not allowed because it is a reserved keyword", columnName));
+      CreateCustomIndex.this.columnName = columnName;
+      return SchemaStatement.fromQueryString(buildInternal());
     }
 
     /**
-     * Add the 'IF NOT EXISTS' condition to this CREATE INDEX statement.
+     * Create an index on the keys of the given map column.
      *
-     * @return this CREATE INDEX statement.
+     * @param columnName the column name.
+     * @return the final CREATE INDEX statement.
      */
-    public CreateIndex ifNotExists() {
-        this.ifNotExists = true;
-        return this;
-    }
-
-    /**
-     * Specify the keyspace and table to create the index on.
-     *
-     * @param keyspaceName the keyspace name.
-     * @param tableName    the table name.
-     * @return a {@link CreateIndex.CreateIndexOn} that will allow the specification of the column.
-     */
-    public CreateIndex.CreateIndexOn onTable(String keyspaceName, String tableName) {
-        validateNotEmpty(keyspaceName, "Keyspace name");
-        validateNotEmpty(tableName, "Table name");
-        validateNotKeyWord(keyspaceName, String.format("The keyspace name '%s' is not allowed because it is a reserved keyword", keyspaceName));
-        validateNotKeyWord(tableName, String.format("The table name '%s' is not allowed because it is a reserved keyword", tableName));
-        this.keyspaceName = Optional.fromNullable(keyspaceName);
-        this.tableName = tableName;
-        return new CreateCustomIndex.CreateIndexOn();
-    }
-
-    /**
-     * Specify the table to create the index on.
-     *
-     * @param tableName the table name.
-     * @return a {@link CreateIndex.CreateIndexOn} that will allow the specification of the column.
-     */
-    public CreateIndex.CreateIndexOn onTable(String tableName) {
-        validateNotEmpty(tableName, "Table name");
-        validateNotKeyWord(tableName, String.format("The table name '%s' is not allowed because it is a reserved keyword", tableName));
-        this.tableName = tableName;
-        return new CreateCustomIndex.CreateIndexOn();
-    }
-
-    public class CreateIndexOn extends CreateIndex.CreateIndexOn {
-        /**
-         * Specify the column to create the index on.
-         *
-         * @param columnName the column name.
-         * @return the final CREATE INDEX statement.
-         */
-        public SchemaStatement andColumn(String columnName) {
-            validateNotEmpty(columnName, "Column name");
-            validateNotKeyWord(columnName, String.format("The column name '%s' is not allowed because it is a reserved keyword", columnName));
-            CreateCustomIndex.this.columnName = columnName;
-            return SchemaStatement.fromQueryString(buildInternal());
-        }
-
-        /**
-         * Create an index on the keys of the given map column.
-         *
-         * @param columnName the column name.
-         * @return the final CREATE INDEX statement.
-         */
-        public SchemaStatement andKeysOfColumn(String columnName) {
-            validateNotEmpty(columnName, "Column name");
-            validateNotKeyWord(columnName, String.format("The column name '%s' is not allowed because it is a reserved keyword", columnName));
-            CreateCustomIndex.this.columnName = columnName;
-            CreateCustomIndex.this.keys = true;
-            return SchemaStatement.fromQueryString(buildInternal());
-        }
-    }
-
-    String getCustomClassName() { return ""; }
-    String getOptions() { return ""; }
-
-    @Override
-    public String buildInternal() {
-        StringBuilder createStatement = new StringBuilder(STATEMENT_START).append("CREATE CUSTOM INDEX ");
-
-        if (ifNotExists) {
-            createStatement.append("IF NOT EXISTS ");
-        }
-
-        createStatement.append(indexName).append(" ON ");
-
-        if (keyspaceName.isPresent()) {
-            createStatement.append(keyspaceName.get()).append(".");
-        }
-        createStatement.append(tableName);
-
-        createStatement.append("(");
-        if (keys) {
-            createStatement.append("KEYS(");
-        }
-
-        createStatement.append(columnName);
-
-        if (keys) {
-            createStatement.append(")");
-        }
-        createStatement.append(")");
-
-        createStatement.append(" USING '");
-        createStatement.append(getCustomClassName());
-        createStatement.append("' WITH OPTIONS = {");
-        createStatement.append(getOptions());
-        createStatement.append(" }");
-
-        return createStatement.toString();
+    public SchemaStatement andKeysOfColumn(String columnName) {
+      validateNotEmpty(columnName, "Column name");
+      validateNotKeyWord(
+          columnName,
+          String.format(
+              "The column name '%s' is not allowed because it is a reserved keyword", columnName));
+      CreateCustomIndex.this.columnName = columnName;
+      CreateCustomIndex.this.keys = true;
+      return SchemaStatement.fromQueryString(buildInternal());
     }
+  }
 }

src/main/java/com/datastax/driver/core/schemabuilder/CreateMaterializedView.java

@@ -0,0 +1,57 @@
+package com.datastax.driver.core.schemabuilder;
+
+import com.datastax.driver.core.CodecRegistry;
+import com.datastax.driver.core.querybuilder.Select;
+
+public class CreateMaterializedView extends Create {
+
+  private final String viewName;
+  private Select.Where selection;
+  private String primaryKey;
+  private String clustering;
+
+  public CreateMaterializedView(
+      String keyspaceName,
+      String viewName,
+      Select.Where selection,
+      String primaryKey,
+      String clustering) {
+    super(keyspaceName, viewName);
+    this.viewName = viewName;
+    this.selection = selection;
+    this.primaryKey = primaryKey;
+    this.clustering = clustering;
+  }
+
+  public String getQueryString(CodecRegistry codecRegistry) {
+    return buildInternal();
+  }
+
+  public String buildInternal() {
+    StringBuilder createStatement =
+        new StringBuilder(STATEMENT_START).append("CREATE MATERIALIZED VIEW");
+    if (ifNotExists) {
+      createStatement.append(" IF NOT EXISTS");
+    }
+    createStatement.append(" ");
+    if (keyspaceName.isPresent()) {
+      createStatement.append(keyspaceName.get()).append(".");
+    }
+    createStatement.append(viewName);
+    createStatement.append(" AS ");
+    createStatement.append(selection.getQueryString());
+    createStatement.setLength(createStatement.length() - 1);
+    createStatement.append(" ");
+    createStatement.append(primaryKey);
+    if (clustering != null) {
+      createStatement.append(" ").append(clustering);
+    }
+    createStatement.append(";");
+
+    return createStatement.toString();
+  }
+
+  public String toString() {
+    return buildInternal();
+  }
+}

src/main/java/com/datastax/driver/core/schemabuilder/CreateSasiIndex.java

@@ -2,17 +2,17 @@ package com.datastax.driver.core.schemabuilder;
 
 public class CreateSasiIndex extends CreateCustomIndex {
 
-    public CreateSasiIndex(String indexName) {
-        super(indexName);
-    }
+  public CreateSasiIndex(String indexName) {
+    super(indexName);
+  }
 
-    String getCustomClassName() {
-        return "org.apache.cassandra.index.sasi.SASIIndex";
-    }
+  String getCustomClassName() {
+    return "org.apache.cassandra.index.sasi.SASIIndex";
+  }
 
-    String getOptions() {
-        return "'analyzer_class': "
-                + "'org.apache.cassandra.index.sasi.analyzer.NonTokenizingAnalyzer', "
-                + "'case_sensitive': 'false'";
-    }
+  String getOptions() {
+    return "'analyzer_class': "
+        + "'org.apache.cassandra.index.sasi.analyzer.NonTokenizingAnalyzer', "
+        + "'case_sensitive': 'false'";
+  }
 }

src/main/java/com/datastax/driver/core/schemabuilder/CreateTable.java

@@ -17,24 +17,22 @@ package com.datastax.driver.core.schemabuilder;
 
 import com.datastax.driver.core.CodecRegistry;
 
-/**
- * A built CREATE TABLE statement.
- */
+/** A built CREATE TABLE statement. */
 public class CreateTable extends Create {
 
-    public CreateTable(String keyspaceName, String tableName) {
-        super(keyspaceName, tableName);
-    }
+  public CreateTable(String keyspaceName, String tableName) {
+    super(keyspaceName, tableName);
+  }
 
-    public CreateTable(String tableName) {
-        super(tableName);
-    }
+  public CreateTable(String tableName) {
+    super(tableName);
+  }
 
-    public String getQueryString(CodecRegistry codecRegistry) {
-        return buildInternal();
-    }
+  public String getQueryString(CodecRegistry codecRegistry) {
+    return buildInternal();
+  }
 
-    public String toString() {
-        return buildInternal();
-    }
+  public String toString() {
+    return buildInternal();
+  }
 }

src/main/java/com/datastax/driver/core/schemabuilder/DropMaterializedView.java

@@ -0,0 +1,52 @@
+package com.datastax.driver.core.schemabuilder;
+
+import com.google.common.base.Optional;
+
+public class DropMaterializedView extends Drop {
+
+  private Optional<String> keyspaceName = Optional.absent();
+  private String itemName;
+  private boolean ifExists = true;
+
+  public DropMaterializedView(String keyspaceName, String viewName) {
+    this(keyspaceName, viewName, DroppedItem.MATERIALIZED_VIEW);
+  }
+
+  private DropMaterializedView(String keyspaceName, String viewName, DroppedItem itemType) {
+    super(keyspaceName, viewName, Drop.DroppedItem.TABLE);
+    validateNotEmpty(keyspaceName, "Keyspace name");
+    this.keyspaceName = Optional.fromNullable(keyspaceName);
+    this.itemName = viewName;
+  }
+
+  /**
+   * Add the 'IF EXISTS' condition to this DROP statement.
+   *
+   * @return this statement.
+   */
+  public Drop ifExists() {
+    this.ifExists = true;
+    return this;
+  }
+
+  @Override
+  public String buildInternal() {
+    StringBuilder dropStatement = new StringBuilder("DROP MATERIALIZED VIEW ");
+    if (ifExists) {
+      dropStatement.append("IF EXISTS ");
+    }
+    if (keyspaceName.isPresent()) {
+      dropStatement.append(keyspaceName.get()).append(".");
+    }
+
+    dropStatement.append(itemName);
+    return dropStatement.toString();
+  }
+
+  enum DroppedItem {
+    TABLE,
+    TYPE,
+    INDEX,
+    MATERIALIZED_VIEW
+  }
+}

src/main/java/net/helenus/config/DefaultHelenusSettings.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -17,7 +18,6 @@ package net.helenus.config;
 
 import java.lang.reflect.Method;
 import java.util.function.Function;
-
 import net.helenus.core.DslInstantiator;
 import net.helenus.core.MapperInstantiator;
 import net.helenus.core.reflect.ReflectionDslInstantiator;
@@ -26,24 +26,23 @@ import net.helenus.mapping.convert.CamelCaseToUnderscoreConverter;
 
 public class DefaultHelenusSettings implements HelenusSettings {
 
-	@Override
-	public Function<String, String> getPropertyToColumnConverter() {
-		return CamelCaseToUnderscoreConverter.INSTANCE;
-	}
+  @Override
+  public Function<String, String> getPropertyToColumnConverter() {
+    return CamelCaseToUnderscoreConverter.INSTANCE;
+  }
 
-	@Override
-	public Function<Method, Boolean> getGetterMethodDetector() {
-		return GetterMethodDetector.INSTANCE;
-	}
+  @Override
+  public Function<Method, Boolean> getGetterMethodDetector() {
+    return GetterMethodDetector.INSTANCE;
+  }
 
-	@Override
-	public DslInstantiator getDslInstantiator() {
-		return ReflectionDslInstantiator.INSTANCE;
-	}
-
-	@Override
-	public MapperInstantiator getMapperInstantiator() {
-		return ReflectionMapperInstantiator.INSTANCE;
-	}
+  @Override
+  public DslInstantiator getDslInstantiator() {
+    return ReflectionDslInstantiator.INSTANCE;
+  }
 
+  @Override
+  public MapperInstantiator getMapperInstantiator() {
+    return ReflectionMapperInstantiator.INSTANCE;
+  }
 }

src/main/java/net/helenus/config/GetterMethodDetector.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,33 +16,34 @@
  */
 package net.helenus.config;
 
+import java.lang.reflect.Method;
+import java.lang.reflect.Modifier;
+import java.util.function.Function;
 import net.helenus.mapping.annotation.Transient;
 
-import java.lang.reflect.Method;
-import java.util.function.Function;
-
 public enum GetterMethodDetector implements Function<Method, Boolean> {
+  INSTANCE;
 
-	INSTANCE;
+  @Override
+  public Boolean apply(Method method) {
 
-	@Override
-	public Boolean apply(Method method) {
+    if (method == null) {
+      throw new IllegalArgumentException("empty parameter");
+    }
 
-		if (method == null) {
-			throw new IllegalArgumentException("empty parameter");
-		}
+    if (method.getParameterCount() != 0 || method.getReturnType() == void.class) {
+      return false;
+    }
 
-		if (method.getParameterCount() != 0 || method.getReturnType() == void.class) {
-			return false;
-		}
+    if (Modifier.isStatic(method.getModifiers())) {
+      return false;
+    }
 
-		// Methods marked "Transient" are not mapped, skip them.
-		if (method.getDeclaredAnnotation(Transient.class) != null) {
-			return false;
-		}
-
-		return true;
-
-	}
+    // Methods marked "Transient" are not mapped, skip them.
+    if (method.getDeclaredAnnotation(Transient.class) != null) {
+      return false;
+    }
 
+    return true;
+  }
 }

src/main/java/net/helenus/config/HelenusSettings.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -17,18 +18,16 @@ package net.helenus.config;
 
 import java.lang.reflect.Method;
 import java.util.function.Function;
-
 import net.helenus.core.DslInstantiator;
 import net.helenus.core.MapperInstantiator;
 
 public interface HelenusSettings {
 
-	Function<String, String> getPropertyToColumnConverter();
+  Function<String, String> getPropertyToColumnConverter();
 
-	Function<Method, Boolean> getGetterMethodDetector();
+  Function<Method, Boolean> getGetterMethodDetector();
 
-	DslInstantiator getDslInstantiator();
-
-	MapperInstantiator getMapperInstantiator();
+  DslInstantiator getDslInstantiator();
 
+  MapperInstantiator getMapperInstantiator();
 }

src/main/java/net/helenus/core/AbstractAuditedEntityDraft.java

@@ -0,0 +1,38 @@
+package net.helenus.core;
+
+import java.time.LocalDateTime;
+import java.time.ZoneId;
+import java.util.Date;
+import net.helenus.core.reflect.MapExportable;
+
+public abstract class AbstractAuditedEntityDraft<E> extends AbstractEntityDraft<E> {
+
+  public AbstractAuditedEntityDraft(MapExportable entity) {
+    super(entity);
+
+    Date in = new Date();
+    LocalDateTime ldt = LocalDateTime.ofInstant(in.toInstant(), ZoneId.systemDefault());
+    Date now = Date.from(ldt.atZone(ZoneId.systemDefault()).toInstant());
+
+    String who = getCurrentAuditor();
+
+    if (entity == null) {
+      if (who != null) {
+        set("createdBy", who);
+      }
+      set("createdAt", now);
+    }
+    if (who != null) {
+      set("modifiedBy", who);
+    }
+    set("modifiedAt", now);
+  }
+
+  protected String getCurrentAuditor() {
+    return null;
+  }
+
+  public Date createdAt() {
+    return get("createdAt", Date.class);
+  }
+}

src/main/java/net/helenus/core/AbstractEntityDraft.java

@@ -0,0 +1,202 @@
+package net.helenus.core;
+
+import com.google.common.primitives.Primitives;
+import java.io.Serializable;
+import java.util.Collection;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+import net.helenus.core.reflect.DefaultPrimitiveTypes;
+import net.helenus.core.reflect.Drafted;
+import net.helenus.core.reflect.MapExportable;
+import net.helenus.mapping.HelenusProperty;
+import net.helenus.mapping.MappingUtil;
+import org.apache.commons.lang3.SerializationUtils;
+
+public abstract class AbstractEntityDraft<E> implements Drafted<E> {
+
+  private final MapExportable entity;
+  private final Map<String, Object> valuesMap;
+  private final Set<String> readSet;
+  private final Map<String, Object> mutationsMap = new HashMap<String, Object>();
+
+  public AbstractEntityDraft(MapExportable entity) {
+    this.entity = entity;
+    // Entities can mutate their map.
+    if (entity != null) {
+      this.valuesMap = entity.toMap(true);
+      this.readSet = entity.toReadSet();
+    } else {
+      this.valuesMap = new HashMap<String, Object>();
+      this.readSet = new HashSet<String>();
+    }
+  }
+
+  public abstract Class<E> getEntityClass();
+
+  public E build() {
+    return Helenus.map(getEntityClass(), toMap());
+  }
+
+  @SuppressWarnings("unchecked")
+  public <T> T get(Getter<T> getter, Class<?> returnType) {
+    return (T) get(this.<T>methodNameFor(getter), returnType);
+  }
+
+  @SuppressWarnings("unchecked")
+  public <T> T get(String key, Class<?> returnType) {
+    readSet.add(key);
+    T value = (T) mutationsMap.get(key);
+
+    if (value == null) {
+      value = (T) valuesMap.get(key);
+      if (value == null) {
+
+        if (Primitives.allPrimitiveTypes().contains(returnType)) {
+
+          DefaultPrimitiveTypes type = DefaultPrimitiveTypes.lookup(returnType);
+          if (type == null) {
+            throw new RuntimeException("unknown primitive type " + returnType);
+          }
+
+          return (T) type.getDefaultValue();
+        }
+      } else {
+        // Collections fetched from the valuesMap
+        if (value instanceof Collection) {
+          value = (T) SerializationUtils.<Serializable>clone((Serializable) value);
+        }
+      }
+    }
+
+    return value;
+  }
+
+  public <T> Object set(Getter<T> getter, Object value) {
+    HelenusProperty prop = MappingUtil.resolveMappingProperty(getter).getProperty();
+    String key = prop.getPropertyName();
+
+    HelenusValidator.INSTANCE.validate(prop, value);
+
+    if (key == null || value == null) {
+      return null;
+    }
+
+    mutationsMap.put(key, value);
+    return value;
+  }
+
+  public Object set(String key, Object value) {
+    if (key == null || value == null) {
+      return null;
+    }
+
+    mutationsMap.put(key, value);
+    return value;
+  }
+
+  public void put(String key, Object value) {
+    mutationsMap.put(key, value);
+  }
+
+  @SuppressWarnings("unchecked")
+  public <T> T mutate(Getter<T> getter, T value) {
+    return (T) mutate(this.<T>methodNameFor(getter), value);
+  }
+
+  public <T> T mutate(String key, T value) {
+    Objects.requireNonNull(key);
+
+    if (value != null) {
+      if (entity != null) {
+        T currentValue = this.<T>fetch(key);
+        if (!value.equals(currentValue)) {
+          mutationsMap.put(key, value);
+          return value;
+        }
+      } else {
+        mutationsMap.put(key, value);
+      }
+    }
+    return null;
+  }
+
+  private <T> String methodNameFor(Getter<T> getter) {
+    return MappingUtil.resolveMappingProperty(getter).getProperty().getPropertyName();
+  }
+
+  public <T> Object unset(Getter<T> getter) {
+    return unset(methodNameFor(getter));
+  }
+
+  public Object unset(String key) {
+    if (key != null) {
+      Object value = mutationsMap.get(key);
+      mutationsMap.put(key, null);
+      return value;
+    }
+    return null;
+  }
+
+  public <T> boolean reset(Getter<T> getter, T desiredValue) {
+    return this.<T>reset(this.<T>methodNameFor(getter), desiredValue);
+  }
+
+  private <T> T fetch(String key) {
+    T value = (T) mutationsMap.get(key);
+    if (value == null) {
+      value = (T) valuesMap.get(key);
+    }
+    return value;
+  }
+
+  public <T> boolean reset(String key, T desiredValue) {
+    if (key != null && desiredValue != null) {
+      @SuppressWarnings("unchecked")
+      T currentValue = (T) this.<T>fetch(key);
+      if (currentValue == null || !currentValue.equals(desiredValue)) {
+        set(key, desiredValue);
+        return true;
+      }
+    }
+    return false;
+  }
+
+  @Override
+  public Map<String, Object> toMap() {
+    return toMap(valuesMap);
+  }
+
+  public Map<String, Object> toMap(Map<String, Object> entityMap) {
+    Map<String, Object> combined;
+    if (entityMap != null && entityMap.size() > 0) {
+      combined = new HashMap<String, Object>(entityMap.size());
+      for (Map.Entry<String, Object> e : entityMap.entrySet()) {
+        combined.put(e.getKey(), e.getValue());
+      }
+    } else {
+      combined = new HashMap<String, Object>(mutationsMap.size());
+    }
+    for (String key : mutated()) {
+      combined.put(key, mutationsMap.get(key));
+    }
+    return combined;
+  }
+
+  @Override
+  public Set<String> mutated() {
+    return mutationsMap.keySet();
+  }
+
+  @Override
+  public Set<String> read() {
+    return readSet;
+  }
+
+  @Override
+  public String toString() {
+    return mutationsMap.toString();
+  }
+}

src/main/java/net/helenus/core/AbstractSessionOperations.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,134 +16,118 @@
  */
 package net.helenus.core;
 
+import com.codahale.metrics.MetricRegistry;
+import com.datastax.driver.core.*;
+import com.google.common.base.Stopwatch;
+import com.google.common.collect.Table;
+import com.google.common.util.concurrent.ListenableFuture;
 import java.io.PrintStream;
+import java.util.List;
 import java.util.concurrent.Executor;
-
-import com.datastax.driver.core.schemabuilder.SchemaStatement;
+import net.helenus.core.cache.Facet;
+import net.helenus.mapping.value.ColumnValuePreparer;
+import net.helenus.mapping.value.ColumnValueProvider;
+import net.helenus.support.Either;
+import net.helenus.support.HelenusException;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
-import com.datastax.driver.core.*;
-import com.datastax.driver.core.querybuilder.BuiltStatement;
-import com.google.common.util.concurrent.ListenableFuture;
-
-import net.helenus.mapping.value.ColumnValuePreparer;
-import net.helenus.mapping.value.ColumnValueProvider;
-import net.helenus.support.HelenusException;
-
-import javax.xml.validation.Schema;
-
 public abstract class AbstractSessionOperations {
 
-	final Logger logger = LoggerFactory.getLogger(getClass());
+  private static final Logger LOG = LoggerFactory.getLogger(AbstractSessionOperations.class);
 
-	abstract public Session currentSession();
+  public abstract Session currentSession();
 
-	abstract public String usingKeyspace();
+  public abstract String usingKeyspace();
 
-	abstract public boolean isShowCql();
+  public abstract boolean isShowCql();
 
-	abstract public PrintStream getPrintStream();
+  public abstract boolean showValues();
 
-	abstract public Executor getExecutor();
+  public abstract PrintStream getPrintStream();
 
-	abstract public SessionRepository getSessionRepository();
+  public abstract Executor getExecutor();
 
-	abstract public ColumnValueProvider getValueProvider();
+  public abstract SessionRepository getSessionRepository();
 
-	abstract public ColumnValuePreparer getValuePreparer();
+  public abstract ColumnValueProvider getValueProvider();
 
-	public PreparedStatement prepare(RegularStatement statement) {
+  public abstract ColumnValuePreparer getValuePreparer();
 
-		try {
+  public abstract ConsistencyLevel getDefaultConsistencyLevel();
 
-			log(statement, false);
+  public abstract boolean getDefaultQueryIdempotency();
 
-			return currentSession().prepare(statement);
+  public PreparedStatement prepare(RegularStatement statement) {
+    try {
+      return currentSession().prepare(statement);
+    } catch (RuntimeException e) {
+      throw translateException(e);
+    }
+  }
 
-		} catch (RuntimeException e) {
-			throw translateException(e);
-		}
+  public ListenableFuture<PreparedStatement> prepareAsync(RegularStatement statement) {
+    try {
+      return currentSession().prepareAsync(statement);
+    } catch (RuntimeException e) {
+      throw translateException(e);
+    }
+  }
 
-	}
+  public ResultSet execute(Statement statement) {
+    return execute(statement, null, null);
+  }
 
-	public ListenableFuture<PreparedStatement> prepareAsync(RegularStatement statement) {
+  public ResultSet execute(Statement statement, Stopwatch timer) {
+    return execute(statement, null, timer);
+  }
 
-		try {
+  public ResultSet execute(Statement statement, UnitOfWork uow) {
+    return execute(statement, uow, null);
+  }
 
-			log(statement, false);
+  public ResultSet execute(Statement statement, UnitOfWork uow, Stopwatch timer) {
+    return executeAsync(statement, uow, timer).getUninterruptibly();
+  }
 
-			return currentSession().prepareAsync(statement);
+  public ResultSetFuture executeAsync(Statement statement) {
+    return executeAsync(statement, null, null);
+  }
 
-		} catch (RuntimeException e) {
-			throw translateException(e);
-		}
+  public ResultSetFuture executeAsync(Statement statement, Stopwatch timer) {
+    return executeAsync(statement, null, timer);
+  }
 
-	}
+  public ResultSetFuture executeAsync(Statement statement, UnitOfWork uow) {
+    return executeAsync(statement, uow, null);
+  }
 
-	public ResultSet execute(Statement statement, boolean showValues) {
+  public ResultSetFuture executeAsync(Statement statement, UnitOfWork uow, Stopwatch timer) {
+    try {
+      return currentSession().executeAsync(statement);
+    } catch (RuntimeException e) {
+      throw translateException(e);
+    }
+  }
 
-		return executeAsync(statement, showValues).getUninterruptibly();
+  public MetricRegistry getMetricRegistry() {
+    return null;
+  }
 
-	}
+  public void mergeCache(Table<String, String, Either<Object, List<Facet>>> uowCache) {}
 
-	public ResultSetFuture executeAsync(Statement statement, boolean showValues) {
+  RuntimeException translateException(RuntimeException e) {
+    if (e instanceof HelenusException) {
+      return e;
+    }
+    throw new HelenusException(e);
+  }
 
-		try {
+  public Object checkCache(String tableName, List<Facet> facets) {
+    return null;
+  }
 
-			log(statement, showValues);
-
-			return currentSession().executeAsync(statement);
-
-		} catch (RuntimeException e) {
-			throw translateException(e);
-		}
-
-	}
-
-	void log(Statement statement, boolean showValues) {
-
-		if (logger.isInfoEnabled()) {
-			logger.info("Execute statement " + statement);
-		}
-
-		if (isShowCql()) {
-
-			if (statement instanceof BuiltStatement) {
-
-                BuiltStatement builtStatement = (BuiltStatement) statement;
-
-                if (showValues) {
-                    RegularStatement regularStatement = builtStatement.setForceNoValues(true);
-                    printCql(regularStatement.getQueryString());
-                } else {
-                    printCql(builtStatement.getQueryString());
-                }
-
-			} else if (statement instanceof RegularStatement) {
-				RegularStatement regularStatement = (RegularStatement) statement;
-				printCql(regularStatement.getQueryString());
-			} else {
-				printCql(statement.toString());
-			}
-
-		}
-	}
-
-	public void cache(String key, Object value) {
-	}
-
-	RuntimeException translateException(RuntimeException e) {
-
-		if (e instanceof HelenusException) {
-			return e;
-		}
-
-		throw new HelenusException(e);
-	}
-
-	void printCql(String cql) {
-		getPrintStream().println(cql);
-	}
+  public void updateCache(Object pojo, List<Facet> facets) {}
 
+  public void cacheEvict(List<Facet> facets) {}
 }

src/main/java/net/helenus/core/AutoDdl.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -16,5 +17,8 @@
 package net.helenus.core;
 
 public enum AutoDdl {
-	VALIDATE, UPDATE, CREATE, CREATE_DROP;
+  VALIDATE,
+  UPDATE,
+  CREATE,
+  CREATE_DROP;
 }

src/main/java/net/helenus/core/ConflictingUnitOfWorkException.java

@@ -1,11 +1,27 @@
+/*
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+
 package net.helenus.core;
 
 public class ConflictingUnitOfWorkException extends Exception {
 
-	final UnitOfWork uow;
-
-	ConflictingUnitOfWorkException(UnitOfWork uow) {
-		this.uow = uow;
-	}
+  final UnitOfWork uow;
 
+  ConflictingUnitOfWorkException(UnitOfWork uow) {
+    this.uow = uow;
+  }
 }

src/main/java/net/helenus/core/DslInstantiator.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,13 +16,15 @@
  */
 package net.helenus.core;
 
-import java.util.Optional;
-
 import com.datastax.driver.core.Metadata;
+import java.util.Optional;
 import net.helenus.core.reflect.HelenusPropertyNode;
 
 public interface DslInstantiator {
 
-	<E> E instantiate(Class<E> iface, ClassLoader classLoader, Optional<HelenusPropertyNode> parent, Metadata metadata);
-
+  <E> E instantiate(
+      Class<E> iface,
+      ClassLoader classLoader,
+      Optional<HelenusPropertyNode> parent,
+      Metadata metadata);
 }

src/main/java/net/helenus/core/Filter.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,99 +16,108 @@
  */
 package net.helenus.core;
 
-import java.util.Objects;
-
 import com.datastax.driver.core.querybuilder.Clause;
-
+import java.util.Objects;
 import net.helenus.core.reflect.HelenusPropertyNode;
 import net.helenus.mapping.MappingUtil;
 import net.helenus.mapping.value.ColumnValuePreparer;
 
 public final class Filter<V> {
 
-	private final HelenusPropertyNode node;
-	private final Postulate<V> postulate;
+  private final HelenusPropertyNode node;
+  private final Postulate<V> postulate;
 
-	private Filter(HelenusPropertyNode node, Postulate<V> postulate) {
-		this.node = node;
-		this.postulate = postulate;
-	}
+  private Filter(HelenusPropertyNode node, Postulate<V> postulate) {
+    this.node = node;
+    this.postulate = postulate;
+  }
 
-	public HelenusPropertyNode getNode() {
-		return node;
-	}
+  public static <V> Filter<V> equal(Getter<V> getter, V val) {
+    return create(getter, Operator.EQ, val);
+  }
 
-	public Clause getClause(ColumnValuePreparer valuePreparer) {
-		return postulate.getClause(node, valuePreparer);
-	}
+  public static <V> Filter<V> in(Getter<V> getter, V... vals) {
+    Objects.requireNonNull(getter, "empty getter");
+    Objects.requireNonNull(vals, "empty values");
 
-	public static <V> Filter<V> equal(Getter<V> getter, V val) {
-		return create(getter, Operator.EQ, val);
-	}
+    if (vals.length == 0) {
+      throw new IllegalArgumentException("values array is empty");
+    }
 
-	public static <V> Filter<V> in(Getter<V> getter, V... vals) {
-		Objects.requireNonNull(getter, "empty getter");
-		Objects.requireNonNull(vals, "empty values");
+    for (int i = 0; i != vals.length; ++i) {
+      Objects.requireNonNull(vals[i], "value[" + i + "] is empty");
+    }
 
-		if (vals.length == 0) {
-			throw new IllegalArgumentException("values array is empty");
-		}
+    HelenusPropertyNode node = MappingUtil.resolveMappingProperty(getter);
 
-		for (int i = 0; i != vals.length; ++i) {
-			Objects.requireNonNull(vals[i], "value[" + i + "] is empty");
-		}
+    Postulate<V> postulate = Postulate.of(Operator.IN, vals);
 
-		HelenusPropertyNode node = MappingUtil.resolveMappingProperty(getter);
+    return new Filter<V>(node, postulate);
+  }
 
-		Postulate<V> postulate = Postulate.of(Operator.IN, vals);
+  public static <V> Filter<V> greaterThan(Getter<V> getter, V val) {
+    return create(getter, Operator.GT, val);
+  }
 
-		return new Filter<V>(node, postulate);
-	}
+  public static <V> Filter<V> lessThan(Getter<V> getter, V val) {
+    return create(getter, Operator.LT, val);
+  }
 
-	public static <V> Filter<V> greaterThan(Getter<V> getter, V val) {
-		return create(getter, Operator.GT, val);
-	}
+  public static <V> Filter<V> greaterThanOrEqual(Getter<V> getter, V val) {
+    return create(getter, Operator.GTE, val);
+  }
 
-	public static <V> Filter<V> lessThan(Getter<V> getter, V val) {
-		return create(getter, Operator.LT, val);
-	}
+  public static <V> Filter<V> lessThanOrEqual(Getter<V> getter, V val) {
+    return create(getter, Operator.LTE, val);
+  }
 
-	public static <V> Filter<V> greaterThanOrEqual(Getter<V> getter, V val) {
-		return create(getter, Operator.GTE, val);
-	}
+  public static <V> Filter<V> create(Getter<V> getter, Postulate<V> postulate) {
+    Objects.requireNonNull(getter, "empty getter");
+    Objects.requireNonNull(postulate, "empty operator");
 
-	public static <V> Filter<V> lessThanOrEqual(Getter<V> getter, V val) {
-		return create(getter, Operator.LTE, val);
-	}
+    HelenusPropertyNode node = MappingUtil.resolveMappingProperty(getter);
 
-	public static <V> Filter<V> create(Getter<V> getter, Postulate<V> postulate) {
-		Objects.requireNonNull(getter, "empty getter");
-		Objects.requireNonNull(postulate, "empty operator");
+    return new Filter<V>(node, postulate);
+  }
 
-		HelenusPropertyNode node = MappingUtil.resolveMappingProperty(getter);
+  public static <V> Filter<V> create(
+      Getter<V> getter, HelenusPropertyNode node, Postulate<V> postulate) {
+    Objects.requireNonNull(getter, "empty getter");
+    Objects.requireNonNull(postulate, "empty operator");
+    return new Filter<V>(node, postulate);
+  }
 
-		return new Filter<V>(node, postulate);
-	}
+  public static <V> Filter<V> create(Getter<V> getter, Operator op, V val) {
+    Objects.requireNonNull(getter, "empty getter");
+    Objects.requireNonNull(op, "empty op");
+    Objects.requireNonNull(val, "empty value");
 
-	public static <V> Filter<V> create(Getter<V> getter, Operator op, V val) {
-		Objects.requireNonNull(getter, "empty getter");
-		Objects.requireNonNull(op, "empty op");
-		Objects.requireNonNull(val, "empty value");
+    if (op == Operator.IN) {
+      throw new IllegalArgumentException(
+          "invalid usage of the 'in' operator, use Filter.in() static method");
+    }
 
-		if (op == Operator.IN) {
-			throw new IllegalArgumentException("invalid usage of the 'in' operator, use Filter.in() static method");
-		}
+    HelenusPropertyNode node = MappingUtil.resolveMappingProperty(getter);
 
-		HelenusPropertyNode node = MappingUtil.resolveMappingProperty(getter);
+    Postulate<V> postulate = Postulate.of(op, val);
 
-		Postulate<V> postulate = Postulate.of(op, val);
+    return new Filter<V>(node, postulate);
+  }
 
-		return new Filter<V>(node, postulate);
-	}
+  public HelenusPropertyNode getNode() {
+    return node;
+  }
 
-	@Override
-	public String toString() {
-		return node.getColumnName() + postulate.toString();
-	}
+  public Clause getClause(ColumnValuePreparer valuePreparer) {
+    return postulate.getClause(node, valuePreparer);
+  }
 
+  public V[] postulateValues() {
+    return postulate.values();
+  }
+
+  @Override
+  public String toString() {
+    return node.getColumnName() + postulate.toString();
+  }
 }

src/main/java/net/helenus/core/Getter.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -17,6 +18,5 @@ package net.helenus.core;
 
 public interface Getter<V> {
 
-	V get();
-
+  V get();
 }

src/main/java/net/helenus/core/Helenus.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,14 +16,15 @@
  */
 package net.helenus.core;
 
-import java.util.*;
-import java.util.concurrent.ConcurrentHashMap;
-import java.util.concurrent.ConcurrentMap;
-
 import com.datastax.driver.core.Cluster;
 import com.datastax.driver.core.Metadata;
 import com.datastax.driver.core.Session;
-
+import java.util.HashSet;
+import java.util.Map;
+import java.util.Optional;
+import java.util.Set;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.ConcurrentMap;
 import net.helenus.config.DefaultHelenusSettings;
 import net.helenus.config.HelenusSettings;
 import net.helenus.core.reflect.DslExportable;
@@ -32,156 +34,170 @@ import net.helenus.support.HelenusMappingException;
 
 public final class Helenus {
 
-    private static volatile HelenusSettings settings = new DefaultHelenusSettings();
-    private static final ConcurrentMap<Class<?>, Object> dslCache = new ConcurrentHashMap<Class<?>, Object>();
-    private static final ConcurrentMap<Class<?>, Metadata> metadataForEntity = new ConcurrentHashMap<Class<?>, Metadata>();
-    private static final Set<HelenusSession> sessions = new HashSet<HelenusSession>();
-    private static volatile HelenusSession singleton;
+  private static final ConcurrentMap<Class<?>, Object> dslCache =
+      new ConcurrentHashMap<Class<?>, Object>();
+  private static final ConcurrentMap<Class<?>, Metadata> metadataForEntity =
+      new ConcurrentHashMap<Class<?>, Metadata>();
+  private static final Set<HelenusSession> sessions = new HashSet<HelenusSession>();
+  private static volatile HelenusSettings settings = new DefaultHelenusSettings();
+  private static volatile HelenusSession singleton;
 
+  private Helenus() {}
 
-    private Helenus() {
-    }
+  protected static void setSession(HelenusSession session) {
+    sessions.add(session);
+    singleton = session;
+  }
 
-    protected static void setSession(HelenusSession session) {
-        sessions.add(session);
-        singleton = session;
-    }
+  public static HelenusSession session() {
+    return singleton;
+  }
 
-    public static HelenusSession session() {
-        return singleton;
-    }
-
-    public static void shutdown() {
-        sessions.forEach((session) -> {
-            session.close();
-            sessions.remove(session);
+  public static void shutdown() {
+    sessions.forEach(
+        (session) -> {
+          session.close();
+          sessions.remove(session);
         });
-        dslCache.clear();
+    dslCache.clear();
+  }
+
+  public static HelenusSettings settings() {
+    return settings;
+  }
+
+  public static HelenusSettings settings(HelenusSettings overrideSettings) {
+    HelenusSettings old = settings;
+    settings = overrideSettings;
+    return old;
+  }
+
+  public static SessionInitializer connect(Cluster cluster) {
+    Session session = cluster.connect();
+    return new SessionInitializer(session);
+  }
+
+  public static SessionInitializer connect(Cluster cluster, String keyspace) {
+    Session session = cluster.connect(keyspace);
+    return new SessionInitializer(session);
+  }
+
+  public static SessionInitializer init(Session session, String keyspace) {
+    return new SessionInitializer(session, keyspace);
+  }
+
+  public static SessionInitializer init(Session session) {
+
+    if (session == null) {
+      throw new IllegalArgumentException("empty session");
     }
 
-    public static HelenusSettings settings() {
-        return settings;
+    return new SessionInitializer(session);
+  }
+
+  public static void clearDslCache() {
+    dslCache.clear();
+  }
+
+  public static <E> E dsl(Class<E> iface) {
+    return dsl(iface, null);
+  }
+
+  public static <E> E dsl(Class<E> iface, Metadata metadata) {
+    return dsl(iface, iface.getClassLoader(), Optional.empty(), metadata);
+  }
+
+  public static <E> E dsl(Class<E> iface, ClassLoader classLoader, Metadata metadata) {
+    return dsl(iface, classLoader, Optional.empty(), metadata);
+  }
+
+  public static <E> E dsl(
+      Class<E> iface,
+      ClassLoader classLoader,
+      Optional<HelenusPropertyNode> parent,
+      Metadata metadata) {
+
+    Object instance = null;
+
+    if (!parent.isPresent()) {
+      instance = dslCache.get(iface);
     }
 
-    public static HelenusSettings settings(HelenusSettings overrideSettings) {
-        HelenusSettings old = settings;
-        settings = overrideSettings;
-        return old;
-    }
+    if (instance == null) {
 
-    public static SessionInitializer connect(Cluster cluster) {
-        Session session = cluster.connect();
-        return new SessionInitializer(session);
-    }
+      instance = settings.getDslInstantiator().instantiate(iface, classLoader, parent, metadata);
 
-    public static SessionInitializer connect(Cluster cluster, String keyspace) {
-        Session session = cluster.connect(keyspace);
-        return new SessionInitializer(session);
-    }
+      if (!parent.isPresent()) {
 
-    public static SessionInitializer init(Session session) {
-
-        if (session == null) {
-            throw new IllegalArgumentException("empty session");
+        Object c = dslCache.putIfAbsent(iface, instance);
+        if (c != null) {
+          instance = c;
         }
-
-        return new SessionInitializer(session);
+      }
     }
 
-    public static void clearDslCache() {
-        dslCache.clear();
+    return (E) instance;
+  }
+
+  public static <E> E map(Class<E> iface, Map<String, Object> src) {
+    return map(iface, src, iface.getClassLoader());
+  }
+
+  public static <E> E map(Class<E> iface, Map<String, Object> src, ClassLoader classLoader) {
+    return settings.getMapperInstantiator().instantiate(iface, src, classLoader);
+  }
+
+  public static HelenusEntity entity(Class<?> iface) {
+    Metadata metadata = metadataForEntity.get(iface);
+    if (metadata == null) {
+      HelenusSession session = session();
+      if (session != null) {
+        metadata = session.getMetadata();
+      }
+    }
+    return entity(iface, metadata);
+  }
+
+  public static HelenusEntity entity(Class<?> iface, Metadata metadata) {
+
+    Object dsl = dsl(iface, metadata);
+
+    DslExportable e = (DslExportable) dsl;
+
+    return e.getHelenusMappingEntity();
+  }
+
+  public static HelenusEntity resolve(Object ifaceOrDsl) {
+    return resolve(ifaceOrDsl, metadataForEntity.get(ifaceOrDsl));
+  }
+
+  public static HelenusEntity resolve(Object ifaceOrDsl, Metadata metadata) {
+
+    if (ifaceOrDsl == null) {
+      throw new HelenusMappingException("ifaceOrDsl is null");
     }
 
-    public static <E> E dsl(Class<E> iface) {
-        return dsl(iface, null);
+    if (ifaceOrDsl instanceof DslExportable) {
+
+      DslExportable e = (DslExportable) ifaceOrDsl;
+
+      return e.getHelenusMappingEntity();
     }
 
-    public static <E> E dsl(Class<E> iface, Metadata metadata) {
-        return dsl(iface, iface.getClassLoader(), Optional.empty(), metadata);
+    if (ifaceOrDsl instanceof Class) {
+
+      Class<?> iface = (Class<?>) ifaceOrDsl;
+
+      if (!iface.isInterface()) {
+        throw new HelenusMappingException("class is not an interface " + iface);
+      }
+
+      if (metadata != null) {
+        metadataForEntity.putIfAbsent(iface, metadata);
+      }
+      return entity(iface, metadata);
     }
 
-    public static <E> E dsl(Class<E> iface, ClassLoader classLoader, Metadata metadata) {
-        return dsl(iface, classLoader, Optional.empty(), metadata);
-    }
-
-    public static <E> E dsl(Class<E> iface, ClassLoader classLoader, Optional<HelenusPropertyNode> parent,
-            Metadata metadata) {
-
-        Object instance = null;
-
-        if (!parent.isPresent()) {
-            instance = dslCache.get(iface);
-        }
-
-        if (instance == null) {
-
-            instance = settings.getDslInstantiator().instantiate(iface, classLoader, parent, metadata);
-
-            if (!parent.isPresent()) {
-
-                Object c = dslCache.putIfAbsent(iface, instance);
-                if (c != null) {
-                    instance = c;
-                }
-
-            }
-        }
-
-        return (E) instance;
-    }
-
-    public static <E> E map(Class<E> iface, Map<String, Object> src) {
-        return map(iface, src, iface.getClassLoader());
-    }
-
-    public static <E> E map(Class<E> iface, Map<String, Object> src, ClassLoader classLoader) {
-        return settings.getMapperInstantiator().instantiate(iface, src, classLoader);
-    }
-
-    public static HelenusEntity entity(Class<?> iface) {
-        return entity(iface, metadataForEntity.get(iface));
-    }
-
-    public static HelenusEntity entity(Class<?> iface, Metadata metadata) {
-
-        Object dsl = dsl(iface, metadata);
-
-        DslExportable e = (DslExportable) dsl;
-
-        return e.getHelenusMappingEntity();
-    }
-
-    public static HelenusEntity resolve(Object ifaceOrDsl) {
-        return resolve(ifaceOrDsl, metadataForEntity.get(ifaceOrDsl));
-    }
-
-    public static HelenusEntity resolve(Object ifaceOrDsl, Metadata metadata) {
-
-		if (ifaceOrDsl == null) {
-			throw new HelenusMappingException("ifaceOrDsl is null");
-		}
-
-		if (ifaceOrDsl instanceof DslExportable) {
-
-			DslExportable e = (DslExportable) ifaceOrDsl;
-
-			return e.getHelenusMappingEntity();
-		}
-
-		if (ifaceOrDsl instanceof Class) {
-
-			Class<?> iface = (Class<?>) ifaceOrDsl;
-
-			if (!iface.isInterface()) {
-				throw new HelenusMappingException("class is not an interface " + iface);
-			}
-
-            metadataForEntity.putIfAbsent(iface, metadata);
-			return entity(iface, metadata);
-
-		}
-
-		throw new HelenusMappingException("unknown dsl object or mapping interface " + ifaceOrDsl);
-	}
-
+    throw new HelenusMappingException("unknown dsl object or mapping interface " + ifaceOrDsl);
+  }
 }

src/main/java/net/helenus/core/HelenusValidator.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -16,36 +17,32 @@
 package net.helenus.core;
 
 import java.lang.annotation.Annotation;
-
 import javax.validation.ConstraintValidator;
-
 import net.helenus.mapping.HelenusProperty;
 import net.helenus.support.HelenusException;
 import net.helenus.support.HelenusMappingException;
 
 public enum HelenusValidator implements PropertyValueValidator {
+  INSTANCE;
 
-	INSTANCE;
+  public void validate(HelenusProperty prop, Object value) {
 
-	public void validate(HelenusProperty prop, Object value) {
+    for (ConstraintValidator<? extends Annotation, ?> validator : prop.getValidators()) {
 
-		for (ConstraintValidator<? extends Annotation, ?> validator : prop.getValidators()) {
+      ConstraintValidator typeless = (ConstraintValidator) validator;
 
-			ConstraintValidator typeless = (ConstraintValidator) validator;
+      boolean valid = false;
 
-			boolean valid = false;
-
-			try {
-				valid = typeless.isValid(value, null);
-			} catch (ClassCastException e) {
-				throw new HelenusMappingException("validator was used for wrong type '" + value + "' in " + prop, e);
-			}
-
-			if (!valid) {
-				throw new HelenusException("wrong value '" + value + "' for " + prop);
-			}
-		}
-
-	}
+      try {
+        valid = typeless.isValid(value, null);
+      } catch (ClassCastException e) {
+        throw new HelenusMappingException(
+            "validator was used for wrong type '" + value + "' in " + prop, e);
+      }
 
+      if (!valid) {
+        throw new HelenusException("wrong value '" + value + "' for " + prop);
+      }
+    }
+  }
 }

src/main/java/net/helenus/core/MapperInstantiator.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -19,6 +20,5 @@ import java.util.Map;
 
 public interface MapperInstantiator {
 
-	<E> E instantiate(Class<E> iface, Map<String, Object> src, ClassLoader classLoader);
-
+  <E> E instantiate(Class<E> iface, Map<String, Object> src, ClassLoader classLoader);
 }

src/main/java/net/helenus/core/Mappers.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,10 +16,8 @@
  */
 package net.helenus.core;
 
-import java.util.function.Function;
-
 import com.datastax.driver.core.Row;
-
+import java.util.function.Function;
 import net.helenus.core.reflect.HelenusPropertyNode;
 import net.helenus.mapping.HelenusProperty;
 import net.helenus.mapping.value.ColumnValueProvider;
@@ -26,162 +25,203 @@ import net.helenus.support.Fun;
 
 public final class Mappers {
 
-	private Mappers() {
-	}
+  private Mappers() {}
 
-	public final static class Mapper1<A> implements Function<Row, Fun.Tuple1<A>> {
+  public static final class Mapper1<A> implements Function<Row, Fun.Tuple1<A>> {
 
-		private final ColumnValueProvider provider;
-		private final HelenusProperty p1;
+    private final ColumnValueProvider provider;
+    private final HelenusProperty p1;
 
-		public Mapper1(ColumnValueProvider provider, HelenusPropertyNode p1) {
-			this.provider = provider;
-			this.p1 = p1.getProperty();
-		}
+    public Mapper1(ColumnValueProvider provider, HelenusPropertyNode p1) {
+      this.provider = provider;
+      this.p1 = p1.getProperty();
+    }
 
-		@Override
-		public Fun.Tuple1<A> apply(Row row) {
-			return new Fun.Tuple1<A>(provider.getColumnValue(row, 0, p1));
-		}
-	}
+    @Override
+    public Fun.Tuple1<A> apply(Row row) {
+      return new Fun.Tuple1<A>(provider.getColumnValue(row, 0, p1));
+    }
+  }
 
-	public final static class Mapper2<A, B> implements Function<Row, Fun.Tuple2<A, B>> {
+  public static final class Mapper2<A, B> implements Function<Row, Fun.Tuple2<A, B>> {
 
-		private final ColumnValueProvider provider;
-		private final HelenusProperty p1;
-		private final HelenusProperty p2;
+    private final ColumnValueProvider provider;
+    private final HelenusProperty p1;
+    private final HelenusProperty p2;
 
-		public Mapper2(ColumnValueProvider provider, HelenusPropertyNode p1, HelenusPropertyNode p2) {
-			this.provider = provider;
-			this.p1 = p1.getProperty();
-			this.p2 = p2.getProperty();
-		}
+    public Mapper2(ColumnValueProvider provider, HelenusPropertyNode p1, HelenusPropertyNode p2) {
+      this.provider = provider;
+      this.p1 = p1.getProperty();
+      this.p2 = p2.getProperty();
+    }
 
-		@Override
-		public Fun.Tuple2<A, B> apply(Row row) {
-			return new Fun.Tuple2<A, B>(provider.getColumnValue(row, 0, p1), provider.getColumnValue(row, 1, p2));
-		}
-	}
+    @Override
+    public Fun.Tuple2<A, B> apply(Row row) {
+      return new Fun.Tuple2<A, B>(
+          provider.getColumnValue(row, 0, p1), provider.getColumnValue(row, 1, p2));
+    }
+  }
 
-	public final static class Mapper3<A, B, C> implements Function<Row, Fun.Tuple3<A, B, C>> {
+  public static final class Mapper3<A, B, C> implements Function<Row, Fun.Tuple3<A, B, C>> {
 
-		private final ColumnValueProvider provider;
-		private final HelenusProperty p1;
-		private final HelenusProperty p2;
-		private final HelenusProperty p3;
+    private final ColumnValueProvider provider;
+    private final HelenusProperty p1;
+    private final HelenusProperty p2;
+    private final HelenusProperty p3;
 
-		public Mapper3(ColumnValueProvider provider, HelenusPropertyNode p1, HelenusPropertyNode p2,
-				HelenusPropertyNode p3) {
-			this.provider = provider;
-			this.p1 = p1.getProperty();
-			this.p2 = p2.getProperty();
-			this.p3 = p3.getProperty();
-		}
+    public Mapper3(
+        ColumnValueProvider provider,
+        HelenusPropertyNode p1,
+        HelenusPropertyNode p2,
+        HelenusPropertyNode p3) {
+      this.provider = provider;
+      this.p1 = p1.getProperty();
+      this.p2 = p2.getProperty();
+      this.p3 = p3.getProperty();
+    }
 
-		@Override
-		public Fun.Tuple3<A, B, C> apply(Row row) {
-			return new Fun.Tuple3<A, B, C>(provider.getColumnValue(row, 0, p1), provider.getColumnValue(row, 1, p2),
-					provider.getColumnValue(row, 2, p3));
-		}
-	}
+    @Override
+    public Fun.Tuple3<A, B, C> apply(Row row) {
+      return new Fun.Tuple3<A, B, C>(
+          provider.getColumnValue(row, 0, p1),
+          provider.getColumnValue(row, 1, p2),
+          provider.getColumnValue(row, 2, p3));
+    }
+  }
 
-	public final static class Mapper4<A, B, C, D> implements Function<Row, Fun.Tuple4<A, B, C, D>> {
+  public static final class Mapper4<A, B, C, D> implements Function<Row, Fun.Tuple4<A, B, C, D>> {
 
-		private final ColumnValueProvider provider;
-		private final HelenusProperty p1;
-		private final HelenusProperty p2;
-		private final HelenusProperty p3;
-		private final HelenusProperty p4;
+    private final ColumnValueProvider provider;
+    private final HelenusProperty p1;
+    private final HelenusProperty p2;
+    private final HelenusProperty p3;
+    private final HelenusProperty p4;
 
-		public Mapper4(ColumnValueProvider provider, HelenusPropertyNode p1, HelenusPropertyNode p2,
-				HelenusPropertyNode p3, HelenusPropertyNode p4) {
-			this.provider = provider;
-			this.p1 = p1.getProperty();
-			this.p2 = p2.getProperty();
-			this.p3 = p3.getProperty();
-			this.p4 = p4.getProperty();
-		}
+    public Mapper4(
+        ColumnValueProvider provider,
+        HelenusPropertyNode p1,
+        HelenusPropertyNode p2,
+        HelenusPropertyNode p3,
+        HelenusPropertyNode p4) {
+      this.provider = provider;
+      this.p1 = p1.getProperty();
+      this.p2 = p2.getProperty();
+      this.p3 = p3.getProperty();
+      this.p4 = p4.getProperty();
+    }
 
-		@Override
-		public Fun.Tuple4<A, B, C, D> apply(Row row) {
-			return new Fun.Tuple4<A, B, C, D>(provider.getColumnValue(row, 0, p1), provider.getColumnValue(row, 1, p2),
-					provider.getColumnValue(row, 2, p3), provider.getColumnValue(row, 3, p4));
-		}
-	}
+    @Override
+    public Fun.Tuple4<A, B, C, D> apply(Row row) {
+      return new Fun.Tuple4<A, B, C, D>(
+          provider.getColumnValue(row, 0, p1),
+          provider.getColumnValue(row, 1, p2),
+          provider.getColumnValue(row, 2, p3),
+          provider.getColumnValue(row, 3, p4));
+    }
+  }
 
-	public final static class Mapper5<A, B, C, D, E> implements Function<Row, Fun.Tuple5<A, B, C, D, E>> {
+  public static final class Mapper5<A, B, C, D, E>
+      implements Function<Row, Fun.Tuple5<A, B, C, D, E>> {
 
-		private final ColumnValueProvider provider;
-		private final HelenusProperty p1, p2, p3, p4, p5;
+    private final ColumnValueProvider provider;
+    private final HelenusProperty p1, p2, p3, p4, p5;
 
-		public Mapper5(ColumnValueProvider provider, HelenusPropertyNode p1, HelenusPropertyNode p2,
-				HelenusPropertyNode p3, HelenusPropertyNode p4, HelenusPropertyNode p5) {
-			this.provider = provider;
-			this.p1 = p1.getProperty();
-			this.p2 = p2.getProperty();
-			this.p3 = p3.getProperty();
-			this.p4 = p4.getProperty();
-			this.p5 = p5.getProperty();
-		}
+    public Mapper5(
+        ColumnValueProvider provider,
+        HelenusPropertyNode p1,
+        HelenusPropertyNode p2,
+        HelenusPropertyNode p3,
+        HelenusPropertyNode p4,
+        HelenusPropertyNode p5) {
+      this.provider = provider;
+      this.p1 = p1.getProperty();
+      this.p2 = p2.getProperty();
+      this.p3 = p3.getProperty();
+      this.p4 = p4.getProperty();
+      this.p5 = p5.getProperty();
+    }
 
-		@Override
-		public Fun.Tuple5<A, B, C, D, E> apply(Row row) {
-			return new Fun.Tuple5<A, B, C, D, E>(provider.getColumnValue(row, 0, p1),
-					provider.getColumnValue(row, 1, p2), provider.getColumnValue(row, 2, p3),
-					provider.getColumnValue(row, 3, p4), provider.getColumnValue(row, 4, p5));
-		}
-	}
+    @Override
+    public Fun.Tuple5<A, B, C, D, E> apply(Row row) {
+      return new Fun.Tuple5<A, B, C, D, E>(
+          provider.getColumnValue(row, 0, p1),
+          provider.getColumnValue(row, 1, p2),
+          provider.getColumnValue(row, 2, p3),
+          provider.getColumnValue(row, 3, p4),
+          provider.getColumnValue(row, 4, p5));
+    }
+  }
 
-	public final static class Mapper6<A, B, C, D, E, F> implements Function<Row, Fun.Tuple6<A, B, C, D, E, F>> {
+  public static final class Mapper6<A, B, C, D, E, F>
+      implements Function<Row, Fun.Tuple6<A, B, C, D, E, F>> {
 
-		private final ColumnValueProvider provider;
-		private final HelenusProperty p1, p2, p3, p4, p5, p6;
+    private final ColumnValueProvider provider;
+    private final HelenusProperty p1, p2, p3, p4, p5, p6;
 
-		public Mapper6(ColumnValueProvider provider, HelenusPropertyNode p1, HelenusPropertyNode p2,
-				HelenusPropertyNode p3, HelenusPropertyNode p4, HelenusPropertyNode p5, HelenusPropertyNode p6) {
-			this.provider = provider;
-			this.p1 = p1.getProperty();
-			this.p2 = p2.getProperty();
-			this.p3 = p3.getProperty();
-			this.p4 = p4.getProperty();
-			this.p5 = p5.getProperty();
-			this.p6 = p6.getProperty();
-		}
+    public Mapper6(
+        ColumnValueProvider provider,
+        HelenusPropertyNode p1,
+        HelenusPropertyNode p2,
+        HelenusPropertyNode p3,
+        HelenusPropertyNode p4,
+        HelenusPropertyNode p5,
+        HelenusPropertyNode p6) {
+      this.provider = provider;
+      this.p1 = p1.getProperty();
+      this.p2 = p2.getProperty();
+      this.p3 = p3.getProperty();
+      this.p4 = p4.getProperty();
+      this.p5 = p5.getProperty();
+      this.p6 = p6.getProperty();
+    }
 
-		@Override
-		public Fun.Tuple6<A, B, C, D, E, F> apply(Row row) {
-			return new Fun.Tuple6<A, B, C, D, E, F>(provider.getColumnValue(row, 0, p1),
-					provider.getColumnValue(row, 1, p2), provider.getColumnValue(row, 2, p3),
-					provider.getColumnValue(row, 3, p4), provider.getColumnValue(row, 4, p5),
-					provider.getColumnValue(row, 5, p6));
-		}
-	}
+    @Override
+    public Fun.Tuple6<A, B, C, D, E, F> apply(Row row) {
+      return new Fun.Tuple6<A, B, C, D, E, F>(
+          provider.getColumnValue(row, 0, p1),
+          provider.getColumnValue(row, 1, p2),
+          provider.getColumnValue(row, 2, p3),
+          provider.getColumnValue(row, 3, p4),
+          provider.getColumnValue(row, 4, p5),
+          provider.getColumnValue(row, 5, p6));
+    }
+  }
 
-	public final static class Mapper7<A, B, C, D, E, F, G> implements Function<Row, Fun.Tuple7<A, B, C, D, E, F, G>> {
+  public static final class Mapper7<A, B, C, D, E, F, G>
+      implements Function<Row, Fun.Tuple7<A, B, C, D, E, F, G>> {
 
-		private final ColumnValueProvider provider;
-		private final HelenusProperty p1, p2, p3, p4, p5, p6, p7;
+    private final ColumnValueProvider provider;
+    private final HelenusProperty p1, p2, p3, p4, p5, p6, p7;
 
-		public Mapper7(ColumnValueProvider provider, HelenusPropertyNode p1, HelenusPropertyNode p2,
-				HelenusPropertyNode p3, HelenusPropertyNode p4, HelenusPropertyNode p5, HelenusPropertyNode p6,
-				HelenusPropertyNode p7) {
-			this.provider = provider;
-			this.p1 = p1.getProperty();
-			this.p2 = p2.getProperty();
-			this.p3 = p3.getProperty();
-			this.p4 = p4.getProperty();
-			this.p5 = p5.getProperty();
-			this.p6 = p6.getProperty();
-			this.p7 = p7.getProperty();
-		}
-
-		@Override
-		public Fun.Tuple7<A, B, C, D, E, F, G> apply(Row row) {
-			return new Fun.Tuple7<A, B, C, D, E, F, G>(provider.getColumnValue(row, 0, p1),
-					provider.getColumnValue(row, 1, p2), provider.getColumnValue(row, 2, p3),
-					provider.getColumnValue(row, 3, p4), provider.getColumnValue(row, 4, p5),
-					provider.getColumnValue(row, 5, p6), provider.getColumnValue(row, 6, p7));
-		}
-	}
+    public Mapper7(
+        ColumnValueProvider provider,
+        HelenusPropertyNode p1,
+        HelenusPropertyNode p2,
+        HelenusPropertyNode p3,
+        HelenusPropertyNode p4,
+        HelenusPropertyNode p5,
+        HelenusPropertyNode p6,
+        HelenusPropertyNode p7) {
+      this.provider = provider;
+      this.p1 = p1.getProperty();
+      this.p2 = p2.getProperty();
+      this.p3 = p3.getProperty();
+      this.p4 = p4.getProperty();
+      this.p5 = p5.getProperty();
+      this.p6 = p6.getProperty();
+      this.p7 = p7.getProperty();
+    }
 
+    @Override
+    public Fun.Tuple7<A, B, C, D, E, F, G> apply(Row row) {
+      return new Fun.Tuple7<A, B, C, D, E, F, G>(
+          provider.getColumnValue(row, 0, p1),
+          provider.getColumnValue(row, 1, p2),
+          provider.getColumnValue(row, 2, p3),
+          provider.getColumnValue(row, 3, p4),
+          provider.getColumnValue(row, 4, p5),
+          provider.getColumnValue(row, 5, p6),
+          provider.getColumnValue(row, 6, p7));
+    }
+  }
 }

src/main/java/net/helenus/core/Operator.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -19,39 +20,37 @@ import java.util.HashMap;
 import java.util.Map;
 
 public enum Operator {
+  EQ("=="),
 
-	EQ("=="),
+  IN("in"),
 
-	IN("in"),
+  GT(">"),
 
-	GT(">"),
+  LT("<"),
 
-	LT("<"),
+  GTE(">="),
 
-	GTE(">="),
+  LTE("<=");
 
-	LTE("<=");
+  private static final Map<String, Operator> indexByName = new HashMap<String, Operator>();
 
-	private final String name;
+  static {
+    for (Operator fo : Operator.values()) {
+      indexByName.put(fo.getName(), fo);
+    }
+  }
 
-	private final static Map<String, Operator> indexByName = new HashMap<String, Operator>();
+  private final String name;
 
-	static {
-		for (Operator fo : Operator.values()) {
-			indexByName.put(fo.getName(), fo);
-		}
-	}
+  private Operator(String name) {
+    this.name = name;
+  }
 
-	private Operator(String name) {
-		this.name = name;
-	}
-
-	public String getName() {
-		return name;
-	}
-
-	public static Operator findByOperator(String name) {
-		return indexByName.get(name);
-	}
+  public static Operator findByOperator(String name) {
+    return indexByName.get(name);
+  }
 
+  public String getName() {
+    return name;
+  }
 }

src/main/java/net/helenus/core/Ordered.java

@@ -1,10 +1,8 @@
 package net.helenus.core;
 
-import java.util.Objects;
-
 import com.datastax.driver.core.querybuilder.Ordering;
 import com.datastax.driver.core.querybuilder.QueryBuilder;
-
+import java.util.Objects;
 import net.helenus.core.reflect.HelenusPropertyNode;
 import net.helenus.mapping.ColumnType;
 import net.helenus.mapping.MappingUtil;
@@ -13,37 +11,34 @@ import net.helenus.support.HelenusMappingException;
 
 public final class Ordered {
 
-	private final Getter<?> getter;
-	private final OrderingDirection direction;
+  private final Getter<?> getter;
+  private final OrderingDirection direction;
 
-	public Ordered(Getter<?> getter, OrderingDirection direction) {
-		this.getter = getter;
-		this.direction = direction;
-	}
+  public Ordered(Getter<?> getter, OrderingDirection direction) {
+    this.getter = getter;
+    this.direction = direction;
+  }
 
-	public Ordering getOrdering() {
+  public Ordering getOrdering() {
 
-		Objects.requireNonNull(getter, "property is null");
-		Objects.requireNonNull(direction, "direction is null");
+    Objects.requireNonNull(getter, "property is null");
+    Objects.requireNonNull(direction, "direction is null");
 
-		HelenusPropertyNode propNode = MappingUtil.resolveMappingProperty(getter);
+    HelenusPropertyNode propNode = MappingUtil.resolveMappingProperty(getter);
 
-		if (propNode.getProperty().getColumnType() != ColumnType.CLUSTERING_COLUMN) {
-			throw new HelenusMappingException(
-					"property must be a clustering column " + propNode.getProperty().getPropertyName());
-		}
+    if (propNode.getProperty().getColumnType() != ColumnType.CLUSTERING_COLUMN) {
+      throw new HelenusMappingException(
+          "property must be a clustering column " + propNode.getProperty().getPropertyName());
+    }
 
-		switch (direction) {
+    switch (direction) {
+      case ASC:
+        return QueryBuilder.asc(propNode.getColumnName());
 
-			case ASC :
-				return QueryBuilder.asc(propNode.getColumnName());
-
-			case DESC :
-				return QueryBuilder.desc(propNode.getColumnName());
-
-		}
-
-		throw new HelenusMappingException("invalid direction " + direction);
-	}
+      case DESC:
+        return QueryBuilder.desc(propNode.getColumnName());
+    }
 
+    throw new HelenusMappingException("invalid direction " + direction);
+  }
 }

src/main/java/net/helenus/core/PostCommitFunction.java

@@ -0,0 +1,78 @@
+package net.helenus.core;
+
+import java.util.List;
+import java.util.Objects;
+import java.util.function.Consumer;
+import java.util.function.Function;
+
+import net.helenus.support.CheckedRunnable;
+
+public class PostCommitFunction<T, R> implements java.util.function.Function<T, R> {
+    public static final PostCommitFunction<Void, Void>  NULL_ABORT = new PostCommitFunction<Void, Void>(null, null, null, false);
+    public static final PostCommitFunction<Void, Void> NULL_COMMIT = new PostCommitFunction<Void, Void>(null, null, null, true);
+
+  private final List<CheckedRunnable> commitThunks;
+  private final List<CheckedRunnable> abortThunks;
+  private Consumer<? super Throwable> exceptionallyThunk;
+  private boolean committed;
+
+  PostCommitFunction(List<CheckedRunnable> postCommit, List<CheckedRunnable> abortThunks,
+      Consumer<? super Throwable> exceptionallyThunk,
+      boolean committed) {
+    this.commitThunks = postCommit;
+    this.abortThunks = abortThunks;
+    this.exceptionallyThunk = exceptionallyThunk;
+    this.committed = committed;
+  }
+
+  private void apply(CheckedRunnable... fns) {
+      try {
+          for (CheckedRunnable fn : fns) {
+              fn.run();
+          }
+      } catch (Throwable t) {
+          if (exceptionallyThunk != null) {
+              exceptionallyThunk.accept(t);
+          }
+      }
+  }
+
+  public PostCommitFunction<T, R> andThen(CheckedRunnable... after) {
+    Objects.requireNonNull(after);
+    if (commitThunks == null) {
+      if (committed) {
+          apply(after);
+      }
+    } else {
+        for (CheckedRunnable fn : after) {
+            commitThunks.add(fn);
+        }
+    }
+    return this;
+  }
+
+  public PostCommitFunction<T, R> orElse(CheckedRunnable... after) {
+    Objects.requireNonNull(after);
+    if (abortThunks == null) {
+      if (!committed) {
+          apply(after);
+      }
+    } else {
+        for (CheckedRunnable fn : after) {
+            abortThunks.add(fn);
+        }
+    }
+    return this;
+  }
+
+  public PostCommitFunction<T, R> exceptionally(Consumer<? super Throwable> fn) {
+      Objects.requireNonNull(fn);
+      exceptionallyThunk = fn;
+      return this;
+  }
+
+  @Override
+  public R apply(T t) {
+    return null;
+  }
+}

src/main/java/net/helenus/core/Postulate.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -17,86 +18,84 @@ package net.helenus.core;
 
 import com.datastax.driver.core.querybuilder.Clause;
 import com.datastax.driver.core.querybuilder.QueryBuilder;
-
 import net.helenus.core.reflect.HelenusPropertyNode;
 import net.helenus.mapping.value.ColumnValuePreparer;
 import net.helenus.support.HelenusMappingException;
 
 public final class Postulate<V> {
 
-	private final Operator operator;
-	private final V[] values;
+  private final Operator operator;
+  private final V[] values;
 
-	protected Postulate(Operator op, V[] values) {
-		this.operator = op;
-		this.values = values;
-	}
+  protected Postulate(Operator op, V[] values) {
+    this.operator = op;
+    this.values = values;
+  }
 
-	public static <V> Postulate<V> of(Operator op, V... values) {
-		return new Postulate<V>(op, values);
-	}
+  public static <V> Postulate<V> of(Operator op, V... values) {
+    return new Postulate<V>(op, values);
+  }
 
-	public Clause getClause(HelenusPropertyNode node, ColumnValuePreparer valuePreparer) {
+  public Clause getClause(HelenusPropertyNode node, ColumnValuePreparer valuePreparer) {
 
-		switch (operator) {
+    switch (operator) {
+      case EQ:
+        return QueryBuilder.eq(
+            node.getColumnName(), valuePreparer.prepareColumnValue(values[0], node.getProperty()));
 
-			case EQ :
-				return QueryBuilder.eq(node.getColumnName(),
-						valuePreparer.prepareColumnValue(values[0], node.getProperty()));
+      case IN:
+        Object[] preparedValues = new Object[values.length];
+        for (int i = 0; i != values.length; ++i) {
+          preparedValues[i] = valuePreparer.prepareColumnValue(values[i], node.getProperty());
+        }
+        return QueryBuilder.in(node.getColumnName(), preparedValues);
 
-			case IN :
-				Object[] preparedValues = new Object[values.length];
-				for (int i = 0; i != values.length; ++i) {
-					preparedValues[i] = valuePreparer.prepareColumnValue(values[i], node.getProperty());
-				}
-				return QueryBuilder.in(node.getColumnName(), preparedValues);
+      case LT:
+        return QueryBuilder.lt(
+            node.getColumnName(), valuePreparer.prepareColumnValue(values[0], node.getProperty()));
 
-			case LT :
-				return QueryBuilder.lt(node.getColumnName(),
-						valuePreparer.prepareColumnValue(values[0], node.getProperty()));
+      case LTE:
+        return QueryBuilder.lte(
+            node.getColumnName(), valuePreparer.prepareColumnValue(values[0], node.getProperty()));
 
-			case LTE :
-				return QueryBuilder.lte(node.getColumnName(),
-						valuePreparer.prepareColumnValue(values[0], node.getProperty()));
+      case GT:
+        return QueryBuilder.gt(
+            node.getColumnName(), valuePreparer.prepareColumnValue(values[0], node.getProperty()));
 
-			case GT :
-				return QueryBuilder.gt(node.getColumnName(),
-						valuePreparer.prepareColumnValue(values[0], node.getProperty()));
+      case GTE:
+        return QueryBuilder.gte(
+            node.getColumnName(), valuePreparer.prepareColumnValue(values[0], node.getProperty()));
 
-			case GTE :
-				return QueryBuilder.gte(node.getColumnName(),
-						valuePreparer.prepareColumnValue(values[0], node.getProperty()));
+      default:
+        throw new HelenusMappingException("unknown filter operation " + operator);
+    }
+  }
 
-			default :
-				throw new HelenusMappingException("unknown filter operation " + operator);
-		}
+  public V[] values() {
+    return values;
+  }
 
-	}
+  @Override
+  public String toString() {
 
-	@Override
-	public String toString() {
+    if (operator == Operator.IN) {
 
-		if (operator == Operator.IN) {
+      if (values == null) {
+        return "in()";
+      }
 
-			if (values == null) {
-				return "in()";
-			}
-
-			int len = values.length;
-			StringBuilder b = new StringBuilder();
-			b.append("in(");
-			for (int i = 0; i != len; i++) {
-				if (b.length() > 3) {
-					b.append(", ");
-				}
-				b.append(String.valueOf(values[i]));
-			}
-			return b.append(')').toString();
-
-		}
-
-		return operator.getName() + values[0];
-
-	}
+      int len = values.length;
+      StringBuilder b = new StringBuilder();
+      b.append("in(");
+      for (int i = 0; i != len; i++) {
+        if (b.length() > 3) {
+          b.append(", ");
+        }
+        b.append(String.valueOf(values[i]));
+      }
+      return b.append(')').toString();
+    }
 
+    return operator.getName() + values[0];
+  }
 }

src/main/java/net/helenus/core/PropertyValueValidator.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -19,6 +20,5 @@ import net.helenus.mapping.HelenusProperty;
 
 public interface PropertyValueValidator {
 
-	void validate(HelenusProperty prop, Object value);
-
+  void validate(HelenusProperty prop, Object value);
 }

src/main/java/net/helenus/core/Query.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,90 +16,80 @@
  */
 package net.helenus.core;
 
+import com.datastax.driver.core.querybuilder.BindMarker;
+import com.datastax.driver.core.querybuilder.QueryBuilder;
 import java.util.List;
 import java.util.Map;
 import java.util.Objects;
-
-import com.datastax.driver.core.querybuilder.BindMarker;
-import com.datastax.driver.core.querybuilder.QueryBuilder;
-
 import net.helenus.mapping.OrderingDirection;
 
-/**
- * Sugar methods for the queries
- *
- */
-
+/** Sugar methods for the queries */
 public final class Query {
 
-	private Query() {
-	}
+  private Query() {}
 
-	public static BindMarker marker() {
-		return QueryBuilder.bindMarker();
-	}
+  public static BindMarker marker() {
+    return QueryBuilder.bindMarker();
+  }
 
-	public static BindMarker marker(String name) {
-		return QueryBuilder.bindMarker(name);
-	}
+  public static BindMarker marker(String name) {
+    return QueryBuilder.bindMarker(name);
+  }
 
-	public static Ordered asc(Getter<?> getter) {
-		return new Ordered(getter, OrderingDirection.ASC);
-	}
+  public static Ordered asc(Getter<?> getter) {
+    return new Ordered(getter, OrderingDirection.ASC);
+  }
 
-	public static Ordered desc(Getter<?> getter) {
-		return new Ordered(getter, OrderingDirection.DESC);
-	}
+  public static Ordered desc(Getter<?> getter) {
+    return new Ordered(getter, OrderingDirection.DESC);
+  }
 
-	public static <V> Postulate<V> eq(V val) {
-		return Postulate.of(Operator.EQ, val);
-	}
+  public static <V> Postulate<V> eq(V val) {
+    return Postulate.of(Operator.EQ, val);
+  }
 
-	public static <V> Postulate<V> lt(V val) {
-		return Postulate.of(Operator.LT, val);
-	}
+  public static <V> Postulate<V> lt(V val) {
+    return Postulate.of(Operator.LT, val);
+  }
 
-	public static <V> Postulate<V> lte(V val) {
-		return Postulate.of(Operator.LTE, val);
-	}
+  public static <V> Postulate<V> lte(V val) {
+    return Postulate.of(Operator.LTE, val);
+  }
 
-	public static <V> Postulate<V> gt(V val) {
-		return Postulate.of(Operator.GT, val);
-	}
+  public static <V> Postulate<V> gt(V val) {
+    return Postulate.of(Operator.GT, val);
+  }
 
-	public static <V> Postulate<V> gte(V val) {
-		return Postulate.of(Operator.GTE, val);
-	}
+  public static <V> Postulate<V> gte(V val) {
+    return Postulate.of(Operator.GTE, val);
+  }
 
-	public static <V> Postulate<V> in(V[] vals) {
-		return new Postulate<V>(Operator.IN, vals);
-	}
+  public static <V> Postulate<V> in(V[] vals) {
+    return new Postulate<V>(Operator.IN, vals);
+  }
 
-	public static <K, V> Getter<V> getIdx(Getter<List<V>> listGetter, int index) {
-		Objects.requireNonNull(listGetter, "listGetter is null");
+  public static <K, V> Getter<V> getIdx(Getter<List<V>> listGetter, int index) {
+    Objects.requireNonNull(listGetter, "listGetter is null");
 
-		return new Getter<V>() {
+    return new Getter<V>() {
 
-			@Override
-			public V get() {
-				return listGetter.get().get(index);
-			}
+      @Override
+      public V get() {
+        return listGetter.get().get(index);
+      }
+    };
+  }
 
-		};
-	}
+  public static <K, V> Getter<V> get(Getter<Map<K, V>> mapGetter, K k) {
+    Objects.requireNonNull(mapGetter, "mapGetter is null");
+    Objects.requireNonNull(k, "key is null");
 
-	public static <K, V> Getter<V> get(Getter<Map<K, V>> mapGetter, K k) {
-		Objects.requireNonNull(mapGetter, "mapGetter is null");
-		Objects.requireNonNull(k, "key is null");
-
-		return new Getter<V>() {
-
-			@Override
-			public V get() {
-				return mapGetter.get().get(k);
-			}
-
-		};
-	}
+    return new Getter<V>() {
 
+      @Override
+      public V get() {
+        return mapGetter.get().get(k);
+      }
+    };
+  }
 }

src/main/java/net/helenus/core/SchemaUtil.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,351 +16,459 @@
  */
 package net.helenus.core;
 
-import java.util.*;
-import java.util.stream.Collectors;
-
 import com.datastax.driver.core.*;
-import com.datastax.driver.core.IndexMetadata;
+import com.datastax.driver.core.querybuilder.IsNotNullClause;
+import com.datastax.driver.core.querybuilder.QueryBuilder;
+import com.datastax.driver.core.querybuilder.Select;
 import com.datastax.driver.core.schemabuilder.*;
 import com.datastax.driver.core.schemabuilder.Create.Options;
-
+import java.util.*;
+import java.util.stream.Collectors;
+import net.helenus.core.reflect.HelenusPropertyNode;
 import net.helenus.mapping.*;
 import net.helenus.mapping.ColumnType;
+import net.helenus.mapping.annotation.ClusteringColumn;
 import net.helenus.mapping.type.OptionalColumnMetadata;
 import net.helenus.support.CqlUtil;
 import net.helenus.support.HelenusMappingException;
 
 public final class SchemaUtil {
 
-	private SchemaUtil() {
-	}
+  private SchemaUtil() {}
 
-	public static RegularStatement use(String keyspace, boolean forceQuote) {
-		if (forceQuote) {
-			return new SimpleStatement("USE" + CqlUtil.forceQuote(keyspace));
-		} else {
-			return new SimpleStatement("USE " + keyspace);
-		}
-	}
+  public static RegularStatement use(String keyspace, boolean forceQuote) {
+    if (forceQuote) {
+      return new SimpleStatement("USE" + CqlUtil.forceQuote(keyspace));
+    } else {
+      return new SimpleStatement("USE " + keyspace);
+    }
+  }
 
-	public static SchemaStatement createUserType(HelenusEntity entity) {
-
-		if (entity.getType() != HelenusEntityType.UDT) {
-			throw new HelenusMappingException("expected UDT entity " + entity);
-		}
-
-		CreateType create = SchemaBuilder.createType(entity.getName().toCql());
-
-		for (HelenusProperty prop : entity.getOrderedProperties()) {
-
-			ColumnType columnType = prop.getColumnType();
-
-			if (columnType == ColumnType.PARTITION_KEY || columnType == ColumnType.CLUSTERING_COLUMN) {
-				throw new HelenusMappingException("primary key columns are not supported in UserDefinedType for "
-						+ prop.getPropertyName() + " in entity " + entity);
-			}
-
-			try {
-				prop.getDataType().addColumn(create, prop.getColumnName());
-			} catch (IllegalArgumentException e) {
-				throw new HelenusMappingException("invalid column name '" + prop.getColumnName() + "' in entity '"
-						+ entity.getName().getName() + "'", e);
-			}
-		}
-
-		return create;
-	}
-
-	public static List<SchemaStatement> alterUserType(UserType userType, HelenusEntity entity,
-			boolean dropUnusedColumns) {
-
-		if (entity.getType() != HelenusEntityType.UDT) {
-			throw new HelenusMappingException("expected UDT entity " + entity);
-		}
-
-		List<SchemaStatement> result = new ArrayList<SchemaStatement>();
-
-		/**
-		 * TODO: In future replace SchemaBuilder.alterTable by SchemaBuilder.alterType
-		 * when it will exist
-		 */
-
-		Alter alter = SchemaBuilder.alterTable(entity.getName().toCql());
-
-		final Set<String> visitedColumns = dropUnusedColumns ? new HashSet<String>() : Collections.<String>emptySet();
-
-		for (HelenusProperty prop : entity.getOrderedProperties()) {
-
-			String columnName = prop.getColumnName().getName();
-
-			if (dropUnusedColumns) {
-				visitedColumns.add(columnName);
-			}
-
-			ColumnType columnType = prop.getColumnType();
-
-			if (columnType == ColumnType.PARTITION_KEY || columnType == ColumnType.CLUSTERING_COLUMN) {
-				continue;
-			}
-
-			DataType dataType = userType.getFieldType(columnName);
-			SchemaStatement stmt = prop.getDataType().alterColumn(alter, prop.getColumnName(),
-					optional(columnName, dataType));
-
-			if (stmt != null) {
-				result.add(stmt);
-			}
-
-		}
-
-		if (dropUnusedColumns) {
-			for (String field : userType.getFieldNames()) {
-				if (!visitedColumns.contains(field)) {
-
-					result.add(alter.dropColumn(field));
-
-				}
-			}
-		}
-
-		return result;
-
-	}
-
-    public static SchemaStatement dropUserType(HelenusEntity entity) {
-
-        if (entity.getType() != HelenusEntityType.UDT) {
-            throw new HelenusMappingException("expected UDT entity " + entity);
-        }
-
-        return SchemaBuilder.dropType(entity.getName().toCql()).ifExists();
+  public static SchemaStatement createUserType(HelenusEntity entity) {
 
+    if (entity.getType() != HelenusEntityType.UDT) {
+      throw new HelenusMappingException("expected UDT entity " + entity);
     }
 
-    public static SchemaStatement dropUserType(UserType type) {
+    CreateType create = SchemaBuilder.createType(entity.getName().toCql());
 
-        return SchemaBuilder.dropType(type.getTypeName()).ifExists();
-	}
+    for (HelenusProperty prop : entity.getOrderedProperties()) {
 
-	public static SchemaStatement createTable(HelenusEntity entity) {
+      ColumnType columnType = prop.getColumnType();
 
-		if (entity.getType() != HelenusEntityType.TABLE) {
-			throw new HelenusMappingException("expected table entity " + entity);
-		}
+      if (columnType == ColumnType.PARTITION_KEY || columnType == ColumnType.CLUSTERING_COLUMN) {
+        throw new HelenusMappingException(
+            "primary key columns are not supported in UserDefinedType for "
+                + prop.getPropertyName()
+                + " in entity "
+                + entity);
+      }
 
-        // NOTE: There is a bug in the normal path of createTable where the
-        // "cache" is set too early and never unset preventing more than
-        // one column on a table.
-        // SchemaBuilder.createTable(entity.getName().toCql());
-		CreateTable create = new CreateTable(entity.getName().toCql());
+      try {
+        prop.getDataType().addColumn(create, prop.getColumnName());
+      } catch (IllegalArgumentException e) {
+        throw new HelenusMappingException(
+            "invalid column name '"
+                + prop.getColumnName()
+                + "' in entity '"
+                + entity.getName().getName()
+                + "'",
+            e);
+      }
+    }
 
-		create.ifNotExists();
+    return create;
+  }
 
-		List<HelenusProperty> clusteringColumns = new ArrayList<HelenusProperty>();
+  public static List<SchemaStatement> alterUserType(
+      UserType userType, HelenusEntity entity, boolean dropUnusedColumns) {
 
-		for (HelenusProperty prop : entity.getOrderedProperties()) {
+    if (entity.getType() != HelenusEntityType.UDT) {
+      throw new HelenusMappingException("expected UDT entity " + entity);
+    }
 
-			ColumnType columnType = prop.getColumnType();
+    List<SchemaStatement> result = new ArrayList<SchemaStatement>();
 
-			if (columnType == ColumnType.CLUSTERING_COLUMN) {
-				clusteringColumns.add(prop);
-			}
+    /**
+     * TODO: In future replace SchemaBuilder.alterTable by SchemaBuilder.alterType when it will
+     * exist
+     */
+    Alter alter = SchemaBuilder.alterTable(entity.getName().toCql());
 
-			prop.getDataType().addColumn(create, prop.getColumnName());
+    final Set<String> visitedColumns =
+        dropUnusedColumns ? new HashSet<String>() : Collections.<String>emptySet();
 
-		}
+    for (HelenusProperty prop : entity.getOrderedProperties()) {
 
-		if (!clusteringColumns.isEmpty()) {
-			Options options = create.withOptions();
-			clusteringColumns
-					.forEach(p -> options.clusteringOrder(p.getColumnName().toCql(), mapDirection(p.getOrdering())));
-		}
+      String columnName = prop.getColumnName().getName();
 
-		return create;
+      if (dropUnusedColumns) {
+        visitedColumns.add(columnName);
+      }
 
-	}
+      ColumnType columnType = prop.getColumnType();
 
-	public static List<SchemaStatement> alterTable(TableMetadata tmd, HelenusEntity entity, boolean dropUnusedColumns) {
+      if (columnType == ColumnType.PARTITION_KEY || columnType == ColumnType.CLUSTERING_COLUMN) {
+        continue;
+      }
 
-		if (entity.getType() != HelenusEntityType.TABLE) {
-			throw new HelenusMappingException("expected table entity " + entity);
-		}
+      DataType dataType = userType.getFieldType(columnName);
+      SchemaStatement stmt =
+          prop.getDataType()
+              .alterColumn(alter, prop.getColumnName(), optional(columnName, dataType));
 
-		List<SchemaStatement> result = new ArrayList<SchemaStatement>();
+      if (stmt != null) {
+        result.add(stmt);
+      }
+    }
 
-		Alter alter = SchemaBuilder.alterTable(entity.getName().toCql());
+    if (dropUnusedColumns) {
+      for (String field : userType.getFieldNames()) {
+        if (!visitedColumns.contains(field)) {
 
-		final Set<String> visitedColumns = dropUnusedColumns ? new HashSet<String>() : Collections.<String>emptySet();
-
-		for (HelenusProperty prop : entity.getOrderedProperties()) {
-
-			String columnName = prop.getColumnName().getName();
-
-			if (dropUnusedColumns) {
-				visitedColumns.add(columnName);
-			}
-
-			ColumnType columnType = prop.getColumnType();
-
-			if (columnType == ColumnType.PARTITION_KEY || columnType == ColumnType.CLUSTERING_COLUMN) {
-				continue;
-			}
-
-			ColumnMetadata columnMetadata = tmd.getColumn(columnName);
-			SchemaStatement stmt = prop.getDataType().alterColumn(alter, prop.getColumnName(),
-					optional(columnMetadata));
-
-			if (stmt != null) {
-				result.add(stmt);
-			}
-
-		}
-
-		if (dropUnusedColumns) {
-			for (ColumnMetadata cm : tmd.getColumns()) {
-				if (!visitedColumns.contains(cm.getName())) {
-
-					result.add(alter.dropColumn(cm.getName()));
-
-				}
-			}
-		}
-
-		return result;
-	}
-
-	public static SchemaStatement dropTable(HelenusEntity entity) {
-
-		if (entity.getType() != HelenusEntityType.TABLE) {
-			throw new HelenusMappingException("expected table entity " + entity);
-		}
-
-		return SchemaBuilder.dropTable(entity.getName().toCql()).ifExists();
-
-	}
-
-	public static SchemaStatement createIndex(HelenusProperty prop) {
-        if (prop.caseSensitiveIndex()) {
-            return SchemaBuilder.createIndex(prop.getIndexName().get().toCql())
-                    .ifNotExists()
-                    .onTable(prop.getEntity().getName().toCql())
-                    .andColumn(prop.getColumnName().toCql());
-        } else {
-            return new CreateSasiIndex(prop.getIndexName().get().toCql())
-                    .ifNotExists()
-                    .onTable(prop.getEntity().getName().toCql())
-                    .andColumn(prop.getColumnName().toCql());
+          result.add(alter.dropColumn(field));
         }
-	}
+      }
+    }
 
-	public static List<SchemaStatement> createIndexes(HelenusEntity entity) {
+    return result;
+  }
 
-		return entity.getOrderedProperties().stream().filter(p -> p.getIndexName().isPresent())
-				.map(p -> SchemaUtil.createIndex(p)).collect(Collectors.toList());
+  public static SchemaStatement dropUserType(HelenusEntity entity) {
 
-	}
+    if (entity.getType() != HelenusEntityType.UDT) {
+      throw new HelenusMappingException("expected UDT entity " + entity);
+    }
 
-	public static List<SchemaStatement> alterIndexes(TableMetadata tmd, HelenusEntity entity,
-			boolean dropUnusedIndexes) {
+    return SchemaBuilder.dropType(entity.getName().toCql()).ifExists();
+  }
 
-		List<SchemaStatement> list = new ArrayList<SchemaStatement>();
+  public static SchemaStatement dropUserType(UserType type) {
 
-		final Set<String> visitedColumns = dropUnusedIndexes ? new HashSet<String>() : Collections.<String>emptySet();
+    return SchemaBuilder.dropType(type.getTypeName()).ifExists();
+  }
 
-		entity.getOrderedProperties().stream().filter(p -> p.getIndexName().isPresent()).forEach(p -> {
+  public static String createPrimaryKeyPhrase(Collection<HelenusProperty> properties) {
+    List<String> p = new ArrayList<String>(properties.size());
+    List<String> c = new ArrayList<String>(properties.size());
 
-			String columnName = p.getColumnName().getName();
+    for (HelenusProperty prop : properties) {
+      String columnName = prop.getColumnName().toCql();
+      switch (prop.getColumnType()) {
+        case PARTITION_KEY:
+          p.add(columnName);
+          break;
+        case CLUSTERING_COLUMN:
+          c.add(columnName);
+          break;
+        default:
+          break;
+      }
+    }
 
-			if (dropUnusedIndexes) {
-				visitedColumns.add(columnName);
-			}
+    if (p.size() == 0 && c.size() == 0)
+      return "{"
+          + properties
+              .stream()
+              .map(HelenusProperty::getPropertyName)
+              .collect(Collectors.joining(", "))
+          + "}";
 
-			ColumnMetadata cm = tmd.getColumn(columnName);
+    return "("
+        + ((p.size() > 1) ? "(" + String.join(", ", p) + ")" : p.get(0))
+        + ((c.size() > 0)
+            ? ", " + ((c.size() > 1) ? "(" + String.join(", ", c) + ")" : c.get(0))
+            : "")
+        + ")";
+  }
 
-			if (cm != null) {
-				IndexMetadata im = tmd.getIndex(columnName);
-				if (im == null) {
-					list.add(createIndex(p));
-				}
-			} else {
-				list.add(createIndex(p));
-			}
+  public static SchemaStatement createMaterializedView(
+      String keyspace, String viewName, HelenusEntity entity) {
+    if (entity.getType() != HelenusEntityType.VIEW) {
+      throw new HelenusMappingException("expected view entity " + entity);
+    }
 
-		});
+    List<HelenusPropertyNode> props = new ArrayList<HelenusPropertyNode>();
+    entity
+        .getOrderedProperties()
+        .stream()
+        .map(p -> new HelenusPropertyNode(p, Optional.empty()))
+        .forEach(p -> props.add(p));
 
-		if (dropUnusedIndexes) {
+    Select.Selection selection = QueryBuilder.select();
 
-			tmd.getColumns().stream().filter(c -> tmd.getIndex(c.getName()) != null && !visitedColumns.contains(c.getName()))
-					.forEach(c -> {
-						list.add(SchemaBuilder.dropIndex(tmd.getIndex(c.getName()).getName()).ifExists());
+    for (HelenusPropertyNode prop : props) {
+      String columnName = prop.getColumnName();
+      selection = selection.column(columnName);
+    }
+    Class<?> iface = entity.getMappingInterface();
+    String tableName = Helenus.entity(iface.getInterfaces()[0]).getName().toCql();
+    Select.Where where = selection.from(tableName).where();
+    List<String> o = new ArrayList<String>(props.size());
 
-					});
+    for (HelenusPropertyNode prop : props) {
+      String columnName = prop.getColumnName();
+      switch (prop.getProperty().getColumnType()) {
+        case PARTITION_KEY:
+          where = where.and(new IsNotNullClause(columnName));
+          break;
 
-		}
+        case CLUSTERING_COLUMN:
+          where = where.and(new IsNotNullClause(columnName));
 
-		return list;
+          ClusteringColumn clusteringColumn =
+              prop.getProperty().getGetterMethod().getAnnotation(ClusteringColumn.class);
+          if (clusteringColumn != null && clusteringColumn.ordering() != null) {
+            o.add(columnName + " " + clusteringColumn.ordering().cql());
+          }
+          break;
+        default:
+          break;
+      }
+    }
 
-	}
+    String primaryKey = "PRIMARY KEY " + createPrimaryKeyPhrase(entity.getOrderedProperties());
 
-	public static SchemaStatement dropIndex(HelenusProperty prop) {
-		return SchemaBuilder.dropIndex(prop.getIndexName().get().toCql()).ifExists();
-	}
+    String clustering = "";
+    if (o.size() > 0) {
+      clustering = "WITH CLUSTERING ORDER BY (" + String.join(", ", o) + ")";
+    }
+    return new CreateMaterializedView(keyspace, viewName, where, primaryKey, clustering)
+        .ifNotExists();
+  }
 
-	private static SchemaBuilder.Direction mapDirection(OrderingDirection o) {
-		switch (o) {
-			case ASC :
-				return SchemaBuilder.Direction.ASC;
-			case DESC :
-				return SchemaBuilder.Direction.DESC;
-		}
-		throw new HelenusMappingException("unknown ordering " + o);
-	}
+  public static SchemaStatement dropMaterializedView(
+      String keyspace, String viewName, HelenusEntity entity) {
+    return new DropMaterializedView(keyspace, viewName);
+  }
 
-	public static void throwNoMapping(HelenusProperty prop) {
+  public static SchemaStatement createTable(HelenusEntity entity) {
 
-		throw new HelenusMappingException(
-				"only primitive types and Set,List,Map collections and UserDefinedTypes are allowed, unknown type for property '"
-						+ prop.getPropertyName() + "' type is '" + prop.getJavaType() + "' in the entity "
-						+ prop.getEntity());
+    if (entity.getType() != HelenusEntityType.TABLE) {
+      throw new HelenusMappingException("expected table entity " + entity);
+    }
 
-	}
+    // NOTE: There is a bug in the normal path of createTable where the
+    // "cache" is set too early and never unset preventing more than
+    // one column on a table.
+    // SchemaBuilder.createTable(entity.getName().toCql());
+    CreateTable create = new CreateTable(entity.getName().toCql());
 
-	private static OptionalColumnMetadata optional(final ColumnMetadata columnMetadata) {
-		if (columnMetadata != null) {
-			return new OptionalColumnMetadata() {
+    create.ifNotExists();
 
-				@Override
-				public String getName() {
-					return columnMetadata.getName();
-				}
+    List<HelenusProperty> clusteringColumns = new ArrayList<HelenusProperty>();
 
-				@Override
-				public DataType getType() {
-					return columnMetadata.getType();
-				}
+    for (HelenusProperty prop : entity.getOrderedProperties()) {
 
-			};
-		}
-		return null;
-	}
+      ColumnType columnType = prop.getColumnType();
 
-	private static OptionalColumnMetadata optional(final String name, final DataType dataType) {
-		if (dataType != null) {
-			return new OptionalColumnMetadata() {
+      if (columnType == ColumnType.CLUSTERING_COLUMN) {
+        clusteringColumns.add(prop);
+      }
 
-				@Override
-				public String getName() {
-					return name;
-				}
+      prop.getDataType().addColumn(create, prop.getColumnName());
+    }
 
-				@Override
-				public DataType getType() {
-					return dataType;
-				}
+    if (!clusteringColumns.isEmpty()) {
+      Options options = create.withOptions();
+      clusteringColumns.forEach(
+          p -> options.clusteringOrder(p.getColumnName().toCql(), mapDirection(p.getOrdering())));
+    }
 
-			};
-		}
-		return null;
-	}
+    return create;
+  }
+
+  public static List<SchemaStatement> alterTable(
+      TableMetadata tmd, HelenusEntity entity, boolean dropUnusedColumns) {
+
+    if (entity.getType() != HelenusEntityType.TABLE) {
+      throw new HelenusMappingException("expected table entity " + entity);
+    }
+
+    List<SchemaStatement> result = new ArrayList<SchemaStatement>();
+
+    Alter alter = SchemaBuilder.alterTable(entity.getName().toCql());
+
+    final Set<String> visitedColumns =
+        dropUnusedColumns ? new HashSet<String>() : Collections.<String>emptySet();
+
+    for (HelenusProperty prop : entity.getOrderedProperties()) {
+
+      String columnName = prop.getColumnName().getName();
+
+      if (dropUnusedColumns) {
+        visitedColumns.add(columnName);
+      }
+
+      ColumnType columnType = prop.getColumnType();
+
+      if (columnType == ColumnType.PARTITION_KEY || columnType == ColumnType.CLUSTERING_COLUMN) {
+        continue;
+      }
+
+      ColumnMetadata columnMetadata = tmd.getColumn(columnName);
+      SchemaStatement stmt =
+          prop.getDataType().alterColumn(alter, prop.getColumnName(), optional(columnMetadata));
+
+      if (stmt != null) {
+        result.add(stmt);
+      }
+    }
+
+    if (dropUnusedColumns) {
+      for (ColumnMetadata cm : tmd.getColumns()) {
+        if (!visitedColumns.contains(cm.getName())) {
+
+          result.add(alter.dropColumn(cm.getName()));
+        }
+      }
+    }
+
+    return result;
+  }
+
+  public static SchemaStatement dropTable(HelenusEntity entity) {
+
+    if (entity.getType() != HelenusEntityType.TABLE) {
+      throw new HelenusMappingException("expected table entity " + entity);
+    }
+
+    return SchemaBuilder.dropTable(entity.getName().toCql()).ifExists();
+  }
+
+  public static SchemaStatement createIndex(HelenusProperty prop) {
+    if (prop.caseSensitiveIndex()) {
+      return SchemaBuilder.createIndex(indexName(prop))
+          .ifNotExists()
+          .onTable(prop.getEntity().getName().toCql())
+          .andColumn(prop.getColumnName().toCql());
+    } else {
+      return new CreateSasiIndex(prop.getIndexName().get().toCql())
+          .ifNotExists()
+          .onTable(prop.getEntity().getName().toCql())
+          .andColumn(prop.getColumnName().toCql());
+    }
+  }
+
+  public static List<SchemaStatement> createIndexes(HelenusEntity entity) {
+
+    return entity
+        .getOrderedProperties()
+        .stream()
+        .filter(p -> p.getIndexName().isPresent())
+        .map(p -> SchemaUtil.createIndex(p))
+        .collect(Collectors.toList());
+  }
+
+  public static List<SchemaStatement> alterIndexes(
+      TableMetadata tmd, HelenusEntity entity, boolean dropUnusedIndexes) {
+
+    List<SchemaStatement> list = new ArrayList<SchemaStatement>();
+
+    final Set<String> visitedColumns =
+        dropUnusedIndexes ? new HashSet<String>() : Collections.<String>emptySet();
+
+    entity
+        .getOrderedProperties()
+        .stream()
+        .filter(p -> p.getIndexName().isPresent())
+        .forEach(
+            p -> {
+              String columnName = p.getColumnName().getName();
+
+              if (dropUnusedIndexes) {
+                visitedColumns.add(columnName);
+              }
+
+              ColumnMetadata cm = tmd.getColumn(columnName);
+
+              if (cm != null) {
+                IndexMetadata im = tmd.getIndex(columnName);
+                if (im == null) {
+                  list.add(createIndex(p));
+                }
+              } else {
+                list.add(createIndex(p));
+              }
+            });
+
+    if (dropUnusedIndexes) {
+
+      tmd.getColumns()
+          .stream()
+          .filter(c -> tmd.getIndex(c.getName()) != null && !visitedColumns.contains(c.getName()))
+          .forEach(
+              c -> {
+                list.add(SchemaBuilder.dropIndex(tmd.getIndex(c.getName()).getName()).ifExists());
+              });
+    }
+
+    return list;
+  }
+
+  public static SchemaStatement dropIndex(HelenusProperty prop) {
+    return SchemaBuilder.dropIndex(indexName(prop)).ifExists();
+  }
+
+  private static SchemaBuilder.Direction mapDirection(OrderingDirection o) {
+    switch (o) {
+      case ASC:
+        return SchemaBuilder.Direction.ASC;
+      case DESC:
+        return SchemaBuilder.Direction.DESC;
+    }
+    throw new HelenusMappingException("unknown ordering " + o);
+  }
+
+  public static void throwNoMapping(HelenusProperty prop) {
+
+    throw new HelenusMappingException(
+        "only primitive types and Set,List,Map collections and UserDefinedTypes are allowed, unknown type for property '"
+            + prop.getPropertyName()
+            + "' type is '"
+            + prop.getJavaType()
+            + "' in the entity "
+            + prop.getEntity());
+  }
+
+  private static OptionalColumnMetadata optional(final ColumnMetadata columnMetadata) {
+    if (columnMetadata != null) {
+      return new OptionalColumnMetadata() {
+
+        @Override
+        public String getName() {
+          return columnMetadata.getName();
+        }
+
+        @Override
+        public DataType getType() {
+          return columnMetadata.getType();
+        }
+      };
+    }
+    return null;
+  }
+
+  private static OptionalColumnMetadata optional(final String name, final DataType dataType) {
+    if (dataType != null) {
+      return new OptionalColumnMetadata() {
+
+        @Override
+        public String getName() {
+          return name;
+        }
+
+        @Override
+        public DataType getType() {
+          return dataType;
+        }
+      };
+    }
+    return null;
+  }
+
+  private static String indexName(HelenusProperty prop) {
+      return prop.getEntity().getName().toCql() + "_" + prop.getIndexName().get().toCql();
+  }
 
 }

src/main/java/net/helenus/core/SessionInitializer.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,321 +16,450 @@
  */
 package net.helenus.core;
 
+import com.codahale.metrics.MetricRegistry;
+import com.datastax.driver.core.*;
+import com.google.common.util.concurrent.MoreExecutors;
 import java.io.IOException;
 import java.io.PrintStream;
 import java.util.*;
 import java.util.concurrent.Executor;
 import java.util.concurrent.Executors;
 import java.util.function.Consumer;
-import java.util.stream.Collector;
-import java.util.stream.Collectors;
-import java.util.stream.Stream;
-
-import com.datastax.driver.core.*;
-import com.google.common.util.concurrent.MoreExecutors;
-
+import javax.cache.CacheManager;
+import net.helenus.core.reflect.DslExportable;
 import net.helenus.mapping.HelenusEntity;
 import net.helenus.mapping.HelenusEntityType;
+import net.helenus.mapping.MappingUtil;
 import net.helenus.mapping.value.ColumnValuePreparer;
 import net.helenus.mapping.value.ColumnValueProvider;
+import net.helenus.support.Either;
 import net.helenus.support.HelenusException;
 import net.helenus.support.PackageUtil;
 
 public final class SessionInitializer extends AbstractSessionOperations {
 
-	private final Session session;
-	private CodecRegistry registry;
-	private String usingKeyspace;
-	private boolean showCql = false;
-	private PrintStream printStream = System.out;
-	private Executor executor = MoreExecutors.directExecutor();
+  private final Session session;
+  private final List<Either<Object, Class<?>>> initList = new ArrayList<Either<Object, Class<?>>>();
+  private CodecRegistry registry;
+  private String usingKeyspace;
+  private boolean showCql = false;
+  private boolean showValues = true;
+  private ConsistencyLevel consistencyLevel;
+  private boolean idempotent = false;
+  private MetricRegistry metricRegistry = new MetricRegistry();
+  private PrintStream printStream = System.out;
+  private Executor executor = MoreExecutors.directExecutor();
+  private SessionRepositoryBuilder sessionRepository;
+  private boolean dropUnusedColumns = false;
+  private boolean dropUnusedIndexes = false;
+  private KeyspaceMetadata keyspaceMetadata;
+  private AutoDdl autoDdl = AutoDdl.UPDATE;
+  private CacheManager cacheManager = null;
 
-	private SessionRepositoryBuilder sessionRepository;
-
-	private boolean dropUnusedColumns = false;
-	private boolean dropUnusedIndexes = false;
-
-	private KeyspaceMetadata keyspaceMetadata;
-
-	private final List<Object> initList = new ArrayList<Object>();
-	private AutoDdl autoDdl = AutoDdl.UPDATE;
-
-	SessionInitializer(Session session) {
-		this.session = Objects.requireNonNull(session, "empty session");
-		this.usingKeyspace = session.getLoggedKeyspace(); // can be null
-		this.sessionRepository = new SessionRepositoryBuilder(session);
-	}
-
-	@Override
-	public Session currentSession() {
-		return session;
-	}
-
-	@Override
-	public String usingKeyspace() {
-		return usingKeyspace;
-	}
-
-	@Override
-	public Executor getExecutor() {
-		return executor;
-	}
-
-	@Override
-	public SessionRepository getSessionRepository() {
-		throw new HelenusException("not expected to call");
-	}
-
-	@Override
-	public ColumnValueProvider getValueProvider() {
-		throw new HelenusException("not expected to call");
-	}
-
-	@Override
-	public ColumnValuePreparer getValuePreparer() {
-		throw new HelenusException("not expected to call");
-	}
-
-	public SessionInitializer showCql() {
-		this.showCql = true;
-		return this;
-	}
-
-	public SessionInitializer showCql(boolean enabled) {
-		this.showCql = enabled;
-		return this;
-	}
-
-	@Override
-	public PrintStream getPrintStream() {
-		return printStream;
-	}
-
-	public SessionInitializer printTo(PrintStream out) {
-		this.printStream = out;
-		return this;
-	}
-
-	public SessionInitializer withExecutor(Executor executor) {
-		Objects.requireNonNull(executor, "empty executor");
-		this.executor = executor;
-		return this;
-	}
-
-	public SessionInitializer withCachingExecutor() {
-		this.executor = Executors.newCachedThreadPool();
-		return this;
-	}
-
-	public SessionInitializer dropUnusedColumns(boolean enabled) {
-		this.dropUnusedColumns = enabled;
-		return this;
-	}
-
-	public SessionInitializer dropUnusedIndexes(boolean enabled) {
-		this.dropUnusedIndexes = enabled;
-		return this;
-	}
-
-    public SessionInitializer withCodecRegistry(CodecRegistry registry) {
-	    this.registry = registry;
-        return this;
+  SessionInitializer(Session session, String keyspace) {
+    this.session = session;
+    this.usingKeyspace = keyspace;
+    if (session != null) {
+      this.sessionRepository = new SessionRepositoryBuilder(session);
     }
+  }
 
-    @Override
-	public boolean isShowCql() {
-		return showCql;
-	}
+  SessionInitializer(Session session) {
+    this.session = Objects.requireNonNull(session, "empty session");
+    this.usingKeyspace = session.getLoggedKeyspace(); // can be null
+    this.sessionRepository = new SessionRepositoryBuilder(session);
+  }
 
-	public SessionInitializer addPackage(String packageName) {
-		try {
-			PackageUtil.getClasses(packageName).stream().filter(c -> c.isInterface() && !c.isAnnotation())
-					.forEach(initList::add);
-		} catch (IOException | ClassNotFoundException e) {
-			throw new HelenusException("fail to add package " + packageName, e);
-        }
-		return this;
-	}
+  @Override
+  public Session currentSession() {
+    return session;
+  }
 
-	public SessionInitializer add(Object... dsls) {
-		Objects.requireNonNull(dsls, "dsls is empty");
-		int len = dsls.length;
-		for (int i = 0; i != len; ++i) {
-			Object obj = Objects.requireNonNull(dsls[i], "element " + i + " is empty");
-			initList.add(obj);
-		}
-		return this;
-	}
+  @Override
+  public String usingKeyspace() {
+    return usingKeyspace;
+  }
 
-	public SessionInitializer autoValidate() {
-		this.autoDdl = AutoDdl.VALIDATE;
-		return this;
-	}
+  @Override
+  public Executor getExecutor() {
+    return executor;
+  }
 
-	public SessionInitializer autoUpdate() {
-		this.autoDdl = AutoDdl.UPDATE;
-		return this;
-	}
+  @Override
+  public SessionRepository getSessionRepository() {
+    throw new HelenusException("not expected to call");
+  }
 
-	public SessionInitializer autoCreate() {
-		this.autoDdl = AutoDdl.CREATE;
-		return this;
-	}
+  @Override
+  public ColumnValueProvider getValueProvider() {
+    throw new HelenusException("not expected to call");
+  }
 
-	public SessionInitializer autoCreateDrop() {
-		this.autoDdl = AutoDdl.CREATE_DROP;
-		return this;
-	}
+  @Override
+  public ColumnValuePreparer getValuePreparer() {
+    throw new HelenusException("not expected to call");
+  }
 
-	public SessionInitializer auto(AutoDdl autoDdl) {
-		this.autoDdl = autoDdl;
-		return this;
-	}
+  public SessionInitializer showCql() {
+    this.showCql = true;
+    return this;
+  }
 
-	public SessionInitializer use(String keyspace) {
-		session.execute(SchemaUtil.use(keyspace, false));
-		this.usingKeyspace = keyspace;
-		return this;
-	}
+  public SessionInitializer showCql(boolean enabled) {
+    this.showCql = enabled;
+    return this;
+  }
 
-	public SessionInitializer use(String keyspace, boolean forceQuote) {
-		session.execute(SchemaUtil.use(keyspace, forceQuote));
-		this.usingKeyspace = keyspace;
-		return this;
-	}
+  public SessionInitializer showQueryValuesInLog(boolean showValues) {
+    this.showValues = showValues;
+    return this;
+  }
 
-	public void singleton() {
+  public SessionInitializer showQueryValuesInLog() {
+    this.showValues = true;
+    return this;
+  }
 
-		Helenus.setSession(get());
-	}
+  public boolean showValues() {
+    return showValues;
+  }
 
-	public synchronized HelenusSession get() {
-		initialize();
-		return new HelenusSession(session, usingKeyspace, registry, showCql, printStream, sessionRepository, executor,
-				autoDdl == AutoDdl.CREATE_DROP);
-	}
+  public SessionInitializer metricRegistry(MetricRegistry metricRegistry) {
+    this.metricRegistry = metricRegistry;
+    return this;
+  }
 
-	private void initialize() {
+  public SessionInitializer consistencyLevel(ConsistencyLevel consistencyLevel) {
+    this.consistencyLevel = consistencyLevel;
+    return this;
+  }
 
-		Objects.requireNonNull(usingKeyspace, "please define keyspace by 'use' operator");
+  public SessionInitializer setCacheManager(CacheManager cacheManager) {
+    this.cacheManager = cacheManager;
+    return this;
+  }
 
-		initList.forEach(dsl -> sessionRepository.add(dsl));
+  public ConsistencyLevel getDefaultConsistencyLevel() {
+    return consistencyLevel;
+  }
 
-		TableOperations tableOps = new TableOperations(this, dropUnusedColumns, dropUnusedIndexes);
-		UserTypeOperations userTypeOps = new UserTypeOperations(this, dropUnusedColumns);
+  public SessionInitializer setOperationsIdempotentByDefault() {
+    this.idempotent = true;
+    return this;
+  }
 
-		switch (autoDdl) {
+  public SessionInitializer idempotentQueryExecution(boolean idempotent) {
+    this.idempotent = idempotent;
+    return this;
+  }
 
-			case CREATE_DROP :
+  public boolean getDefaultQueryIdempotency() {
+    return idempotent;
+  }
 
-			    // Drop tables first, otherwise a `DROP TYPE ...` will fail as the type is still referenced
-                // by a table.
-                sessionRepository.entities().stream().filter(e -> e.getType() == HelenusEntityType.TABLE)
-                        .forEach(e -> tableOps.dropTable(e));
+  @Override
+  public PrintStream getPrintStream() {
+    return printStream;
+  }
 
-                eachUserTypeInReverseOrder(userTypeOps, e -> userTypeOps.dropUserType(e));
+  public SessionInitializer printTo(PrintStream out) {
+    this.printStream = out;
+    return this;
+  }
 
-                // FALLTHRU to CREATE case (read: the absence of a `break;` statement here is intentional!)
-			case CREATE :
+  public SessionInitializer withExecutor(Executor executor) {
+    Objects.requireNonNull(executor, "empty executor");
+    this.executor = executor;
+    return this;
+  }
 
-                eachUserTypeInOrder(userTypeOps, e -> userTypeOps.createUserType(e));
+  public SessionInitializer withCachingExecutor() {
+    this.executor = Executors.newCachedThreadPool();
+    return this;
+  }
 
-                sessionRepository.entities().stream().filter(e -> e.getType() == HelenusEntityType.TABLE)
-                        .forEach(e -> tableOps.createTable(e));
+  public SessionInitializer dropUnusedColumns(boolean enabled) {
+    this.dropUnusedColumns = enabled;
+    return this;
+  }
 
-                break;
+  public SessionInitializer dropUnusedIndexes(boolean enabled) {
+    this.dropUnusedIndexes = enabled;
+    return this;
+  }
 
-			case VALIDATE :
+  public SessionInitializer withCodecRegistry(CodecRegistry registry) {
+    this.registry = registry;
+    return this;
+  }
 
-				eachUserTypeInOrder(userTypeOps, e -> userTypeOps.validateUserType(getUserType(e), e));
+  @Override
+  public boolean isShowCql() {
+    return showCql;
+  }
 
-				sessionRepository.entities().stream().filter(e -> e.getType() == HelenusEntityType.TABLE)
-						.forEach(e -> tableOps.validateTable(getTableMetadata(e), e));
-				break;
+  public SessionInitializer addPackage(String packageName) {
+    try {
+      PackageUtil.getClasses(packageName)
+          .stream()
+          .filter(c -> c.isInterface() && !c.isAnnotation())
+          .forEach(
+              clazz -> {
+                initList.add(Either.right(clazz));
+              });
+    } catch (IOException | ClassNotFoundException e) {
+      throw new HelenusException("fail to add package " + packageName, e);
+    }
+    return this;
+  }
 
-			case UPDATE :
+  public SessionInitializer add(Object... dsls) {
+    Objects.requireNonNull(dsls, "dsls is empty");
+    int len = dsls.length;
+    for (int i = 0; i != len; ++i) {
+      Object obj = Objects.requireNonNull(dsls[i], "element " + i + " is empty");
+      initList.add(Either.left(obj));
+    }
+    return this;
+  }
 
-				eachUserTypeInOrder(userTypeOps, e -> userTypeOps.updateUserType(getUserType(e), e));
+  public SessionInitializer autoValidate() {
+    this.autoDdl = AutoDdl.VALIDATE;
+    return this;
+  }
 
-				sessionRepository.entities().stream().filter(e -> e.getType() == HelenusEntityType.TABLE)
-						.forEach(e -> tableOps.updateTable(getTableMetadata(e), e));
-				break;
+  public SessionInitializer autoUpdate() {
+    this.autoDdl = AutoDdl.UPDATE;
+    return this;
+  }
 
-		}
+  public SessionInitializer autoCreate() {
+    this.autoDdl = AutoDdl.CREATE;
+    return this;
+  }
 
-		KeyspaceMetadata km = getKeyspaceMetadata();
+  public SessionInitializer autoCreateDrop() {
+    this.autoDdl = AutoDdl.CREATE_DROP;
+    return this;
+  }
 
-		for (UserType userType : km.getUserTypes()) {
-			sessionRepository.addUserType(userType.getTypeName(), userType);
-		}
+  public SessionInitializer auto(AutoDdl autoDdl) {
+    this.autoDdl = autoDdl;
+    return this;
+  }
 
-	}
+  public SessionInitializer use(String keyspace) {
+    if (session != null) {
+      session.execute(SchemaUtil.use(keyspace, false));
+      this.usingKeyspace = keyspace;
+    }
+    return this;
+  }
 
-    private void eachUserTypeInOrder(UserTypeOperations userTypeOps, Consumer<? super HelenusEntity> action) {
+  public SessionInitializer use(String keyspace, boolean forceQuote) {
+    session.execute(SchemaUtil.use(keyspace, forceQuote));
+    this.usingKeyspace = keyspace;
+    return this;
+  }
 
-        Set<HelenusEntity> processedSet = new HashSet<HelenusEntity>();
-        Set<HelenusEntity> stack = new HashSet<HelenusEntity>();
+  public void singleton() {
+    Helenus.setSession(get());
+  }
 
-        sessionRepository.entities().stream().filter(e -> e.getType() == HelenusEntityType.UDT).forEach(e -> {
-            stack.clear();
-            eachUserTypeInRecursion(e, processedSet, stack, userTypeOps, action);
+  public synchronized HelenusSession get() {
+    initialize();
+    return new HelenusSession(
+        session,
+        usingKeyspace,
+        registry,
+        showCql,
+        showValues,
+        printStream,
+        sessionRepository,
+        executor,
+        autoDdl == AutoDdl.CREATE_DROP,
+        consistencyLevel,
+        idempotent,
+        cacheManager,
+        metricRegistry);
+  }
+
+  private void initialize() {
+
+    Objects.requireNonNull(usingKeyspace, "please define keyspace by 'use' operator");
+
+    initList.forEach(
+        (either) -> {
+          Class<?> iface = null;
+          if (either.isLeft()) {
+            iface = MappingUtil.getMappingInterface(either.getLeft());
+          } else {
+            iface = either.getRight();
+          }
+
+          DslExportable dsl = (DslExportable) Helenus.dsl(iface);
+          if (session != null) {
+            dsl.setCassandraMetadataForHelenusSession(session.getCluster().getMetadata());
+          }
+          if (sessionRepository != null) {
+            sessionRepository.add(dsl);
+          }
         });
 
+    if (session == null) return;
+
+    TableOperations tableOps = new TableOperations(this, dropUnusedColumns, dropUnusedIndexes);
+    UserTypeOperations userTypeOps = new UserTypeOperations(this, dropUnusedColumns);
+
+    switch (autoDdl) {
+      case CREATE_DROP:
+
+        // Drop view first, otherwise a `DROP TABLE ...` will fail as the type is still
+        // referenced
+        // by a view.
+        sessionRepository
+            .entities()
+            .stream()
+            .filter(e -> e.getType() == HelenusEntityType.VIEW)
+            .forEach(e -> tableOps.dropView(e));
+
+        // Drop tables second, before DROP TYPE otherwise a `DROP TYPE ...` will fail as
+        // the type is
+        // still referenced by a table.
+        sessionRepository
+            .entities()
+            .stream()
+            .filter(e -> e.getType() == HelenusEntityType.TABLE)
+            .forEach(e -> tableOps.dropTable(e));
+
+        eachUserTypeInReverseOrder(userTypeOps, e -> userTypeOps.dropUserType(e));
+
+        // FALLTHRU to CREATE case (read: the absence of a `break;` statement here is
+        // intentional!)
+      case CREATE:
+        eachUserTypeInOrder(userTypeOps, e -> userTypeOps.createUserType(e));
+
+        sessionRepository
+            .entities()
+            .stream()
+            .filter(e -> e.getType() == HelenusEntityType.TABLE)
+            .forEach(e -> tableOps.createTable(e));
+
+        sessionRepository
+            .entities()
+            .stream()
+            .filter(e -> e.getType() == HelenusEntityType.VIEW)
+            .forEach(e -> tableOps.createView(e));
+
+        break;
+
+      case VALIDATE:
+        eachUserTypeInOrder(userTypeOps, e -> userTypeOps.validateUserType(getUserType(e), e));
+
+        sessionRepository
+            .entities()
+            .stream()
+            .filter(e -> e.getType() == HelenusEntityType.TABLE)
+            .forEach(e -> tableOps.validateTable(getTableMetadata(e), e));
+
+        break;
+
+      case UPDATE:
+        eachUserTypeInOrder(userTypeOps, e -> userTypeOps.updateUserType(getUserType(e), e));
+
+        sessionRepository
+            .entities()
+            .stream()
+            .filter(e -> e.getType() == HelenusEntityType.VIEW)
+            .forEach(e -> tableOps.dropView(e));
+
+        sessionRepository
+            .entities()
+            .stream()
+            .filter(e -> e.getType() == HelenusEntityType.TABLE)
+            .forEach(e -> tableOps.updateTable(getTableMetadata(e), e));
+
+        sessionRepository
+            .entities()
+            .stream()
+            .filter(e -> e.getType() == HelenusEntityType.VIEW)
+            .forEach(e -> tableOps.createView(e));
+        break;
     }
 
-    private void eachUserTypeInReverseOrder(UserTypeOperations userTypeOps, Consumer<? super HelenusEntity> action) {
-	    ArrayDeque<HelenusEntity> deque = new ArrayDeque<>();
-	    eachUserTypeInOrder(userTypeOps, e -> deque.addFirst(e));
-	    deque.stream().forEach(e -> {action.accept(e); });
-/*
-        Set<HelenusEntity> processedSet = new HashSet<HelenusEntity>();
-        Set<HelenusEntity> stack = new HashSet<HelenusEntity>();
+    KeyspaceMetadata km = getKeyspaceMetadata();
 
-        sessionRepository.entities().stream()
-                .filter(e -> e.getType() == HelenusEntityType.UDT)
-                .collect(Collectors.toCollection(ArrayDeque::new))
-                .descendingIterator()
-                .forEachRemaining(e -> {
-                    stack.clear();
-                    eachUserTypeInRecursion(e, processedSet, stack, userTypeOps, action);
-                });
-*/
+    for (UserType userType : km.getUserTypes()) {
+      sessionRepository.addUserType(userType.getTypeName(), userType);
+    }
+  }
+
+  private void eachUserTypeInOrder(
+      UserTypeOperations userTypeOps, Consumer<? super HelenusEntity> action) {
+
+    Set<HelenusEntity> processedSet = new HashSet<HelenusEntity>();
+    Set<HelenusEntity> stack = new HashSet<HelenusEntity>();
+
+    sessionRepository
+        .entities()
+        .stream()
+        .filter(e -> e.getType() == HelenusEntityType.UDT)
+        .forEach(
+            e -> {
+              stack.clear();
+              eachUserTypeInRecursion(e, processedSet, stack, userTypeOps, action);
+            });
+  }
+
+  private void eachUserTypeInReverseOrder(
+      UserTypeOperations userTypeOps, Consumer<? super HelenusEntity> action) {
+    ArrayDeque<HelenusEntity> deque = new ArrayDeque<>();
+    eachUserTypeInOrder(userTypeOps, e -> deque.addFirst(e));
+    deque
+        .stream()
+        .forEach(
+            e -> {
+              action.accept(e);
+            });
+  }
+
+  private void eachUserTypeInRecursion(
+      HelenusEntity e,
+      Set<HelenusEntity> processedSet,
+      Set<HelenusEntity> stack,
+      UserTypeOperations userTypeOps,
+      Consumer<? super HelenusEntity> action) {
+
+    stack.add(e);
+
+    Collection<HelenusEntity> createBefore = sessionRepository.getUserTypeUses(e);
+
+    for (HelenusEntity be : createBefore) {
+      if (!processedSet.contains(be) && !stack.contains(be)) {
+        eachUserTypeInRecursion(be, processedSet, stack, userTypeOps, action);
+        processedSet.add(be);
+      }
     }
 
-    private void eachUserTypeInRecursion(HelenusEntity e, Set<HelenusEntity> processedSet, Set<HelenusEntity> stack,
-			UserTypeOperations userTypeOps, Consumer<? super HelenusEntity> action) {
+    if (!processedSet.contains(e)) {
+      action.accept(e);
+      processedSet.add(e);
+    }
+  }
 
-		stack.add(e);
+  private KeyspaceMetadata getKeyspaceMetadata() {
+    if (keyspaceMetadata == null) {
+      keyspaceMetadata =
+          session.getCluster().getMetadata().getKeyspace(usingKeyspace.toLowerCase());
+    }
+    return keyspaceMetadata;
+  }
 
-		Collection<HelenusEntity> createBefore = sessionRepository.getUserTypeUses(e);
+  private TableMetadata getTableMetadata(HelenusEntity entity) {
+    return getKeyspaceMetadata().getTable(entity.getName().getName());
+  }
 
-		for (HelenusEntity be : createBefore) {
-			if (!processedSet.contains(be) && !stack.contains(be)) {
-				eachUserTypeInRecursion(be, processedSet, stack, userTypeOps, action);
-				processedSet.add(be);
-			}
-		}
-
-		if (!processedSet.contains(e)) {
-			action.accept(e);
-			processedSet.add(e);
-		}
-
-	}
-
-	private KeyspaceMetadata getKeyspaceMetadata() {
-		if (keyspaceMetadata == null) {
-			keyspaceMetadata = session.getCluster().getMetadata().getKeyspace(usingKeyspace.toLowerCase());
-		}
-		return keyspaceMetadata;
-	}
-
-	private TableMetadata getTableMetadata(HelenusEntity entity) {
-		return getKeyspaceMetadata().getTable(entity.getName().getName());
-
-	}
-
-	private UserType getUserType(HelenusEntity entity) {
-		return getKeyspaceMetadata().getUserType(entity.getName().getName());
-	}
+  private UserType getUserType(HelenusEntity entity) {
+    return getKeyspaceMetadata().getUserType(entity.getName().getName());
+  }
 }

src/main/java/net/helenus/core/SessionRepository.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,32 +16,30 @@
  */
 package net.helenus.core;
 
-import java.util.Collection;
-
 import com.datastax.driver.core.UserType;
 import com.google.common.collect.ImmutableMap;
-
+import java.util.Collection;
 import net.helenus.mapping.HelenusEntity;
 
 public final class SessionRepository {
 
-	private final ImmutableMap<String, UserType> userTypeMap;
+  private final ImmutableMap<String, UserType> userTypeMap;
 
-	private final ImmutableMap<Class<?>, HelenusEntity> entityMap;
+  private final ImmutableMap<Class<?>, HelenusEntity> entityMap;
 
-	public SessionRepository(SessionRepositoryBuilder builder) {
+  public SessionRepository(SessionRepositoryBuilder builder) {
 
-		userTypeMap = ImmutableMap.<String, UserType>builder().putAll(builder.getUserTypeMap()).build();
+    userTypeMap = ImmutableMap.<String, UserType>builder().putAll(builder.getUserTypeMap()).build();
 
-		entityMap = ImmutableMap.<Class<?>, HelenusEntity>builder().putAll(builder.getEntityMap()).build();
-	}
+    entityMap =
+        ImmutableMap.<Class<?>, HelenusEntity>builder().putAll(builder.getEntityMap()).build();
+  }
 
-	public UserType findUserType(String name) {
-		return userTypeMap.get(name.toLowerCase());
-	}
-
-	public Collection<HelenusEntity> entities() {
-		return entityMap.values();
-	}
+  public UserType findUserType(String name) {
+    return userTypeMap.get(name.toLowerCase());
+  }
 
+  public Collection<HelenusEntity> entities() {
+    return entityMap.values();
+  }
 }

src/main/java/net/helenus/core/SessionRepositoryBuilder.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,17 +16,15 @@
  */
 package net.helenus.core;
 
-import java.util.Collection;
-import java.util.HashMap;
-import java.util.Map;
-import java.util.Optional;
-
 import com.datastax.driver.core.Session;
 import com.datastax.driver.core.UDTValue;
 import com.datastax.driver.core.UserType;
 import com.google.common.collect.HashMultimap;
 import com.google.common.collect.Multimap;
-
+import java.util.Collection;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Optional;
 import net.helenus.mapping.HelenusEntity;
 import net.helenus.mapping.HelenusEntityType;
 import net.helenus.mapping.HelenusProperty;
@@ -35,118 +34,112 @@ import net.helenus.support.HelenusMappingException;
 
 public final class SessionRepositoryBuilder {
 
-	private static final Optional<HelenusEntityType> OPTIONAL_UDT = Optional.of(HelenusEntityType.UDT);
+  private static final Optional<HelenusEntityType> OPTIONAL_UDT =
+      Optional.of(HelenusEntityType.UDT);
 
-	private final Map<Class<?>, HelenusEntity> entityMap = new HashMap<Class<?>, HelenusEntity>();
+  private final Map<Class<?>, HelenusEntity> entityMap = new HashMap<Class<?>, HelenusEntity>();
 
-	private final Map<String, UserType> userTypeMap = new HashMap<String, UserType>();
+  private final Map<String, UserType> userTypeMap = new HashMap<String, UserType>();
 
-	private final Multimap<HelenusEntity, HelenusEntity> userTypeUsesMap = HashMultimap.create();
+  private final Multimap<HelenusEntity, HelenusEntity> userTypeUsesMap = HashMultimap.create();
 
-	private final Session session;
+  private final Session session;
 
+  SessionRepositoryBuilder(Session session) {
+    this.session = session;
+  }
 
-	SessionRepositoryBuilder(Session session) {
-		this.session = session;
-	}
+  public SessionRepository build() {
+    return new SessionRepository(this);
+  }
 
-	public SessionRepository build() {
-		return new SessionRepository(this);
-	}
+  public Collection<HelenusEntity> getUserTypeUses(HelenusEntity udtName) {
+    return userTypeUsesMap.get(udtName);
+  }
 
-	public Collection<HelenusEntity> getUserTypeUses(HelenusEntity udtName) {
-		return userTypeUsesMap.get(udtName);
-	}
+  public Collection<HelenusEntity> entities() {
+    return entityMap.values();
+  }
 
-	public Collection<HelenusEntity> entities() {
-		return entityMap.values();
-	}
+  protected Map<Class<?>, HelenusEntity> getEntityMap() {
+    return entityMap;
+  }
 
-	protected Map<Class<?>, HelenusEntity> getEntityMap() {
-		return entityMap;
-	}
+  protected Map<String, UserType> getUserTypeMap() {
+    return userTypeMap;
+  }
 
-	protected Map<String, UserType> getUserTypeMap() {
-		return userTypeMap;
-	}
+  public void addUserType(String name, UserType userType) {
+    userTypeMap.putIfAbsent(name.toLowerCase(), userType);
+  }
 
-	public void addUserType(String name, UserType userType) {
-		userTypeMap.putIfAbsent(name.toLowerCase(), userType);
-	}
+  public HelenusEntity add(Object dsl) {
+    return add(dsl, Optional.empty());
+  }
 
-	public HelenusEntity add(Object dsl) {
-		return add(dsl, Optional.empty());
-	}
+  public void addEntity(HelenusEntity entity) {
 
-	public void addEntity(HelenusEntity entity) {
+    HelenusEntity concurrentEntity = entityMap.putIfAbsent(entity.getMappingInterface(), entity);
 
-		HelenusEntity concurrentEntity = entityMap.putIfAbsent(entity.getMappingInterface(), entity);
+    if (concurrentEntity == null) {
+      addUserDefinedTypes(entity.getOrderedProperties());
+    }
+  }
 
-		if (concurrentEntity == null) {
-			addUserDefinedTypes(entity.getOrderedProperties());
-		}
+  public HelenusEntity add(Object dsl, Optional<HelenusEntityType> type) {
 
-	}
+    HelenusEntity helenusEntity = Helenus.resolve(dsl, session.getCluster().getMetadata());
 
-	public HelenusEntity add(Object dsl, Optional<HelenusEntityType> type) {
+    Class<?> iface = helenusEntity.getMappingInterface();
 
-		HelenusEntity helenusEntity = Helenus.resolve(dsl, session.getCluster().getMetadata());
+    HelenusEntity entity = entityMap.get(iface);
 
-		Class<?> iface = helenusEntity.getMappingInterface();
+    if (entity == null) {
 
-		HelenusEntity entity = entityMap.get(iface);
+      entity = helenusEntity;
 
-		if (entity == null) {
+      if (type.isPresent() && entity.getType() != type.get()) {
+        throw new HelenusMappingException(
+            "unexpected entity type " + entity.getType() + " for " + entity);
+      }
 
-			entity = helenusEntity;
+      HelenusEntity concurrentEntity = entityMap.putIfAbsent(iface, entity);
 
-			if (type.isPresent() && entity.getType() != type.get()) {
-				throw new HelenusMappingException("unexpected entity type " + entity.getType() + " for " + entity);
-			}
+      if (concurrentEntity == null) {
+        addUserDefinedTypes(entity.getOrderedProperties());
+      } else {
+        entity = concurrentEntity;
+      }
+    }
 
-			HelenusEntity concurrentEntity = entityMap.putIfAbsent(iface, entity);
+    return entity;
+  }
 
-			if (concurrentEntity == null) {
-				addUserDefinedTypes(entity.getOrderedProperties());
-			} else {
-				entity = concurrentEntity;
-			}
+  private void addUserDefinedTypes(Collection<HelenusProperty> props) {
 
-		}
+    for (HelenusProperty prop : props) {
 
-		return entity;
-	}
+      AbstractDataType type = prop.getDataType();
 
-	private void addUserDefinedTypes(Collection<HelenusProperty> props) {
+      if (type instanceof DTDataType) {
+        continue;
+      }
 
-		for (HelenusProperty prop : props) {
+      if (!UDTValue.class.isAssignableFrom(prop.getJavaType())) {
 
-			AbstractDataType type = prop.getDataType();
+        for (Class<?> udtClass : type.getTypeArguments()) {
 
-			if (type instanceof DTDataType) {
-				continue;
-			}
+          if (UDTValue.class.isAssignableFrom(udtClass)) {
+            continue;
+          }
 
-			if (!UDTValue.class.isAssignableFrom(prop.getJavaType())) {
-
-				for (Class<?> udtClass : type.getTypeArguments()) {
-
-					if (UDTValue.class.isAssignableFrom(udtClass)) {
-						continue;
-					}
-
-					HelenusEntity addedUserType = add(udtClass, OPTIONAL_UDT);
-
-					if (HelenusEntityType.UDT == prop.getEntity().getType()) {
-						userTypeUsesMap.put(prop.getEntity(), addedUserType);
-					}
-
-				}
-
-			}
-
-		}
-
-	}
+          HelenusEntity addedUserType = add(udtClass, OPTIONAL_UDT);
 
+          if (HelenusEntityType.UDT == prop.getEntity().getType()) {
+            userTypeUsesMap.put(prop.getEntity(), addedUserType);
+          }
+        }
+      }
+    }
+  }
 }

src/main/java/net/helenus/core/TableOperations.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,74 +16,92 @@
  */
 package net.helenus.core;
 
-import java.util.List;
-
 import com.datastax.driver.core.TableMetadata;
 import com.datastax.driver.core.schemabuilder.SchemaStatement;
-
+import java.util.List;
 import net.helenus.mapping.HelenusEntity;
 import net.helenus.support.HelenusException;
 
 public final class TableOperations {
 
-	private final AbstractSessionOperations sessionOps;
-	private final boolean dropUnusedColumns;
-	private final boolean dropUnusedIndexes;
+  private final AbstractSessionOperations sessionOps;
+  private final boolean dropUnusedColumns;
+  private final boolean dropUnusedIndexes;
 
-	public TableOperations(AbstractSessionOperations sessionOps, boolean dropUnusedColumns, boolean dropUnusedIndexes) {
-		this.sessionOps = sessionOps;
-		this.dropUnusedColumns = dropUnusedColumns;
-		this.dropUnusedIndexes = dropUnusedIndexes;
-	}
+  public TableOperations(
+      AbstractSessionOperations sessionOps, boolean dropUnusedColumns, boolean dropUnusedIndexes) {
+    this.sessionOps = sessionOps;
+    this.dropUnusedColumns = dropUnusedColumns;
+    this.dropUnusedIndexes = dropUnusedIndexes;
+  }
 
-	public void createTable(HelenusEntity entity) {
+  public void createTable(HelenusEntity entity) {
+    sessionOps.execute(SchemaUtil.createTable(entity));
+    executeBatch(SchemaUtil.createIndexes(entity));
+  }
 
-		sessionOps.execute(SchemaUtil.createTable(entity), true);
+  public void dropTable(HelenusEntity entity) {
+    sessionOps.execute(SchemaUtil.dropTable(entity));
+  }
 
-		executeBatch(SchemaUtil.createIndexes(entity));
-
-	}
-
-	public void dropTable(HelenusEntity entity) {
-
-	    sessionOps.execute(SchemaUtil.dropTable(entity), true);
+  public void validateTable(TableMetadata tmd, HelenusEntity entity) {
 
+    if (tmd == null) {
+      throw new HelenusException(
+          "table does not exists "
+              + entity.getName()
+              + "for entity "
+              + entity.getMappingInterface());
     }
 
-	public void validateTable(TableMetadata tmd, HelenusEntity entity) {
+    List<SchemaStatement> list = SchemaUtil.alterTable(tmd, entity, dropUnusedColumns);
 
-		if (tmd == null) {
-			throw new HelenusException(
-					"table not exists " + entity.getName() + "for entity " + entity.getMappingInterface());
-		}
+    list.addAll(SchemaUtil.alterIndexes(tmd, entity, dropUnusedIndexes));
 
-		List<SchemaStatement> list = SchemaUtil.alterTable(tmd, entity, dropUnusedColumns);
+    if (!list.isEmpty()) {
+      throw new HelenusException(
+          "schema changed for entity "
+              + entity.getMappingInterface()
+              + ", apply this command: "
+              + list);
+    }
+  }
 
-		list.addAll(SchemaUtil.alterIndexes(tmd, entity, dropUnusedIndexes));
+  public void updateTable(TableMetadata tmd, HelenusEntity entity) {
+    if (tmd == null) {
+      createTable(entity);
+      return;
+    }
 
-		if (!list.isEmpty()) {
-			throw new HelenusException(
-					"schema changed for entity " + entity.getMappingInterface() + ", apply this command: " + list);
-		}
-	}
+    executeBatch(SchemaUtil.alterTable(tmd, entity, dropUnusedColumns));
+    executeBatch(SchemaUtil.alterIndexes(tmd, entity, dropUnusedIndexes));
+  }
 
-	public void updateTable(TableMetadata tmd, HelenusEntity entity) {
+  public void createView(HelenusEntity entity) {
+    sessionOps.execute(
+        SchemaUtil.createMaterializedView(
+            sessionOps.usingKeyspace(), entity.getName().toCql(), entity));
+    // executeBatch(SchemaUtil.createIndexes(entity)); NOTE: Unfortunately C* 3.10 does not yet support 2i on materialized views.
+  }
 
-		if (tmd == null) {
-			createTable(entity);
-			return;
-		}
+  public void dropView(HelenusEntity entity) {
+    sessionOps.execute(
+        SchemaUtil.dropMaterializedView(
+            sessionOps.usingKeyspace(), entity.getName().toCql(), entity));
+  }
 
-		executeBatch(SchemaUtil.alterTable(tmd, entity, dropUnusedColumns));
-		executeBatch(SchemaUtil.alterIndexes(tmd, entity, dropUnusedIndexes));
-	}
+  public void updateView(TableMetadata tmd, HelenusEntity entity) {
+    if (tmd == null) {
+      createTable(entity);
+      return;
+    }
 
-	private void executeBatch(List<SchemaStatement> list) {
+    executeBatch(SchemaUtil.alterTable(tmd, entity, dropUnusedColumns));
+    executeBatch(SchemaUtil.alterIndexes(tmd, entity, dropUnusedIndexes));
+  }
 
-		list.forEach(s -> {
-			sessionOps.execute(s, true);
-		});
-
-	}
+  private void executeBatch(List<SchemaStatement> list) {
 
+    list.forEach(s -> sessionOps.execute(s));
+  }
 }

src/main/java/net/helenus/core/UnitOfWork.java

@@ -1,60 +1,816 @@
+/*
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
 package net.helenus.core;
 
+import static net.helenus.core.HelenusSession.deleted;
+
+import com.google.common.base.Stopwatch;
+import com.google.common.collect.HashBasedTable;
+import com.google.common.collect.Table;
+import com.google.common.collect.TreeTraverser;
+import java.io.Serializable;
 import java.util.ArrayList;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Optional;
+import java.util.Set;
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.TimeUnit;
+import java.util.concurrent.TimeoutException;
+import java.util.function.Consumer;
+import java.util.stream.Collectors;
+import javax.cache.Cache;
+import javax.cache.CacheManager;
+import javax.cache.configuration.CacheEntryListenerConfiguration;
+import javax.cache.configuration.Configuration;
+import javax.cache.integration.CacheLoader;
+import javax.cache.integration.CacheLoaderException;
+import javax.cache.integration.CompletionListener;
+import javax.cache.processor.EntryProcessor;
+import javax.cache.processor.EntryProcessorException;
+import javax.cache.processor.EntryProcessorResult;
 
-/**
- * Encapsulates the concept of a "transaction" as a unit-of-work.
- */
-public class UnitOfWork {
+import net.helenus.core.cache.CacheUtil;
+import net.helenus.core.cache.Facet;
+import net.helenus.core.cache.MapCache;
+import net.helenus.core.operation.AbstractOperation;
+import net.helenus.core.operation.BatchOperation;
+import net.helenus.mapping.MappingUtil;
+import net.helenus.support.CheckedRunnable;
+import net.helenus.support.Either;
+import net.helenus.support.HelenusException;
+import org.apache.commons.lang3.SerializationUtils;
+import org.apache.commons.lang3.StringUtils;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 
-	private final HelenusSession session;
-	private ArrayList<UnitOfWork> nested;
+/** Encapsulates the concept of a "transaction" as a unit-of-work. */
+public class UnitOfWork implements AutoCloseable {
+  private static final Logger LOG = LoggerFactory.getLogger(UnitOfWork.class);
 
-	UnitOfWork(HelenusSession session) {
-		this.session = session;
-		// log.record(txn::start)
-	}
+  public final UnitOfWork parent;
+  protected final List<UnitOfWork> nested = new ArrayList<>();
+  protected final Table<String, String, Either<Object, List<Facet>>> cache = HashBasedTable.create();
+  protected final EvictTrackingMapCache<String, Object> statementCache;
+  protected final HelenusSession session;
+  protected String purpose;
+  protected List<String> nestedPurposes = new ArrayList<String>();
+  protected String info;
+  protected int cacheHits = 0;
+  protected int cacheMisses = 0;
+  protected int databaseLookups = 0;
+  protected final Stopwatch elapsedTime;
+  protected Map<String, Double> databaseTime = new HashMap<>();
+  protected double cacheLookupTimeMSecs = 0.0;
+  private List<CheckedRunnable> commitThunks = new ArrayList<>();
+  private List<CheckedRunnable> abortThunks = new ArrayList<>();
+  private Consumer<? super Throwable> exceptionallyThunk;
+  private List<CompletableFuture<?>> asyncOperationFutures = new ArrayList<CompletableFuture<?>>();
+  private boolean aborted = false;
+  private boolean committed = false;
+  private long committedAt = 0L;
+  private BatchOperation batch;
 
-	/**
-	 * Marks the beginning of a transactional section of work. Will write a record
-	 * to the shared write-ahead log.
-	 *
-	 * @return the handle used to commit or abort the work.
-	 */
-	public UnitOfWork begin() {
-		if (nested == null) {
-			nested = new ArrayList<UnitOfWork>();
-		}
-		UnitOfWork unitOfWork = new UnitOfWork(session);
-		nested.add(unitOfWork);
-		return unitOfWork;
-	}
+  public UnitOfWork(HelenusSession session) {
+    this(session, null);
+  }
 
-	/**
-	 * Checks to see if the work performed between calling begin and now can be
-	 * committed or not.
-	 *
-	 * @throws ConflictingUnitOfWorkException
-	 *             when the work overlaps with other concurrent writers.
-	 */
-	public void commit() throws ConflictingUnitOfWorkException {
-		// nested.foreach.commit()
-		// log.record(txn::provisionalCommit)
-		// examine log for conflicts in read-set and write-set between begin and
-		// provisional commit
-		// if (conflict) { throw new ConflictingUnitOfWorkException(this) }
-	}
+  public UnitOfWork(HelenusSession session, UnitOfWork parent) {
+    Objects.requireNonNull(session, "containing session cannot be null");
 
-	/**
-	 * Explicitly discard the work and mark it as as such in the log.
-	 */
-	public void abort() {
-		// log.record(txn::abort)
-		// cache.invalidateSince(txn::start time)
-	}
+    this.parent = parent;
+    if (parent != null) {
+      parent.addNestedUnitOfWork(this);
+    }
+    this.session = session;
+    CacheLoader<String, Object> cacheLoader = null;
+    if (parent != null) {
+      cacheLoader =
+          new CacheLoader<String, Object>() {
 
-	public String describeConflicts() {
-		return "it's complex...";
-	}
+            Cache<String, Object> cache = parent.getCache();
 
+            @Override
+            public Object load(String key) throws CacheLoaderException {
+              return cache.get(key);
+            }
+
+            @Override
+            public Map<String, Object> loadAll(Iterable<? extends String> keys)
+                throws CacheLoaderException {
+              Map<String, Object> kvp = new HashMap<String, Object>();
+              for (String key : keys) {
+                kvp.put(key, cache.get(key));
+              }
+              return kvp;
+            }
+          };
+    }
+    this.elapsedTime = Stopwatch.createUnstarted();
+    this.statementCache = new EvictTrackingMapCache<String, Object>(null, "UOW(" + hashCode() + ")", cacheLoader, true);
+  }
+
+  public void addDatabaseTime(String name, Stopwatch amount) {
+    Double time = databaseTime.get(name);
+    if (time == null) {
+      databaseTime.put(name, (double) amount.elapsed(TimeUnit.MICROSECONDS));
+    } else {
+      databaseTime.put(name, time + amount.elapsed(TimeUnit.MICROSECONDS));
+    }
+  }
+
+  public void addCacheLookupTime(Stopwatch amount) {
+    cacheLookupTimeMSecs += amount.elapsed(TimeUnit.MICROSECONDS);
+  }
+
+  public void addNestedUnitOfWork(UnitOfWork uow) {
+    synchronized (nested) {
+      nested.add(uow);
+    }
+  }
+
+  /**
+   * Marks the beginning of a transactional section of work. Will write a
+   * recordCacheAndDatabaseOperationCount to the shared write-ahead log.
+   *
+   * @return the handle used to commit or abort the work.
+   */
+  public synchronized UnitOfWork begin() {
+    elapsedTime.start();
+    // log.record(txn::start)
+    return this;
+  }
+
+  public String getPurpose() {
+    return purpose;
+  }
+
+  public UnitOfWork setPurpose(String purpose) {
+    this.purpose = purpose;
+    return this;
+  }
+
+  public void addFuture(CompletableFuture<?> future) {
+    asyncOperationFutures.add(future);
+  }
+
+  public void setInfo(String info) {
+    this.info = info;
+  }
+
+  public void recordCacheAndDatabaseOperationCount(int cache, int ops) {
+    if (cache > 0) {
+      cacheHits += cache;
+    } else {
+      cacheMisses += Math.abs(cache);
+    }
+    if (ops > 0) {
+      databaseLookups += ops;
+    }
+  }
+
+  public String logTimers(String what) {
+    double e = (double) elapsedTime.elapsed(TimeUnit.MICROSECONDS) / 1000.0;
+    double d = 0.0;
+    double c = cacheLookupTimeMSecs / 1000.0;
+    double fc = (c / e) * 100.0;
+    String database = "";
+    if (databaseTime.size() > 0) {
+      List<String> dbt = new ArrayList<>(databaseTime.size());
+      for (Map.Entry<String, Double> dt : databaseTime.entrySet()) {
+        double t = dt.getValue() / 1000.0;
+        d += t;
+        dbt.add(String.format("%s took %,.3fms %,2.2f%%", dt.getKey(), t, (t / e) * 100.0));
+      }
+      double fd = (d / e) * 100.0;
+      database =
+          String.format(
+              ", %d quer%s (%,.3fms %,2.2f%% - %s)",
+              databaseLookups, (databaseLookups > 1) ? "ies" : "y", d, fd, String.join(", ", dbt));
+    }
+    String cache = "";
+    if (cacheLookupTimeMSecs > 0) {
+      int cacheLookups = cacheHits + cacheMisses;
+      cache =
+          String.format(
+              " with %d cache lookup%s (%,.3fms %,2.2f%% - %,d hit, %,d miss)",
+              cacheLookups, cacheLookups > 1 ? "s" : "", c, fc, cacheHits, cacheMisses);
+    }
+    String da = "";
+    if (databaseTime.size() > 0 || cacheLookupTimeMSecs > 0) {
+      double dat = d + c;
+      double daf = (dat / e) * 100;
+      da =
+          String.format(
+              " consuming %,.3fms for data access, or %,2.2f%% of total UOW time.", dat, daf);
+    }
+    String x = nestedPurposes.stream().distinct().collect(Collectors.joining(", "));
+    String n =
+        nested
+            .stream()
+            .map(uow -> String.valueOf(uow.hashCode()))
+            .collect(Collectors.joining(", "));
+    String s =
+        String.format(
+            Locale.US,
+            "UOW(%s%s) %s in %,.3fms%s%s%s%s%s%s",
+            hashCode(),
+            (nested.size() > 0 ? ", [" + n + "]" : ""),
+            what,
+            e,
+            cache,
+            database,
+            da,
+            (purpose == null ? "" : " " + purpose),
+            (nestedPurposes.isEmpty()) ? "" : ", " + x,
+            (info == null) ? "" : " " + info);
+    return s;
+  }
+
+  private void applyPostCommitFunctions(String what, List<CheckedRunnable> thunks, Consumer<? super Throwable> exceptionallyThunk) {
+    if (!thunks.isEmpty()) {
+      for (CheckedRunnable f : thunks) {
+          try {
+              f.run();
+          } catch (Throwable t) {
+              if (exceptionallyThunk != null) {
+                  exceptionallyThunk.accept(t);
+              }
+          }
+      }
+    }
+  }
+
+  public Optional<Object> cacheLookup(List<Facet> facets) {
+    String tableName = CacheUtil.schemaName(facets);
+    Optional<Object> result = Optional.empty();
+    for (Facet facet : facets) {
+      if (!facet.fixed()) {
+        String columnName = facet.name() + "==" + facet.value();
+        Either<Object, List<Facet>> eitherValue = cache.get(tableName, columnName);
+        if (eitherValue != null) {
+          Object value = deleted;
+          if (eitherValue.isLeft()) {
+            value = eitherValue.getLeft();
+          }
+          return Optional.of(value);
+        }
+      }
+    }
+
+    // Be sure to check all enclosing UnitOfWork caches as well, we may be nested.
+    result = checkParentCache(facets);
+    if (result.isPresent()) {
+      Object r = result.get();
+      Class<?> iface = MappingUtil.getMappingInterface(r);
+      if (Helenus.entity(iface).isDraftable()) {
+        cacheUpdate(r, facets);
+      } else {
+        cacheUpdate(SerializationUtils.<Serializable>clone((Serializable) r), facets);
+      }
+    }
+    return result;
+  }
+
+  private Optional<Object> checkParentCache(List<Facet> facets) {
+    Optional<Object> result = Optional.empty();
+    if (parent != null) {
+      result = parent.checkParentCache(facets);
+    }
+    return result;
+  }
+
+  public List<Facet> cacheEvict(List<Facet> facets) {
+    Either<Object, List<Facet>> deletedObjectFacets = Either.right(facets);
+    String tableName = CacheUtil.schemaName(facets);
+    Optional<Object> optionalValue = cacheLookup(facets);
+
+    for (Facet facet : facets) {
+      if (!facet.fixed()) {
+        String columnKey = facet.name() + "==" + facet.value();
+        // mark the value identified by the facet to `deleted`
+        cache.put(tableName, columnKey, deletedObjectFacets);
+      }
+    }
+
+    // Now, look for other row/col pairs that referenced the same object, mark them
+    // `deleted` if the cache had a value before we added the deleted marker objects.
+    if (optionalValue.isPresent()) {
+      Object value = optionalValue.get();
+      cache
+          .columnKeySet()
+          .forEach(
+              columnKey -> {
+                Either<Object, List<Facet>> eitherCachedValue = cache.get(tableName, columnKey);
+                if (eitherCachedValue.isLeft()) {
+                  Object cachedValue = eitherCachedValue.getLeft();
+                  if (cachedValue == value) {
+                    cache.put(tableName, columnKey, deletedObjectFacets);
+                    String[] parts = columnKey.split("==");
+                    facets.add(new Facet<String>(parts[0], parts[1]));
+                  }
+                }
+              });
+    }
+    return facets;
+  }
+
+  public Cache<String, Object> getCache() {
+    return statementCache;
+  }
+
+  public Object cacheUpdate(Object value, List<Facet> facets) {
+    Object result = null;
+    String tableName = CacheUtil.schemaName(facets);
+    for (Facet facet : facets) {
+      if (!facet.fixed()) {
+        if (facet.alone()) {
+          String columnName = facet.name() + "==" + facet.value();
+          if (result == null) result = cache.get(tableName, columnName);
+          cache.put(tableName, columnName, Either.left(value));
+        }
+      }
+    }
+    return result;
+  }
+
+  public void batch(AbstractOperation s) {
+    if (batch == null) {
+      batch = new BatchOperation(session);
+    }
+    batch.add(s);
+  }
+
+  private Iterator<UnitOfWork> getChildNodes() {
+    return nested.iterator();
+  }
+
+  /**
+   * Checks to see if the work performed between calling begin and now can be committed or not.
+   *
+   * @return a function from which to chain work that only happens when commit is successful
+   * @throws HelenusException when the work overlaps with other concurrent writers.
+   */
+  public synchronized PostCommitFunction<Void, Void> commit() throws HelenusException {
+
+    if (isDone()) {
+      return PostCommitFunction.NULL_ABORT;
+    }
+
+    // Only the outer-most UOW batches statements for commit time, execute them.
+    if (batch != null) {
+      committedAt = batch.sync(this); //TODO(gburd): update cache with writeTime...
+    }
+
+    // All nested UnitOfWork should be committed (not aborted) before calls to
+    // commit, check.
+    boolean canCommit = true;
+    TreeTraverser<UnitOfWork> traverser = TreeTraverser.using(node -> node::getChildNodes);
+    for (UnitOfWork uow : traverser.postOrderTraversal(this)) {
+      if (this != uow) {
+        canCommit &= (!uow.aborted && uow.committed);
+      }
+    }
+
+    if (!canCommit) {
+
+      if (parent == null) {
+
+        // Apply all post-commit abort functions, this is the outer-most UnitOfWork.
+        traverser
+            .postOrderTraversal(this)
+            .forEach(
+                uow -> {
+                  applyPostCommitFunctions("aborted", abortThunks, exceptionallyThunk);
+                });
+
+        elapsedTime.stop();
+        if (LOG.isInfoEnabled()) {
+          LOG.info(logTimers("aborted"));
+        }
+      }
+
+      return PostCommitFunction.NULL_ABORT;
+    } else {
+      committed = true;
+      aborted = false;
+
+      if (parent == null) {
+
+        // Apply all post-commit commit functions, this is the outer-most UnitOfWork.
+        traverser
+            .postOrderTraversal(this)
+            .forEach(
+                uow -> {
+                  applyPostCommitFunctions("committed", uow.commitThunks, exceptionallyThunk);
+                });
+
+        // Merge our statement cache into the session cache if it exists.
+        CacheManager cacheManager = session.getCacheManager();
+        if (cacheManager != null) {
+          for (Map.Entry<String, Object> entry :
+              (Set<Map.Entry<String, Object>>) statementCache.<Map>unwrap(Map.class).entrySet()) {
+            String[] keyParts = entry.getKey().split("\\.");
+            if (keyParts.length == 2) {
+              String cacheName = keyParts[0];
+              String key = keyParts[1];
+              if (!StringUtils.isBlank(cacheName) && !StringUtils.isBlank(key)) {
+                Cache<Object, Object> cache = cacheManager.getCache(cacheName);
+                if (cache != null) {
+                  Object value = entry.getValue();
+                  if (value == deleted) {
+                    cache.remove(key);
+                  } else {
+                    cache.put(key.toString(), value);
+                  }
+                }
+              }
+            }
+          }
+        }
+
+        // Merge our cache into the session cache.
+        session.mergeCache(cache);
+
+        // Spoil any lingering futures that may be out there.
+        asyncOperationFutures.forEach(
+            f ->
+                f.completeExceptionally(
+                    new HelenusException(
+                        "Futures must be resolved before their unit of work has committed/aborted.")));
+
+        elapsedTime.stop();
+        if (LOG.isInfoEnabled()) {
+          LOG.info(logTimers("committed"));
+        }
+
+        return PostCommitFunction.NULL_COMMIT;
+      } else {
+        // Merge cache and statistics into parent if there is one.
+        parent.statementCache.putAll(statementCache.<Map>unwrap(Map.class));
+        parent.statementCache.removeAll(statementCache.getDeletions());
+        parent.mergeCache(cache);
+        parent.addBatched(batch);
+        if (purpose != null) {
+          parent.nestedPurposes.add(purpose);
+        }
+        parent.cacheHits += cacheHits;
+        parent.cacheMisses += cacheMisses;
+        parent.databaseLookups += databaseLookups;
+        parent.cacheLookupTimeMSecs += cacheLookupTimeMSecs;
+        for (Map.Entry<String, Double> dt : databaseTime.entrySet()) {
+          String name = dt.getKey();
+          if (parent.databaseTime.containsKey(name)) {
+            double t = parent.databaseTime.get(name);
+            parent.databaseTime.put(name, t + dt.getValue());
+          } else {
+            parent.databaseTime.put(name, dt.getValue());
+          }
+        }
+      }
+    }
+    // TODO(gburd): hopefully we'll be able to detect conflicts here and so we'd want to...
+    // else {
+    // Constructor<T> ctor = clazz.getConstructor(conflictExceptionClass);
+    // T object = ctor.newInstance(new Object[] { String message });
+    // }
+    return new PostCommitFunction<Void, Void>(commitThunks, abortThunks, exceptionallyThunk, true);
+  }
+
+  private void addBatched(BatchOperation batchArg) {
+    if (batchArg != null) {
+      if (this.batch == null) {
+        this.batch = batchArg;
+      } else {
+        this.batch.addAll(batchArg);
+      }
+    }
+  }
+
+  /**
+   * Explicitly abort the work within this unit of work. Any nested aborted unit of work will
+   * trigger the entire unit of work to commit.
+   */
+  public synchronized void abort() {
+    if (!aborted) {
+      aborted = true;
+
+      // Spoil any pending futures created within the context of this unit of work.
+      asyncOperationFutures.forEach(
+          f ->
+              f.completeExceptionally(
+                  new HelenusException(
+                      "Futures must be resolved before their unit of work has committed/aborted.")));
+
+      TreeTraverser<UnitOfWork> traverser = TreeTraverser.using(node -> node::getChildNodes);
+      traverser
+          .postOrderTraversal(this)
+          .forEach(
+              uow -> {
+                applyPostCommitFunctions("aborted", uow.abortThunks, exceptionallyThunk);
+                uow.abortThunks.clear();
+              });
+
+      if (parent == null) {
+        if (elapsedTime.isRunning()) {
+          elapsedTime.stop();
+        }
+        if (LOG.isInfoEnabled()) {
+          LOG.info(logTimers("aborted"));
+        }
+      }
+
+      // TODO(gburd): when we integrate the transaction support we'll need to...
+      // log.record(txn::abort)
+      // cache.invalidateSince(txn::start time)
+    }
+  }
+
+  private void mergeCache(Table<String, String, Either<Object, List<Facet>>> from) {
+    Table<String, String, Either<Object, List<Facet>>> to = this.cache;
+    from.rowMap()
+        .forEach(
+            (rowKey, columnMap) -> {
+              columnMap.forEach(
+                  (columnKey, value) -> {
+                    if (to.contains(rowKey, columnKey)) {
+                      to.put(
+                          rowKey,
+                          columnKey,
+                          Either.left(
+                              CacheUtil.merge(
+                                  to.get(rowKey, columnKey).getLeft(),
+                                  from.get(rowKey, columnKey).getLeft())));
+                    } else {
+                      to.put(rowKey, columnKey, from.get(rowKey, columnKey));
+                    }
+                  });
+            });
+  }
+
+  public boolean isDone() {
+    return aborted || committed;
+  }
+
+  public String describeConflicts() {
+    return "it's complex...";
+  }
+
+  @Override
+  public void close() throws HelenusException {
+    // Closing a UnitOfWork will abort iff we've not already aborted or committed this unit of work.
+    if (aborted == false && committed == false) {
+      abort();
+    }
+  }
+
+  public boolean hasAborted() {
+    return aborted;
+  }
+
+  public boolean hasCommitted() {
+    return committed;
+  }
+
+  public long committedAt() {
+    return committedAt;
+  }
+
+ private static class EvictTrackingMapCache<K, V> implements Cache<K, V> {
+      private final Set<K> deletes;
+      private final Cache<K, V> delegate;
+
+      public EvictTrackingMapCache(CacheManager manager, String name, CacheLoader<K, V> cacheLoader,
+              boolean isReadThrough) {
+          deletes = Collections.synchronizedSet(new HashSet<>());
+          delegate = new MapCache<>(manager, name, cacheLoader, isReadThrough);
+      }
+
+      /** Non-interface method; should only be called by UnitOfWork when merging to an enclosing UnitOfWork. */
+      public Set<K> getDeletions() {
+          return new HashSet<>(deletes);
+      }
+
+      @Override
+      public V get(K key) {
+          if (deletes.contains(key)) {
+              return null;
+          }
+
+          return delegate.get(key);
+      }
+
+      @Override
+      public Map<K, V> getAll(Set<? extends K> keys) {
+          Set<? extends K> clonedKeys = new HashSet<>(keys);
+          clonedKeys.removeAll(deletes);
+          return delegate.getAll(clonedKeys);
+      }
+
+      @Override
+      public boolean containsKey(K key) {
+          if (deletes.contains(key)) {
+              return false;
+          }
+
+          return delegate.containsKey(key);
+      }
+
+      @Override
+      public void loadAll(Set<? extends K> keys, boolean replaceExistingValues, CompletionListener listener) {
+          Set<? extends K> clonedKeys = new HashSet<>(keys);
+          clonedKeys.removeAll(deletes);
+          delegate.loadAll(clonedKeys, replaceExistingValues, listener);
+      }
+
+      @Override
+      public void put(K key, V value) {
+          if (deletes.contains(key)) {
+              deletes.remove(key);
+          }
+
+          delegate.put(key, value);
+      }
+
+      @Override
+      public V getAndPut(K key, V value) {
+          if (deletes.contains(key)) {
+              deletes.remove(key);
+          }
+
+          return delegate.getAndPut(key, value);
+      }
+
+      @Override
+      public void putAll(Map<? extends K, ? extends V> map) {
+          deletes.removeAll(map.keySet());
+          delegate.putAll(map);
+      }
+
+      @Override
+      public synchronized boolean putIfAbsent(K key, V value) {
+          if (!delegate.containsKey(key) && deletes.contains(key)) {
+              deletes.remove(key);
+          }
+
+          return delegate.putIfAbsent(key,  value);
+      }
+
+      @Override
+      public boolean remove(K key) {
+          boolean removed = delegate.remove(key);
+          deletes.add(key);
+          return removed;
+      }
+
+      @Override
+      public boolean remove(K key, V value) {
+          boolean removed = delegate.remove(key, value);
+          if (removed) {
+              deletes.add(key);
+          }
+
+          return removed;
+      }
+
+      @Override
+      public V getAndRemove(K key) {
+          V value = delegate.getAndRemove(key);
+          deletes.add(key);
+          return value;
+      }
+
+      @Override
+      public void removeAll(Set<? extends K> keys) {
+          Set<? extends K> cloneKeys = new HashSet<>(keys);
+          delegate.removeAll(cloneKeys);
+          deletes.addAll(cloneKeys);
+      }
+
+      @Override
+      @SuppressWarnings("unchecked")
+      public synchronized void removeAll() {
+          Map<K, V> impl = delegate.unwrap(Map.class);
+          Set<K> keys = impl.keySet();
+          delegate.removeAll();
+          deletes.addAll(keys);
+      }
+
+      @Override
+      public void clear() {
+          delegate.clear();
+          // TODO(gburd): all parents too
+          deletes.clear();
+      }
+
+    @Override
+    public boolean replace(K key, V oldValue, V newValue) {
+        if (deletes.contains(key)) {
+            return false;
+        }
+
+        return delegate.replace(key, oldValue, newValue);
+    }
+
+    @Override
+    public boolean replace(K key, V value) {
+        if (deletes.contains(key)) {
+            return false;
+        }
+
+        return delegate.replace(key, value);
+    }
+
+    @Override
+    public V getAndReplace(K key, V value) {
+        if (deletes.contains(key)) {
+            return null;
+        }
+
+        return delegate.getAndReplace(key, value);
+    }
+
+    @Override
+    public <C extends Configuration<K, V>> C getConfiguration(Class<C> clazz) {
+        return delegate.getConfiguration(clazz);
+    }
+
+    @Override
+    public <T> T invoke(K key, EntryProcessor<K, V, T> processor, Object... arguments)
+            throws EntryProcessorException {
+        if (deletes.contains(key)) {
+            return null;
+        }
+
+        return delegate.invoke(key,  processor, arguments);
+    }
+
+    @Override
+    public <T> Map<K, EntryProcessorResult<T>> invokeAll(Set<? extends K> keys, EntryProcessor<K, V, T> processor,
+            Object... arguments) {
+        Set<? extends K> clonedKeys = new HashSet<>(keys);
+        clonedKeys.removeAll(deletes);
+        return delegate.invokeAll(clonedKeys, processor, arguments);
+    }
+
+    @Override
+    public String getName() {
+        return delegate.getName();
+    }
+
+    @Override
+    public CacheManager getCacheManager() {
+        return delegate.getCacheManager();
+    }
+
+    @Override
+    public void close() {
+        delegate.close();
+    }
+
+    @Override
+    public boolean isClosed() {
+        return delegate.isClosed();
+    }
+
+    @Override
+    public <T> T unwrap(Class<T> clazz) {
+        return delegate.unwrap(clazz);
+    }
+
+    @Override
+    public void registerCacheEntryListener(CacheEntryListenerConfiguration<K, V> cacheEntryListenerConfiguration) {
+        delegate.registerCacheEntryListener(cacheEntryListenerConfiguration);
+    }
+
+    @Override
+    public void deregisterCacheEntryListener(CacheEntryListenerConfiguration<K, V> cacheEntryListenerConfiguration) {
+        delegate.deregisterCacheEntryListener(cacheEntryListenerConfiguration);
+    }
+
+    @Override
+    public Iterator<Entry<K, V>> iterator() {
+        return delegate.iterator();
+    }
+  }
 }

src/main/java/net/helenus/core/UserTypeOperations.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,69 +16,62 @@
  */
 package net.helenus.core;
 
-import java.util.List;
-
 import com.datastax.driver.core.UserType;
 import com.datastax.driver.core.schemabuilder.SchemaStatement;
-
+import java.util.List;
 import net.helenus.mapping.HelenusEntity;
 import net.helenus.support.HelenusException;
 
 public final class UserTypeOperations {
 
-	private final AbstractSessionOperations sessionOps;
-	private final boolean dropUnusedColumns;
+  private final AbstractSessionOperations sessionOps;
+  private final boolean dropUnusedColumns;
 
-	public UserTypeOperations(AbstractSessionOperations sessionOps, boolean dropUnusedColumns) {
-		this.sessionOps = sessionOps;
-		this.dropUnusedColumns = dropUnusedColumns;
-	}
+  public UserTypeOperations(AbstractSessionOperations sessionOps, boolean dropUnusedColumns) {
+    this.sessionOps = sessionOps;
+    this.dropUnusedColumns = dropUnusedColumns;
+  }
 
-	public void createUserType(HelenusEntity entity) {
+  public void createUserType(HelenusEntity entity) {
 
-		sessionOps.execute(SchemaUtil.createUserType(entity), true);
+    sessionOps.execute(SchemaUtil.createUserType(entity));
+  }
 
-	}
+  public void dropUserType(HelenusEntity entity) {
 
-	public void dropUserType(HelenusEntity entity) {
+    sessionOps.execute(SchemaUtil.dropUserType(entity));
+  }
 
-        sessionOps.execute(SchemaUtil.dropUserType(entity), true);
+  public void validateUserType(UserType userType, HelenusEntity entity) {
 
+    if (userType == null) {
+      throw new HelenusException(
+          "userType not exists " + entity.getName() + "for entity " + entity.getMappingInterface());
     }
 
-	public void validateUserType(UserType userType, HelenusEntity entity) {
+    List<SchemaStatement> list = SchemaUtil.alterUserType(userType, entity, dropUnusedColumns);
 
-		if (userType == null) {
-			throw new HelenusException(
-					"userType not exists " + entity.getName() + "for entity " + entity.getMappingInterface());
-		}
+    if (!list.isEmpty()) {
+      throw new HelenusException(
+          "schema changed for entity "
+              + entity.getMappingInterface()
+              + ", apply this command: "
+              + list);
+    }
+  }
 
-		List<SchemaStatement> list = SchemaUtil.alterUserType(userType, entity, dropUnusedColumns);
+  public void updateUserType(UserType userType, HelenusEntity entity) {
 
-		if (!list.isEmpty()) {
-			throw new HelenusException(
-					"schema changed for entity " + entity.getMappingInterface() + ", apply this command: " + list);
-		}
+    if (userType == null) {
+      createUserType(entity);
+      return;
+    }
 
-	}
+    executeBatch(SchemaUtil.alterUserType(userType, entity, dropUnusedColumns));
+  }
 
-	public void updateUserType(UserType userType, HelenusEntity entity) {
-
-		if (userType == null) {
-			createUserType(entity);
-			return;
-		}
-
-		executeBatch(SchemaUtil.alterUserType(userType, entity, dropUnusedColumns));
-
-	}
-
-	private void executeBatch(List<SchemaStatement> list) {
-
-		list.forEach(s -> {
-			sessionOps.execute(s, true);
-		});
-
-	}
+  private void executeBatch(List<SchemaStatement> list) {
 
+    list.forEach(s -> sessionOps.execute(s));
+  }
 }

src/main/java/net/helenus/core/annotation/Cacheable.java

@@ -1,3 +1,19 @@
+/*
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
 package net.helenus.core.annotation;
 
 import java.lang.annotation.ElementType;
@@ -7,5 +23,4 @@ import java.lang.annotation.Target;
 
 @Retention(RetentionPolicy.RUNTIME)
 @Target(ElementType.TYPE)
-public @interface Cacheable {
-}
+public @interface Cacheable {}

src/main/java/net/helenus/core/annotation/Retry.java

@@ -1,17 +1,36 @@
+/*
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+
 package net.helenus.core.annotation;
 
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
-
+import java.util.concurrent.TimeoutException;
 import net.helenus.core.ConflictingUnitOfWorkException;
 
 @Retention(RetentionPolicy.RUNTIME)
 @Target(ElementType.METHOD)
 public @interface Retry {
 
-	Class<? extends Exception>[] on() default ConflictingUnitOfWorkException.class;
+  Class<? extends Exception>[] on() default {
+    ConflictingUnitOfWorkException.class, TimeoutException.class
+  };
 
-	int times() default 3;
+  int times() default 3;
 }

src/main/java/net/helenus/core/aspect/RetryAspect.java

@@ -0,0 +1,98 @@
+/*
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+
+package net.helenus.core.aspect;
+
+import java.lang.reflect.Method;
+import java.util.Arrays;
+import net.helenus.core.annotation.Retry;
+import org.apache.commons.lang3.exception.ExceptionUtils;
+import org.aspectj.lang.ProceedingJoinPoint;
+import org.aspectj.lang.annotation.Around;
+import org.aspectj.lang.annotation.Aspect;
+import org.aspectj.lang.reflect.MethodSignature;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.core.annotation.AnnotationUtils;
+import org.springframework.util.Assert;
+
+@Aspect
+public class RetryAspect {
+
+  private static final Logger log = LoggerFactory.getLogger(RetryAspect.class);
+
+  @Around("@annotation(net.helenus.core.annotations.Retry)")
+  public Object retry(ProceedingJoinPoint pjp) throws Throwable {
+    Retry retryAnnotation = getRetryAnnotation(pjp);
+    return (retryAnnotation != null) ? proceed(pjp, retryAnnotation) : proceed(pjp);
+  }
+
+  private Object proceed(ProceedingJoinPoint pjp) throws Throwable {
+    return pjp.proceed();
+  }
+
+  private Object proceed(ProceedingJoinPoint pjp, Retry retryAnnotation) throws Throwable {
+    int times = retryAnnotation.times();
+    Class<? extends Throwable>[] retryOn = retryAnnotation.on();
+    Assert.isTrue(times > 0, "@Retry{times} should be greater than 0!");
+    Assert.isTrue(retryOn.length > 0, "@Retry{on} should have at least one Throwable!");
+    log.info("Proceed with {} retries on {}", times, Arrays.toString(retryOn));
+    return tryProceeding(pjp, times, retryOn);
+  }
+
+  private Object tryProceeding(
+      ProceedingJoinPoint pjp, int times, Class<? extends Throwable>[] retryOn) throws Throwable {
+    try {
+      return proceed(pjp);
+    } catch (Throwable throwable) {
+      if (isRetryThrowable(throwable, retryOn) && times-- > 0) {
+        log.info("Conflict detected, {} remaining retries on {}", times, Arrays.toString(retryOn));
+        return tryProceeding(pjp, times, retryOn);
+      }
+      throw throwable;
+    }
+  }
+
+  private boolean isRetryThrowable(Throwable throwable, Class<? extends Throwable>[] retryOn) {
+    Throwable[] causes = ExceptionUtils.getThrowables(throwable);
+    for (Throwable cause : causes) {
+      for (Class<? extends Throwable> retryThrowable : retryOn) {
+        if (retryThrowable.isAssignableFrom(cause.getClass())) {
+          return true;
+        }
+      }
+    }
+    return false;
+  }
+
+  private Retry getRetryAnnotation(ProceedingJoinPoint pjp) throws NoSuchMethodException {
+    MethodSignature signature = (MethodSignature) pjp.getSignature();
+    Method method = signature.getMethod();
+    Retry retryAnnotation = AnnotationUtils.findAnnotation(method, Retry.class);
+
+    if (retryAnnotation != null) {
+      return retryAnnotation;
+    }
+
+    Class<?>[] argClasses = new Class[pjp.getArgs().length];
+    for (int i = 0; i < pjp.getArgs().length; i++) {
+      argClasses[i] = pjp.getArgs()[i].getClass();
+    }
+    method = pjp.getTarget().getClass().getMethod(pjp.getSignature().getName(), argClasses);
+    return AnnotationUtils.findAnnotation(method, Retry.class);
+  }
+}

src/main/java/net/helenus/core/aspect/RetryConcurrentUnitOfWorkAspect.java

@@ -2,7 +2,7 @@ package net.helenus.core.aspect;
 
 import java.lang.reflect.Method;
 import java.util.Arrays;
-
+import net.helenus.core.annotation.Retry;
 import org.apache.commons.lang3.exception.ExceptionUtils;
 import org.aspectj.lang.ProceedingJoinPoint;
 import org.aspectj.lang.annotation.Around;
@@ -13,71 +13,69 @@ import org.slf4j.LoggerFactory;
 import org.springframework.core.annotation.AnnotationUtils;
 import org.springframework.util.Assert;
 
-import net.helenus.core.annotation.Retry;
-
 @Aspect
 public class RetryConcurrentUnitOfWorkAspect {
 
-	private static final Logger log = LoggerFactory.getLogger(RetryConcurrentUnitOfWorkAspect.class);
+  private static final Logger log = LoggerFactory.getLogger(RetryConcurrentUnitOfWorkAspect.class);
 
-	@Around("@annotation(net.helenus.core.annotations.Retry)")
-	public Object retry(ProceedingJoinPoint pjp) throws Throwable {
-		Retry retryAnnotation = getRetryAnnotation(pjp);
-		return (retryAnnotation != null) ? proceed(pjp, retryAnnotation) : proceed(pjp);
-	}
+  @Around("@annotation(net.helenus.core.annotations.Retry)")
+  public Object retry(ProceedingJoinPoint pjp) throws Throwable {
+    Retry retryAnnotation = getRetryAnnotation(pjp);
+    return (retryAnnotation != null) ? proceed(pjp, retryAnnotation) : proceed(pjp);
+  }
 
-	private Object proceed(ProceedingJoinPoint pjp) throws Throwable {
-		return pjp.proceed();
-	}
+  private Object proceed(ProceedingJoinPoint pjp) throws Throwable {
+    return pjp.proceed();
+  }
 
-	private Object proceed(ProceedingJoinPoint pjp, Retry retryAnnotation) throws Throwable {
-		int times = retryAnnotation.times();
-		Class<? extends Throwable>[] retryOn = retryAnnotation.on();
-		Assert.isTrue(times > 0, "@Retry{times} should be greater than 0!");
-		Assert.isTrue(retryOn.length > 0, "@Retry{on} should have at least one Throwable!");
-		log.info("Proceed with {} retries on {}", times, Arrays.toString(retryOn));
-		return tryProceeding(pjp, times, retryOn);
-	}
+  private Object proceed(ProceedingJoinPoint pjp, Retry retryAnnotation) throws Throwable {
+    int times = retryAnnotation.times();
+    Class<? extends Throwable>[] retryOn = retryAnnotation.on();
+    Assert.isTrue(times > 0, "@Retry{times} should be greater than 0!");
+    Assert.isTrue(retryOn.length > 0, "@Retry{on} should have at least one Throwable!");
+    log.info("Proceed with {} retries on {}", times, Arrays.toString(retryOn));
+    return tryProceeding(pjp, times, retryOn);
+  }
 
-	private Object tryProceeding(ProceedingJoinPoint pjp, int times, Class<? extends Throwable>[] retryOn)
-			throws Throwable {
-		try {
-			return proceed(pjp);
-		} catch (Throwable throwable) {
-			if (isRetryThrowable(throwable, retryOn) && times-- > 0) {
-				log.info("Conflict detected, {} remaining retries on {}", times, Arrays.toString(retryOn));
-				return tryProceeding(pjp, times, retryOn);
-			}
-			throw throwable;
-		}
-	}
+  private Object tryProceeding(
+      ProceedingJoinPoint pjp, int times, Class<? extends Throwable>[] retryOn) throws Throwable {
+    try {
+      return proceed(pjp);
+    } catch (Throwable throwable) {
+      if (isRetryThrowable(throwable, retryOn) && times-- > 0) {
+        log.info("Conflict detected, {} remaining retries on {}", times, Arrays.toString(retryOn));
+        return tryProceeding(pjp, times, retryOn);
+      }
+      throw throwable;
+    }
+  }
 
-	private boolean isRetryThrowable(Throwable throwable, Class<? extends Throwable>[] retryOn) {
-		Throwable[] causes = ExceptionUtils.getThrowables(throwable);
-		for (Throwable cause : causes) {
-			for (Class<? extends Throwable> retryThrowable : retryOn) {
-				if (retryThrowable.isAssignableFrom(cause.getClass())) {
-					return true;
-				}
-			}
-		}
-		return false;
-	}
+  private boolean isRetryThrowable(Throwable throwable, Class<? extends Throwable>[] retryOn) {
+    Throwable[] causes = ExceptionUtils.getThrowables(throwable);
+    for (Throwable cause : causes) {
+      for (Class<? extends Throwable> retryThrowable : retryOn) {
+        if (retryThrowable.isAssignableFrom(cause.getClass())) {
+          return true;
+        }
+      }
+    }
+    return false;
+  }
 
-	private Retry getRetryAnnotation(ProceedingJoinPoint pjp) throws NoSuchMethodException {
-		MethodSignature signature = (MethodSignature) pjp.getSignature();
-		Method method = signature.getMethod();
-		Retry retryAnnotation = AnnotationUtils.findAnnotation(method, Retry.class);
+  private Retry getRetryAnnotation(ProceedingJoinPoint pjp) throws NoSuchMethodException {
+    MethodSignature signature = (MethodSignature) pjp.getSignature();
+    Method method = signature.getMethod();
+    Retry retryAnnotation = AnnotationUtils.findAnnotation(method, Retry.class);
 
-		if (retryAnnotation != null) {
-			return retryAnnotation;
-		}
+    if (retryAnnotation != null) {
+      return retryAnnotation;
+    }
 
-		Class[] argClasses = new Class[pjp.getArgs().length];
-		for (int i = 0; i < pjp.getArgs().length; i++) {
-			argClasses[i] = pjp.getArgs()[i].getClass();
-		}
-		method = pjp.getTarget().getClass().getMethod(pjp.getSignature().getName(), argClasses);
-		return AnnotationUtils.findAnnotation(method, Retry.class);
-	}
+    Class[] argClasses = new Class[pjp.getArgs().length];
+    for (int i = 0; i < pjp.getArgs().length; i++) {
+      argClasses[i] = pjp.getArgs()[i].getClass();
+    }
+    method = pjp.getTarget().getClass().getMethod(pjp.getSignature().getName(), argClasses);
+    return AnnotationUtils.findAnnotation(method, Retry.class);
+  }
 }

src/main/java/net/helenus/core/cache/BoundFacet.java

@@ -0,0 +1,60 @@
+/*
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+package net.helenus.core.cache;
+
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Set;
+import java.util.stream.Collectors;
+import net.helenus.mapping.HelenusProperty;
+
+public class BoundFacet extends Facet<String> {
+  private final Map<HelenusProperty, Object> properties;
+
+  public BoundFacet(HelenusProperty property, Object value) {
+    super(property.getPropertyName(), value == null ? null : value.toString());
+    this.properties = new HashMap<HelenusProperty, Object>(1);
+    this.properties.put(property, value);
+  }
+
+  public Set<HelenusProperty> getProperties() {
+    return properties.keySet();
+  }
+
+  public BoundFacet(String name, Map<HelenusProperty, Object> properties) {
+    super(
+        name,
+        (properties.keySet().size() > 1)
+            ? "["
+                + String.join(
+                    ", ",
+                    properties
+                        .keySet()
+                        .stream()
+                        .map(key -> properties.get(key).toString())
+                        .collect(Collectors.toSet()))
+                + "]"
+            : String.join(
+                "",
+                properties
+                    .keySet()
+                    .stream()
+                    .map(key -> properties.get(key).toString())
+                    .collect(Collectors.toSet())));
+    this.properties = properties;
+  }
+}

src/main/java/net/helenus/core/cache/CacheUtil.java

@@ -0,0 +1,221 @@
+package net.helenus.core.cache;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+import net.helenus.core.Helenus;
+import net.helenus.core.reflect.Entity;
+import net.helenus.core.reflect.MapExportable;
+import net.helenus.mapping.HelenusEntity;
+import net.helenus.mapping.HelenusProperty;
+import net.helenus.mapping.MappingUtil;
+import net.helenus.mapping.value.BeanColumnValueProvider;
+
+public class CacheUtil {
+
+  public static List<String[]> combinations(List<String> items) {
+    int n = items.size();
+    if (n > 20) throw new IllegalArgumentException(n + " is out of range");
+    long e = Math.round(Math.pow(2, n));
+    List<String[]> out = new ArrayList<String[]>((int) e - 1);
+    for (int k = 1; k <= items.size(); k++) {
+      kCombinations(items, 0, k, new String[k], out);
+    }
+    return out;
+  }
+
+  private static void kCombinations(
+      List<String> items, int n, int k, String[] arr, List<String[]> out) {
+    if (k == 0) {
+      out.add(arr.clone());
+    } else {
+      for (int i = n; i <= items.size() - k; i++) {
+        arr[arr.length - k] = items.get(i);
+        kCombinations(items, i + 1, k - 1, arr, out);
+      }
+    }
+  }
+
+  public static List<String> flatKeys(String table, List<Facet> facets) {
+    return flattenFacets(facets)
+        .stream()
+        .map(
+            combination -> {
+              return table + "." + Arrays.toString(combination);
+            })
+        .collect(Collectors.toList());
+  }
+
+  public static List<String[]> flattenFacets(List<Facet> facets) {
+    List<String[]> combinations =
+        CacheUtil.combinations(
+            facets
+                .stream()
+                .filter(facet -> !facet.fixed())
+                .filter(facet -> facet.value() != null)
+                .map(
+                    facet -> {
+                      return facet.name() + "==" + facet.value();
+                    })
+                .collect(Collectors.toList()));
+    // TODO(gburd): rework so as to not generate the combinations at all rather than filter
+    facets =
+        facets
+            .stream()
+            .filter(f -> !f.fixed())
+            .filter(f -> !f.alone() || !f.combined())
+            .collect(Collectors.toList());
+    for (Facet facet : facets) {
+      combinations =
+          combinations
+              .stream()
+              .filter(
+                  combo -> {
+                    // When used alone, this facet is not distinct so don't use it as a key.
+                    if (combo.length == 1) {
+                      if (!facet.alone() && combo[0].startsWith(facet.name() + "==")) {
+                        return false;
+                      }
+                    } else {
+                      if (!facet.combined()) {
+                        for (String c : combo) {
+                          // Don't use this facet in combination with others to create keys.
+                          if (c.startsWith(facet.name() + "==")) {
+                            return false;
+                          }
+                        }
+                      }
+                    }
+                    return true;
+                  })
+              .collect(Collectors.toList());
+    }
+    return combinations;
+  }
+
+  /** Merge changed values in the map behind `from` into `to`. */
+  public static Object merge(Object t, Object f) {
+    HelenusEntity entity = Helenus.resolve(MappingUtil.getMappingInterface(t));
+
+    if (t == f) return t;
+    if (f == null) return t;
+    if (t == null) return f;
+
+    if (t instanceof MapExportable
+        && t instanceof Entity
+        && f instanceof MapExportable
+        && f instanceof Entity) {
+      Entity to = (Entity) t;
+      Entity from = (Entity) f;
+      Map<String, Object> toValueMap = ((MapExportable) to).toMap();
+      Map<String, Object> fromValueMap = ((MapExportable) from).toMap();
+      for (HelenusProperty prop : entity.getOrderedProperties()) {
+        switch (prop.getColumnType()) {
+          case PARTITION_KEY:
+          case CLUSTERING_COLUMN:
+            continue;
+          default:
+            Object toVal = BeanColumnValueProvider.INSTANCE.getColumnValue(to, -1, prop, false);
+            Object fromVal = BeanColumnValueProvider.INSTANCE.getColumnValue(from, -1, prop, false);
+            String ttlKey = ttlKey(prop);
+            String writeTimeKey = writeTimeKey(prop);
+            int[] toTtlI = (int[]) toValueMap.get(ttlKey);
+            int toTtl = (toTtlI != null) ? toTtlI[0] : 0;
+            Long toWriteTime = (Long) toValueMap.get(writeTimeKey);
+            int[] fromTtlI = (int[]) fromValueMap.get(ttlKey);
+            int fromTtl = (fromTtlI != null) ? fromTtlI[0] : 0;
+            Long fromWriteTime = (Long) fromValueMap.get(writeTimeKey);
+
+            if (toVal != null) {
+              if (fromVal != null) {
+                if (toVal == fromVal) {
+                  // Case: object identity
+                  // Goal: ensure write time and ttl are also in sync
+                  if (fromWriteTime != null
+                      && fromWriteTime != 0L
+                      && (toWriteTime == null || fromWriteTime > toWriteTime)) {
+                    ((MapExportable) to).put(writeTimeKey, fromWriteTime);
+                  }
+                  if (fromTtl > 0 && fromTtl > toTtl) {
+                    ((MapExportable) to).put(ttlKey, fromTtl);
+                  }
+                } else if (fromWriteTime != null && fromWriteTime != 0L) {
+                  // Case: to exists and from exists
+                  // Goal: copy over from -> to iff from.writeTime > to.writeTime
+                  if (toWriteTime != null && toWriteTime != 0L) {
+                    if (fromWriteTime > toWriteTime) {
+                      ((MapExportable) to).put(prop.getPropertyName(), fromVal);
+                      ((MapExportable) to).put(writeTimeKey, fromWriteTime);
+                      if (fromTtl > 0) {
+                        ((MapExportable) to).put(ttlKey, fromTtl);
+                      }
+                    }
+                  } else {
+                    ((MapExportable) to).put(prop.getPropertyName(), fromVal);
+                    ((MapExportable) to).put(writeTimeKey, fromWriteTime);
+                    if (fromTtl > 0) {
+                      ((MapExportable) to).put(ttlKey, fromTtl);
+                    }
+                  }
+                } else {
+                  if (toWriteTime == null || toWriteTime == 0L) {
+                    // Caution, entering grey area...
+                    if (!toVal.equals(fromVal)) {
+                      // dangerous waters here, values diverge without information that enables resolution,
+                      // policy (for now) is to move value from -> to anyway.
+                      ((MapExportable) to).put(prop.getPropertyName(), fromVal);
+                      if (fromTtl > 0) {
+                        ((MapExportable) to).put(ttlKey, fromTtl);
+                      }
+                    }
+                  }
+                }
+              }
+            } else {
+              // Case: from exists, but to doesn't (it's null)
+              // Goal: copy over from -> to, include ttl and writeTime if present
+              if (fromVal != null) {
+                ((MapExportable) to).put(prop.getPropertyName(), fromVal);
+                if (fromWriteTime != null && fromWriteTime != 0L) {
+                  ((MapExportable) to).put(writeTimeKey, fromWriteTime);
+                }
+                if (fromTtl > 0) {
+                  ((MapExportable) to).put(ttlKey, fromTtl);
+                }
+              }
+            }
+        }
+      }
+      return to;
+    }
+    return t;
+  }
+
+  public static String schemaName(List<Facet> facets) {
+    return facets
+        .stream()
+        .filter(Facet::fixed)
+        .map(facet -> facet.value().toString())
+        .collect(Collectors.joining("."));
+  }
+
+  public static String writeTimeKey(HelenusProperty prop) {
+    return writeTimeKey(prop.getColumnName().toCql(false));
+  }
+
+  public static String ttlKey(HelenusProperty prop) {
+    return ttlKey(prop.getColumnName().toCql(false));
+  }
+
+  public static String writeTimeKey(String columnName) {
+    String key = "_" + columnName + "_writeTime";
+    return key.toLowerCase();
+  }
+
+  public static String ttlKey(String columnName) {
+    String key = "_" + columnName + "_ttl";
+    return key.toLowerCase();
+  }
+}

src/main/java/net/helenus/core/cache/Facet.java

@@ -0,0 +1,69 @@
+/*
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+
+package net.helenus.core.cache;
+
+/** An Entity is identifiable via one or more Facets */
+public class Facet<T> {
+  private final String name;
+  private T value;
+  private boolean fixed = false;
+  private boolean alone = true;
+  private boolean combined = true;
+
+  public Facet(String name) {
+    this.name = name;
+  }
+
+  public Facet(String name, T value) {
+    this.name = name;
+    this.value = value;
+  }
+
+  public String name() {
+    return name;
+  }
+
+  public T value() {
+    return value;
+  }
+
+  public Facet setFixed() {
+    fixed = true;
+    return this;
+  }
+
+  public boolean fixed() {
+    return fixed;
+  }
+
+  public void setUniquelyIdentifyingWhenAlone(boolean alone) {
+    this.alone = alone;
+  }
+
+  public void setUniquelyIdentifyingWhenCombined(boolean combined) {
+    this.combined = combined;
+  }
+
+  public boolean alone() {
+    return alone;
+  }
+
+  public boolean combined() {
+    return combined;
+  }
+}

src/main/java/net/helenus/core/cache/MapCache.java

@@ -0,0 +1,463 @@
+package net.helenus.core.cache;
+
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.Iterator;
+import java.util.Map;
+import java.util.Set;
+import java.util.concurrent.ConcurrentHashMap;
+import javax.cache.Cache;
+import javax.cache.CacheManager;
+import javax.cache.configuration.CacheEntryListenerConfiguration;
+import javax.cache.configuration.Configuration;
+import javax.cache.event.CacheEntryRemovedListener;
+import javax.cache.integration.CacheLoader;
+import javax.cache.integration.CompletionListener;
+import javax.cache.processor.EntryProcessor;
+import javax.cache.processor.EntryProcessorException;
+import javax.cache.processor.EntryProcessorResult;
+import javax.cache.processor.MutableEntry;
+
+public class MapCache<K, V> implements Cache<K, V> {
+  private final CacheManager manager;
+  private final String name;
+  private Map<K, V> map = new ConcurrentHashMap<>();
+  private Set<CacheEntryRemovedListener<K, V>> cacheEntryRemovedListeners = new HashSet<>();
+  private CacheLoader<K, V> cacheLoader = null;
+  private boolean isReadThrough = false;
+
+  private static class MapConfiguration<K, V> implements Configuration<K, V> {
+    private static final long serialVersionUID = 6093947542772516209L;
+
+    @Override
+    public Class<K> getKeyType() {
+      return null;
+    }
+
+    @Override
+    public Class<V> getValueType() {
+      return null;
+    }
+
+    @Override
+    public boolean isStoreByValue() {
+      return false;
+    }
+  }
+
+  public MapCache(
+      CacheManager manager, String name, CacheLoader<K, V> cacheLoader, boolean isReadThrough) {
+    this.manager = manager;
+    this.name = name;
+    this.cacheLoader = cacheLoader;
+    this.isReadThrough = isReadThrough;
+  }
+
+
+  /** {@inheritDoc} */
+  @Override
+  public V get(K key) {
+    V value = null;
+    synchronized (map) {
+      value = map.get(key);
+      if (value == null && isReadThrough && cacheLoader != null) {
+        V loadedValue = cacheLoader.load(key);
+        if (loadedValue != null) {
+          map.put(key, loadedValue);
+          value = loadedValue;
+        }
+      }
+    }
+    return value;
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public Map<K, V> getAll(Set<? extends K> keys) {
+    Map<K, V> result = null;
+    synchronized (map) {
+      result = new HashMap<K, V>(keys.size());
+      Iterator<? extends K> it = keys.iterator();
+      while (it.hasNext()) {
+        K key = it.next();
+        V value = map.get(key);
+        if (value != null) {
+          result.put(key, value);
+          it.remove();
+        }
+      }
+      if (keys.size() != 0 && isReadThrough && cacheLoader != null) {
+        Map<K, V> loadedValues = cacheLoader.loadAll(keys);
+        for (Map.Entry<K, V> entry : loadedValues.entrySet()) {
+          V v = entry.getValue();
+          if (v != null) {
+            K k = entry.getKey();
+            map.put(k, v);
+            result.put(k, v);
+          }
+        }
+      }
+    }
+    return result;
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public boolean containsKey(K key) {
+    return map.containsKey(key);
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public void loadAll(
+      Set<? extends K> keys, boolean replaceExistingValues, CompletionListener completionListener) {
+    if (cacheLoader != null) {
+      try {
+        synchronized (map) {
+          Map<K, V> loadedValues = cacheLoader.loadAll(keys);
+          for (Map.Entry<K, V> entry : loadedValues.entrySet()) {
+            V value = entry.getValue();
+            K key = entry.getKey();
+            if (value != null) {
+              boolean existsCurrently = map.containsKey(key);
+              if (!existsCurrently || replaceExistingValues) {
+                map.put(key, value);
+                keys.remove(key);
+              }
+            }
+          }
+        }
+      } catch (Exception e) {
+        if (completionListener != null) {
+          completionListener.onException(e);
+        }
+      }
+    }
+    if (completionListener != null) {
+      if (keys.isEmpty()) {
+        completionListener.onCompletion();
+      }
+    }
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public void put(K key, V value) {
+    map.put(key, value);
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public V getAndPut(K key, V value) {
+    V result = null;
+    synchronized (map) {
+      result = map.get(key);
+      if (result == null && isReadThrough && cacheLoader != null) {
+        V loadedValue = cacheLoader.load(key);
+        if (loadedValue != null) {
+          result = loadedValue;
+        }
+      }
+      map.put(key, value);
+    }
+    return result;
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public void putAll(Map<? extends K, ? extends V> map) {
+    synchronized (map) {
+      for (Map.Entry<? extends K, ? extends V> entry : map.entrySet()) {
+        this.map.put(entry.getKey(), entry.getValue());
+      }
+    }
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public boolean putIfAbsent(K key, V value) {
+    synchronized (map) {
+      if (!map.containsKey(key)) {
+        map.put(key, value);
+        return true;
+      } else {
+        return false;
+      }
+    }
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public boolean remove(K key) {
+    boolean removed = false;
+    synchronized (map) {
+      removed = map.remove(key) != null;
+      notifyRemovedListeners(key);
+    }
+    return removed;
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public boolean remove(K key, V oldValue) {
+    synchronized (map) {
+      V value = map.get(key);
+      if (value != null && oldValue.equals(value)) {
+        map.remove(key);
+        notifyRemovedListeners(key);
+        return true;
+      }
+    }
+    return false;
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public V getAndRemove(K key) {
+    synchronized (map) {
+      V oldValue = null;
+      oldValue = map.get(key);
+      map.remove(key);
+      notifyRemovedListeners(key);
+      return oldValue;
+    }
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public boolean replace(K key, V oldValue, V newValue) {
+    synchronized (map) {
+      V value = map.get(key);
+      if (value != null && oldValue.equals(value)) {
+        map.put(key, newValue);
+        return true;
+      }
+    }
+    return false;
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public boolean replace(K key, V value) {
+    synchronized (map) {
+      if (map.containsKey(key)) {
+        map.put(key, value);
+        return true;
+      }
+    }
+    return false;
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public V getAndReplace(K key, V value) {
+    synchronized (map) {
+      V oldValue = map.get(key);
+      if (value != null && value.equals(oldValue)) {
+        map.put(key, value);
+        return oldValue;
+      }
+    }
+    return null;
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public void removeAll(Set<? extends K> keys) {
+    synchronized (map) {
+      Iterator<? extends K> it = keys.iterator();
+      while (it.hasNext()) {
+        K key = it.next();
+        if (map.containsKey(key)) {
+          map.remove(key);
+        } else {
+          it.remove();
+        }
+      }
+    }
+    notifyRemovedListeners(keys);
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public void removeAll() {
+    synchronized (map) {
+      Set<K> keys = map.keySet();
+      map.clear();
+      notifyRemovedListeners(keys);
+    }
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public void clear() {
+    map.clear();
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public <C extends Configuration<K, V>> C getConfiguration(Class<C> clazz) {
+    if (!MapConfiguration.class.isAssignableFrom(clazz)) {
+      throw new IllegalArgumentException();
+    }
+    return null;
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public <T> T invoke(K key, EntryProcessor<K, V, T> entryProcessor, Object... arguments)
+      throws EntryProcessorException {
+    // TODO
+    return null;
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public <T> Map<K, EntryProcessorResult<T>> invokeAll(
+      Set<? extends K> keys, EntryProcessor<K, V, T> entryProcessor, Object... arguments) {
+    synchronized (map) {
+      for (K key : keys) {
+        V value = map.get(key);
+        if (value != null) {
+          entryProcessor.process(
+              new MutableEntry<K, V>() {
+                @Override
+                public boolean exists() {
+                  return map.containsKey(key);
+                }
+
+                @Override
+                public void remove() {
+                  synchronized (map) {
+                    V value = map.get(key);
+                    if (value != null) {
+                      map.remove(key);
+                      notifyRemovedListeners(key);
+                    }
+                  }
+                }
+
+                @Override
+                public K getKey() {
+                  return key;
+                }
+
+                @Override
+                public V getValue() {
+                  return map.get(value);
+                }
+
+                @Override
+                public <T> T unwrap(Class<T> clazz) {
+                  return null;
+                }
+
+                @Override
+                public void setValue(V value) {
+                  map.put(key, value);
+                }
+              },
+              arguments);
+        }
+      }
+    }
+    return null;
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public String getName() {
+    return name;
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public CacheManager getCacheManager() {
+    return manager;
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public void close() {}
+
+  /** {@inheritDoc} */
+  @Override
+  public boolean isClosed() {
+    return false;
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  @SuppressWarnings("unchecked")
+  public <T> T unwrap(Class<T> clazz) {
+    if (Map.class.isAssignableFrom(clazz)) {
+        return (T) map;
+    }
+    return null;
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public void registerCacheEntryListener(
+      CacheEntryListenerConfiguration<K, V> cacheEntryListenerConfiguration) {
+    //cacheEntryRemovedListeners.add(cacheEntryListenerConfiguration.getCacheEntryListenerFactory().create());
+  }
+
+  /** {@inheritDoc} */
+  @Override
+  public void deregisterCacheEntryListener(
+      CacheEntryListenerConfiguration<K, V> cacheEntryListenerConfiguration) {}
+
+  /** {@inheritDoc} */
+  @Override
+  public Iterator<Entry<K, V>> iterator() {
+    synchronized (map) {
+      return new Iterator<Entry<K, V>>() {
+
+        Iterator<Map.Entry<K, V>> entries = map.entrySet().iterator();
+
+        @Override
+        public boolean hasNext() {
+          return entries.hasNext();
+        }
+
+        @Override
+        public Entry<K, V> next() {
+          Map.Entry<K, V> entry = entries.next();
+          return new Entry<K, V>() {
+            K key = entry.getKey();
+            V value = entry.getValue();
+
+            @Override
+            public K getKey() {
+              return key;
+            }
+
+            @Override
+            public V getValue() {
+              return value;
+            }
+
+            @Override
+            public <T> T unwrap(Class<T> clazz) {
+              return null;
+            }
+          };
+        }
+
+        @Override
+        public void remove() {
+          throw new UnsupportedOperationException();
+        }
+      };
+    }
+  }
+
+  private void notifyRemovedListeners(K key) {
+    //      if (cacheEntryRemovedListeners != null) {
+    //          cacheEntryRemovedListeners.forEach(listener -> listener.onRemoved())
+    //      }
+  }
+
+  private void notifyRemovedListeners(Set<? extends K> keys) {}
+}

src/main/java/net/helenus/core/cache/UnboundFacet.java

@@ -0,0 +1,95 @@
+/*
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+package net.helenus.core.cache;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import net.helenus.core.SchemaUtil;
+import net.helenus.mapping.HelenusProperty;
+
+public class UnboundFacet extends Facet<String> {
+
+  private final List<HelenusProperty> properties;
+  private final boolean alone;
+  private final boolean combined;
+
+  public UnboundFacet(List<HelenusProperty> properties, boolean alone, boolean combined) {
+    super(SchemaUtil.createPrimaryKeyPhrase(properties));
+    this.properties = properties;
+    this.alone = alone;
+    this.combined = combined;
+  }
+
+  public UnboundFacet(List<HelenusProperty> properties) {
+    this(properties, true, true);
+  }
+
+  public UnboundFacet(HelenusProperty property, boolean alone, boolean combined) {
+    super(property.getPropertyName());
+    properties = new ArrayList<HelenusProperty>();
+    properties.add(property);
+    this.alone = alone;
+    this.combined = combined;
+  }
+
+  public UnboundFacet(HelenusProperty property) {
+    this(property, true, true);
+  }
+
+  public List<HelenusProperty> getProperties() {
+    return properties;
+  }
+
+  public Binder binder() {
+    return new Binder(name(), properties, alone, combined);
+  }
+
+  public static class Binder {
+
+    private final String name;
+    private final boolean alone;
+    private final boolean combined;
+    private final List<HelenusProperty> properties = new ArrayList<HelenusProperty>();
+    private Map<HelenusProperty, Object> boundProperties = new HashMap<HelenusProperty, Object>();
+
+    Binder(String name, List<HelenusProperty> properties, boolean alone, boolean combined) {
+      this.name = name;
+      this.properties.addAll(properties);
+      this.alone = alone;
+      this.combined = combined;
+    }
+
+    public Binder setValueForProperty(HelenusProperty prop, Object value) {
+      properties.remove(prop);
+      boundProperties.put(prop, value);
+      return this;
+    }
+
+    public boolean isBound() {
+      return properties.isEmpty();
+    }
+
+    public BoundFacet bind() {
+      BoundFacet facet = new BoundFacet(name, boundProperties);
+      facet.setUniquelyIdentifyingWhenAlone(alone);
+      facet.setUniquelyIdentifyingWhenCombined(combined);
+      return facet;
+    }
+  }
+}

src/main/java/net/helenus/core/operation/AbstractFilterOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,97 +16,153 @@
  */
 package net.helenus.core.operation;
 
-import java.util.LinkedList;
-import java.util.List;
-
+import java.util.*;
 import net.helenus.core.*;
+import net.helenus.core.cache.Facet;
+import net.helenus.core.cache.UnboundFacet;
+import net.helenus.core.reflect.HelenusPropertyNode;
+import net.helenus.mapping.HelenusProperty;
 
 public abstract class AbstractFilterOperation<E, O extends AbstractFilterOperation<E, O>>
-		extends
-			AbstractOperation<E, O> {
+    extends AbstractOperation<E, O> {
 
-	protected List<Filter<?>> filters = null;
-	protected List<Filter<?>> ifFilters = null;
+  protected List<Filter<?>> filters = null;
+  protected List<Filter<?>> ifFilters = null;
 
-	public AbstractFilterOperation(AbstractSessionOperations sessionOperations) {
-		super(sessionOperations);
-	}
+  public AbstractFilterOperation(AbstractSessionOperations sessionOperations) {
+    super(sessionOperations);
+  }
 
-	public <V> O where(Getter<V> getter, Postulate<V> postulate) {
+  public <V> O where(Getter<V> getter, Postulate<V> postulate) {
 
-		addFilter(Filter.create(getter, postulate));
+    addFilter(Filter.create(getter, postulate));
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O where(Getter<V> getter, Operator operator, V val) {
+  public <V> O where(Getter<V> getter, Operator operator, V val) {
 
-		addFilter(Filter.create(getter, operator, val));
+    addFilter(Filter.create(getter, operator, val));
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O where(Filter<V> filter) {
+  public <V> O where(Filter<V> filter) {
 
-		addFilter(filter);
+    addFilter(filter);
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O and(Getter<V> getter, Postulate<V> postulate) {
+  public <V> O and(Getter<V> getter, Postulate<V> postulate) {
 
-		addFilter(Filter.create(getter, postulate));
+    addFilter(Filter.create(getter, postulate));
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O and(Getter<V> getter, Operator operator, V val) {
+  public <V> O and(Getter<V> getter, Operator operator, V val) {
 
-		addFilter(Filter.create(getter, operator, val));
+    addFilter(Filter.create(getter, operator, val));
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O and(Filter<V> filter) {
+  public <V> O and(Filter<V> filter) {
 
-		addFilter(filter);
+    addFilter(filter);
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O onlyIf(Getter<V> getter, Postulate<V> postulate) {
+  public <V> O onlyIf(Getter<V> getter, Postulate<V> postulate) {
 
-		addIfFilter(Filter.create(getter, postulate));
+    addIfFilter(Filter.create(getter, postulate));
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O onlyIf(Getter<V> getter, Operator operator, V val) {
+  public <V> O onlyIf(Getter<V> getter, Operator operator, V val) {
 
-		addIfFilter(Filter.create(getter, operator, val));
+    addIfFilter(Filter.create(getter, operator, val));
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O onlyIf(Filter<V> filter) {
+  public <V> O onlyIf(Filter<V> filter) {
 
-		addIfFilter(filter);
+    addIfFilter(filter);
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	private void addFilter(Filter<?> filter) {
-		if (filters == null) {
-			filters = new LinkedList<Filter<?>>();
-		}
-		filters.add(filter);
-	}
+  private void addFilter(Filter<?> filter) {
+    if (filters == null) {
+      filters = new LinkedList<Filter<?>>();
+    }
+    filters.add(filter);
+  }
 
-	private void addIfFilter(Filter<?> filter) {
-		if (ifFilters == null) {
-			ifFilters = new LinkedList<Filter<?>>();
-		}
-		ifFilters.add(filter);
-	}
+  private void addIfFilter(Filter<?> filter) {
+    if (ifFilters == null) {
+      ifFilters = new LinkedList<Filter<?>>();
+    }
+    ifFilters.add(filter);
+  }
 
+  @Override
+  protected boolean isIdempotentOperation() {
+    if (filters == null) {
+      return super.isIdempotentOperation();
+    }
+
+    return filters
+            .stream()
+            .anyMatch(
+                filter -> {
+                  HelenusPropertyNode node = filter.getNode();
+                  if (node != null) {
+                    HelenusProperty prop = node.getProperty();
+                    if (prop != null) {
+                      return prop.isIdempotent();
+                    }
+                  }
+                  return false;
+                })
+        || super.isIdempotentOperation();
+  }
+
+  protected List<Facet> bindFacetValues(List<Facet> facets) {
+    if (facets == null) {
+      return new ArrayList<Facet>();
+    }
+    List<Facet> boundFacets = new ArrayList<>();
+    Map<HelenusProperty, Filter> filterMap = new HashMap<>(filters.size());
+    filters.forEach(f -> filterMap.put(f.getNode().getProperty(), f));
+
+    for (Facet facet : facets) {
+      if (facet instanceof UnboundFacet) {
+        UnboundFacet unboundFacet = (UnboundFacet) facet;
+        UnboundFacet.Binder binder = unboundFacet.binder();
+        if (filters != null) {
+          for (HelenusProperty prop : unboundFacet.getProperties()) {
+
+            Filter filter = filterMap.get(prop);
+            if (filter != null) {
+              Object[] postulates = filter.postulateValues();
+              for (Object p : postulates) {
+                binder.setValueForProperty(prop, p.toString());
+              }
+            }
+          }
+        }
+        if (binder.isBound()) {
+          boundFacets.add(binder.bind());
+        }
+      } else {
+        boundFacets.add(facet);
+      }
+    }
+    return boundFacets;
+  }
 }

src/main/java/net/helenus/core/operation/AbstractFilterOptionalOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,97 +16,98 @@
  */
 package net.helenus.core.operation;
 
+import java.util.LinkedHashMap;
 import java.util.LinkedList;
 import java.util.List;
-
+import java.util.Map;
 import net.helenus.core.*;
+import net.helenus.mapping.HelenusProperty;
 
-public abstract class AbstractFilterOptionalOperation<E, O extends AbstractFilterOptionalOperation<E, O>>
-		extends
-			AbstractOptionalOperation<E, O> {
+public abstract class AbstractFilterOptionalOperation<
+        E, O extends AbstractFilterOptionalOperation<E, O>>
+    extends AbstractOptionalOperation<E, O> {
 
-	protected List<Filter<?>> filters = null;
-	protected List<Filter<?>> ifFilters = null;
+  protected Map<HelenusProperty, Filter<?>> filters = null;
+  protected List<Filter<?>> ifFilters = null;
 
-	public AbstractFilterOptionalOperation(AbstractSessionOperations sessionOperations) {
-		super(sessionOperations);
-	}
+  public AbstractFilterOptionalOperation(AbstractSessionOperations sessionOperations) {
+    super(sessionOperations);
+  }
 
-	public <V> O where(Getter<V> getter, Postulate<V> postulate) {
+  public <V> O where(Getter<V> getter, Postulate<V> postulate) {
 
-		addFilter(Filter.create(getter, postulate));
+    addFilter(Filter.create(getter, postulate));
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O where(Getter<V> getter, Operator operator, V val) {
+  public <V> O where(Getter<V> getter, Operator operator, V val) {
 
-		addFilter(Filter.create(getter, operator, val));
+    addFilter(Filter.create(getter, operator, val));
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O where(Filter<V> filter) {
+  public <V> O where(Filter<V> filter) {
 
-		addFilter(filter);
+    addFilter(filter);
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O and(Getter<V> getter, Postulate<V> postulate) {
+  public <V> O and(Getter<V> getter, Postulate<V> postulate) {
 
-		addFilter(Filter.create(getter, postulate));
+    addFilter(Filter.create(getter, postulate));
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O and(Getter<V> getter, Operator operator, V val) {
+  public <V> O and(Getter<V> getter, Operator operator, V val) {
 
-		addFilter(Filter.create(getter, operator, val));
+    addFilter(Filter.create(getter, operator, val));
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O and(Filter<V> filter) {
+  public <V> O and(Filter<V> filter) {
 
-		addFilter(filter);
+    addFilter(filter);
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O onlyIf(Getter<V> getter, Postulate<V> postulate) {
+  public <V> O onlyIf(Getter<V> getter, Postulate<V> postulate) {
 
-		addIfFilter(Filter.create(getter, postulate));
+    addIfFilter(Filter.create(getter, postulate));
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O onlyIf(Getter<V> getter, Operator operator, V val) {
+  public <V> O onlyIf(Getter<V> getter, Operator operator, V val) {
 
-		addIfFilter(Filter.create(getter, operator, val));
+    addIfFilter(Filter.create(getter, operator, val));
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O onlyIf(Filter<V> filter) {
+  public <V> O onlyIf(Filter<V> filter) {
 
-		addIfFilter(filter);
+    addIfFilter(filter);
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	private void addFilter(Filter<?> filter) {
-		if (filters == null) {
-			filters = new LinkedList<Filter<?>>();
-		}
-		filters.add(filter);
-	}
-
-	private void addIfFilter(Filter<?> filter) {
-		if (ifFilters == null) {
-			ifFilters = new LinkedList<Filter<?>>();
-		}
-		ifFilters.add(filter);
-	}
+  private void addFilter(Filter<?> filter) {
+    if (filters == null) {
+      filters = new LinkedHashMap<HelenusProperty, Filter<?>>();
+    }
+    filters.put(filter.getNode().getProperty(), filter);
+  }
 
+  private void addIfFilter(Filter<?> filter) {
+    if (ifFilters == null) {
+      ifFilters = new LinkedList<Filter<?>>();
+    }
+    ifFilters.add(filter);
+  }
 }

src/main/java/net/helenus/core/operation/AbstractFilterStreamOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,97 +16,98 @@
  */
 package net.helenus.core.operation;
 
+import java.util.LinkedHashMap;
 import java.util.LinkedList;
 import java.util.List;
-
+import java.util.Map;
 import net.helenus.core.*;
+import net.helenus.mapping.HelenusProperty;
 
-public abstract class AbstractFilterStreamOperation<E, O extends AbstractFilterStreamOperation<E, O>>
-		extends
-			AbstractStreamOperation<E, O> {
+public abstract class AbstractFilterStreamOperation<
+        E, O extends AbstractFilterStreamOperation<E, O>>
+    extends AbstractStreamOperation<E, O> {
 
-	protected List<Filter<?>> filters = null;
-	protected List<Filter<?>> ifFilters = null;
+  protected Map<HelenusProperty, Filter<?>> filters = null;
+  protected List<Filter<?>> ifFilters = null;
 
-	public AbstractFilterStreamOperation(AbstractSessionOperations sessionOperations) {
-		super(sessionOperations);
-	}
+  public AbstractFilterStreamOperation(AbstractSessionOperations sessionOperations) {
+    super(sessionOperations);
+  }
 
-	public <V> O where(Getter<V> getter, Postulate<V> postulate) {
+  public <V> O where(Getter<V> getter, Postulate<V> postulate) {
 
-		addFilter(Filter.create(getter, postulate));
+    addFilter(Filter.create(getter, postulate));
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O where(Getter<V> getter, Operator operator, V val) {
+  public <V> O where(Getter<V> getter, Operator operator, V val) {
 
-		addFilter(Filter.create(getter, operator, val));
+    if (val != null) addFilter(Filter.create(getter, operator, val));
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O where(Filter<V> filter) {
+  public <V> O where(Filter<V> filter) {
 
-		addFilter(filter);
+    addFilter(filter);
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O and(Getter<V> getter, Postulate<V> postulate) {
+  public <V> O and(Getter<V> getter, Postulate<V> postulate) {
 
-		addFilter(Filter.create(getter, postulate));
+    addFilter(Filter.create(getter, postulate));
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O and(Getter<V> getter, Operator operator, V val) {
+  public <V> O and(Getter<V> getter, Operator operator, V val) {
 
-		addFilter(Filter.create(getter, operator, val));
+    if (val != null) addFilter(Filter.create(getter, operator, val));
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O and(Filter<V> filter) {
+  public <V> O and(Filter<V> filter) {
 
-		addFilter(filter);
+    addFilter(filter);
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O onlyIf(Getter<V> getter, Postulate<V> postulate) {
+  public <V> O onlyIf(Getter<V> getter, Postulate<V> postulate) {
 
-		addIfFilter(Filter.create(getter, postulate));
+    addIfFilter(Filter.create(getter, postulate));
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O onlyIf(Getter<V> getter, Operator operator, V val) {
+  public <V> O onlyIf(Getter<V> getter, Operator operator, V val) {
 
-		addIfFilter(Filter.create(getter, operator, val));
+    if (val != null) addIfFilter(Filter.create(getter, operator, val));
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	public <V> O onlyIf(Filter<V> filter) {
+  public <V> O onlyIf(Filter<V> filter) {
 
-		addIfFilter(filter);
+    addIfFilter(filter);
 
-		return (O) this;
-	}
+    return (O) this;
+  }
 
-	private void addFilter(Filter<?> filter) {
-		if (filters == null) {
-			filters = new LinkedList<Filter<?>>();
-		}
-		filters.add(filter);
-	}
-
-	private void addIfFilter(Filter<?> filter) {
-		if (ifFilters == null) {
-			ifFilters = new LinkedList<Filter<?>>();
-		}
-		ifFilters.add(filter);
-	}
+  private void addFilter(Filter<?> filter) {
+    if (filters == null) {
+      filters = new LinkedHashMap<HelenusProperty, Filter<?>>();
+    }
+    filters.put(filter.getNode().getProperty(), filter);
+  }
 
+  private void addIfFilter(Filter<?> filter) {
+    if (ifFilters == null) {
+      ifFilters = new LinkedList<Filter<?>>();
+    }
+    ifFilters.add(filter);
+  }
 }

src/main/java/net/helenus/core/operation/AbstractOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,105 +16,76 @@
  */
 package net.helenus.core.operation;
 
-import com.datastax.driver.core.PreparedStatement;
+import com.codahale.metrics.Timer;
 import com.datastax.driver.core.ResultSet;
-import com.datastax.driver.core.ResultSetFuture;
-import com.google.common.base.Function;
-import com.google.common.util.concurrent.Futures;
-import com.google.common.util.concurrent.ListenableFuture;
-
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.CompletionException;
+import java.util.concurrent.TimeoutException;
 import net.helenus.core.AbstractSessionOperations;
-import net.helenus.support.Fun;
-import net.helenus.support.Scala;
-import scala.concurrent.Future;
+import net.helenus.core.UnitOfWork;
 
-public abstract class AbstractOperation<E, O extends AbstractOperation<E, O>> extends AbstractStatementOperation<E, O> {
+public abstract class AbstractOperation<E, O extends AbstractOperation<E, O>>
+    extends AbstractStatementOperation<E, O> {
 
-	public abstract E transform(ResultSet resultSet);
+  public AbstractOperation(AbstractSessionOperations sessionOperations) {
+    super(sessionOperations);
+  }
 
-	public boolean cacheable() {
-		return false;
-	}
+  public abstract E transform(ResultSet resultSet);
 
-	public String getCacheKey() {
-		return "";
-	}
+  public PreparedOperation<E> prepare() {
+    return new PreparedOperation<E>(prepareStatement(), this);
+  }
 
-	public AbstractOperation(AbstractSessionOperations sessionOperations) {
-		super(sessionOperations);
-	}
+  public E sync() throws TimeoutException {
+    final Timer.Context context = requestLatency.time();
+    try {
+      ResultSet resultSet =
+          this.execute(
+              sessionOps, null, queryExecutionTimeout, queryTimeoutUnits, showValues, false);
+      return transform(resultSet);
+    } finally {
+      context.stop();
+    }
+  }
 
-	public PreparedOperation<E> prepare() {
-		return new PreparedOperation<E>(prepareStatement(), this);
-	}
+  public E sync(UnitOfWork uow) throws TimeoutException {
+    if (uow == null) return sync();
 
-	public ListenableFuture<PreparedOperation<E>> prepareAsync() {
+    final Timer.Context context = requestLatency.time();
+    try {
+      ResultSet resultSet =
+          execute(sessionOps, uow, queryExecutionTimeout, queryTimeoutUnits, showValues, true);
+      E result = transform(resultSet);
+      return result;
+    } finally {
+      context.stop();
+    }
+  }
 
-		final O _this = (O) this;
-
-		return Futures.transform(prepareStatementAsync(), new Function<PreparedStatement, PreparedOperation<E>>() {
-
-			@Override
-			public PreparedOperation<E> apply(PreparedStatement preparedStatement) {
-				return new PreparedOperation<E>(preparedStatement, _this);
-			}
-
-		});
-
-	}
-
-	public Future<PreparedOperation<E>> prepareFuture() {
-		return Scala.asFuture(prepareAsync());
-	}
-
-	public E sync() {
-
-		ResultSet resultSet = sessionOps.executeAsync(options(buildStatement()), showValues).getUninterruptibly();
-		E result = transform(resultSet);
-		if (cacheable()) {
-			sessionOps.cache(getCacheKey(), result);
-		}
-		return result;
-	}
-
-	public ListenableFuture<E> async() {
-
-		ResultSetFuture resultSetFuture = sessionOps.executeAsync(options(buildStatement()), showValues);
-
-		ListenableFuture<E> future = Futures.transform(resultSetFuture, new Function<ResultSet, E>() {
-
-			@Override
-			public E apply(ResultSet resultSet) {
-				E result = transform(resultSet);
-				if (cacheable()) {
-					sessionOps.cache(getCacheKey(), result);
-				}
-				return transform(resultSet);
-			}
-
-		}, sessionOps.getExecutor());
-
-		return future;
-	}
-
-	public Future<E> future() {
-		return Scala.asFuture(async());
-	}
-
-	public <A> Future<Fun.Tuple2<E, A>> future(A a) {
-		return Scala.asFuture(async(), a);
-	}
-
-	public <A, B> Future<Fun.Tuple3<E, A, B>> future(A a, B b) {
-		return Scala.asFuture(async(), a, b);
-	}
-
-	public <A, B, C> Future<Fun.Tuple4<E, A, B, C>> future(A a, B b, C c) {
-		return Scala.asFuture(async(), a, b, c);
-	}
-
-	public <A, B, C, D> Future<Fun.Tuple5<E, A, B, C, D>> future(A a, B b, C c, D d) {
-		return Scala.asFuture(async(), a, b, c, d);
-	}
+  public CompletableFuture<E> async() {
+    return CompletableFuture.<E>supplyAsync(
+        () -> {
+          try {
+            return sync();
+          } catch (TimeoutException ex) {
+            throw new CompletionException(ex);
+          }
+        });
+  }
 
+  public CompletableFuture<E> async(UnitOfWork uow) {
+    if (uow == null) return async();
+    CompletableFuture<E> f =
+        CompletableFuture.<E>supplyAsync(
+            () -> {
+              try {
+                return sync();
+              } catch (TimeoutException ex) {
+                throw new CompletionException(ex);
+              }
+            });
+    uow.addFuture(f);
+    return f;
+  }
 }

src/main/java/net/helenus/core/operation/AbstractOptionalOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,118 +16,240 @@
  */
 package net.helenus.core.operation;
 
-import java.util.Optional;
+import static net.helenus.core.HelenusSession.deleted;
 
+import com.codahale.metrics.Timer;
 import com.datastax.driver.core.PreparedStatement;
 import com.datastax.driver.core.ResultSet;
-import com.datastax.driver.core.ResultSetFuture;
 import com.google.common.base.Function;
+import com.google.common.base.Stopwatch;
 import com.google.common.util.concurrent.Futures;
 import com.google.common.util.concurrent.ListenableFuture;
-
+import java.io.Serializable;
+import java.util.List;
+import java.util.Optional;
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.CompletionException;
+import java.util.concurrent.TimeoutException;
 import net.helenus.core.AbstractSessionOperations;
+import net.helenus.core.Helenus;
+import net.helenus.core.UnitOfWork;
+import net.helenus.core.cache.CacheUtil;
+import net.helenus.core.cache.Facet;
+import net.helenus.mapping.MappingUtil;
 import net.helenus.support.Fun;
-import net.helenus.support.Scala;
-import scala.Option;
-import scala.Some;
-import scala.concurrent.Future;
+import org.apache.commons.lang3.SerializationUtils;
 
 public abstract class AbstractOptionalOperation<E, O extends AbstractOptionalOperation<E, O>>
-		extends
-			AbstractStatementOperation<E, O> {
+    extends AbstractStatementOperation<E, O> {
 
-	public AbstractOptionalOperation(AbstractSessionOperations sessionOperations) {
-		super(sessionOperations);
-	}
+  public AbstractOptionalOperation(AbstractSessionOperations sessionOperations) {
+    super(sessionOperations);
+  }
 
-	public abstract Optional<E> transform(ResultSet resultSet);
+  public abstract Optional<E> transform(ResultSet resultSet);
 
-	public PreparedOptionalOperation<E> prepare() {
-		return new PreparedOptionalOperation<E>(prepareStatement(), this);
-	}
+  public PreparedOptionalOperation<E> prepare() {
+    return new PreparedOptionalOperation<E>(prepareStatement(), this);
+  }
 
-	public ListenableFuture<PreparedOptionalOperation<E>> prepareAsync() {
+  public ListenableFuture<PreparedOptionalOperation<E>> prepareAsync() {
+    final O _this = (O) this;
+    return Futures.transform(
+        prepareStatementAsync(),
+        new Function<PreparedStatement, PreparedOptionalOperation<E>>() {
+          @Override
+          public PreparedOptionalOperation<E> apply(PreparedStatement preparedStatement) {
+            return new PreparedOptionalOperation<E>(preparedStatement, _this);
+          }
+        });
+  }
 
-		final O _this = (O) this;
+  public Optional<E> sync() throws TimeoutException {
+    final Timer.Context context = requestLatency.time();
+    try {
+      Optional<E> result = Optional.empty();
+      E cacheResult = null;
+      boolean updateCache = isSessionCacheable() && !ignoreCache();
 
-		return Futures.transform(prepareStatementAsync(),
-				new Function<PreparedStatement, PreparedOptionalOperation<E>>() {
+      if (updateCache) {
+        List<Facet> facets = bindFacetValues();
+        if (facets != null && facets.size() > 0) {
+          if (facets.stream().filter(f -> !f.fixed()).distinct().count() > 0) {
+            String tableName = CacheUtil.schemaName(facets);
+            cacheResult = (E) sessionOps.checkCache(tableName, facets);
+            if (cacheResult != null) {
+              result = Optional.of(cacheResult);
+              updateCache = false;
+              sessionCacheHits.mark();
+              cacheHits.mark();
+            } else {
+              sessionCacheMiss.mark();
+              cacheMiss.mark();
+            }
+          }
+        } else {
+          //TODO(gburd): look in statement cache for results
+        }
+      }
 
-					@Override
-					public PreparedOptionalOperation<E> apply(PreparedStatement preparedStatement) {
-						return new PreparedOptionalOperation<E>(preparedStatement, _this);
-					}
+      if (!result.isPresent()) {
+        // Formulate the query and execute it against the Cassandra cluster.
+        ResultSet resultSet =
+            this.execute(
+                sessionOps,
+                null,
+                queryExecutionTimeout,
+                queryTimeoutUnits,
+                showValues,
+                isSessionCacheable());
 
-				});
+        // Transform the query result set into the desired shape.
+        result = transform(resultSet);
+      }
 
-	}
+      if (updateCache && result.isPresent()) {
+        E r = result.get();
+        Class<?> resultClass = r.getClass();
+        if (!(resultClass.getEnclosingClass() != null
+            && resultClass.getEnclosingClass() == Fun.class)) {
+          List<Facet> facets = getFacets();
+          if (facets != null && facets.size() > 1) {
+            sessionOps.updateCache(r, facets);
+          }
+        }
+      }
+      return result;
+    } finally {
+      context.stop();
+    }
+  }
 
-	public Future<PreparedOptionalOperation<E>> prepareFuture() {
-		return Scala.asFuture(prepareAsync());
-	}
+  public Optional<E> sync(UnitOfWork uow) throws TimeoutException {
+    if (uow == null) return sync();
 
-	public Optional<E> sync() {
+    final Timer.Context context = requestLatency.time();
+    try {
 
-		ResultSet resultSet = sessionOps.executeAsync(options(buildStatement()), showValues).getUninterruptibly();
+      Optional<E> result = Optional.empty();
+      E cachedResult = null;
+      final boolean updateCache;
 
-		return transform(resultSet);
-	}
+      if (!ignoreCache()) {
+        Stopwatch timer = Stopwatch.createStarted();
+        try {
+          List<Facet> facets = bindFacetValues();
+          if (facets != null && facets.size() > 0) {
+            if (facets.stream().filter(f -> !f.fixed()).distinct().count() > 0) {
+              cachedResult = checkCache(uow, facets);
+              if (cachedResult != null) {
+                updateCache = false;
+                result = Optional.of(cachedResult);
+                uowCacheHits.mark();
+                cacheHits.mark();
+                uow.recordCacheAndDatabaseOperationCount(1, 0);
+              } else {
+                uowCacheMiss.mark();
+                if (isSessionCacheable()) {
+                  String tableName = CacheUtil.schemaName(facets);
+                  cachedResult = (E) sessionOps.checkCache(tableName, facets);
+                  if (cachedResult != null) {
+                    Class<?> iface = MappingUtil.getMappingInterface(cachedResult);
+                    if (Helenus.entity(iface).isDraftable()) {
+                      result = Optional.of(cachedResult);
+                    } else {
+                      result =
+                          Optional.of(
+                              (E)
+                                  SerializationUtils.<Serializable>clone(
+                                      (Serializable) cachedResult));
+                    }
+                    updateCache = false;
+                    sessionCacheHits.mark();
+                    cacheHits.mark();
+                    uow.recordCacheAndDatabaseOperationCount(1, 0);
+                  } else {
+                    updateCache = true;
+                    sessionCacheMiss.mark();
+                    cacheMiss.mark();
+                    uow.recordCacheAndDatabaseOperationCount(-1, 0);
+                  }
+                } else {
+                  updateCache = false;
+                }
+              }
+            } else {
+              //TODO(gburd): look in statement cache for results
+              updateCache = false; //true;
+              cacheMiss.mark();
+              uow.recordCacheAndDatabaseOperationCount(-1, 0);
+            }
+          } else {
+            updateCache = false;
+          }
+        } finally {
+          timer.stop();
+          uow.addCacheLookupTime(timer);
+        }
+      } else {
+        updateCache = false;
+      }
 
-	public ListenableFuture<Optional<E>> async() {
+      // Check to see if we fetched the object from the cache
+      if (result.isPresent()) {
+        // If we fetched the `deleted` object then the result is null (really
+        // Optional.empty()).
+        if (result.get() == deleted) {
+          result = Optional.empty();
+        }
+      } else {
 
-		ResultSetFuture resultSetFuture = sessionOps.executeAsync(options(buildStatement()), showValues);
+        // Formulate the query and execute it against the Cassandra cluster.
+        ResultSet resultSet =
+            execute(sessionOps, uow, queryExecutionTimeout, queryTimeoutUnits, showValues, true);
 
-		ListenableFuture<Optional<E>> future = Futures.transform(resultSetFuture,
-				new Function<ResultSet, Optional<E>>() {
+        // Transform the query result set into the desired shape.
+        result = transform(resultSet);
+      }
 
-					@Override
-					public Optional<E> apply(ResultSet resultSet) {
-						return transform(resultSet);
-					}
+      // If we have a result, it wasn't from the UOW cache, and we're caching things
+      // then we need to put this result into the cache for future requests to find.
+      if (updateCache && result.isPresent()) {
+        E r = result.get();
+        if (!(r instanceof Fun) && r != deleted) {
+          cacheUpdate(uow, r, getFacets());
+        }
+      }
 
-				}, sessionOps.getExecutor());
+      return result;
+    } finally {
+      context.stop();
+    }
+  }
 
-		return future;
-	}
-
-	public ListenableFuture<Option<E>> asyncForScala() {
-
-		ResultSetFuture resultSetFuture = sessionOps.executeAsync(options(buildStatement()), showValues);
-
-		ListenableFuture<Option<E>> future = Futures.transform(resultSetFuture, new Function<ResultSet, Option<E>>() {
-
-			@Override
-			public Option<E> apply(ResultSet resultSet) {
-				Optional<E> optional = transform(resultSet);
-				if (optional.isPresent()) {
-					return new Some<E>(optional.get());
-				} else {
-					return Option.empty();
-				}
-			}
-
-		}, sessionOps.getExecutor());
-
-		return future;
-	}
-	public Future<Option<E>> future() {
-		return Scala.asFuture(asyncForScala());
-	}
-
-	public <A> Future<Fun.Tuple2<Option<E>, A>> future(A a) {
-		return Scala.asFuture(asyncForScala(), a);
-	}
-
-	public <A, B> Future<Fun.Tuple3<Option<E>, A, B>> future(A a, B b) {
-		return Scala.asFuture(asyncForScala(), a, b);
-	}
-
-	public <A, B, C> Future<Fun.Tuple4<Option<E>, A, B, C>> future(A a, B b, C c) {
-		return Scala.asFuture(asyncForScala(), a, b, c);
-	}
-
-	public <A, B, C, D> Future<Fun.Tuple5<Option<E>, A, B, C, D>> future(A a, B b, C c, D d) {
-		return Scala.asFuture(asyncForScala(), a, b, c, d);
-	}
+  public CompletableFuture<Optional<E>> async() {
+    return CompletableFuture.<Optional<E>>supplyAsync(
+        () -> {
+          try {
+            return sync();
+          } catch (TimeoutException ex) {
+            throw new CompletionException(ex);
+          }
+        });
+  }
 
+  public CompletableFuture<Optional<E>> async(UnitOfWork uow) {
+    if (uow == null) return async();
+    CompletableFuture<Optional<E>> f =
+        CompletableFuture.<Optional<E>>supplyAsync(
+            () -> {
+              try {
+                return sync();
+              } catch (TimeoutException ex) {
+                throw new CompletionException(ex);
+              }
+            });
+    uow.addFuture(f);
+    return f;
+  }
 }

src/main/java/net/helenus/core/operation/AbstractStatementOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,9 +16,6 @@
  */
 package net.helenus.core.operation;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
 import com.datastax.driver.core.ConsistencyLevel;
 import com.datastax.driver.core.PreparedStatement;
 import com.datastax.driver.core.RegularStatement;
@@ -28,211 +26,331 @@ import com.datastax.driver.core.policies.FallthroughRetryPolicy;
 import com.datastax.driver.core.policies.RetryPolicy;
 import com.datastax.driver.core.querybuilder.BuiltStatement;
 import com.google.common.util.concurrent.ListenableFuture;
-
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+import java.util.concurrent.TimeUnit;
 import net.helenus.core.AbstractSessionOperations;
+import net.helenus.core.UnitOfWork;
+import net.helenus.core.cache.Facet;
+import net.helenus.core.cache.UnboundFacet;
+import net.helenus.core.reflect.MapExportable;
+import net.helenus.mapping.HelenusProperty;
+import net.helenus.mapping.value.BeanColumnValueProvider;
 import net.helenus.support.HelenusException;
-import net.helenus.support.Scala;
-import scala.concurrent.Future;
 
-public abstract class AbstractStatementOperation<E, O extends AbstractStatementOperation<E, O>> {
+public abstract class AbstractStatementOperation<E, O extends AbstractStatementOperation<E, O>>
+    extends Operation<E> {
+  private boolean ignoreCache = false;
+  private ConsistencyLevel consistencyLevel;
+  private ConsistencyLevel serialConsistencyLevel;
+  private RetryPolicy retryPolicy;
+  private boolean enableTracing = false;
+  private long[] defaultTimestamp = null;
+  private int[] fetchSize = null;
+  protected boolean idempotent = false;
 
-	final Logger logger = LoggerFactory.getLogger(getClass());
+  public AbstractStatementOperation(AbstractSessionOperations sessionOperations) {
+    super(sessionOperations);
+    this.consistencyLevel = sessionOperations.getDefaultConsistencyLevel();
+    this.idempotent = sessionOperations.getDefaultQueryIdempotency();
+  }
 
-	protected final AbstractSessionOperations sessionOps;
+  public abstract Statement buildStatement(boolean cached);
 
-	public abstract Statement buildStatement();
+  public O uncached(boolean enabled) {
+    ignoreCache = !enabled;
+    return (O) this;
+  }
 
-	protected boolean showValues = true;
-	private ConsistencyLevel consistencyLevel;
-	private ConsistencyLevel serialConsistencyLevel;
-	private RetryPolicy retryPolicy;
-	private boolean enableTracing = false;
-	private long[] defaultTimestamp = null;
-	private int[] fetchSize = null;
+  public O uncached() {
+    ignoreCache = true;
+    return (O) this;
+  }
 
-	public AbstractStatementOperation(AbstractSessionOperations sessionOperations) {
-		this.sessionOps = sessionOperations;
-	}
+  public O showValues(boolean enabled) {
+    this.showValues = enabled;
+    return (O) this;
+  }
 
-	public O showValues(boolean enabled) {
-		this.showValues = enabled;
-		return (O) this;
-	}
+  public O defaultTimestamp(long timestamp) {
+    this.defaultTimestamp = new long[1];
+    this.defaultTimestamp[0] = timestamp;
+    return (O) this;
+  }
 
-	public O defaultTimestamp(long timestamp) {
-		this.defaultTimestamp = new long[1];
-		this.defaultTimestamp[0] = timestamp;
-		return (O) this;
-	}
+  public O retryPolicy(RetryPolicy retryPolicy) {
+    this.retryPolicy = retryPolicy;
+    return (O) this;
+  }
 
-	public O retryPolicy(RetryPolicy retryPolicy) {
-		this.retryPolicy = retryPolicy;
-		return (O) this;
-	}
+  public O defaultRetryPolicy() {
+    this.retryPolicy = DefaultRetryPolicy.INSTANCE;
+    return (O) this;
+  }
 
-	public O defaultRetryPolicy() {
-		this.retryPolicy = DefaultRetryPolicy.INSTANCE;
-		return (O) this;
-	}
+  public O idempotent() {
+    this.idempotent = true;
+    return (O) this;
+  }
 
-	public O downgradingConsistencyRetryPolicy() {
-		this.retryPolicy = DowngradingConsistencyRetryPolicy.INSTANCE;
-		return (O) this;
-	}
+  public O isIdempotent(boolean idempotent) {
+    this.idempotent = idempotent;
+    return (O) this;
+  }
 
-	public O fallthroughRetryPolicy() {
-		this.retryPolicy = FallthroughRetryPolicy.INSTANCE;
-		return (O) this;
-	}
+  public O downgradingConsistencyRetryPolicy() {
+    this.retryPolicy = DowngradingConsistencyRetryPolicy.INSTANCE;
+    return (O) this;
+  }
 
-	public O consistency(ConsistencyLevel level) {
-		this.consistencyLevel = level;
-		return (O) this;
-	}
+  public O fallthroughRetryPolicy() {
+    this.retryPolicy = FallthroughRetryPolicy.INSTANCE;
+    return (O) this;
+  }
 
-	public O consistencyAny() {
-		this.consistencyLevel = ConsistencyLevel.ANY;
-		return (O) this;
-	}
+  public O consistency(ConsistencyLevel level) {
+    this.consistencyLevel = level;
+    return (O) this;
+  }
 
-	public O consistencyOne() {
-		this.consistencyLevel = ConsistencyLevel.ONE;
-		return (O) this;
-	}
+  public O consistencyAny() {
+    this.consistencyLevel = ConsistencyLevel.ANY;
+    return (O) this;
+  }
 
-	public O consistencyQuorum() {
-		this.consistencyLevel = ConsistencyLevel.QUORUM;
-		return (O) this;
-	}
+  public O consistencyOne() {
+    this.consistencyLevel = ConsistencyLevel.ONE;
+    return (O) this;
+  }
 
-	public O consistencyAll() {
-		this.consistencyLevel = ConsistencyLevel.ALL;
-		return (O) this;
-	}
+  public O consistencyQuorum() {
+    this.consistencyLevel = ConsistencyLevel.QUORUM;
+    return (O) this;
+  }
 
-	public O serialConsistency(ConsistencyLevel level) {
-		this.serialConsistencyLevel = level;
-		return (O) this;
-	}
+  public O consistencyAll() {
+    this.consistencyLevel = ConsistencyLevel.ALL;
+    return (O) this;
+  }
 
-	public O serialConsistencyAny() {
-		this.serialConsistencyLevel = ConsistencyLevel.ANY;
-		return (O) this;
-	}
+  public O consistencyLocalOne() {
+    this.consistencyLevel = ConsistencyLevel.LOCAL_ONE;
+    return (O) this;
+  }
 
-	public O serialConsistencyOne() {
-		this.serialConsistencyLevel = ConsistencyLevel.ONE;
-		return (O) this;
-	}
+  public O consistencyLocalQuorum() {
+    this.consistencyLevel = ConsistencyLevel.LOCAL_QUORUM;
+    return (O) this;
+  }
 
-	public O serialConsistencyQuorum() {
-		this.serialConsistencyLevel = ConsistencyLevel.QUORUM;
-		return (O) this;
-	}
+  public O consistencyEachQuorum() {
+    this.consistencyLevel = ConsistencyLevel.EACH_QUORUM;
+    return (O) this;
+  }
 
-	public O serialConsistencyAll() {
-		this.serialConsistencyLevel = ConsistencyLevel.ALL;
-		return (O) this;
-	}
+  public O serialConsistency(ConsistencyLevel level) {
+    this.serialConsistencyLevel = level;
+    return (O) this;
+  }
 
-	public O disableTracing() {
-		this.enableTracing = false;
-		return (O) this;
-	}
+  public O serialConsistencyAny() {
+    this.serialConsistencyLevel = ConsistencyLevel.ANY;
+    return (O) this;
+  }
 
-	public O enableTracing() {
-		this.enableTracing = true;
-		return (O) this;
-	}
+  public O serialConsistencyOne() {
+    this.serialConsistencyLevel = ConsistencyLevel.ONE;
+    return (O) this;
+  }
 
-	public O tracing(boolean enable) {
-		this.enableTracing = enable;
-		return (O) this;
-	}
+  public O serialConsistencyQuorum() {
+    this.serialConsistencyLevel = ConsistencyLevel.QUORUM;
+    return (O) this;
+  }
 
-	public O fetchSize(int fetchSize) {
-		this.fetchSize = new int[1];
-		this.fetchSize[0] = fetchSize;
-		return (O) this;
-	}
+  public O serialConsistencyAll() {
+    this.serialConsistencyLevel = ConsistencyLevel.ALL;
+    return (O) this;
+  }
 
-	protected Statement options(Statement statement) {
+  public O serialConsistencyLocal() {
+    this.serialConsistencyLevel = ConsistencyLevel.LOCAL_SERIAL;
+    return (O) this;
+  }
 
-		if (defaultTimestamp != null) {
-			statement.setDefaultTimestamp(defaultTimestamp[0]);
-		}
+  public O serialConsistencyLocalQuorum() {
+    this.serialConsistencyLevel = ConsistencyLevel.LOCAL_QUORUM;
+    return (O) this;
+  }
 
-		if (consistencyLevel != null) {
-			statement.setConsistencyLevel(consistencyLevel);
-		}
+  public O disableTracing() {
+    this.enableTracing = false;
+    return (O) this;
+  }
 
-		if (serialConsistencyLevel != null) {
-			statement.setSerialConsistencyLevel(serialConsistencyLevel);
-		}
+  public O enableTracing() {
+    this.enableTracing = true;
+    return (O) this;
+  }
 
-		if (retryPolicy != null) {
-			statement.setRetryPolicy(retryPolicy);
-		}
+  public O tracing(boolean enable) {
+    this.enableTracing = enable;
+    return (O) this;
+  }
 
-		if (enableTracing) {
-			statement.enableTracing();
-		} else {
-			statement.disableTracing();
-		}
+  public O fetchSize(int fetchSize) {
+    this.fetchSize = new int[1];
+    this.fetchSize[0] = fetchSize;
+    return (O) this;
+  }
 
-		if (fetchSize != null) {
-			statement.setFetchSize(fetchSize[0]);
-		}
+  public O queryTimeoutMs(long ms) {
+    this.queryExecutionTimeout = ms;
+    this.queryTimeoutUnits = TimeUnit.MILLISECONDS;
+    return (O) this;
+  }
 
-		return statement;
-	}
+  public O queryTimeout(long timeout, TimeUnit units) {
+    this.queryExecutionTimeout = timeout;
+    this.queryTimeoutUnits = units;
+    return (O) this;
+  }
 
-	public Statement statement() {
-		return buildStatement();
-	}
+  public Statement options(Statement statement) {
 
-	public String cql() {
-		Statement statement = buildStatement();
-		if (statement == null) return "";
-		if (statement instanceof BuiltStatement) {
-			BuiltStatement buildStatement = (BuiltStatement) statement;
-			return buildStatement.setForceNoValues(true).getQueryString();
-		} else {
-			return statement.toString();
-		}
-	}
+    if (defaultTimestamp != null) {
+      statement.setDefaultTimestamp(defaultTimestamp[0]);
+    }
 
-	public PreparedStatement prepareStatement() {
+    if (consistencyLevel != null) {
+      statement.setConsistencyLevel(consistencyLevel);
+    }
 
-		Statement statement = buildStatement();
+    if (serialConsistencyLevel != null) {
+      statement.setSerialConsistencyLevel(serialConsistencyLevel);
+    }
 
-		if (statement instanceof RegularStatement) {
+    if (retryPolicy != null) {
+      statement.setRetryPolicy(retryPolicy);
+    }
 
-			RegularStatement regularStatement = (RegularStatement) statement;
+    if (enableTracing) {
+      statement.enableTracing();
+    } else {
+      statement.disableTracing();
+    }
 
-			return sessionOps.prepare(regularStatement);
-		}
+    if (fetchSize != null) {
+      statement.setFetchSize(fetchSize[0]);
+    }
 
-		throw new HelenusException("only RegularStatements can be prepared");
-	}
+    if (isIdempotentOperation()) {
+      statement.setIdempotent(true);
+    }
 
-	public ListenableFuture<PreparedStatement> prepareStatementAsync() {
+    return statement;
+  }
 
-		Statement statement = buildStatement();
+  @Override
+  protected boolean isIdempotentOperation() {
+    return idempotent;
+  }
 
-		if (statement instanceof RegularStatement) {
+  public Statement statement() {
+    return buildStatement(false);
+  }
 
-			RegularStatement regularStatement = (RegularStatement) statement;
+  public String cql() {
+    Statement statement = buildStatement(false);
+    if (statement == null) return "";
+    if (statement instanceof BuiltStatement) {
+      BuiltStatement buildStatement = (BuiltStatement) statement;
+      return buildStatement.setForceNoValues(true).getQueryString();
+    } else {
+      return statement.toString();
+    }
+  }
 
-			return sessionOps.prepareAsync(regularStatement);
+  public PreparedStatement prepareStatement() {
 
-		}
+    Statement statement = buildStatement(true);
 
-		throw new HelenusException("only RegularStatements can be prepared");
-	}
+    if (statement instanceof RegularStatement) {
 
-	public Future<PreparedStatement> prepareStatementFuture() {
-		return Scala.asFuture(prepareStatementAsync());
-	}
+      RegularStatement regularStatement = (RegularStatement) statement;
 
+      return sessionOps.prepare(regularStatement);
+    }
+
+    throw new HelenusException("only RegularStatements can be prepared");
+  }
+
+  public ListenableFuture<PreparedStatement> prepareStatementAsync() {
+
+    Statement statement = buildStatement(true);
+
+    if (statement instanceof RegularStatement) {
+
+      RegularStatement regularStatement = (RegularStatement) statement;
+
+      return sessionOps.prepareAsync(regularStatement);
+    }
+
+    throw new HelenusException("only RegularStatements can be prepared");
+  }
+
+  protected boolean ignoreCache() {
+    return ignoreCache;
+  }
+
+  protected E checkCache(UnitOfWork uow, List<Facet> facets) {
+    E result = null;
+    Optional<Object> optionalCachedResult = Optional.empty();
+
+    if (!facets.isEmpty()) {
+      optionalCachedResult = uow.cacheLookup(facets);
+      if (optionalCachedResult.isPresent()) {
+        result = (E) optionalCachedResult.get();
+      }
+    }
+
+    return result;
+  }
+
+  protected Object cacheUpdate(UnitOfWork uow, E pojo, List<Facet> identifyingFacets) {
+    List<Facet> facets = new ArrayList<>();
+    Map<String, Object> valueMap =
+        pojo instanceof MapExportable ? ((MapExportable) pojo).toMap() : null;
+
+    for (Facet facet : identifyingFacets) {
+      if (facet instanceof UnboundFacet) {
+        UnboundFacet unboundFacet = (UnboundFacet) facet;
+        UnboundFacet.Binder binder = unboundFacet.binder();
+        for (HelenusProperty prop : unboundFacet.getProperties()) {
+          Object value;
+          if (valueMap == null) {
+            value = BeanColumnValueProvider.INSTANCE.getColumnValue(pojo, -1, prop, false);
+            if (value != null) {
+              binder.setValueForProperty(prop, value.toString());
+            }
+          } else {
+            value = valueMap.get(prop.getPropertyName());
+            if (value != null) {
+              binder.setValueForProperty(prop, value.toString());
+            }
+          }
+        }
+        if (binder.isBound()) {
+          facets.add(binder.bind());
+        }
+      } else {
+        facets.add(facet);
+      }
+    }
+
+    // Cache the value (pojo), the statement key, and the fully bound facets.
+    return uow.cacheUpdate(pojo, facets);
+  }
 }

src/main/java/net/helenus/core/operation/AbstractStreamOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,114 +16,246 @@
  */
 package net.helenus.core.operation;
 
-import java.util.stream.Stream;
+import static net.helenus.core.HelenusSession.deleted;
 
+import com.codahale.metrics.Timer;
 import com.datastax.driver.core.PreparedStatement;
 import com.datastax.driver.core.ResultSet;
-import com.datastax.driver.core.ResultSetFuture;
 import com.google.common.base.Function;
+import com.google.common.base.Stopwatch;
 import com.google.common.util.concurrent.Futures;
 import com.google.common.util.concurrent.ListenableFuture;
-
+import java.io.Serializable;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.CompletionException;
+import java.util.concurrent.TimeoutException;
+import java.util.stream.Stream;
 import net.helenus.core.AbstractSessionOperations;
+import net.helenus.core.Helenus;
+import net.helenus.core.UnitOfWork;
+import net.helenus.core.cache.CacheUtil;
+import net.helenus.core.cache.Facet;
+import net.helenus.mapping.MappingUtil;
 import net.helenus.support.Fun;
-import net.helenus.support.Scala;
-import scala.concurrent.Future;
+import org.apache.commons.lang3.SerializationUtils;
 
 public abstract class AbstractStreamOperation<E, O extends AbstractStreamOperation<E, O>>
-		extends
-			AbstractStatementOperation<E, O> {
+    extends AbstractStatementOperation<E, O> {
 
-	public AbstractStreamOperation(AbstractSessionOperations sessionOperations) {
-		super(sessionOperations);
-	}
+  public AbstractStreamOperation(AbstractSessionOperations sessionOperations) {
+    super(sessionOperations);
+  }
 
-	public abstract Stream<E> transform(ResultSet resultSet);
+  public abstract Stream<E> transform(ResultSet resultSet);
 
-	public PreparedStreamOperation<E> prepare() {
-		return new PreparedStreamOperation<E>(prepareStatement(), this);
-	}
+  public PreparedStreamOperation<E> prepare() {
+    return new PreparedStreamOperation<E>(prepareStatement(), this);
+  }
 
-	public ListenableFuture<PreparedStreamOperation<E>> prepareAsync() {
+  public ListenableFuture<PreparedStreamOperation<E>> prepareAsync() {
+    final O _this = (O) this;
+    return Futures.transform(
+        prepareStatementAsync(),
+        new Function<PreparedStatement, PreparedStreamOperation<E>>() {
+          @Override
+          public PreparedStreamOperation<E> apply(PreparedStatement preparedStatement) {
+            return new PreparedStreamOperation<E>(preparedStatement, _this);
+          }
+        });
+  }
 
-		final O _this = (O) this;
+  public Stream<E> sync() throws TimeoutException {
+    final Timer.Context context = requestLatency.time();
+    try {
+      Stream<E> resultStream = null;
+      E cacheResult = null;
+      boolean updateCache = isSessionCacheable();
 
-		return Futures.transform(prepareStatementAsync(),
-				new Function<PreparedStatement, PreparedStreamOperation<E>>() {
+      if (!ignoreCache() && isSessionCacheable()) {
+        List<Facet> facets = bindFacetValues();
+        if (facets != null && facets.size() > 0) {
+          if (facets.stream().filter(f -> !f.fixed()).distinct().count() > 0) {
+            String tableName = CacheUtil.schemaName(facets);
+            cacheResult = (E) sessionOps.checkCache(tableName, facets);
+            if (cacheResult != null) {
+              resultStream = Stream.of(cacheResult);
+              updateCache = false;
+              sessionCacheHits.mark();
+              cacheHits.mark();
+            } else {
+              sessionCacheMiss.mark();
+              cacheMiss.mark();
+            }
+          } else {
+            //TODO(gburd): look in statement cache for results
+          }
+        }
+      }
 
-					@Override
-					public PreparedStreamOperation<E> apply(PreparedStatement preparedStatement) {
-						return new PreparedStreamOperation<E>(preparedStatement, _this);
-					}
+      if (resultStream == null) {
+        // Formulate the query and execute it against the Cassandra cluster.
+        ResultSet resultSet =
+            this.execute(
+                sessionOps,
+                null,
+                queryExecutionTimeout,
+                queryTimeoutUnits,
+                showValues,
+                isSessionCacheable());
 
-				});
+        // Transform the query result set into the desired shape.
+        resultStream = transform(resultSet);
+      }
 
-	}
+      if (updateCache && resultStream != null) {
+        List<Facet> facets = getFacets();
+        if (facets != null && facets.size() > 1) {
+          List<E> again = new ArrayList<>();
+          resultStream.forEach(
+              result -> {
+                Class<?> resultClass = result.getClass();
+                if (!(resultClass.getEnclosingClass() != null
+                    && resultClass.getEnclosingClass() == Fun.class)) {
+                  sessionOps.updateCache(result, facets);
+                }
+                again.add(result);
+              });
+          resultStream = again.stream();
+        }
+      }
+      return resultStream;
 
-	public Future<PreparedStreamOperation<E>> prepareFuture() {
-		return Scala.asFuture(prepareAsync());
-	}
+    } finally {
+      context.stop();
+    }
+  }
 
-	public Stream<E> sync() {
+  public Stream<E> sync(UnitOfWork uow) throws TimeoutException {
+    if (uow == null) return sync();
 
-		ResultSet resultSet = sessionOps.executeAsync(options(buildStatement()), showValues).getUninterruptibly();
+    final Timer.Context context = requestLatency.time();
+    try {
+      Stream<E> resultStream = null;
+      E cachedResult = null;
+      final boolean updateCache;
 
-		return transform(resultSet);
-	}
+      if (!ignoreCache()) {
+        Stopwatch timer = Stopwatch.createStarted();
+        try {
+          List<Facet> facets = bindFacetValues();
+          if (facets != null && facets.size() > 0) {
+            if (facets.stream().filter(f -> !f.fixed()).distinct().count() > 0) {
+              cachedResult = checkCache(uow, facets);
+              if (cachedResult != null) {
+                updateCache = false;
+                resultStream = Stream.of(cachedResult);
+                uowCacheHits.mark();
+                cacheHits.mark();
+                uow.recordCacheAndDatabaseOperationCount(1, 0);
+              } else {
+                uowCacheMiss.mark();
+                if (isSessionCacheable()) {
+                  String tableName = CacheUtil.schemaName(facets);
+                  cachedResult = (E) sessionOps.checkCache(tableName, facets);
+                  if (cachedResult != null) {
+                    Class<?> iface = MappingUtil.getMappingInterface(cachedResult);
+                    E result = null;
+                    if (Helenus.entity(iface).isDraftable()) {
+                      result = cachedResult;
+                    } else {
+                      result =
+                          (E) SerializationUtils.<Serializable>clone((Serializable) cachedResult);
+                    }
+                    updateCache = false;
+                    resultStream = Stream.of(result);
+                    sessionCacheHits.mark();
+                    cacheHits.mark();
+                    uow.recordCacheAndDatabaseOperationCount(1, 0);
+                  } else {
+                    updateCache = true;
+                    sessionCacheMiss.mark();
+                    cacheMiss.mark();
+                    uow.recordCacheAndDatabaseOperationCount(-1, 0);
+                  }
+                } else {
+                  updateCache = false;
+                }
+              }
+            } else {
+              //TODO(gburd): look in statement cache for results
+              updateCache = false; //true;
+              cacheMiss.mark();
+              uow.recordCacheAndDatabaseOperationCount(-1, 0);
+            }
+          } else {
+            updateCache = false;
+          }
+        } finally {
+          timer.stop();
+          uow.addCacheLookupTime(timer);
+        }
+      } else {
+        updateCache = false;
+      }
 
-	public ListenableFuture<Stream<E>> async() {
+      // Check to see if we fetched the object from the cache
+      if (resultStream == null) {
+        ResultSet resultSet =
+            execute(sessionOps, uow, queryExecutionTimeout, queryTimeoutUnits, showValues, true);
+        resultStream = transform(resultSet);
+      }
 
-		ResultSetFuture resultSetFuture = sessionOps.executeAsync(options(buildStatement()), showValues);
+      // If we have a result and we're caching then we need to put it into the cache
+      // for future requests to find.
+      if (resultStream != null) {
+        if (updateCache) {
+          List<E> again = new ArrayList<>();
+          List<Facet> facets = getFacets();
+          resultStream.forEach(
+              result -> {
+                Class<?> resultClass = result.getClass();
+                if (result != deleted
+                    && !(resultClass.getEnclosingClass() != null
+                        && resultClass.getEnclosingClass() == Fun.class)) {
+                  result = (E) cacheUpdate(uow, result, facets);
+                }
+                again.add(result);
+              });
+          resultStream = again.stream();
+        }
+      }
 
-		ListenableFuture<Stream<E>> future = Futures.transform(resultSetFuture, new Function<ResultSet, Stream<E>>() {
+      return resultStream;
+    } finally {
+      context.stop();
+    }
+  }
 
-			@Override
-			public Stream<E> apply(ResultSet resultSet) {
-				return transform(resultSet);
-			}
-
-		}, sessionOps.getExecutor());
-
-		return future;
-	}
-
-	public ListenableFuture<scala.collection.immutable.Stream<E>> asyncForScala() {
-
-		ResultSetFuture resultSetFuture = sessionOps.executeAsync(options(buildStatement()), showValues);
-
-		ListenableFuture<scala.collection.immutable.Stream<E>> future = Futures.transform(resultSetFuture,
-				new Function<ResultSet, scala.collection.immutable.Stream<E>>() {
-
-					@Override
-					public scala.collection.immutable.Stream<E> apply(ResultSet resultSet) {
-						Stream<E> stream = transform(resultSet);
-						return scala.collection.JavaConversions.asScalaIterator(stream.iterator()).toStream();
-					}
-
-				}, sessionOps.getExecutor());
-
-		return future;
-	}
-
-	public Future<scala.collection.immutable.Stream<E>> future() {
-		return Scala.asFuture(asyncForScala());
-	}
-
-	public <A> Future<Fun.Tuple2<scala.collection.immutable.Stream<E>, A>> future(A a) {
-		return Scala.asFuture(asyncForScala(), a);
-	}
-
-	public <A, B> Future<Fun.Tuple3<scala.collection.immutable.Stream<E>, A, B>> future(A a, B b) {
-		return Scala.asFuture(asyncForScala(), a, b);
-	}
-
-	public <A, B, C> Future<Fun.Tuple4<scala.collection.immutable.Stream<E>, A, B, C>> future(A a, B b, C c) {
-		return Scala.asFuture(asyncForScala(), a, b, c);
-	}
-
-	public <A, B, C, D> Future<Fun.Tuple5<scala.collection.immutable.Stream<E>, A, B, C, D>> future(A a, B b, C c,
-			D d) {
-		return Scala.asFuture(asyncForScala(), a, b, c, d);
-	}
+  public CompletableFuture<Stream<E>> async() {
+    return CompletableFuture.<Stream<E>>supplyAsync(
+        () -> {
+          try {
+            return sync();
+          } catch (TimeoutException ex) {
+            throw new CompletionException(ex);
+          }
+        });
+  }
 
+  public CompletableFuture<Stream<E>> async(UnitOfWork uow) {
+    if (uow == null) return async();
+    CompletableFuture<Stream<E>> f =
+        CompletableFuture.<Stream<E>>supplyAsync(
+            () -> {
+              try {
+                return sync();
+              } catch (TimeoutException ex) {
+                throw new CompletionException(ex);
+              }
+            });
+    uow.addFuture(f);
+    return f;
+  }
 }

src/main/java/net/helenus/core/operation/BatchOperation.java

@@ -0,0 +1,140 @@
+/*
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+package net.helenus.core.operation;
+
+import com.codahale.metrics.Timer;
+import com.datastax.driver.core.AtomicMonotonicTimestampGenerator;
+import com.datastax.driver.core.BatchStatement;
+import com.datastax.driver.core.ResultSet;
+import com.datastax.driver.core.TimestampGenerator;
+import com.google.common.base.Stopwatch;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.concurrent.TimeoutException;
+import java.util.stream.Collectors;
+import net.helenus.core.AbstractSessionOperations;
+import net.helenus.core.UnitOfWork;
+import net.helenus.support.HelenusException;
+
+public class BatchOperation extends Operation<Long> {
+  //TODO(gburd): find the way to get the driver's timestamp generator
+  private static final TimestampGenerator timestampGenerator =
+      new AtomicMonotonicTimestampGenerator();
+
+  private final BatchStatement batch;
+  private List<AbstractOperation<?, ?>> operations = new ArrayList<AbstractOperation<?, ?>>();
+  private boolean logged = true;
+
+  public BatchOperation(AbstractSessionOperations sessionOperations) {
+    super(sessionOperations);
+    batch = new BatchStatement();
+  }
+
+  public void add(AbstractOperation<?, ?> operation) {
+    operations.add(operation);
+  }
+
+  @Override
+  public BatchStatement buildStatement(boolean cached) {
+    batch.addAll(
+        operations.stream().map(o -> o.buildStatement(cached)).collect(Collectors.toList()));
+    batch.setConsistencyLevel(sessionOps.getDefaultConsistencyLevel());
+    return batch;
+  }
+
+  public BatchOperation logged() {
+    logged = true;
+    return this;
+  }
+
+  public BatchOperation setLogged(boolean logStatements) {
+    logged = logStatements;
+    return this;
+  }
+
+  public Long sync() {
+    if (operations.size() == 0) return 0L;
+    final Timer.Context context = requestLatency.time();
+    try {
+        batch.setDefaultTimestamp(timestampGenerator.next());
+        ResultSet resultSet =
+                this.execute(
+                        sessionOps, null, queryExecutionTimeout, queryTimeoutUnits, showValues, false);
+        if (!resultSet.wasApplied()) {
+            throw new HelenusException("Failed to apply batch.");
+        }
+    } catch (TimeoutException e) {
+        throw new HelenusException(e);
+    } finally {
+      context.stop();
+    }
+    return batch.getDefaultTimestamp();
+  }
+
+  public Long sync(UnitOfWork uow) {
+    if (operations.size() == 0) return 0L;
+    if (uow == null) return sync();
+
+    final Timer.Context context = requestLatency.time();
+    final Stopwatch timer = Stopwatch.createStarted();
+    try {
+        uow.recordCacheAndDatabaseOperationCount(0, 1);
+        batch.setDefaultTimestamp(timestampGenerator.next());
+        ResultSet resultSet =
+                this.execute(
+                        sessionOps, uow, queryExecutionTimeout, queryTimeoutUnits, showValues, false);
+        if (!resultSet.wasApplied()) {
+            throw new HelenusException("Failed to apply batch.");
+        }
+    } catch (TimeoutException e) {
+        throw new HelenusException(e);
+    } finally {
+      context.stop();
+      timer.stop();
+    }
+    uow.addDatabaseTime("Cassandra", timer);
+    return batch.getDefaultTimestamp();
+  }
+
+  public void addAll(BatchOperation batch) {
+    batch.operations.forEach(o -> this.operations.add(o));
+  }
+
+  public String toString() {
+    return toString(true); //TODO(gburd): sessionOps.showQueryValues()
+  }
+
+  public String toString(boolean showValues) {
+    StringBuilder s = new StringBuilder();
+    s.append("BEGIN ");
+    if (!logged) {
+      s.append("UNLOGGED ");
+    }
+    s.append("BATCH ");
+
+    if (batch.getDefaultTimestamp() > -9223372036854775808L) {
+      s.append("USING TIMESTAMP ").append(String.valueOf(batch.getDefaultTimestamp())).append(" ");
+    }
+    s.append(
+        operations
+            .stream()
+            .map(o -> Operation.queryString(o.buildStatement(showValues), showValues))
+            .collect(Collectors.joining(" ")));
+    s.append(" APPLY BATCH;");
+    return s.toString();
+  }
+}

src/main/java/net/helenus/core/operation/BoundOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -21,23 +22,27 @@ import com.datastax.driver.core.Statement;
 
 public final class BoundOperation<E> extends AbstractOperation<E, BoundOperation<E>> {
 
-	private final BoundStatement boundStatement;
-	private final AbstractOperation<E, ?> delegate;
+  private final BoundStatement boundStatement;
+  private final AbstractOperation<E, ?> delegate;
 
-	public BoundOperation(BoundStatement boundStatement, AbstractOperation<E, ?> operation) {
-		super(operation.sessionOps);
-		this.boundStatement = boundStatement;
-		this.delegate = operation;
-	}
+  public BoundOperation(BoundStatement boundStatement, AbstractOperation<E, ?> operation) {
+    super(operation.sessionOps);
+    this.boundStatement = boundStatement;
+    this.delegate = operation;
+  }
 
-	@Override
-	public E transform(ResultSet resultSet) {
-		return delegate.transform(resultSet);
-	}
+  @Override
+  public E transform(ResultSet resultSet) {
+    return delegate.transform(resultSet);
+  }
 
-	@Override
-	public Statement buildStatement() {
-		return boundStatement;
-	}
+  @Override
+  public Statement buildStatement(boolean cached) {
+    return boundStatement;
+  }
 
+  @Override
+  public boolean isSessionCacheable() {
+    return delegate.isSessionCacheable();
+  }
 }

src/main/java/net/helenus/core/operation/BoundOptionalOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,31 +16,36 @@
  */
 package net.helenus.core.operation;
 
-import java.util.Optional;
-
 import com.datastax.driver.core.BoundStatement;
 import com.datastax.driver.core.ResultSet;
 import com.datastax.driver.core.Statement;
+import java.util.Optional;
 
-public final class BoundOptionalOperation<E> extends AbstractOptionalOperation<E, BoundOptionalOperation<E>> {
+public final class BoundOptionalOperation<E>
+    extends AbstractOptionalOperation<E, BoundOptionalOperation<E>> {
 
-	private final BoundStatement boundStatement;
-	private final AbstractOptionalOperation<E, ?> delegate;
+  private final BoundStatement boundStatement;
+  private final AbstractOptionalOperation<E, ?> delegate;
 
-	public BoundOptionalOperation(BoundStatement boundStatement, AbstractOptionalOperation<E, ?> operation) {
-		super(operation.sessionOps);
-		this.boundStatement = boundStatement;
-		this.delegate = operation;
-	}
+  public BoundOptionalOperation(
+      BoundStatement boundStatement, AbstractOptionalOperation<E, ?> operation) {
+    super(operation.sessionOps);
+    this.boundStatement = boundStatement;
+    this.delegate = operation;
+  }
 
-	@Override
-	public Optional<E> transform(ResultSet resultSet) {
-		return delegate.transform(resultSet);
-	}
+  @Override
+  public Optional<E> transform(ResultSet resultSet) {
+    return delegate.transform(resultSet);
+  }
 
-	@Override
-	public Statement buildStatement() {
-		return boundStatement;
-	}
+  @Override
+  public Statement buildStatement(boolean cached) {
+    return boundStatement;
+  }
 
+  @Override
+  public boolean isSessionCacheable() {
+    return delegate.isSessionCacheable();
+  }
 }

src/main/java/net/helenus/core/operation/BoundStreamOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,31 +16,43 @@
  */
 package net.helenus.core.operation;
 
-import java.util.stream.Stream;
-
 import com.datastax.driver.core.BoundStatement;
 import com.datastax.driver.core.ResultSet;
 import com.datastax.driver.core.Statement;
+import java.util.List;
+import java.util.stream.Stream;
+import net.helenus.core.cache.Facet;
 
-public final class BoundStreamOperation<E> extends AbstractStreamOperation<E, BoundStreamOperation<E>> {
+public final class BoundStreamOperation<E>
+    extends AbstractStreamOperation<E, BoundStreamOperation<E>> {
 
-	private final BoundStatement boundStatement;
-	private final AbstractStreamOperation<E, ?> delegate;
+  private final BoundStatement boundStatement;
+  private final AbstractStreamOperation<E, ?> delegate;
 
-	public BoundStreamOperation(BoundStatement boundStatement, AbstractStreamOperation<E, ?> operation) {
-		super(operation.sessionOps);
-		this.boundStatement = boundStatement;
-		this.delegate = operation;
-	}
+  public BoundStreamOperation(
+      BoundStatement boundStatement, AbstractStreamOperation<E, ?> operation) {
+    super(operation.sessionOps);
+    this.boundStatement = boundStatement;
+    this.delegate = operation;
+  }
 
-	@Override
-	public Stream<E> transform(ResultSet resultSet) {
-		return delegate.transform(resultSet);
-	}
+  @Override
+  public List<Facet> bindFacetValues() {
+    return delegate.bindFacetValues();
+  }
 
-	@Override
-	public Statement buildStatement() {
-		return boundStatement;
-	}
+  @Override
+  public Stream<E> transform(ResultSet resultSet) {
+    return delegate.transform(resultSet);
+  }
 
+  @Override
+  public Statement buildStatement(boolean cached) {
+    return boundStatement;
+  }
+
+  @Override
+  public boolean isSessionCacheable() {
+    return delegate.isSessionCacheable();
+  }
 }

src/main/java/net/helenus/core/operation/CountOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -20,7 +21,6 @@ import com.datastax.driver.core.querybuilder.BuiltStatement;
 import com.datastax.driver.core.querybuilder.QueryBuilder;
 import com.datastax.driver.core.querybuilder.Select;
 import com.datastax.driver.core.querybuilder.Select.Where;
-
 import net.helenus.core.AbstractSessionOperations;
 import net.helenus.core.Filter;
 import net.helenus.core.reflect.HelenusPropertyNode;
@@ -29,54 +29,57 @@ import net.helenus.support.HelenusMappingException;
 
 public final class CountOperation extends AbstractFilterOperation<Long, CountOperation> {
 
-	private HelenusEntity entity;
+  private HelenusEntity entity;
 
-	public CountOperation(AbstractSessionOperations sessionOperations) {
-		super(sessionOperations);
-	}
+  public CountOperation(AbstractSessionOperations sessionOperations) {
+    super(sessionOperations);
+  }
 
-	public CountOperation(AbstractSessionOperations sessionOperations, HelenusEntity entity) {
-		super(sessionOperations);
-		this.entity = entity;
-	}
+  public CountOperation(AbstractSessionOperations sessionOperations, HelenusEntity entity) {
+    super(sessionOperations);
+    this.entity = entity;
+    //TODO(gburd): cache SELECT COUNT results within the scope of a UOW
+  }
 
-	@Override
-	public BuiltStatement buildStatement() {
+  @Override
+  public BuiltStatement buildStatement(boolean cached) {
 
-		if (filters != null && !filters.isEmpty()) {
-			filters.forEach(f -> addPropertyNode(f.getNode()));
-		}
+    if (filters != null && !filters.isEmpty()) {
+      filters.forEach(f -> addPropertyNode(f.getNode()));
+    }
 
-		if (entity == null) {
-			throw new HelenusMappingException("unknown entity");
-		}
+    if (entity == null) {
+      throw new HelenusMappingException("unknown entity");
+    }
 
-		Select select = QueryBuilder.select().countAll().from(entity.getName().toCql());
+    Select select = QueryBuilder.select().countAll().from(entity.getName().toCql());
 
-		if (filters != null && !filters.isEmpty()) {
+    if (filters != null && !filters.isEmpty()) {
 
-			Where where = select.where();
+      Where where = select.where();
 
-			for (Filter<?> filter : filters) {
-				where.and(filter.getClause(sessionOps.getValuePreparer()));
-			}
-		}
+      for (Filter<?> filter : filters) {
+        where.and(filter.getClause(sessionOps.getValuePreparer()));
+      }
+    }
 
-		return select;
-	}
+    return select;
+  }
 
-	@Override
-	public Long transform(ResultSet resultSet) {
-		return resultSet.one().getLong(0);
-	}
-
-	private void addPropertyNode(HelenusPropertyNode p) {
-		if (entity == null) {
-			entity = p.getEntity();
-		} else if (entity != p.getEntity()) {
-			throw new HelenusMappingException("you can count columns only in single entity "
-					+ entity.getMappingInterface() + " or " + p.getEntity().getMappingInterface());
-		}
-	}
+  @Override
+  public Long transform(ResultSet resultSet) {
+    return resultSet.one().getLong(0);
+  }
 
+  private void addPropertyNode(HelenusPropertyNode p) {
+    if (entity == null) {
+      entity = p.getEntity();
+    } else if (entity != p.getEntity()) {
+      throw new HelenusMappingException(
+          "you can count columns only in single entity "
+              + entity.getMappingInterface()
+              + " or "
+              + p.getEntity().getMappingInterface());
+    }
+  }
 }

src/main/java/net/helenus/core/operation/DeleteOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -20,106 +21,155 @@ import com.datastax.driver.core.querybuilder.BuiltStatement;
 import com.datastax.driver.core.querybuilder.Delete;
 import com.datastax.driver.core.querybuilder.Delete.Where;
 import com.datastax.driver.core.querybuilder.QueryBuilder;
-
+import java.util.List;
+import java.util.concurrent.TimeoutException;
 import net.helenus.core.AbstractSessionOperations;
 import net.helenus.core.Filter;
+import net.helenus.core.UnitOfWork;
+import net.helenus.core.cache.Facet;
 import net.helenus.core.reflect.HelenusPropertyNode;
 import net.helenus.mapping.HelenusEntity;
+import net.helenus.support.HelenusException;
 import net.helenus.support.HelenusMappingException;
 
 public final class DeleteOperation extends AbstractFilterOperation<ResultSet, DeleteOperation> {
 
-	private HelenusEntity entity;
+  private HelenusEntity entity;
 
-	private boolean ifExists = false;
+  private boolean ifExists = false;
 
-	private int[] ttl;
-	private long[] timestamp;
+  private int[] ttl;
+  private long[] timestamp;
 
-	public DeleteOperation(AbstractSessionOperations sessionOperations) {
-		super(sessionOperations);
-	}
+  public DeleteOperation(AbstractSessionOperations sessionOperations) {
+    super(sessionOperations);
+  }
 
-	public DeleteOperation(AbstractSessionOperations sessionOperations, HelenusEntity entity) {
-		super(sessionOperations);
+  public DeleteOperation(AbstractSessionOperations sessionOperations, HelenusEntity entity) {
+    super(sessionOperations);
 
-		this.entity = entity;
-	}
+    this.entity = entity;
+  }
 
-	@Override
-	public BuiltStatement buildStatement() {
+  @Override
+  public BuiltStatement buildStatement(boolean cached) {
 
-		if (filters != null && !filters.isEmpty()) {
-			filters.forEach(f -> addPropertyNode(f.getNode()));
-		}
+    if (filters != null && !filters.isEmpty()) {
+      filters.forEach(f -> addPropertyNode(f.getNode()));
+    }
 
-		if (entity == null) {
-			throw new HelenusMappingException("unknown entity");
-		}
+    if (entity == null) {
+      throw new HelenusMappingException("unknown entity");
+    }
 
-		if (filters != null && !filters.isEmpty()) {
+    if (filters != null && !filters.isEmpty()) {
 
-			Delete delete = QueryBuilder.delete().from(entity.getName().toCql());
+      Delete delete = QueryBuilder.delete().from(entity.getName().toCql());
 
-			if (this.ifExists) {
-				delete.ifExists();
-			}
+      if (this.ifExists) {
+        delete.ifExists();
+      }
 
-			Where where = delete.where();
+      Where where = delete.where();
 
-			for (Filter<?> filter : filters) {
-				where.and(filter.getClause(sessionOps.getValuePreparer()));
-			}
+      for (Filter<?> filter : filters) {
+        where.and(filter.getClause(sessionOps.getValuePreparer()));
+      }
 
-			if (ifFilters != null && !ifFilters.isEmpty()) {
+      if (ifFilters != null && !ifFilters.isEmpty()) {
 
-				for (Filter<?> filter : ifFilters) {
-					delete.onlyIf(filter.getClause(sessionOps.getValuePreparer()));
-				}
-			}
+        for (Filter<?> filter : ifFilters) {
+          delete.onlyIf(filter.getClause(sessionOps.getValuePreparer()));
+        }
+      }
 
-			if (this.ttl != null) {
-				delete.using(QueryBuilder.ttl(this.ttl[0]));
-			}
-			if (this.timestamp != null) {
-				delete.using(QueryBuilder.timestamp(this.timestamp[0]));
-			}
+      if (this.ttl != null) {
+        delete.using(QueryBuilder.ttl(this.ttl[0]));
+      }
+      if (this.timestamp != null) {
+        delete.using(QueryBuilder.timestamp(this.timestamp[0]));
+      }
 
-			return delete;
+      return delete;
 
-		} else {
-			return QueryBuilder.truncate(entity.getName().toCql());
-		}
-	}
+    } else {
+      return QueryBuilder.truncate(entity.getName().toCql());
+    }
+  }
 
-	@Override
-	public ResultSet transform(ResultSet resultSet) {
-		return resultSet;
-	}
+  @Override
+  public ResultSet transform(ResultSet resultSet) {
+    return resultSet;
+  }
 
-	public DeleteOperation ifExists() {
-		this.ifExists = true;
-		return this;
-	}
+  public DeleteOperation ifExists() {
+    this.ifExists = true;
+    return this;
+  }
 
-	public DeleteOperation usingTtl(int ttl) {
-		this.ttl = new int[1];
-		this.ttl[0] = ttl;
-		return this;
-	}
+  public DeleteOperation usingTtl(int ttl) {
+    this.ttl = new int[1];
+    this.ttl[0] = ttl;
+    return this;
+  }
 
-	public DeleteOperation usingTimestamp(long timestamp) {
-		this.timestamp = new long[1];
-		this.timestamp[0] = timestamp;
-		return this;
-	}
+  public DeleteOperation usingTimestamp(long timestamp) {
+    this.timestamp = new long[1];
+    this.timestamp[0] = timestamp;
+    return this;
+  }
 
-	private void addPropertyNode(HelenusPropertyNode p) {
-		if (entity == null) {
-			entity = p.getEntity();
-		} else if (entity != p.getEntity()) {
-			throw new HelenusMappingException("you can delete rows only in single entity "
-					+ entity.getMappingInterface() + " or " + p.getEntity().getMappingInterface());
-		}
-	}
+  private void addPropertyNode(HelenusPropertyNode p) {
+    if (entity == null) {
+      entity = p.getEntity();
+    } else if (entity != p.getEntity()) {
+      throw new HelenusMappingException(
+          "you can delete rows only in single entity "
+              + entity.getMappingInterface()
+              + " or "
+              + p.getEntity().getMappingInterface());
+    }
+  }
+
+  public List<Facet> bindFacetValues() {
+    return bindFacetValues(getFacets());
+  }
+
+  protected boolean isIdempotentOperation() {
+    return true;
+  }
+
+  @Override
+  public ResultSet sync() throws TimeoutException {
+    ResultSet result = super.sync();
+    if (entity.isCacheable()) {
+      sessionOps.cacheEvict(bindFacetValues());
+    }
+    return result;
+  }
+
+  @Override
+  public ResultSet sync(UnitOfWork uow) throws TimeoutException {
+    if (uow == null) {
+      return sync();
+    }
+    ResultSet result = super.sync(uow);
+    uow.cacheEvict(bindFacetValues());
+    return result;
+  }
+
+  public ResultSet batch(UnitOfWork uow) throws TimeoutException {
+    if (uow == null) {
+      throw new HelenusException("UnitOfWork cannot be null when batching operations.");
+    }
+
+    uow.cacheEvict(bindFacetValues());
+    uow.batch(this);
+    return null;
+  }
+
+  @Override
+  public List<Facet> getFacets() {
+    return entity.getFacets();
+  }
 }

src/main/java/net/helenus/core/operation/InsertOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,154 +16,409 @@
  */
 package net.helenus.core.operation;
 
-import java.util.*;
-
 import com.datastax.driver.core.ResultSet;
 import com.datastax.driver.core.querybuilder.BuiltStatement;
 import com.datastax.driver.core.querybuilder.Insert;
 import com.datastax.driver.core.querybuilder.QueryBuilder;
-
-import com.google.common.base.Predicates;
-import com.google.common.collect.Lists;
-import com.google.common.collect.Maps;
+import java.util.*;
+import java.util.concurrent.TimeoutException;
+import java.util.function.Function;
+import java.util.stream.Collectors;
 import net.helenus.core.AbstractSessionOperations;
 import net.helenus.core.Getter;
+import net.helenus.core.Helenus;
+import net.helenus.core.UnitOfWork;
+import net.helenus.core.cache.CacheUtil;
+import net.helenus.core.cache.Facet;
+import net.helenus.core.cache.UnboundFacet;
+import net.helenus.core.reflect.DefaultPrimitiveTypes;
 import net.helenus.core.reflect.HelenusPropertyNode;
 import net.helenus.core.reflect.MapExportable;
-import net.helenus.mapping.ColumnType;
 import net.helenus.mapping.HelenusEntity;
 import net.helenus.mapping.HelenusProperty;
 import net.helenus.mapping.MappingUtil;
 import net.helenus.mapping.value.BeanColumnValueProvider;
 import net.helenus.support.Fun;
+import net.helenus.support.HelenusException;
 import net.helenus.support.HelenusMappingException;
 
-public final class InsertOperation extends AbstractOperation<ResultSet, InsertOperation> {
+public final class InsertOperation<T> extends AbstractOperation<T, InsertOperation<T>> {
 
-	private HelenusEntity entity;
+  private final List<Fun.Tuple2<HelenusPropertyNode, Object>> values =
+      new ArrayList<Fun.Tuple2<HelenusPropertyNode, Object>>();
+  private final T pojo;
+  private final Class<?> resultType;
+  private final Set<String> readSet;
+  private HelenusEntity entity;
+  private boolean ifNotExists;
 
-	private final List<Fun.Tuple2<HelenusPropertyNode, Object>> values = new ArrayList<Fun.Tuple2<HelenusPropertyNode, Object>>();
-	private boolean ifNotExists;
+  private int[] ttl;
+  private long[] timestamp;
+  private long writeTime = 0L;
 
-	private int[] ttl;
-	private long[] timestamp;
+  public InsertOperation(AbstractSessionOperations sessionOperations, boolean ifNotExists) {
+    super(sessionOperations);
 
-	public InsertOperation(AbstractSessionOperations sessionOperations, boolean ifNotExists) {
-		super(sessionOperations);
+    this.pojo = null;
+    this.readSet = null;
+    this.ifNotExists = ifNotExists;
+    this.resultType = ResultSet.class;
+  }
 
-		this.ifNotExists = ifNotExists;
-	}
+  public InsertOperation(
+      AbstractSessionOperations sessionOperations,
+      HelenusEntity entity,
+      Class<?> resultType,
+      boolean ifNotExists) {
+    super(sessionOperations);
 
-	public InsertOperation(AbstractSessionOperations sessionOperations, HelenusEntity entity, Object pojo,
-			boolean ifNotExists) {
-		super(sessionOperations);
+    this.pojo = null;
+    this.readSet = null;
+    this.ifNotExists = ifNotExists;
+    this.resultType = resultType;
+    this.entity = entity;
+  }
 
-		this.entity = entity;
-		this.ifNotExists = ifNotExists;
-        Set<String> keys = (pojo instanceof MapExportable) ? ((MapExportable)pojo).toMap().keySet() : null;
-        Collection<HelenusProperty> properties = entity.getOrderedProperties();
+  public InsertOperation(
+      AbstractSessionOperations sessionOperations, Class<?> resultType, boolean ifNotExists) {
+    super(sessionOperations);
 
-        for (HelenusProperty prop : properties) {
+    this.pojo = null;
+    this.readSet = null;
+    this.ifNotExists = ifNotExists;
+    this.resultType = resultType;
+  }
 
-            // Skip properties that are not in the map of the pojo we're storing.  This creates a path
-            // for entity instances to be {in,up}serted without including all columns in the INSERT statement.
-		    if (keys == null || keys.contains(prop.getPropertyName())) {
+  public InsertOperation(
+      AbstractSessionOperations sessionOperations,
+      HelenusEntity entity,
+      T pojo,
+      Set<String> mutations,
+      Set<String> read,
+      boolean ifNotExists) {
+    super(sessionOperations);
 
-                Object value = BeanColumnValueProvider.INSTANCE.getColumnValue(pojo, -1, prop);
-                value = sessionOps.getValuePreparer().prepareColumnValue(value, prop);
+    this.pojo = pojo;
+    this.readSet = read;
+    this.entity = entity;
+    this.ifNotExists = ifNotExists;
+    this.resultType = entity.getMappingInterface();
 
-                if (value != null) {
-                    HelenusPropertyNode node = new HelenusPropertyNode(prop, Optional.empty());
-                    values.add(Fun.Tuple2.of(node, value));
-                }
+    Collection<HelenusProperty> properties = entity.getOrderedProperties();
+    Set<String> keys = (mutations == null) ? null : mutations;
 
+    for (HelenusProperty prop : properties) {
+      boolean addProp = false;
+
+      switch (prop.getColumnType()) {
+        case PARTITION_KEY:
+        case CLUSTERING_COLUMN:
+          addProp = true;
+          break;
+        default:
+          addProp = (keys == null || keys.contains(prop.getPropertyName()));
+      }
+
+      if (addProp) {
+        Object value = BeanColumnValueProvider.INSTANCE.getColumnValue(pojo, -1, prop);
+        value = sessionOps.getValuePreparer().prepareColumnValue(value, prop);
+
+        if (value != null) {
+          HelenusPropertyNode node = new HelenusPropertyNode(prop, Optional.empty());
+          values.add(Fun.Tuple2.of(node, value));
+        }
+      }
+    }
+  }
+
+  public InsertOperation<T> ifNotExists() {
+    this.ifNotExists = true;
+    return this;
+  }
+
+  public InsertOperation<T> ifNotExists(boolean enable) {
+    this.ifNotExists = enable;
+    return this;
+  }
+
+  public <V> InsertOperation<T> value(Getter<V> getter, V val) {
+
+    Objects.requireNonNull(getter, "getter is empty");
+
+    if (val != null) {
+      HelenusPropertyNode node = MappingUtil.resolveMappingProperty(getter);
+      Object value = sessionOps.getValuePreparer().prepareColumnValue(val, node.getProperty());
+
+      if (value != null) {
+        values.add(Fun.Tuple2.of(node, value));
+      }
+    }
+
+    return this;
+  }
+
+  @Override
+  public BuiltStatement buildStatement(boolean cached) {
+    List<HelenusEntity> entities =
+        values
+            .stream()
+            .map(t -> t._1.getProperty().getEntity())
+            .distinct()
+            .collect(Collectors.toList());
+    if (entities.size() != 1) {
+      throw new HelenusMappingException(
+          "you can insert only single entity at a time, found: "
+              + entities
+                  .stream()
+                  .map(e -> e.getMappingInterface().toString())
+                  .collect(Collectors.joining(", ")));
+    }
+    HelenusEntity entity = entities.get(0);
+    if (this.entity != null) {
+      if (this.entity != entity) {
+        throw new HelenusMappingException(
+            "you can insert only single entity at a time, found: "
+                + this.entity.getMappingInterface().toString()
+                + ", "
+                + entity.getMappingInterface().toString());
+      }
+    } else {
+      this.entity = entity;
+    }
+
+    if (values.isEmpty()) return null;
+
+    if (entity == null) {
+      throw new HelenusMappingException("unknown entity");
+    }
+
+    Insert insert = QueryBuilder.insertInto(entity.getName().toCql());
+
+    if (ifNotExists) {
+      insert.ifNotExists();
+    }
+
+    values.forEach(
+        t -> {
+          insert.value(t._1.getColumnName(), t._2);
+        });
+
+    //TODO(gburd): IF NOT EXISTS when @Constraints.Relationship is 1:1 or 1:m
+
+    if (this.ttl != null) {
+      insert.using(QueryBuilder.ttl(this.ttl[0]));
+    }
+    if (this.timestamp != null) {
+      insert.using(QueryBuilder.timestamp(this.timestamp[0]));
+    }
+
+    return insert;
+  }
+
+  private T newInstance(Class<?> iface) {
+    if (values.size() > 0) {
+      boolean immutable = entity.isDraftable();
+      Collection<HelenusProperty> properties = entity.getOrderedProperties();
+      Map<String, Object> backingMap = new HashMap<String, Object>(properties.size());
+
+      // First, add all the inserted values into our new map.
+      values.forEach(t -> backingMap.put(t._1.getProperty().getPropertyName(), t._2));
+
+      // Then, fill in all the rest of the properties.
+      for (HelenusProperty prop : properties) {
+        String key = prop.getPropertyName();
+        if (backingMap.containsKey(key)) {
+          // Some values man need to be converted (e.g. from String to Enum). This is done
+          // within the BeanColumnValueProvider below.
+          Optional<Function<Object, Object>> converter =
+              prop.getReadConverter(sessionOps.getSessionRepository());
+          if (converter.isPresent()) {
+            backingMap.put(key, converter.get().apply(backingMap.get(key)));
+          }
+        } else {
+          // If we started this operation with an instance of this type, use values from
+          // that.
+          if (pojo != null) {
+            backingMap.put(
+                key, BeanColumnValueProvider.INSTANCE.getColumnValue(pojo, -1, prop, immutable));
+          } else {
+            // Otherwise we'll use default values for the property type if available.
+            Class<?> propType = prop.getJavaType();
+            if (propType.isPrimitive()) {
+              DefaultPrimitiveTypes type = DefaultPrimitiveTypes.lookup(propType);
+              if (type == null) {
+                throw new HelenusException("unknown primitive type " + propType);
+              }
+              backingMap.put(key, type.getDefaultValue());
             }
+          }
+        }
+      }
 
-		}
+      // Lastly, create a new proxy object for the entity and return the new instance.
+      return (T) Helenus.map(iface, backingMap);
+    }
+    return null;
+  }
 
-	}
+  @Override
+  public T transform(ResultSet resultSet) {
+    if ((ifNotExists == true) && (resultSet.wasApplied() == false)) {
+      throw new HelenusException("Statement was not applied due to consistency constraints");
+    }
 
-	public InsertOperation ifNotExists() {
-		this.ifNotExists = true;
-		return this;
-	}
+    Class<?> iface = entity.getMappingInterface();
+    if (resultType == iface) {
+      T o = newInstance(iface);
+      if (o == null) {
+        // Oddly, this insert didn't change anything so simply return the pojo.
+        return (T) pojo;
+      }
+      return o;
+    }
+    return (T) resultSet;
+  }
 
-	public InsertOperation ifNotExists(boolean enable) {
-		this.ifNotExists = enable;
-		return this;
-	}
+  public InsertOperation<T> usingTtl(int ttl) {
+    this.ttl = new int[1];
+    this.ttl[0] = ttl;
+    return this;
+  }
 
-	public <V> InsertOperation value(Getter<V> getter, V val) {
+  public InsertOperation<T> usingTimestamp(long timestamp) {
+    this.timestamp = new long[1];
+    this.timestamp[0] = timestamp;
+    return this;
+  }
 
-		Objects.requireNonNull(getter, "getter is empty");
+  protected void adjustTtlAndWriteTime(MapExportable pojo) {
+    if (ttl != null || writeTime != 0L) {
+      List<String> columnNames =
+          values
+              .stream()
+              .map(t -> t._1.getProperty())
+              .filter(
+                  prop -> {
+                    switch (prop.getColumnType()) {
+                      case PARTITION_KEY:
+                      case CLUSTERING_COLUMN:
+                        return false;
+                      default:
+                        return true;
+                    }
+                  })
+              .map(prop -> prop.getColumnName().toCql(false))
+              .collect(Collectors.toList());
 
-		if (val != null) {
-			HelenusPropertyNode node = MappingUtil.resolveMappingProperty(getter);
-			Object value = sessionOps.getValuePreparer().prepareColumnValue(val, node.getProperty());
+      if (columnNames.size() > 0) {
+        if (ttl != null) {
+          columnNames.forEach(name -> pojo.put(CacheUtil.ttlKey(name), ttl));
+        }
+        if (writeTime != 0L) {
+          columnNames.forEach(name -> pojo.put(CacheUtil.writeTimeKey(name), writeTime));
+        }
+      }
+    }
+  }
 
-			if (value != null) {
-				values.add(Fun.Tuple2.of(node, value));
-			}
-		}
+  @Override
+  protected boolean isIdempotentOperation() {
+    return values.stream().map(v -> v._1.getProperty()).allMatch(prop -> prop.isIdempotent())
+        || super.isIdempotentOperation();
+  }
 
-		return this;
-	}
+  @Override
+  public T sync() throws TimeoutException {
+    T result = super.sync();
+    if (entity.isCacheable() && result != null) {
+      adjustTtlAndWriteTime((MapExportable) result);
+      sessionOps.updateCache(result, bindFacetValues());
+    }
+    return result;
+  }
 
-	@Override
-	public BuiltStatement buildStatement() {
+  @Override
+  public T sync(UnitOfWork uow) throws TimeoutException {
+    if (uow == null) {
+      return sync();
+    }
+    T result = super.sync(uow);
+    if (result != null && pojo != null && !(pojo == result) && pojo.equals(result)) {
+      // To preserve object identity we need to find this object in cache
+      // because it was unchanged by the INSERT but pojo in this case was
+      // the result of a draft.build().
+      T cachedValue = (T) uow.cacheLookup(bindFacetValues());
+      if (cachedValue != null) {
+        result = cachedValue;
+      }
+    }
+    Class<?> iface = entity.getMappingInterface();
+    if (resultType == iface) {
+      if (entity != null && MapExportable.class.isAssignableFrom(entity.getMappingInterface())) {
+        adjustTtlAndWriteTime((MapExportable) result);
+      }
+      cacheUpdate(uow, result, bindFacetValues());
+    }
+    return result;
+  }
 
-		values.forEach(t -> addPropertyNode(t._1));
+  public T batch(UnitOfWork uow) throws TimeoutException {
+    if (uow == null) {
+      throw new HelenusException("UnitOfWork cannot be null when batching operations.");
+    }
 
-		if (values.isEmpty())
-		    return null;
+    if (this.entity != null) {
+      Class<?> iface = this.entity.getMappingInterface();
+      if (resultType == iface) {
+        final T result = (pojo == null) ? newInstance(iface) : pojo;
+        if (result != null) {
+          adjustTtlAndWriteTime((MapExportable) result);
+          cacheUpdate(uow, result, bindFacetValues());
+        }
+        uow.batch(this);
+        return (T) result;
+      }
+    }
 
-		if (entity == null) {
-			throw new HelenusMappingException("unknown entity");
-		}
+    return sync(uow);
+  }
 
-		Insert insert = QueryBuilder.insertInto(entity.getName().toCql());
+  @Override
+  public List<Facet> bindFacetValues() {
+    List<Facet> facets = getFacets();
+    if (facets == null || facets.size() == 0) {
+      return new ArrayList<Facet>();
+    }
+    List<Facet> boundFacets = new ArrayList<>();
+    Map<HelenusProperty, Object> valuesMap = new HashMap<>(values.size());
+    values.forEach(t -> valuesMap.put(t._1.getProperty(), t._2));
 
-		if (ifNotExists) {
-			insert.ifNotExists();
-		}
+    for (Facet facet : facets) {
+      if (facet instanceof UnboundFacet) {
+        UnboundFacet unboundFacet = (UnboundFacet) facet;
+        UnboundFacet.Binder binder = unboundFacet.binder();
+        for (HelenusProperty prop : unboundFacet.getProperties()) {
+          Object value = valuesMap.get(prop);
+          if (value != null) {
+            binder.setValueForProperty(prop, value.toString());
+          }
+        }
+        if (binder.isBound()) {
+          boundFacets.add(binder.bind());
+        }
+      } else {
+        boundFacets.add(facet);
+      }
+    }
+    return boundFacets;
+  }
 
-		values.forEach(t -> {
-			insert.value(t._1.getColumnName(), t._2);
-		});
-
-		if (this.ttl != null) {
-			insert.using(QueryBuilder.ttl(this.ttl[0]));
-		}
-		if (this.timestamp != null) {
-			insert.using(QueryBuilder.timestamp(this.timestamp[0]));
-		}
-
-		return insert;
-	}
-
-	@Override
-	public ResultSet transform(ResultSet resultSet) {
-		return resultSet;
-	}
-
-	public InsertOperation usingTtl(int ttl) {
-		this.ttl = new int[1];
-		this.ttl[0] = ttl;
-		return this;
-	}
-
-	public InsertOperation usingTimestamp(long timestamp) {
-		this.timestamp = new long[1];
-		this.timestamp[0] = timestamp;
-		return this;
-	}
-
-	private void addPropertyNode(HelenusPropertyNode p) {
-		if (entity == null) {
-			entity = p.getEntity();
-		} else if (entity != p.getEntity()) {
-			throw new HelenusMappingException("you can insert only single entity " + entity.getMappingInterface()
-					+ " or " + p.getEntity().getMappingInterface());
-		}
-	}
+  @Override
+  public List<Facet> getFacets() {
+    if (entity != null) {
+      return entity.getFacets();
+    } else {
+      return new ArrayList<Facet>();
+    }
+  }
 }

src/main/java/net/helenus/core/operation/Operation.java

@@ -0,0 +1,211 @@
+/*
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+package net.helenus.core.operation;
+
+import com.codahale.metrics.Meter;
+import com.codahale.metrics.MetricRegistry;
+import com.codahale.metrics.Timer;
+import com.datastax.driver.core.*;
+import com.datastax.driver.core.querybuilder.BuiltStatement;
+import com.google.common.base.Stopwatch;
+import java.net.InetAddress;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.concurrent.TimeUnit;
+import java.util.concurrent.TimeoutException;
+import java.util.stream.Collectors;
+import net.helenus.core.AbstractSessionOperations;
+import net.helenus.core.UnitOfWork;
+import net.helenus.core.cache.Facet;
+import net.helenus.support.HelenusException;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+public abstract class Operation<E> {
+
+  private static final Logger LOG = LoggerFactory.getLogger(Operation.class);
+
+  protected final AbstractSessionOperations sessionOps;
+  protected boolean showValues;
+  protected long queryExecutionTimeout = 10;
+  protected TimeUnit queryTimeoutUnits = TimeUnit.SECONDS;
+  protected final Meter uowCacheHits;
+  protected final Meter uowCacheMiss;
+  protected final Meter sessionCacheHits;
+  protected final Meter sessionCacheMiss;
+  protected final Meter cacheHits;
+  protected final Meter cacheMiss;
+  protected final Timer requestLatency;
+
+  Operation(AbstractSessionOperations sessionOperations) {
+    this.sessionOps = sessionOperations;
+    this.showValues = sessionOps.showValues();
+    MetricRegistry metrics = sessionOperations.getMetricRegistry();
+    if (metrics == null) {
+      metrics = new MetricRegistry();
+    }
+    this.uowCacheHits = metrics.meter("net.helenus.UOW-cache-hits");
+    this.uowCacheMiss = metrics.meter("net.helenus.UOW-cache-miss");
+    this.sessionCacheHits = metrics.meter("net.helenus.session-cache-hits");
+    this.sessionCacheMiss = metrics.meter("net.helenus.session-cache-miss");
+    this.cacheHits = metrics.meter("net.helenus.cache-hits");
+    this.cacheMiss = metrics.meter("net.helenus.cache-miss");
+    this.requestLatency = metrics.timer("net.helenus.request-latency");
+  }
+
+  public static String queryString(BatchOperation operation, boolean includeValues) {
+    return operation.toString(includeValues);
+  }
+
+  public static String queryString(Statement statement, boolean includeValues) {
+    String query = null;
+    if (statement instanceof BuiltStatement) {
+      BuiltStatement builtStatement = (BuiltStatement) statement;
+      if (includeValues) {
+        RegularStatement regularStatement = builtStatement.setForceNoValues(true);
+        query = regularStatement.getQueryString();
+      } else {
+        query = builtStatement.getQueryString();
+      }
+    } else if (statement instanceof RegularStatement) {
+      RegularStatement regularStatement = (RegularStatement) statement;
+      query = regularStatement.getQueryString();
+    } else {
+      query = statement.toString();
+    }
+    return query;
+  }
+
+  public ResultSet execute(
+      AbstractSessionOperations session,
+      UnitOfWork uow,
+      long timeout,
+      TimeUnit units,
+      boolean showValues,
+      boolean cached)
+      throws TimeoutException {
+
+    Statement statement = options(buildStatement(cached));
+
+    if (session.isShowCql()) {
+      String stmt =
+          (this instanceof BatchOperation)
+              ? queryString((BatchOperation) this, showValues)
+              : queryString(statement, showValues);
+      session.getPrintStream().println(stmt);
+    } else if (LOG.isDebugEnabled()) {
+      String stmt =
+          (this instanceof BatchOperation)
+              ? queryString((BatchOperation) this, showValues)
+              : queryString(statement, showValues);
+      LOG.info("CQL> " + stmt);
+    }
+
+    Stopwatch timer = Stopwatch.createStarted();
+    try {
+      ResultSetFuture futureResultSet = session.executeAsync(statement, uow, timer);
+      if (uow != null) uow.recordCacheAndDatabaseOperationCount(0, 1);
+      ResultSet resultSet = futureResultSet.getUninterruptibly(timeout, units);
+      ColumnDefinitions columnDefinitions = resultSet.getColumnDefinitions();
+      if (LOG.isDebugEnabled()) {
+        ExecutionInfo ei = resultSet.getExecutionInfo();
+        Host qh = ei.getQueriedHost();
+        String oh =
+            ei.getTriedHosts()
+                .stream()
+                .map(Host::getAddress)
+                .map(InetAddress::toString)
+                .collect(Collectors.joining(", "));
+        ConsistencyLevel cl = ei.getAchievedConsistencyLevel();
+        if (cl == null) {
+          cl = statement.getConsistencyLevel();
+        }
+        int se = ei.getSpeculativeExecutions();
+        String warn = ei.getWarnings().stream().collect(Collectors.joining(", "));
+        String ri =
+            String.format(
+                "%s %s ~%s %s %s%s%sspec-retries: %d",
+                "server v" + qh.getCassandraVersion(),
+                qh.getAddress().toString(),
+                (oh != null && !oh.equals("")) ? " [tried: " + oh + "]" : "",
+                qh.getDatacenter(),
+                qh.getRack(),
+                (cl != null)
+                    ? (" consistency: "
+                        + cl.name()
+                        + " "
+                        + (cl.isDCLocal() ? " DC " : "")
+                        + (cl.isSerial() ? " SC " : ""))
+                    : "",
+                (warn != null && !warn.equals("")) ? ": " + warn : "",
+                se);
+        if (uow != null) uow.setInfo(ri);
+        else LOG.debug(ri);
+      }
+      if (!resultSet.wasApplied()
+          && !(columnDefinitions.size() > 1 || !columnDefinitions.contains("[applied]"))) {
+        throw new HelenusException("Operation Failed");
+      }
+      return resultSet;
+
+    } finally {
+      timer.stop();
+      if (uow != null) uow.addDatabaseTime("Cassandra", timer);
+      log(statement, uow, timer, showValues);
+    }
+  }
+
+  void log(Statement statement, UnitOfWork uow, Stopwatch timer, boolean showValues) {
+    if (LOG.isInfoEnabled()) {
+      String uowString = "";
+      if (uow != null) {
+        uowString = "UOW(" + uow.hashCode() + ")";
+      }
+      String timerString = "";
+      if (timer != null) {
+        timerString = String.format(" %s ", timer.toString());
+      }
+      LOG.info(
+          String.format(
+              "%s%s%s", uowString, timerString, Operation.queryString(statement, showValues)));
+    }
+  }
+
+  protected boolean isIdempotentOperation() {
+    return false;
+  }
+
+  public Statement options(Statement statement) {
+    return statement;
+  }
+
+  public Statement buildStatement(boolean cached) {
+    return null;
+  }
+
+  public List<Facet> getFacets() {
+    return new ArrayList<Facet>();
+  }
+
+  public List<Facet> bindFacetValues() {
+    return null;
+  }
+
+  public boolean isSessionCacheable() {
+    return false;
+  }
+}

src/main/java/net/helenus/core/operation/PreparedOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -20,28 +21,27 @@ import com.datastax.driver.core.PreparedStatement;
 
 public final class PreparedOperation<E> {
 
-	private final PreparedStatement preparedStatement;
-	private final AbstractOperation<E, ?> operation;
+  private final PreparedStatement preparedStatement;
+  private final AbstractOperation<E, ?> operation;
 
-	public PreparedOperation(PreparedStatement statement, AbstractOperation<E, ?> operation) {
-		this.preparedStatement = statement;
-		this.operation = operation;
-	}
+  public PreparedOperation(PreparedStatement statement, AbstractOperation<E, ?> operation) {
+    this.preparedStatement = statement;
+    this.operation = operation;
+  }
 
-	public PreparedStatement getPreparedStatement() {
-		return preparedStatement;
-	}
+  public PreparedStatement getPreparedStatement() {
+    return preparedStatement;
+  }
 
-	public BoundOperation<E> bind(Object... params) {
+  public BoundOperation<E> bind(Object... params) {
 
-		BoundStatement boundStatement = preparedStatement.bind(params);
+    BoundStatement boundStatement = preparedStatement.bind(params);
 
-		return new BoundOperation<E>(boundStatement, operation);
-	}
-
-	@Override
-	public String toString() {
-		return preparedStatement.getQueryString();
-	}
+    return new BoundOperation<E>(boundStatement, operation);
+  }
 
+  @Override
+  public String toString() {
+    return preparedStatement.getQueryString();
+  }
 }

src/main/java/net/helenus/core/operation/PreparedOptionalOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -20,28 +21,28 @@ import com.datastax.driver.core.PreparedStatement;
 
 public final class PreparedOptionalOperation<E> {
 
-	private final PreparedStatement preparedStatement;
-	private final AbstractOptionalOperation<E, ?> operation;
+  private final PreparedStatement preparedStatement;
+  private final AbstractOptionalOperation<E, ?> operation;
 
-	public PreparedOptionalOperation(PreparedStatement statement, AbstractOptionalOperation<E, ?> operation) {
-		this.preparedStatement = statement;
-		this.operation = operation;
-	}
+  public PreparedOptionalOperation(
+      PreparedStatement statement, AbstractOptionalOperation<E, ?> operation) {
+    this.preparedStatement = statement;
+    this.operation = operation;
+  }
 
-	public PreparedStatement getPreparedStatement() {
-		return preparedStatement;
-	}
+  public PreparedStatement getPreparedStatement() {
+    return preparedStatement;
+  }
 
-	public BoundOptionalOperation<E> bind(Object... params) {
+  public BoundOptionalOperation<E> bind(Object... params) {
 
-		BoundStatement boundStatement = preparedStatement.bind(params);
+    BoundStatement boundStatement = preparedStatement.bind(params);
 
-		return new BoundOptionalOperation<E>(boundStatement, operation);
-	}
-
-	@Override
-	public String toString() {
-		return preparedStatement.getQueryString();
-	}
+    return new BoundOptionalOperation<E>(boundStatement, operation);
+  }
 
+  @Override
+  public String toString() {
+    return preparedStatement.getQueryString();
+  }
 }

src/main/java/net/helenus/core/operation/PreparedStreamOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -20,28 +21,26 @@ import com.datastax.driver.core.PreparedStatement;
 
 public final class PreparedStreamOperation<E> {
 
-	private final PreparedStatement preparedStatement;
-	private final AbstractStreamOperation<E, ?> operation;
+  private final PreparedStatement preparedStatement;
+  private final AbstractStreamOperation<E, ?> operation;
 
-	public PreparedStreamOperation(PreparedStatement statement, AbstractStreamOperation<E, ?> operation) {
-		this.preparedStatement = statement;
-		this.operation = operation;
-	}
+  public PreparedStreamOperation(
+      PreparedStatement statement, AbstractStreamOperation<E, ?> operation) {
+    this.preparedStatement = statement;
+    this.operation = operation;
+  }
 
-	public PreparedStatement getPreparedStatement() {
-		return preparedStatement;
-	}
+  public PreparedStatement getPreparedStatement() {
+    return preparedStatement;
+  }
 
-	public BoundStreamOperation<E> bind(Object... params) {
-
-		BoundStatement boundStatement = preparedStatement.bind(params);
-
-		return new BoundStreamOperation<E>(boundStatement, operation);
-	}
-
-	@Override
-	public String toString() {
-		return preparedStatement.getQueryString();
-	}
+  public BoundStreamOperation<E> bind(Object... params) {
+    BoundStatement boundStatement = preparedStatement.bind(params);
+    return new BoundStreamOperation<E>(boundStatement, operation);
+  }
 
+  @Override
+  public String toString() {
+    return preparedStatement.getQueryString();
+  }
 }

src/main/java/net/helenus/core/operation/SelectFirstOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,36 +16,57 @@
  */
 package net.helenus.core.operation;
 
-import java.util.Optional;
-import java.util.function.Function;
-
 import com.datastax.driver.core.ResultSet;
 import com.datastax.driver.core.querybuilder.BuiltStatement;
+import java.util.List;
+import java.util.Optional;
+import java.util.function.Function;
+import net.helenus.core.cache.Facet;
 
-public final class SelectFirstOperation<E> extends AbstractFilterOptionalOperation<E, SelectFirstOperation<E>> {
+public final class SelectFirstOperation<E>
+    extends AbstractFilterOptionalOperation<E, SelectFirstOperation<E>> {
 
-	private final SelectOperation<E> src;
+  private final SelectOperation<E> delegate;
 
-	public SelectFirstOperation(SelectOperation<E> src) {
-		super(src.sessionOps);
+  public SelectFirstOperation(SelectOperation<E> delegate) {
+    super(delegate.sessionOps);
 
-		this.src = src;
-		this.filters = src.filters;
-		this.ifFilters = src.ifFilters;
-	}
+    this.delegate = delegate;
+    this.filters = delegate.filters;
+    this.ifFilters = delegate.ifFilters;
+  }
 
-	public <R> SelectFirstTransformingOperation<R, E> map(Function<E, R> fn) {
-		return new SelectFirstTransformingOperation<R, E>(src, fn);
-	}
+  public <R> SelectFirstTransformingOperation<R, E> map(Function<E, R> fn) {
+    return new SelectFirstTransformingOperation<R, E>(delegate, fn);
+  }
 
-	@Override
-	public BuiltStatement buildStatement() {
-		return src.buildStatement();
-	}
+  @Override
+  public BuiltStatement buildStatement(boolean cached) {
+    return delegate.buildStatement(cached);
+  }
 
-	@Override
-	public Optional<E> transform(ResultSet resultSet) {
-		return src.transform(resultSet).findFirst();
-	}
+  @Override
+  public List<Facet> getFacets() {
+    return delegate.getFacets();
+  }
 
+  @Override
+  public List<Facet> bindFacetValues() {
+    return delegate.bindFacetValues();
+  }
+
+  @Override
+  public Optional<E> transform(ResultSet resultSet) {
+    return delegate.transform(resultSet).findFirst();
+  }
+
+  @Override
+  public boolean isSessionCacheable() {
+    return delegate.isSessionCacheable();
+  }
+
+  @Override
+  public boolean ignoreCache() {
+    return delegate.ignoreCache();
+  }
 }

src/main/java/net/helenus/core/operation/SelectFirstTransformingOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,36 +16,50 @@
  */
 package net.helenus.core.operation;
 
-import java.util.Optional;
-import java.util.function.Function;
-
 import com.datastax.driver.core.ResultSet;
 import com.datastax.driver.core.querybuilder.BuiltStatement;
+import java.util.List;
+import java.util.Optional;
+import java.util.function.Function;
+import net.helenus.core.cache.Facet;
 
 public final class SelectFirstTransformingOperation<R, E>
-		extends
-			AbstractFilterOptionalOperation<R, SelectFirstTransformingOperation<R, E>> {
+    extends AbstractFilterOptionalOperation<R, SelectFirstTransformingOperation<R, E>> {
 
-	private final SelectOperation<E> src;
-	private final Function<E, R> fn;
+  private final SelectOperation<E> delegate;
+  private final Function<E, R> fn;
 
-	public SelectFirstTransformingOperation(SelectOperation<E> src, Function<E, R> fn) {
-		super(src.sessionOps);
+  public SelectFirstTransformingOperation(SelectOperation<E> delegate, Function<E, R> fn) {
+    super(delegate.sessionOps);
 
-		this.src = src;
-		this.fn = fn;
-		this.filters = src.filters;
-		this.ifFilters = src.ifFilters;
-	}
+    this.delegate = delegate;
+    this.fn = fn;
+    this.filters = delegate.filters;
+    this.ifFilters = delegate.ifFilters;
+  }
 
-	@Override
-	public BuiltStatement buildStatement() {
-		return src.buildStatement();
-	}
+  @Override
+  public List<Facet> bindFacetValues() {
+    return delegate.bindFacetValues();
+  }
 
-	@Override
-	public Optional<R> transform(ResultSet resultSet) {
-		return src.transform(resultSet).findFirst().map(fn);
-	}
+  @Override
+  public BuiltStatement buildStatement(boolean cached) {
+    return delegate.buildStatement(cached);
+  }
 
+  @Override
+  public Optional<R> transform(ResultSet resultSet) {
+    return delegate.transform(resultSet).findFirst().map(fn);
+  }
+
+  @Override
+  public boolean isSessionCacheable() {
+    return delegate.isSessionCacheable();
+  }
+
+  @Override
+  public boolean ignoreCache() {
+    return delegate.ignoreCache();
+  }
 }

src/main/java/net/helenus/core/operation/SelectOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,11 +16,6 @@
  */
 package net.helenus.core.operation;
 
-import java.util.*;
-import java.util.function.Function;
-import java.util.stream.Stream;
-import java.util.stream.StreamSupport;
-
 import com.datastax.driver.core.ResultSet;
 import com.datastax.driver.core.Row;
 import com.datastax.driver.core.querybuilder.BuiltStatement;
@@ -28,223 +24,355 @@ import com.datastax.driver.core.querybuilder.QueryBuilder;
 import com.datastax.driver.core.querybuilder.Select;
 import com.datastax.driver.core.querybuilder.Select.Selection;
 import com.datastax.driver.core.querybuilder.Select.Where;
-
+import java.util.*;
+import java.util.function.Function;
+import java.util.stream.Stream;
+import java.util.stream.StreamSupport;
 import net.helenus.core.*;
+import net.helenus.core.cache.CacheUtil;
+import net.helenus.core.cache.Facet;
+import net.helenus.core.cache.UnboundFacet;
+import net.helenus.core.reflect.Entity;
 import net.helenus.core.reflect.HelenusPropertyNode;
 import net.helenus.mapping.HelenusEntity;
+import net.helenus.mapping.HelenusProperty;
 import net.helenus.mapping.MappingUtil;
 import net.helenus.mapping.OrderingDirection;
 import net.helenus.mapping.value.ColumnValueProvider;
 import net.helenus.mapping.value.ValueProviderMap;
 import net.helenus.support.Fun;
 import net.helenus.support.HelenusMappingException;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 
 public final class SelectOperation<E> extends AbstractFilterStreamOperation<E, SelectOperation<E>> {
 
-	protected Function<Row, E> rowMapper = null;
-	protected final List<HelenusPropertyNode> props = new ArrayList<HelenusPropertyNode>();
+  private static final Logger LOG = LoggerFactory.getLogger(SelectOperation.class);
 
-	protected List<Ordering> ordering = null;
-	protected Integer limit = null;
-	protected boolean allowFiltering = false;
+  protected final List<HelenusPropertyNode> props = new ArrayList<HelenusPropertyNode>();
+  protected Function<Row, E> rowMapper = null;
+  protected List<Ordering> ordering = null;
+  protected Integer limit = null;
+  protected boolean allowFiltering = false;
 
-	public SelectOperation(AbstractSessionOperations sessionOperations) {
-		super(sessionOperations);
+  protected String alternateTableName = null;
+  protected boolean isCacheable = false;
+  protected boolean implementsEntityType = false;
 
-		this.rowMapper = new Function<Row, E>() {
+  @SuppressWarnings("unchecked")
+  public SelectOperation(AbstractSessionOperations sessionOperations) {
+    super(sessionOperations);
 
-			@Override
-			public E apply(Row source) {
+    this.rowMapper =
+        new Function<Row, E>() {
 
-				ColumnValueProvider valueProvider = sessionOps.getValueProvider();
-				Object[] arr = new Object[props.size()];
+          @Override
+          public E apply(Row source) {
 
-				int i = 0;
-				for (HelenusPropertyNode p : props) {
-					Object value = valueProvider.getColumnValue(source, -1, p.getProperty());
-					arr[i++] = value;
-				}
+            ColumnValueProvider valueProvider = sessionOps.getValueProvider();
+            Object[] arr = new Object[props.size()];
 
-				return (E) Fun.ArrayTuple.of(arr);
-			}
+            int i = 0;
+            for (HelenusPropertyNode p : props) {
+              Object value = valueProvider.getColumnValue(source, -1, p.getProperty());
+              arr[i++] = value;
+            }
 
-		};
-	}
+            return (E) Fun.ArrayTuple.of(arr);
+          }
+        };
+  }
 
-	public SelectOperation(AbstractSessionOperations sessionOperations, HelenusEntity entity) {
+  public SelectOperation(AbstractSessionOperations sessionOperations, HelenusEntity entity) {
 
-		super(sessionOperations);
+    super(sessionOperations);
 
-		entity.getOrderedProperties().stream().map(p -> new HelenusPropertyNode(p, Optional.empty()))
-				.forEach(p -> this.props.add(p));
+    entity
+        .getOrderedProperties()
+        .stream()
+        .map(p -> new HelenusPropertyNode(p, Optional.empty()))
+        .forEach(p -> this.props.add(p));
 
-	}
+    this.isCacheable = entity.isCacheable();
+    this.implementsEntityType = Entity.class.isAssignableFrom(entity.getMappingInterface());
+  }
 
-	public SelectOperation(AbstractSessionOperations sessionOperations, HelenusEntity entity,
-			Function<Row, E> rowMapper) {
+  public SelectOperation(
+      AbstractSessionOperations sessionOperations,
+      HelenusEntity entity,
+      Function<Row, E> rowMapper) {
 
-		super(sessionOperations);
-		this.rowMapper = rowMapper;
+    super(sessionOperations);
+    this.rowMapper = rowMapper;
 
-		entity.getOrderedProperties().stream().map(p -> new HelenusPropertyNode(p, Optional.empty()))
-				.forEach(p -> this.props.add(p));
+    entity
+        .getOrderedProperties()
+        .stream()
+        .map(p -> new HelenusPropertyNode(p, Optional.empty()))
+        .forEach(p -> this.props.add(p));
 
-	}
+    this.isCacheable = entity.isCacheable();
+    this.implementsEntityType = Entity.class.isAssignableFrom(entity.getMappingInterface());
+  }
 
-	public SelectOperation(AbstractSessionOperations sessionOperations, Function<Row, E> rowMapper,
-			HelenusPropertyNode... props) {
+  public SelectOperation(
+      AbstractSessionOperations sessionOperations,
+      Function<Row, E> rowMapper,
+      HelenusPropertyNode... props) {
 
-		super(sessionOperations);
-		this.rowMapper = rowMapper;
-		Collections.addAll(this.props, props);
-	}
+    super(sessionOperations);
 
-	public CountOperation count() {
+    this.rowMapper = rowMapper;
+    Collections.addAll(this.props, props);
 
-		HelenusEntity entity = null;
-		for (HelenusPropertyNode prop : props) {
+    HelenusEntity entity = props[0].getEntity();
+    this.isCacheable = entity.isCacheable();
+    this.implementsEntityType = Entity.class.isAssignableFrom(entity.getMappingInterface());
+  }
 
-			if (entity == null) {
-				entity = prop.getEntity();
-			} else if (entity != prop.getEntity()) {
-				throw new HelenusMappingException("you can count records only from a single entity "
-						+ entity.getMappingInterface() + " or " + prop.getEntity().getMappingInterface());
-			}
-		}
+  public CountOperation count() {
 
-		return new CountOperation(sessionOps, entity);
-	}
+    HelenusEntity entity = null;
+    for (HelenusPropertyNode prop : props) {
 
-	public SelectFirstOperation<E> single() {
-		limit(1);
-		return new SelectFirstOperation<E>(this);
-	}
+      if (entity == null) {
+        entity = prop.getEntity();
+      } else if (entity != prop.getEntity()) {
+        throw new HelenusMappingException(
+            "you can count records only from a single entity "
+                + entity.getMappingInterface()
+                + " or "
+                + prop.getEntity().getMappingInterface());
+      }
+    }
 
-	public <R> SelectTransformingOperation<R, E> mapTo(Class<R> entityClass) {
+    return new CountOperation(sessionOps, entity);
+  }
 
-		Objects.requireNonNull(entityClass, "entityClass is null");
+  public <V extends E> SelectOperation<E> from(Class<V> materializedViewClass) {
+    Objects.requireNonNull(materializedViewClass);
+    HelenusEntity entity = Helenus.entity(materializedViewClass);
+    this.alternateTableName = entity.getName().toCql();
+    this.props.clear();
+    entity
+        .getOrderedProperties()
+        .stream()
+        .map(p -> new HelenusPropertyNode(p, Optional.empty()))
+        .forEach(p -> this.props.add(p));
+    return this;
+  }
 
-		HelenusEntity entity = Helenus.entity(entityClass);
+  public SelectFirstOperation<E> single() {
+    limit(1);
+    return new SelectFirstOperation<E>(this);
+  }
 
-		this.rowMapper = null;
+  public <R> SelectTransformingOperation<R, E> mapTo(Class<R> entityClass) {
 
-		return new SelectTransformingOperation<R, E>(this, (r) -> {
+    Objects.requireNonNull(entityClass, "entityClass is null");
 
-			Map<String, Object> map = new ValueProviderMap(r, sessionOps.getValueProvider(), entity);
-			return (R) Helenus.map(entityClass, map);
+    HelenusEntity entity = Helenus.entity(entityClass);
 
-		});
-	}
+    this.rowMapper = null;
 
-	public <R> SelectTransformingOperation<R, E> map(Function<E, R> fn) {
-		return new SelectTransformingOperation<R, E>(this, fn);
-	}
+    return new SelectTransformingOperation<R, E>(
+        this,
+        (r) -> {
+          Map<String, Object> map = new ValueProviderMap(r, sessionOps.getValueProvider(), entity);
+          return (R) Helenus.map(entityClass, map);
+        });
+  }
 
-	public SelectOperation<E> column(Getter<?> getter) {
-		HelenusPropertyNode p = MappingUtil.resolveMappingProperty(getter);
-		this.props.add(p);
-		return this;
-	}
+  public <R> SelectTransformingOperation<R, E> map(Function<E, R> fn) {
+    return new SelectTransformingOperation<R, E>(this, fn);
+  }
 
-	public SelectOperation<E> orderBy(Getter<?> getter, OrderingDirection direction) {
-		getOrCreateOrdering().add(new Ordered(getter, direction).getOrdering());
-		return this;
-	}
+  public SelectOperation<E> column(Getter<?> getter) {
+    HelenusPropertyNode p = MappingUtil.resolveMappingProperty(getter);
+    this.props.add(p);
+    return this;
+  }
 
-	public SelectOperation<E> orderBy(Ordered ordered) {
-		getOrCreateOrdering().add(ordered.getOrdering());
-		return this;
-	}
+  public SelectOperation<E> orderBy(Getter<?> getter, OrderingDirection direction) {
+    getOrCreateOrdering().add(new Ordered(getter, direction).getOrdering());
+    return this;
+  }
 
-	public SelectOperation<E> limit(Integer limit) {
-		this.limit = limit;
-		return this;
-	}
+  public SelectOperation<E> orderBy(Ordered ordered) {
+    getOrCreateOrdering().add(ordered.getOrdering());
+    return this;
+  }
 
-	public SelectOperation<E> allowFiltering() {
-		this.allowFiltering = true;
-		return this;
-	}
+  public SelectOperation<E> limit(Integer limit) {
+    this.limit = limit;
+    return this;
+  }
 
-	@Override
-	public BuiltStatement buildStatement() {
+  public SelectOperation<E> allowFiltering() {
+    this.allowFiltering = true;
+    return this;
+  }
 
-		HelenusEntity entity = null;
-		Selection selection = QueryBuilder.select();
+  @Override
+  public boolean isSessionCacheable() {
+    return isCacheable;
+  }
 
-		for (HelenusPropertyNode prop : props) {
-			selection = selection.column(prop.getColumnName());
+  @Override
+  public List<Facet> getFacets() {
+    HelenusEntity entity = props.get(0).getEntity();
+    return entity.getFacets();
+  }
 
-			if (prop.getProperty().caseSensitiveIndex()) {
-				allowFiltering = true;
-			}
+  @Override
+  public List<Facet> bindFacetValues() {
+    HelenusEntity entity = props.get(0).getEntity();
+    List<Facet> boundFacets = new ArrayList<>();
 
-			if (entity == null) {
-				entity = prop.getEntity();
-			} else if (entity != prop.getEntity()) {
-				throw new HelenusMappingException("you can select columns only from a single entity "
-						+ entity.getMappingInterface() + " or " + prop.getEntity().getMappingInterface());
-			}
-		}
+    for (Facet facet : entity.getFacets()) {
+      if (facet instanceof UnboundFacet) {
+        UnboundFacet unboundFacet = (UnboundFacet) facet;
+        UnboundFacet.Binder binder = unboundFacet.binder();
+        for (HelenusProperty prop : unboundFacet.getProperties()) {
+          if (filters != null) {
+            Filter filter = filters.get(prop);
+            if (filter != null) {
+              Object[] postulates = filter.postulateValues();
+              for (Object p : postulates) {
+                binder.setValueForProperty(prop, p.toString());
+              }
+            }
+          }
+        }
+        if (binder.isBound()) {
+          boundFacets.add(binder.bind());
+        }
+      } else {
+        boundFacets.add(facet);
+      }
+    }
+    return boundFacets;
+  }
 
-		if (entity == null) {
-			throw new HelenusMappingException("no entity or table to select data");
-		}
+  @Override
+  public BuiltStatement buildStatement(boolean cached) {
 
-		Select select = selection.from(entity.getName().toCql());
+    HelenusEntity entity = null;
+    Selection selection = QueryBuilder.select();
 
-		if (ordering != null && !ordering.isEmpty()) {
-			select.orderBy(ordering.toArray(new Ordering[ordering.size()]));
-		}
+    for (HelenusPropertyNode prop : props) {
+      String columnName = prop.getColumnName();
+      selection = selection.column(columnName);
 
-		if (limit != null) {
-			select.limit(limit);
-		}
+      if (entity == null) {
+        entity = prop.getEntity();
+      } else if (entity != prop.getEntity()) {
+        throw new HelenusMappingException(
+            "you can select columns only from a single entity "
+                + entity.getMappingInterface()
+                + " or "
+                + prop.getEntity().getMappingInterface());
+      }
 
-		if (filters != null && !filters.isEmpty()) {
+      if (cached && implementsEntityType) {
+        switch (prop.getProperty().getColumnType()) {
+          case PARTITION_KEY:
+          case CLUSTERING_COLUMN:
+            break;
+          default:
+            if (entity.equals(prop.getEntity())) {
+              if (!prop.getProperty().getDataType().isCollectionType()) {
+                columnName = prop.getProperty().getColumnName().toCql(false);
+                selection.ttl(columnName).as('"' + CacheUtil.ttlKey(columnName) + '"');
+                selection.writeTime(columnName).as('"' + CacheUtil.writeTimeKey(columnName) + '"');
+              }
+            }
+            break;
+        }
+      }
+    }
 
-			Where where = select.where();
+    if (entity == null) {
+      throw new HelenusMappingException("no entity or table to select data");
+    }
 
-			for (Filter<?> filter : filters) {
-				where.and(filter.getClause(sessionOps.getValuePreparer()));
-			}
-		}
+    String tableName = alternateTableName == null ? entity.getName().toCql() : alternateTableName;
+    Select select = selection.from(tableName);
 
-		if (ifFilters != null && !ifFilters.isEmpty()) {
-			logger.error("onlyIf conditions " + ifFilters + " would be ignored in the statement " + select);
-		}
+    if (ordering != null && !ordering.isEmpty()) {
+      select.orderBy(ordering.toArray(new Ordering[ordering.size()]));
+    }
 
-		if (allowFiltering) {
-			select.allowFiltering();
-		}
+    if (limit != null) {
+      select.limit(limit);
+    }
 
-		return select;
-	}
+    if (filters != null && !filters.isEmpty()) {
 
-	@SuppressWarnings("unchecked")
-	@Override
-	public Stream<E> transform(ResultSet resultSet) {
+      Where where = select.where();
 
-		if (rowMapper != null) {
+      boolean isFirstIndex = true;
+      for (Filter<?> filter : filters.values()) {
+        where.and(filter.getClause(sessionOps.getValuePreparer()));
+        HelenusProperty filterProp = filter.getNode().getProperty();
+        HelenusProperty prop =
+            props
+                .stream()
+                .map(HelenusPropertyNode::getProperty)
+                .filter(thisProp -> thisProp.getPropertyName().equals(filterProp.getPropertyName()))
+                .findFirst()
+                .orElse(null);
+        if (allowFiltering == false && prop != null) {
+          switch (prop.getColumnType()) {
+            case PARTITION_KEY:
+              break;
+            case CLUSTERING_COLUMN:
+            default:
+              // When using non-Cassandra-standard 2i types or when using more than one
+              // indexed column or non-indexed columns the query must include ALLOW FILTERING.
+              if (prop.caseSensitiveIndex() == false) {
+                allowFiltering = true;
+              } else if (prop.getIndexName() != null) {
+                allowFiltering |= !isFirstIndex;
+                isFirstIndex = false;
+              } else {
+                allowFiltering = true;
+              }
+          }
+        }
+      }
+    }
 
-			return StreamSupport
-					.stream(Spliterators.spliteratorUnknownSize(resultSet.iterator(), Spliterator.ORDERED), false)
-					.map(rowMapper);
-		}
+    if (ifFilters != null && !ifFilters.isEmpty()) {
+      LOG.error("onlyIf conditions " + ifFilters + " would be ignored in the statement " + select);
+    }
 
-		else {
+    if (allowFiltering) {
+      select.allowFiltering();
+    }
 
-			return (Stream<E>) StreamSupport
-					.stream(Spliterators.spliteratorUnknownSize(resultSet.iterator(), Spliterator.ORDERED), false);
+    return select;
+  }
 
-		}
-	}
-
-	private List<Ordering> getOrCreateOrdering() {
-		if (ordering == null) {
-			ordering = new ArrayList<Ordering>();
-		}
-		return ordering;
-	}
+  @SuppressWarnings("unchecked")
+  @Override
+  public Stream<E> transform(ResultSet resultSet) {
+    if (rowMapper != null) {
+      return StreamSupport.stream(
+              Spliterators.spliteratorUnknownSize(resultSet.iterator(), Spliterator.ORDERED), false)
+          .map(rowMapper);
+    } else {
+      return (Stream<E>)
+          StreamSupport.stream(
+              Spliterators.spliteratorUnknownSize(resultSet.iterator(), Spliterator.ORDERED),
+              false);
+    }
+  }
 
+  private List<Ordering> getOrCreateOrdering() {
+    if (ordering == null) {
+      ordering = new ArrayList<Ordering>();
+    }
+    return ordering;
+  }
 }

src/main/java/net/helenus/core/operation/SelectTransformingOperation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,36 +16,55 @@
  */
 package net.helenus.core.operation;
 
-import java.util.function.Function;
-import java.util.stream.Stream;
-
 import com.datastax.driver.core.ResultSet;
 import com.datastax.driver.core.querybuilder.BuiltStatement;
+import java.util.List;
+import java.util.function.Function;
+import java.util.stream.Stream;
+import net.helenus.core.cache.Facet;
 
 public final class SelectTransformingOperation<R, E>
-		extends
-			AbstractFilterStreamOperation<R, SelectTransformingOperation<R, E>> {
+    extends AbstractFilterStreamOperation<R, SelectTransformingOperation<R, E>> {
 
-	private final SelectOperation<E> src;
-	private final Function<E, R> fn;
+  private final SelectOperation<E> delegate;
+  private final Function<E, R> fn;
 
-	public SelectTransformingOperation(SelectOperation<E> src, Function<E, R> fn) {
-		super(src.sessionOps);
+  public SelectTransformingOperation(SelectOperation<E> delegate, Function<E, R> fn) {
+    super(delegate.sessionOps);
 
-		this.src = src;
-		this.fn = fn;
-		this.filters = src.filters;
-		this.ifFilters = src.ifFilters;
-	}
+    this.delegate = delegate;
+    this.fn = fn;
+    this.filters = delegate.filters;
+    this.ifFilters = delegate.ifFilters;
+  }
 
-	@Override
-	public BuiltStatement buildStatement() {
-		return src.buildStatement();
-	}
+  @Override
+  public List<Facet> bindFacetValues() {
+    return delegate.bindFacetValues();
+  }
 
-	@Override
-	public Stream<R> transform(ResultSet resultSet) {
-		return src.transform(resultSet).map(fn);
-	}
+  @Override
+  public List<Facet> getFacets() {
+    return delegate.getFacets();
+  }
 
+  @Override
+  public BuiltStatement buildStatement(boolean cached) {
+    return delegate.buildStatement(cached);
+  }
+
+  @Override
+  public Stream<R> transform(ResultSet resultSet) {
+    return delegate.transform(resultSet).map(fn);
+  }
+
+  @Override
+  public boolean isSessionCacheable() {
+    return delegate.isSessionCacheable();
+  }
+
+  @Override
+  public boolean ignoreCache() {
+    return delegate.ignoreCache();
+  }
 }

src/main/java/net/helenus/core/reflect/DefaultPrimitiveTypes.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -19,36 +20,41 @@ import java.util.HashMap;
 import java.util.Map;
 
 public enum DefaultPrimitiveTypes {
+  BOOLEAN(boolean.class, false),
+  BYTE(byte.class, (byte) 0x0),
+  CHAR(char.class, (char) 0x0),
+  SHORT(short.class, (short) 0),
+  INT(int.class, 0),
+  LONG(long.class, 0L),
+  FLOAT(float.class, 0.0f),
+  DOUBLE(double.class, 0.0);
 
-	BOOLEAN(boolean.class, false), BYTE(byte.class, (byte) 0x0), CHAR(char.class, (char) 0x0), SHORT(short.class,
-			(short) 0), INT(int.class, 0), LONG(long.class, 0L), FLOAT(float.class, 0.0f), DOUBLE(double.class, 0.0);
+  private static final Map<Class<?>, DefaultPrimitiveTypes> map =
+      new HashMap<Class<?>, DefaultPrimitiveTypes>();
 
-	private final Class<?> primitiveClass;
-	private final Object defaultValue;
+  static {
+    for (DefaultPrimitiveTypes type : DefaultPrimitiveTypes.values()) {
+      map.put(type.getPrimitiveClass(), type);
+    }
+  }
 
-	private final static Map<Class<?>, DefaultPrimitiveTypes> map = new HashMap<Class<?>, DefaultPrimitiveTypes>();
+  private final Class<?> primitiveClass;
+  private final Object defaultValue;
 
-	static {
-		for (DefaultPrimitiveTypes type : DefaultPrimitiveTypes.values()) {
-			map.put(type.getPrimitiveClass(), type);
-		}
-	}
+  private DefaultPrimitiveTypes(Class<?> primitiveClass, Object defaultValue) {
+    this.primitiveClass = primitiveClass;
+    this.defaultValue = defaultValue;
+  }
 
-	private DefaultPrimitiveTypes(Class<?> primitiveClass, Object defaultValue) {
-		this.primitiveClass = primitiveClass;
-		this.defaultValue = defaultValue;
-	}
+  public static DefaultPrimitiveTypes lookup(Class<?> primitiveClass) {
+    return map.get(primitiveClass);
+  }
 
-	public static DefaultPrimitiveTypes lookup(Class<?> primitiveClass) {
-		return map.get(primitiveClass);
-	}
-
-	public Class<?> getPrimitiveClass() {
-		return primitiveClass;
-	}
-
-	public Object getDefaultValue() {
-		return defaultValue;
-	}
+  public Class<?> getPrimitiveClass() {
+    return primitiveClass;
+  }
 
+  public Object getDefaultValue() {
+    return defaultValue;
+  }
 }

src/main/java/net/helenus/core/reflect/Drafted.java

@@ -0,0 +1,28 @@
+/*
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+package net.helenus.core.reflect;
+
+import java.util.Set;
+
+public interface Drafted<T> extends MapExportable {
+
+  Set<String> mutated();
+
+  T build();
+
+  Set<String> read();
+}

src/main/java/net/helenus/core/reflect/DslExportable.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,15 +16,18 @@
  */
 package net.helenus.core.reflect;
 
+import com.datastax.driver.core.Metadata;
 import net.helenus.mapping.HelenusEntity;
 
 public interface DslExportable {
 
-	public static final String GET_ENTITY_METHOD = "getHelenusMappingEntity";
-	public static final String GET_PARENT_METHOD = "getParentDslHelenusPropertyNode";
+  String GET_ENTITY_METHOD = "getHelenusMappingEntity";
+  String GET_PARENT_METHOD = "getParentDslHelenusPropertyNode";
+  String SET_METADATA_METHOD = "setCassandraMetadataForHelenusSession";
 
-	HelenusEntity getHelenusMappingEntity();
+  HelenusEntity getHelenusMappingEntity();
 
-	HelenusPropertyNode getParentDslHelenusPropertyNode();
+  HelenusPropertyNode getParentDslHelenusPropertyNode();
 
+  void setCassandraMetadataForHelenusSession(Metadata metadata);
 }

src/main/java/net/helenus/core/reflect/DslInvocationHandler.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,18 +16,14 @@
  */
 package net.helenus.core.reflect;
 
-import java.lang.invoke.MethodHandle;
-import java.lang.invoke.MethodHandles;
+import com.datastax.driver.core.*;
 import java.lang.reflect.InvocationHandler;
 import java.lang.reflect.Method;
 import java.lang.reflect.Proxy;
+import java.util.Collection;
 import java.util.HashMap;
 import java.util.Map;
-import java.util.Objects;
 import java.util.Optional;
-
-import com.datastax.driver.core.*;
-
 import net.helenus.core.Helenus;
 import net.helenus.mapping.HelenusEntity;
 import net.helenus.mapping.HelenusMappingEntity;
@@ -39,144 +36,178 @@ import net.helenus.support.HelenusException;
 
 public class DslInvocationHandler<E> implements InvocationHandler {
 
-	private final HelenusEntity entity;
-	private final Optional<HelenusPropertyNode> parent;
+  private final Class<E> iface;
+  private final ClassLoader classLoader;
+  private final Optional<HelenusPropertyNode> parent;
+  private final Map<Method, HelenusProperty> map = new HashMap<Method, HelenusProperty>();
+  private final Map<Method, Object> udtMap = new HashMap<Method, Object>();
+  private final Map<Method, Object> tupleMap = new HashMap<Method, Object>();
+  private HelenusEntity entity = null;
+  private Metadata metadata = null;
 
-	private final Map<Method, HelenusProperty> map = new HashMap<Method, HelenusProperty>();
+  public DslInvocationHandler(
+      Class<E> iface,
+      ClassLoader classLoader,
+      Optional<HelenusPropertyNode> parent,
+      Metadata metadata) {
 
-	private final Map<Method, Object> udtMap = new HashMap<Method, Object>();
-	private final Map<Method, Object> tupleMap = new HashMap<Method, Object>();
+    this.metadata = metadata;
+    this.parent = parent;
+    this.iface = iface;
+    this.classLoader = classLoader;
+  }
 
-	public DslInvocationHandler(Class<E> iface, ClassLoader classLoader, Optional<HelenusPropertyNode> parent, Metadata metadata) {
+  public void setCassandraMetadataForHelenusSession(Metadata metadata) {
+    if (metadata != null) {
+      this.metadata = metadata;
+      entity = init(metadata);
+    }
+  }
 
-		this.entity = new HelenusMappingEntity(iface, metadata);
-		this.parent = parent;
+  private HelenusEntity init(Metadata metadata) {
+    HelenusEntity entity = new HelenusMappingEntity(iface, metadata);
+    Collection<HelenusProperty> properties = entity.getOrderedProperties();
+    if (properties != null) {
+      for (HelenusProperty prop : properties) {
 
-		if (this.entity != null) {
-            for (HelenusProperty prop : entity.getOrderedProperties()) {
+        map.put(prop.getGetterMethod(), prop);
 
-                map.put(prop.getGetterMethod(), prop);
+        AbstractDataType type = prop.getDataType();
+        Class<?> javaType = prop.getJavaType();
 
-                AbstractDataType type = prop.getDataType();
-                Class<?> javaType = prop.getJavaType();
+        if (type instanceof UDTDataType && !UDTValue.class.isAssignableFrom(javaType)) {
 
-                if (type instanceof UDTDataType && !UDTValue.class.isAssignableFrom(javaType)) {
+          Object childDsl =
+              Helenus.dsl(
+                  javaType,
+                  classLoader,
+                  Optional.of(new HelenusPropertyNode(prop, parent)),
+                  metadata);
 
-                    Object childDsl = Helenus.dsl(javaType, classLoader,
-                            Optional.of(new HelenusPropertyNode(prop, parent)), metadata);
+          udtMap.put(prop.getGetterMethod(), childDsl);
+        }
 
-                    udtMap.put(prop.getGetterMethod(), childDsl);
-                }
+        if (type instanceof DTDataType) {
+          DTDataType dataType = (DTDataType) type;
 
-                if (type instanceof DTDataType) {
-                    DTDataType dataType = (DTDataType) type;
+          if (dataType.getDataType() instanceof TupleType
+              && !TupleValue.class.isAssignableFrom(javaType)) {
 
-                    if (dataType.getDataType() instanceof TupleType && !TupleValue.class.isAssignableFrom(javaType)) {
+            Object childDsl =
+                Helenus.dsl(
+                    javaType,
+                    classLoader,
+                    Optional.of(new HelenusPropertyNode(prop, parent)),
+                    metadata);
 
-                        Object childDsl = Helenus.dsl(javaType, classLoader,
-                                Optional.of(new HelenusPropertyNode(prop, parent)), metadata);
+            tupleMap.put(prop.getGetterMethod(), childDsl);
+          }
+        }
+      }
+    }
 
-                        tupleMap.put(prop.getGetterMethod(), childDsl);
+    return entity;
+  }
 
-                    }
-                }
+  @Override
+  public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
 
+    HelenusEntity entity = this.entity;
+    String methodName = method.getName();
+
+    if ("equals".equals(methodName) && method.getParameterCount() == 1) {
+      Object otherObj = args[0];
+      if (otherObj == null) {
+        return false;
+      }
+      if (Proxy.isProxyClass(otherObj.getClass())) {
+        return this == Proxy.getInvocationHandler(otherObj);
+      }
+      return false;
+    }
+
+    if (DslExportable.SET_METADATA_METHOD.equals(methodName)
+        && args.length == 1
+        && args[0] instanceof Metadata) {
+      if (metadata == null) {
+        this.setCassandraMetadataForHelenusSession((Metadata) args[0]);
+      }
+      return null;
+    }
+
+    if (method.getParameterCount() != 0 || method.getReturnType() == void.class) {
+      throw new HelenusException("invalid getter method " + method);
+    }
+
+    if ("hashCode".equals(methodName)) {
+      return hashCode();
+    }
+
+    if (DslExportable.GET_PARENT_METHOD.equals(methodName)) {
+      return parent.get();
+    }
+
+    if (entity == null) {
+      entity = init(metadata);
+    }
+
+    if ("toString".equals(methodName)) {
+      return entity.toString();
+    }
+
+    if (DslExportable.GET_ENTITY_METHOD.equals(methodName)) {
+      return entity;
+    }
+
+    HelenusProperty prop = map.get(method);
+    if (prop == null) {
+      prop = entity.getProperty(methodName);
+    }
+
+    if (prop != null) {
+
+      AbstractDataType type = prop.getDataType();
+
+      if (type instanceof UDTDataType) {
+
+        Object childDsl = udtMap.get(method);
+
+        if (childDsl != null) {
+          return childDsl;
+        }
+      }
+
+      if (type instanceof DTDataType) {
+        DTDataType dataType = (DTDataType) type;
+        DataType dt = dataType.getDataType();
+
+        switch (dt.getName()) {
+          case TUPLE:
+            Object childDsl = tupleMap.get(method);
+
+            if (childDsl != null) {
+              return childDsl;
             }
+
+            break;
+
+          case SET:
+            return new SetDsl(new HelenusPropertyNode(prop, parent));
+
+          case LIST:
+            return new ListDsl(new HelenusPropertyNode(prop, parent));
+
+          case MAP:
+            return new MapDsl(new HelenusPropertyNode(prop, parent));
+
+          default:
+            break;
         }
-	}
+      }
 
-	@Override
-	public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
-
-        String methodName = method.getName();
-
-		if ("equals".equals(methodName) && method.getParameterCount() == 1) {
-			Object otherObj = args[0];
-			if (otherObj == null) {
-				return false;
-			}
-			if (Proxy.isProxyClass(otherObj.getClass())) {
-				return this == Proxy.getInvocationHandler(otherObj);
-			}
-			return false;
-		}
-
-		if (method.getParameterCount() != 0 || method.getReturnType() == void.class) {
-			throw new HelenusException("invalid getter method " + method);
-		}
-
-		if ("hashCode".equals(methodName)) {
-			return hashCode();
-		}
-
-		if ("toString".equals(methodName)) {
-			return entity.toString();
-		}
-
-		if (DslExportable.GET_ENTITY_METHOD.equals(methodName)) {
-			return entity;
-		}
-
-		if (DslExportable.GET_PARENT_METHOD.equals(methodName)) {
-			return parent.get();
-		}
-
-
-		HelenusProperty prop = map.get(method);
-		if (prop == null) {
-		    prop = entity.getProperty(methodName);
-        }
-
-		if (prop != null) {
-
-			AbstractDataType type = prop.getDataType();
-
-			if (type instanceof UDTDataType) {
-
-				Object childDsl = udtMap.get(method);
-
-				if (childDsl != null) {
-					return childDsl;
-				}
-
-			}
-
-			if (type instanceof DTDataType) {
-				DTDataType dataType = (DTDataType) type;
-				DataType dt = dataType.getDataType();
-
-				switch (dt.getName()) {
-
-					case TUPLE :
-
-						Object childDsl = tupleMap.get(method);
-
-						if (childDsl != null) {
-							return childDsl;
-						}
-
-						break;
-
-					case SET :
-						return new SetDsl(new HelenusPropertyNode(prop, parent));
-
-					case LIST :
-						return new ListDsl(new HelenusPropertyNode(prop, parent));
-
-					case MAP :
-						return new MapDsl(new HelenusPropertyNode(prop, parent));
-
-					default :
-						break;
-
-				}
-
-			}
-
-			throw new DslPropertyException(new HelenusPropertyNode(prop, parent));
-		}
-
-		throw new HelenusException("invalid method call " + method);
-	}
+      throw new DslPropertyException(new HelenusPropertyNode(prop, parent));
+    }
 
+    throw new HelenusException("invalid method call " + method);
+  }
 }

src/main/java/net/helenus/core/reflect/Entity.java

@@ -0,0 +1,73 @@
+/*
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+package net.helenus.core.reflect;
+
+import net.helenus.core.Getter;
+
+public interface Entity {
+  String WRITTEN_AT_METHOD = "writtenAt";
+  String TTL_OF_METHOD = "ttlOf";
+  String TOKEN_OF_METHOD = "tokenOf";
+
+    /**
+     * The write time for the property in question referenced by the getter.
+     *
+     * @param getter the property getter
+     * @return the timestamp associated with the property identified by the getter
+     */
+  default Long writtenAt(Getter getter) {
+    return 0L;
+  }
+
+    /**
+     * The write time for the property in question referenced by the property name.
+     *
+     * @param prop the name of a property in this entity
+     * @return the timestamp associated with the property identified by the property name if it exists
+     */
+  default Long writtenAt(String prop) {
+    return 0L;
+  };
+
+    /**
+     * The time-to-live for the property in question referenced by the getter.
+     *
+     * @param getter the property getter
+     * @return the time-to-live in seconds associated with the property identified by the getter
+     */
+  default Integer ttlOf(Getter getter) {
+    return 0;
+  };
+
+    /**
+     * The time-to-live for the property in question referenced by the property name.
+     *
+     * @param prop the name of a property in this entity
+     * @return the time-to-live in seconds associated with the property identified by the property name if it exists
+     */
+  default Integer ttlOf(String prop) {
+    return 0;
+  };
+
+    /**
+     * The token (partition identifier) for this entity which can change over time if
+     * the cluster grows or shrinks but should be stable otherwise.
+     *
+     * @return the token for the entity
+     */
+  default Long tokenOf() { return 0L; }
+}

src/main/java/net/helenus/core/reflect/HelenusNamedProperty.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -19,9 +20,7 @@ import java.lang.annotation.Annotation;
 import java.lang.reflect.Method;
 import java.util.Optional;
 import java.util.function.Function;
-
 import javax.validation.ConstraintValidator;
-
 import net.helenus.core.SessionRepository;
 import net.helenus.mapping.*;
 import net.helenus.mapping.type.AbstractDataType;
@@ -29,77 +28,84 @@ import net.helenus.support.HelenusMappingException;
 
 public final class HelenusNamedProperty implements HelenusProperty {
 
-	private final String name;
+  private final String name;
 
-	public HelenusNamedProperty(String name) {
-		this.name = name;
-	}
+  public HelenusNamedProperty(String name) {
+    this.name = name;
+  }
 
-	@Override
-	public HelenusEntity getEntity() {
-		throw new HelenusMappingException("will never called");
-	}
+  @Override
+  public HelenusEntity getEntity() {
+    throw new HelenusMappingException("will never called");
+  }
 
-	@Override
-	public String getPropertyName() {
-		return name;
-	}
+  @Override
+  public String getPropertyName() {
+    return name;
+  }
 
-	@Override
-	public Method getGetterMethod() {
-		throw new HelenusMappingException("will never called");
-	}
+  @Override
+  public Method getGetterMethod() {
+    throw new HelenusMappingException("will never called");
+  }
 
-	@Override
-	public IdentityName getColumnName() {
-		return IdentityName.of(name, false);
-	}
+  @Override
+  public IdentityName getColumnName() {
+    return IdentityName.of(name, false);
+  }
 
-	@Override
-	public Optional<IdentityName> getIndexName() {
-		return Optional.empty();
-	}
+  @Override
+  public Optional<IdentityName> getIndexName() {
+    return Optional.empty();
+  }
 
-	@Override
-	public boolean caseSensitiveIndex() { return false; }
+  @Override
+  public boolean caseSensitiveIndex() {
+    return false;
+  }
 
-	@Override
-	public Class<?> getJavaType() {
-		throw new HelenusMappingException("will never called");
-	}
+  @Override
+  public boolean isIdempotent() {
+    return false;
+  }
 
-	@Override
-	public AbstractDataType getDataType() {
-		throw new HelenusMappingException("will never called");
-	}
+  @Override
+  public Class<?> getJavaType() {
+    throw new HelenusMappingException("will never called");
+  }
 
-	@Override
-	public ColumnType getColumnType() {
-		return ColumnType.COLUMN;
-	}
+  @Override
+  public AbstractDataType getDataType() {
+    throw new HelenusMappingException("will never called");
+  }
 
-	@Override
-	public int getOrdinal() {
-		return 0;
-	}
+  @Override
+  public ColumnType getColumnType() {
+    return ColumnType.COLUMN;
+  }
 
-	@Override
-	public OrderingDirection getOrdering() {
-		return OrderingDirection.ASC;
-	}
+  @Override
+  public int getOrdinal() {
+    return 0;
+  }
 
-	@Override
-	public Optional<Function<Object, Object>> getReadConverter(SessionRepository repository) {
-		return Optional.empty();
-	}
+  @Override
+  public OrderingDirection getOrdering() {
+    return OrderingDirection.ASC;
+  }
 
-	@Override
-	public Optional<Function<Object, Object>> getWriteConverter(SessionRepository repository) {
-		return Optional.empty();
-	}
+  @Override
+  public Optional<Function<Object, Object>> getReadConverter(SessionRepository repository) {
+    return Optional.empty();
+  }
 
-	@Override
-	public ConstraintValidator<? extends Annotation, ?>[] getValidators() {
-		return MappingUtil.EMPTY_VALIDATORS;
-	}
+  @Override
+  public Optional<Function<Object, Object>> getWriteConverter(SessionRepository repository) {
+    return Optional.empty();
+  }
+
+  @Override
+  public ConstraintValidator<? extends Annotation, ?>[] getValidators() {
+    return MappingUtil.EMPTY_VALIDATORS;
+  }
 }

src/main/java/net/helenus/core/reflect/HelenusPropertyNode.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -17,92 +18,89 @@ package net.helenus.core.reflect;
 
 import java.util.*;
 import java.util.stream.Collectors;
-
 import net.helenus.mapping.HelenusEntity;
 import net.helenus.mapping.HelenusProperty;
 
 public final class HelenusPropertyNode implements Iterable<HelenusProperty> {
 
-	private final HelenusProperty prop;
-	private final Optional<HelenusPropertyNode> next;
+  private final HelenusProperty prop;
+  private final Optional<HelenusPropertyNode> next;
 
-	public HelenusPropertyNode(HelenusProperty prop, Optional<HelenusPropertyNode> next) {
-		this.prop = prop;
-		this.next = next;
-	}
+  public HelenusPropertyNode(HelenusProperty prop, Optional<HelenusPropertyNode> next) {
+    this.prop = prop;
+    this.next = next;
+  }
 
-	public String getColumnName() {
-		if (next.isPresent()) {
+  public String getColumnName() {
+    if (next.isPresent()) {
 
-			List<String> columnNames = new ArrayList<String>();
-			for (HelenusProperty p : this) {
-				columnNames.add(p.getColumnName().toCql(true));
-			}
-			Collections.reverse(columnNames);
+      List<String> columnNames = new ArrayList<String>();
+      for (HelenusProperty p : this) {
+        columnNames.add(p.getColumnName().toCql(true));
+      }
+      Collections.reverse(columnNames);
 
-			if (prop instanceof HelenusNamedProperty) {
-				int size = columnNames.size();
-				StringBuilder str = new StringBuilder();
-				for (int i = 0; i != size - 1; ++i) {
-					if (str.length() != 0) {
-						str.append(".");
-					}
-					str.append(columnNames.get(i));
-				}
-				str.append("[").append(columnNames.get(size - 1)).append("]");
-				return str.toString();
-			} else {
-				return columnNames.stream().collect(Collectors.joining("."));
-			}
-		} else {
-			return prop.getColumnName().toCql();
-		}
-	}
+      if (prop instanceof HelenusNamedProperty) {
+        int size = columnNames.size();
+        StringBuilder str = new StringBuilder();
+        for (int i = 0; i != size - 1; ++i) {
+          if (str.length() != 0) {
+            str.append(".");
+          }
+          str.append(columnNames.get(i));
+        }
+        str.append("[").append(columnNames.get(size - 1)).append("]");
+        return str.toString();
+      } else {
+        return columnNames.stream().collect(Collectors.joining("."));
+      }
+    } else {
+      return prop.getColumnName().toCql();
+    }
+  }
 
-	public HelenusEntity getEntity() {
-		if (next.isPresent()) {
-			HelenusProperty last = prop;
-			for (HelenusProperty p : this) {
-				last = p;
-			}
-			return last.getEntity();
-		} else {
-			return prop.getEntity();
-		}
-	}
+  public HelenusEntity getEntity() {
+    if (next.isPresent()) {
+      HelenusProperty last = prop;
+      for (HelenusProperty p : this) {
+        last = p;
+      }
+      return last.getEntity();
+    } else {
+      return prop.getEntity();
+    }
+  }
 
-	public HelenusProperty getProperty() {
-		return prop;
-	}
+  public HelenusProperty getProperty() {
+    return prop;
+  }
 
-	public Optional<HelenusPropertyNode> getNext() {
-		return next;
-	}
+  public Optional<HelenusPropertyNode> getNext() {
+    return next;
+  }
 
-	public Iterator<HelenusProperty> iterator() {
-		return new PropertyNodeIterator(Optional.of(this));
-	}
+  public Iterator<HelenusProperty> iterator() {
+    return new PropertyNodeIterator(Optional.of(this));
+  }
 
-	private static class PropertyNodeIterator implements Iterator<HelenusProperty> {
+  private static class PropertyNodeIterator implements Iterator<HelenusProperty> {
 
-		private Optional<HelenusPropertyNode> next;
+    private Optional<HelenusPropertyNode> next;
 
-		public PropertyNodeIterator(Optional<HelenusPropertyNode> next) {
-			this.next = next;
-		}
+    public PropertyNodeIterator(Optional<HelenusPropertyNode> next) {
+      this.next = next;
+    }
 
-		@Override
-		public boolean hasNext() {
-			return next.isPresent();
-		}
-
-		@Override
-		public HelenusProperty next() {
-			HelenusPropertyNode node = next.get();
-			next = node.next;
-			return node.prop;
-		}
-
-	}
+    @Override
+    public boolean hasNext() {
+      return next.isPresent();
+    }
 
+    @Override
+    public HelenusProperty next() {
+      HelenusPropertyNode node = next.get();
+      next = node.next;
+      return node.prop;
+    }
+  }
 }

src/main/java/net/helenus/core/reflect/ListDsl.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -16,165 +17,164 @@
 package net.helenus.core.reflect;
 
 import java.util.*;
-
 import net.helenus.mapping.HelenusProperty;
 import net.helenus.support.DslPropertyException;
 import net.helenus.support.HelenusMappingException;
 
 public final class ListDsl<V> implements List<V> {
 
-	private final HelenusPropertyNode parent;
+  private final HelenusPropertyNode parent;
 
-	public ListDsl(HelenusPropertyNode parent) {
-		this.parent = parent;
-	}
+  public ListDsl(HelenusPropertyNode parent) {
+    this.parent = parent;
+  }
 
-	public HelenusPropertyNode getParent() {
-		return parent;
-	}
+  public HelenusPropertyNode getParent() {
+    return parent;
+  }
 
-	@Override
-	public V get(int index) {
-		HelenusProperty prop = new HelenusNamedProperty(Integer.toString(index));
-		throw new DslPropertyException(new HelenusPropertyNode(prop, Optional.of(parent)));
-	}
+  @Override
+  public V get(int index) {
+    HelenusProperty prop = new HelenusNamedProperty(Integer.toString(index));
+    throw new DslPropertyException(new HelenusPropertyNode(prop, Optional.of(parent)));
+  }
 
-	@Override
-	public int size() {
-		throwShouldNeverCall();
-		return 0;
-	}
+  @Override
+  public int size() {
+    throwShouldNeverCall();
+    return 0;
+  }
 
-	@Override
-	public boolean isEmpty() {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean isEmpty() {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public boolean contains(Object o) {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean contains(Object o) {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public Iterator<V> iterator() {
-		throwShouldNeverCall();
-		return null;
-	}
+  @Override
+  public Iterator<V> iterator() {
+    throwShouldNeverCall();
+    return null;
+  }
 
-	@Override
-	public Object[] toArray() {
-		throwShouldNeverCall();
-		return null;
-	}
+  @Override
+  public Object[] toArray() {
+    throwShouldNeverCall();
+    return null;
+  }
 
-	@Override
-	public <T> T[] toArray(T[] a) {
-		throwShouldNeverCall();
-		return null;
-	}
+  @Override
+  public <T> T[] toArray(T[] a) {
+    throwShouldNeverCall();
+    return null;
+  }
 
-	@Override
-	public boolean add(V e) {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean add(V e) {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public boolean remove(Object o) {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean remove(Object o) {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public boolean containsAll(Collection<?> c) {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean containsAll(Collection<?> c) {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public boolean addAll(Collection<? extends V> c) {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean addAll(Collection<? extends V> c) {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public boolean addAll(int index, Collection<? extends V> c) {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean addAll(int index, Collection<? extends V> c) {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public boolean removeAll(Collection<?> c) {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean removeAll(Collection<?> c) {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public boolean retainAll(Collection<?> c) {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean retainAll(Collection<?> c) {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public void clear() {
-		throwShouldNeverCall();
-	}
+  @Override
+  public void clear() {
+    throwShouldNeverCall();
+  }
 
-	@Override
-	public V set(int index, V element) {
-		throwShouldNeverCall();
-		return null;
-	}
+  @Override
+  public V set(int index, V element) {
+    throwShouldNeverCall();
+    return null;
+  }
 
-	@Override
-	public void add(int index, V element) {
-		throwShouldNeverCall();
-	}
+  @Override
+  public void add(int index, V element) {
+    throwShouldNeverCall();
+  }
 
-	@Override
-	public V remove(int index) {
-		throwShouldNeverCall();
-		return null;
-	}
+  @Override
+  public V remove(int index) {
+    throwShouldNeverCall();
+    return null;
+  }
 
-	@Override
-	public int indexOf(Object o) {
-		throwShouldNeverCall();
-		return 0;
-	}
+  @Override
+  public int indexOf(Object o) {
+    throwShouldNeverCall();
+    return 0;
+  }
 
-	@Override
-	public int lastIndexOf(Object o) {
-		throwShouldNeverCall();
-		return 0;
-	}
+  @Override
+  public int lastIndexOf(Object o) {
+    throwShouldNeverCall();
+    return 0;
+  }
 
-	@Override
-	public ListIterator<V> listIterator() {
-		throwShouldNeverCall();
-		return null;
-	}
+  @Override
+  public ListIterator<V> listIterator() {
+    throwShouldNeverCall();
+    return null;
+  }
 
-	@Override
-	public ListIterator<V> listIterator(int index) {
-		throwShouldNeverCall();
-		return null;
-	}
+  @Override
+  public ListIterator<V> listIterator(int index) {
+    throwShouldNeverCall();
+    return null;
+  }
 
-	@Override
-	public List<V> subList(int fromIndex, int toIndex) {
-		throwShouldNeverCall();
-		return null;
-	}
+  @Override
+  public List<V> subList(int fromIndex, int toIndex) {
+    throwShouldNeverCall();
+    return null;
+  }
 
-	private void throwShouldNeverCall() {
-		throw new HelenusMappingException("should be never called");
-	}
+  private void throwShouldNeverCall() {
+    throw new HelenusMappingException("should be never called");
+  }
 
-	@Override
-	public String toString() {
-		return "ListDsl";
-	}
+  @Override
+  public String toString() {
+    return "ListDsl";
+  }
 }

src/main/java/net/helenus/core/reflect/MapDsl.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -19,100 +20,98 @@ import java.util.Collection;
 import java.util.Map;
 import java.util.Optional;
 import java.util.Set;
-
 import net.helenus.mapping.HelenusProperty;
 import net.helenus.support.DslPropertyException;
 import net.helenus.support.HelenusMappingException;
 
 public final class MapDsl<K, V> implements Map<K, V> {
 
-	private final HelenusPropertyNode parent;
+  private final HelenusPropertyNode parent;
 
-	public MapDsl(HelenusPropertyNode parent) {
-		this.parent = parent;
-	}
+  public MapDsl(HelenusPropertyNode parent) {
+    this.parent = parent;
+  }
 
-	public HelenusPropertyNode getParent() {
-		return parent;
-	}
+  public HelenusPropertyNode getParent() {
+    return parent;
+  }
 
-	@Override
-	public V get(Object key) {
-		HelenusProperty prop = new HelenusNamedProperty(key.toString());
-		throw new DslPropertyException(new HelenusPropertyNode(prop, Optional.of(parent)));
-	}
+  @Override
+  public V get(Object key) {
+    HelenusProperty prop = new HelenusNamedProperty(key.toString());
+    throw new DslPropertyException(new HelenusPropertyNode(prop, Optional.of(parent)));
+  }
 
-	@Override
-	public int size() {
-		throwShouldNeverCall();
-		return 0;
-	}
+  @Override
+  public int size() {
+    throwShouldNeverCall();
+    return 0;
+  }
 
-	@Override
-	public boolean isEmpty() {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean isEmpty() {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public boolean containsKey(Object key) {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean containsKey(Object key) {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public boolean containsValue(Object value) {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean containsValue(Object value) {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public V put(K key, V value) {
-		throwShouldNeverCall();
-		return null;
-	}
+  @Override
+  public V put(K key, V value) {
+    throwShouldNeverCall();
+    return null;
+  }
 
-	@Override
-	public V remove(Object key) {
-		throwShouldNeverCall();
-		return null;
-	}
+  @Override
+  public V remove(Object key) {
+    throwShouldNeverCall();
+    return null;
+  }
 
-	@Override
-	public void putAll(Map<? extends K, ? extends V> m) {
-		throwShouldNeverCall();
-	}
+  @Override
+  public void putAll(Map<? extends K, ? extends V> m) {
+    throwShouldNeverCall();
+  }
 
-	@Override
-	public void clear() {
-		throwShouldNeverCall();
-	}
+  @Override
+  public void clear() {
+    throwShouldNeverCall();
+  }
 
-	@Override
-	public Set<K> keySet() {
-		throwShouldNeverCall();
-		return null;
-	}
+  @Override
+  public Set<K> keySet() {
+    throwShouldNeverCall();
+    return null;
+  }
 
-	@Override
-	public Collection<V> values() {
-		throwShouldNeverCall();
-		return null;
-	}
+  @Override
+  public Collection<V> values() {
+    throwShouldNeverCall();
+    return null;
+  }
 
-	@Override
-	public Set<java.util.Map.Entry<K, V>> entrySet() {
-		throwShouldNeverCall();
-		return null;
-	}
+  @Override
+  public Set<java.util.Map.Entry<K, V>> entrySet() {
+    throwShouldNeverCall();
+    return null;
+  }
 
-	private void throwShouldNeverCall() {
-		throw new HelenusMappingException("should be never called");
-	}
-
-	@Override
-	public String toString() {
-		return "MapDsl";
-	}
+  private void throwShouldNeverCall() {
+    throw new HelenusMappingException("should be never called");
+  }
 
+  @Override
+  public String toString() {
+    return "MapDsl";
+  }
 }

src/main/java/net/helenus/core/reflect/MapExportable.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -16,11 +17,25 @@
 package net.helenus.core.reflect;
 
 import java.util.Map;
+import java.util.Set;
+import net.helenus.core.Getter;
 
 public interface MapExportable {
+  String TO_MAP_METHOD = "toMap";
+  String TO_READ_SET_METHOD = "toReadSet";
+  String PUT_METHOD = "put";
 
-	public static final String TO_MAP_METHOD = "toMap";
+  Map<String, Object> toMap();
 
-	Map<String, Object> toMap();
+  default Map<String, Object> toMap(boolean mutable) {
+    return null;
+  }
 
+  default Set<String> toReadSet() {
+    return null;
+  }
+
+  default void put(String key, Object value) {}
+
+  default <T> void put(Getter<T> getter, T value) {}
 }

src/main/java/net/helenus/core/reflect/MapperInvocationHandler.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,97 +16,279 @@
  */
 package net.helenus.core.reflect;
 
-import java.lang.invoke.MethodHandle;
+import com.google.common.collect.ImmutableList;
+import com.google.common.collect.ImmutableMap;
+import com.google.common.collect.ImmutableSet;
+import java.io.InvalidObjectException;
+import java.io.ObjectInputStream;
+import java.io.ObjectStreamException;
+import java.io.Serializable;
 import java.lang.invoke.MethodHandles;
 import java.lang.reflect.Constructor;
 import java.lang.reflect.InvocationHandler;
 import java.lang.reflect.Method;
 import java.lang.reflect.Proxy;
-import java.util.Collections;
-import java.util.Map;
-
+import java.util.*;
+import net.helenus.core.Getter;
+import net.helenus.core.Helenus;
+import net.helenus.core.cache.CacheUtil;
+import net.helenus.mapping.MappingUtil;
+import net.helenus.mapping.annotation.Transient;
+import net.helenus.mapping.value.ValueProviderMap;
 import net.helenus.support.HelenusException;
 
-public class MapperInvocationHandler<E> implements InvocationHandler {
+public class MapperInvocationHandler<E> implements InvocationHandler, Serializable {
+  private static final long serialVersionUID = -7044209982830584984L;
 
-	private final Map<String, Object> src;
-	private final Class<E> iface;
+  private Map<String, Object> src;
+  private final Set<String> read = new HashSet<String>();
+  private final Class<E> iface;
 
-	public MapperInvocationHandler(Class<E> iface, Map<String, Object> src) {
-		this.src = src;
-		this.iface = iface;
-	}
+  public MapperInvocationHandler(Class<E> iface, Map<String, Object> src) {
+    this.src = src;
+    this.iface = iface;
+  }
 
-	@Override
-	public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
+  private Object invokeDefault(Object proxy, Method method, Object[] args) throws Throwable {
+    // NOTE: This is reflection magic to invoke (non-recursively) a default method
+    // implemented on an interface
+    // that we've proxied (in ReflectionDslInstantiator). I found the answer in this
+    // article.
+    // https://zeroturnaround.com/rebellabs/recognize-and-conquer-java-proxies-default-methods-and-method-handles/
 
-        if (method.isDefault()) {
-            // NOTE: This is reflection magic to invoke (non-recursively) a default method implemented on an interface
-            // that we've proxied (in ReflectionDslInstantiator).  I found the answer in this article.
-            // https://zeroturnaround.com/rebellabs/recognize-and-conquer-java-proxies-default-methods-and-method-handles/
+    // First, we need an instance of a private inner-class found in MethodHandles.
+    Constructor<MethodHandles.Lookup> constructor =
+        MethodHandles.Lookup.class.getDeclaredConstructor(Class.class, int.class);
+    constructor.setAccessible(true);
 
-            // First, we need an instance of a private inner-class found in MethodHandles.
-            Constructor<MethodHandles.Lookup> constructor = MethodHandles.Lookup.class.getDeclaredConstructor(Class.class, int.class);
-            constructor.setAccessible(true);
+    // Now we need to lookup and invoke special the default method on the interface
+    // class.
+    final Class<?> declaringClass = method.getDeclaringClass();
+    Object result =
+        constructor
+            .newInstance(declaringClass, MethodHandles.Lookup.PRIVATE)
+            .unreflectSpecial(method, declaringClass)
+            .bindTo(proxy)
+            .invokeWithArguments(args);
+    return result;
+  }
 
-            // Now we need to lookup and invoke special the default method on the interface class.
-            final Class<?> declaringClass = method.getDeclaringClass();
-            Object result = constructor.newInstance(declaringClass, MethodHandles.Lookup.PRIVATE)
-                            .unreflectSpecial(method, declaringClass)
-                            .bindTo(proxy)
-                            .invokeWithArguments(args);
-            return result;
+  private Object writeReplace() {
+    return new SerializationProxy<E>(this);
+  }
+
+  private void readObject(ObjectInputStream stream) throws InvalidObjectException {
+    throw new InvalidObjectException("Proxy required.");
+  }
+
+  @Override
+  public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
+
+    // Transient, default methods should simply be invoked as-is.
+    if (method.isDefault() && method.getDeclaredAnnotation(Transient.class) != null) {
+      return invokeDefault(proxy, method, args);
+    }
+
+    String methodName = method.getName();
+
+    if ("equals".equals(methodName) && method.getParameterCount() == 1) {
+      Object otherObj = args[0];
+      if (otherObj == null) {
+        return false;
+      }
+      if (Proxy.isProxyClass(otherObj.getClass())) {
+        if (this == Proxy.getInvocationHandler(otherObj)) {
+          return true;
         }
+      }
+      if (otherObj instanceof MapExportable) {
+        return MappingUtil.compareMaps((MapExportable) otherObj, src);
+      }
+      return false;
+    }
 
-		String methodName = method.getName();
+    if (MapExportable.PUT_METHOD.equals(methodName) && method.getParameterCount() == 2) {
+      final String key;
+      if (args[0] instanceof String) {
+        key = (String) args[0];
+      } else if (args[0] instanceof Getter) {
+        key = MappingUtil.resolveMappingProperty((Getter) args[0]).getProperty().getPropertyName();
+      } else {
+        key = null;
+      }
+      if (key != null) {
+        final Object value = (Object) args[1];
+        if (src instanceof ValueProviderMap) {
+          this.src = fromValueProviderMap(src);
+        }
+        src.put(key, value);
+      }
+      return null;
+    }
 
-		if ("equals".equals(methodName) && method.getParameterCount() == 1) {
-			Object otherObj = args[0];
-			if (otherObj == null) {
-				return false;
-			}
-			if (Proxy.isProxyClass(otherObj.getClass())) {
-				return this == Proxy.getInvocationHandler(otherObj);
-			}
-			return false;
-		}
+    if (Entity.WRITTEN_AT_METHOD.equals(methodName) && method.getParameterCount() == 1) {
+      final String key;
+      if (args[0] instanceof String) {
+        key = CacheUtil.writeTimeKey((String) args[0]);
+      } else if (args[0] instanceof Getter) {
+        Getter getter = (Getter) args[0];
+        key =
+            CacheUtil.writeTimeKey(
+                MappingUtil.resolveMappingProperty(getter)
+                    .getProperty()
+                    .getColumnName()
+                    .toCql(false));
+      } else {
+        return 0L;
+      }
+      Long v = (Long) src.get(key);
+      if (v != null) {
+        return v;
+      }
+      return 0L;
+    }
 
-		if (method.getParameterCount() != 0 || method.getReturnType() == void.class) {
-			throw new HelenusException("invalid getter method " + method);
-		}
+    if (Entity.TOKEN_OF_METHOD.equals(methodName) && method.getParameterCount() == 0) {
+        Long v = (Long) src.get("");
+        if (v != null) {
+            return v;
+        }
+        return 0L;
+    }
 
-		if ("hashCode".equals(methodName)) {
-			return hashCode();
-		}
+    if (Entity.TTL_OF_METHOD.equals(methodName) && method.getParameterCount() == 1) {
+      final String key;
+      if (args[0] instanceof String) {
+        key = CacheUtil.ttlKey((String) args[0]);
+      } else if (args[0] instanceof Getter) {
+        Getter getter = (Getter) args[0];
+        key =
+            CacheUtil.ttlKey(
+                MappingUtil.resolveMappingProperty(getter)
+                    .getProperty()
+                    .getColumnName()
+                    .toCql(false));
+      } else {
+        return 0;
+      }
+      int v[] = (int[]) src.get(key);
+      if (v != null) {
+        return v[0];
+      }
+      return 0;
+    }
 
-		if ("toString".equals(methodName)) {
-			return iface.getSimpleName() + ": " + src.toString();
-		}
+    if (MapExportable.TO_MAP_METHOD.equals(methodName)) {
+      if (method.getParameterCount() == 1 && args[0] instanceof Boolean) {
+        if ((boolean) args[0] == true) {
+          return fromValueProviderMap(src, true);
+        }
+      }
+      return Collections.unmodifiableMap(src);
+    }
 
-		if (MapExportable.TO_MAP_METHOD.equals(methodName)) {
-			return Collections.unmodifiableMap(src);
-		}
+    if (MapExportable.TO_READ_SET_METHOD.equals(methodName)) {
+      return read;
+    }
 
-		Object value = src.get(methodName);
+    if (method.getParameterCount() != 0 || method.getReturnType() == void.class) {
+      throw new HelenusException("invalid getter method " + method);
+    }
 
-		if (value == null) {
+    if ("hashCode".equals(methodName)) {
+      return hashCode();
+    }
 
-            Class<?> returnType = method.getReturnType();
+    if ("toString".equals(methodName)) {
+      return iface.getSimpleName() + ": " + src.toString();
+    }
 
-			if (returnType.isPrimitive()) {
+    if ("writeReplace".equals(methodName)) {
+      return new SerializationProxy(this);
+    }
 
-				DefaultPrimitiveTypes type = DefaultPrimitiveTypes.lookup(returnType);
-				if (type == null) {
-					throw new HelenusException("unknown primitive type " + returnType);
-				}
+    if ("readObject".equals(methodName)) {
+      throw new InvalidObjectException("Proxy required.");
+    }
 
-				return type.getDefaultValue();
+    if ("dsl".equals(methodName)) {
+      return Helenus.dsl(iface);
+    }
 
-			}
+    final Object value = src.get(methodName);
+    read.add(methodName);
 
-		}
+    if (value == null) {
 
-		return value;
-	}
+      Class<?> returnType = method.getReturnType();
 
+      // Default implementations of non-Transient methods in entities are the default
+      // value when the map contains 'null'.
+      if (method.isDefault()) {
+        return invokeDefault(proxy, method, args);
+      }
+
+      // Otherwise, if the return type of the method is a primitive Java type then
+      // we'll return the standard default values to avoid a NPE in user code.
+      if (returnType.isPrimitive()) {
+        DefaultPrimitiveTypes type = DefaultPrimitiveTypes.lookup(returnType);
+        if (type == null) {
+          throw new HelenusException("unknown primitive type " + returnType);
+        }
+        return type.getDefaultValue();
+      }
+    }
+
+    return value;
+  }
+
+  static Map<String, Object> fromValueProviderMap(Map v) {
+    return fromValueProviderMap(v, false);
+  }
+
+  static Map<String, Object> fromValueProviderMap(Map v, boolean mutable) {
+    if (v instanceof ValueProviderMap) {
+      Map<String, Object> m = new HashMap<String, Object>(v.size());
+      Set<String> keys = v.keySet();
+      for (String key : keys) {
+        Object value = v.get(key);
+        if (value != null && mutable) {
+          if (ImmutableList.class.isAssignableFrom(value.getClass())) {
+            m.put(key, new ArrayList((List) value));
+          } else if (ImmutableMap.class.isAssignableFrom(value.getClass())) {
+            m.put(key, new HashMap((Map) value));
+          } else if (ImmutableSet.class.isAssignableFrom(value.getClass())) {
+            m.put(key, new HashSet((Set) value));
+          } else {
+            m.put(key, value);
+          }
+        } else {
+          m.put(key, value);
+        }
+      }
+      return m;
+    }
+    return v;
+  }
+
+  static class SerializationProxy<E> implements Serializable {
+
+    private static final long serialVersionUID = -5617583940055969353L;
+
+    private final Class<E> iface;
+    private final Map<String, Object> src;
+
+    public SerializationProxy(MapperInvocationHandler mapper) {
+      this.iface = mapper.iface;
+      if (mapper.src instanceof ValueProviderMap) {
+        this.src = fromValueProviderMap(mapper.src);
+      } else {
+        this.src = mapper.src;
+      }
+    }
+
+    Object readResolve() throws ObjectStreamException {
+      return new MapperInvocationHandler(iface, src);
+    }
+  }
 }

src/main/java/net/helenus/core/reflect/ReflectionDslInstantiator.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,22 +16,25 @@
  */
 package net.helenus.core.reflect;
 
+import com.datastax.driver.core.Metadata;
 import java.lang.reflect.Proxy;
 import java.util.Optional;
-
-import com.datastax.driver.core.Metadata;
 import net.helenus.core.DslInstantiator;
 
 public enum ReflectionDslInstantiator implements DslInstantiator {
+  INSTANCE;
 
-	INSTANCE;
-
-	@Override
-	@SuppressWarnings("unchecked")
-	public <E> E instantiate(Class<E> iface, ClassLoader classLoader, Optional<HelenusPropertyNode> parent, Metadata metadata) {
-		DslInvocationHandler<E> handler = new DslInvocationHandler<E>(iface, classLoader, parent, metadata);
-		E proxy = (E) Proxy.newProxyInstance(classLoader, new Class[]{iface, DslExportable.class}, handler);
-		return proxy;
-	}
-
+  @Override
+  @SuppressWarnings("unchecked")
+  public <E> E instantiate(
+      Class<E> iface,
+      ClassLoader classLoader,
+      Optional<HelenusPropertyNode> parent,
+      Metadata metadata) {
+    DslInvocationHandler<E> handler =
+        new DslInvocationHandler<E>(iface, classLoader, parent, metadata);
+    E proxy =
+        (E) Proxy.newProxyInstance(classLoader, new Class[] {iface, DslExportable.class}, handler);
+    return proxy;
+  }
 }

src/main/java/net/helenus/core/reflect/ReflectionInstantiator.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -19,17 +20,14 @@ import net.helenus.support.HelenusMappingException;
 
 public final class ReflectionInstantiator {
 
-	private ReflectionInstantiator() {
-	}
+  private ReflectionInstantiator() {}
 
-	public static <T> T instantiateClass(Class<T> clazz) {
-
-		try {
-			return clazz.newInstance();
-		} catch (InstantiationException | IllegalAccessException e) {
-			throw new HelenusMappingException("invalid class " + clazz, e);
-		}
-
-	}
+  public static <T> T instantiateClass(Class<T> clazz) {
 
+    try {
+      return clazz.newInstance();
+    } catch (InstantiationException | IllegalAccessException e) {
+      throw new HelenusMappingException("invalid class " + clazz, e);
+    }
+  }
 }

src/main/java/net/helenus/core/reflect/ReflectionMapperInstantiator.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,23 +16,23 @@
  */
 package net.helenus.core.reflect;
 
+import java.io.Serializable;
 import java.lang.reflect.Proxy;
 import java.util.Map;
-
 import net.helenus.core.MapperInstantiator;
 
 public enum ReflectionMapperInstantiator implements MapperInstantiator {
+  INSTANCE;
 
-	INSTANCE;
-
-	@Override
-	@SuppressWarnings("unchecked")
-	public <E> E instantiate(Class<E> iface, Map<String, Object> src, ClassLoader classLoader) {
-
-		MapperInvocationHandler<E> handler = new MapperInvocationHandler<E>(iface, src);
-		E proxy = (E) Proxy.newProxyInstance(classLoader, new Class[]{iface, MapExportable.class}, handler);
-		return proxy;
-
-	}
+  @Override
+  @SuppressWarnings("unchecked")
+  public <E> E instantiate(Class<E> iface, Map<String, Object> src, ClassLoader classLoader) {
 
+    MapperInvocationHandler<E> handler = new MapperInvocationHandler<E>(iface, src);
+    E proxy =
+        (E)
+            Proxy.newProxyInstance(
+                classLoader, new Class[] {iface, MapExportable.class, Serializable.class}, handler);
+    return proxy;
+  }
 }

src/main/java/net/helenus/core/reflect/SetDsl.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -18,104 +19,103 @@ package net.helenus.core.reflect;
 import java.util.Collection;
 import java.util.Iterator;
 import java.util.Set;
-
 import net.helenus.support.HelenusMappingException;
 
 public final class SetDsl<V> implements Set<V> {
 
-	private final HelenusPropertyNode parent;
+  private final HelenusPropertyNode parent;
 
-	public SetDsl(HelenusPropertyNode parent) {
-		this.parent = parent;
-	}
+  public SetDsl(HelenusPropertyNode parent) {
+    this.parent = parent;
+  }
 
-	public HelenusPropertyNode getParent() {
-		return parent;
-	}
+  public HelenusPropertyNode getParent() {
+    return parent;
+  }
 
-	@Override
-	public int size() {
-		throwShouldNeverCall();
-		return 0;
-	}
+  @Override
+  public int size() {
+    throwShouldNeverCall();
+    return 0;
+  }
 
-	@Override
-	public boolean isEmpty() {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean isEmpty() {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public boolean contains(Object o) {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean contains(Object o) {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public Iterator<V> iterator() {
-		throwShouldNeverCall();
-		return null;
-	}
+  @Override
+  public Iterator<V> iterator() {
+    throwShouldNeverCall();
+    return null;
+  }
 
-	@Override
-	public Object[] toArray() {
-		throwShouldNeverCall();
-		return null;
-	}
+  @Override
+  public Object[] toArray() {
+    throwShouldNeverCall();
+    return null;
+  }
 
-	@Override
-	public <T> T[] toArray(T[] a) {
-		throwShouldNeverCall();
-		return null;
-	}
+  @Override
+  public <T> T[] toArray(T[] a) {
+    throwShouldNeverCall();
+    return null;
+  }
 
-	@Override
-	public boolean add(V e) {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean add(V e) {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public boolean remove(Object o) {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean remove(Object o) {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public boolean containsAll(Collection<?> c) {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean containsAll(Collection<?> c) {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public boolean addAll(Collection<? extends V> c) {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean addAll(Collection<? extends V> c) {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public boolean retainAll(Collection<?> c) {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean retainAll(Collection<?> c) {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public boolean removeAll(Collection<?> c) {
-		throwShouldNeverCall();
-		return false;
-	}
+  @Override
+  public boolean removeAll(Collection<?> c) {
+    throwShouldNeverCall();
+    return false;
+  }
 
-	@Override
-	public void clear() {
-		throwShouldNeverCall();
-	}
+  @Override
+  public void clear() {
+    throwShouldNeverCall();
+  }
 
-	private void throwShouldNeverCall() {
-		throw new HelenusMappingException("should be never called");
-	}
+  private void throwShouldNeverCall() {
+    throw new HelenusMappingException("should be never called");
+  }
 
-	@Override
-	public String toString() {
-		return "SetDsl";
-	}
+  @Override
+  public String toString() {
+    return "SetDsl";
+  }
 }

src/main/java/net/helenus/mapping/ColumnInformation.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -16,7 +17,6 @@
 package net.helenus.mapping;
 
 import java.lang.reflect.Method;
-
 import net.helenus.mapping.annotation.ClusteringColumn;
 import net.helenus.mapping.annotation.Column;
 import net.helenus.mapping.annotation.PartitionKey;
@@ -25,93 +25,99 @@ import net.helenus.support.HelenusMappingException;
 
 public final class ColumnInformation {
 
-	private final IdentityName columnName;
-	private final ColumnType columnType;
-	private final int ordinal;
-	private final OrderingDirection ordering;
+  private final IdentityName columnName;
+  private final ColumnType columnType;
+  private final int ordinal;
+  private final OrderingDirection ordering;
 
-	public ColumnInformation(Method getter) {
+  public ColumnInformation(Method getter) {
 
-		String columnName = null;
-		boolean forceQuote = false;
-		ColumnType columnTypeLocal = ColumnType.COLUMN;
-		int ordinalLocal = 0;
-		OrderingDirection orderingLocal = OrderingDirection.ASC;
+    String columnName = null;
+    boolean forceQuote = false;
+    ColumnType columnTypeLocal = ColumnType.COLUMN;
+    int ordinalLocal = 0;
+    OrderingDirection orderingLocal = OrderingDirection.ASC;
 
-		PartitionKey partitionKey = getter.getDeclaredAnnotation(PartitionKey.class);
-		if (partitionKey != null) {
-			columnName = partitionKey.value();
-			forceQuote = partitionKey.forceQuote();
-			columnTypeLocal = ColumnType.PARTITION_KEY;
-			ordinalLocal = partitionKey.ordinal();
-		}
+    PartitionKey partitionKey = getter.getDeclaredAnnotation(PartitionKey.class);
+    if (partitionKey != null) {
+      columnName = partitionKey.value();
+      forceQuote = partitionKey.forceQuote();
+      columnTypeLocal = ColumnType.PARTITION_KEY;
+      ordinalLocal = partitionKey.ordinal();
+    }
 
-		ClusteringColumn clusteringColumn = getter.getDeclaredAnnotation(ClusteringColumn.class);
-		if (clusteringColumn != null) {
-			ensureSingleColumnType(columnTypeLocal, getter);
-			columnName = clusteringColumn.value();
-			forceQuote = clusteringColumn.forceQuote();
-			columnTypeLocal = ColumnType.CLUSTERING_COLUMN;
-			ordinalLocal = clusteringColumn.ordinal();
-			orderingLocal = clusteringColumn.ordering();
-		}
+    ClusteringColumn clusteringColumn = getter.getDeclaredAnnotation(ClusteringColumn.class);
+    if (clusteringColumn != null) {
+      ensureSingleColumnType(columnTypeLocal, getter);
+      columnName = clusteringColumn.value();
+      forceQuote = clusteringColumn.forceQuote();
+      columnTypeLocal = ColumnType.CLUSTERING_COLUMN;
+      ordinalLocal = clusteringColumn.ordinal();
+      orderingLocal = clusteringColumn.ordering();
+    }
 
-		StaticColumn staticColumn = getter.getDeclaredAnnotation(StaticColumn.class);
-		if (staticColumn != null) {
-			ensureSingleColumnType(columnTypeLocal, getter);
-			columnName = staticColumn.value();
-			forceQuote = staticColumn.forceQuote();
-			columnTypeLocal = ColumnType.STATIC_COLUMN;
-			ordinalLocal = staticColumn.ordinal();
-		}
+    StaticColumn staticColumn = getter.getDeclaredAnnotation(StaticColumn.class);
+    if (staticColumn != null) {
+      ensureSingleColumnType(columnTypeLocal, getter);
+      columnName = staticColumn.value();
+      forceQuote = staticColumn.forceQuote();
+      columnTypeLocal = ColumnType.STATIC_COLUMN;
+      ordinalLocal = staticColumn.ordinal();
+    }
 
-		Column column = getter.getDeclaredAnnotation(Column.class);
-		if (column != null) {
-			ensureSingleColumnType(columnTypeLocal, getter);
-			columnName = column.value();
-			forceQuote = column.forceQuote();
-			columnTypeLocal = ColumnType.COLUMN;
-			ordinalLocal = column.ordinal();
-		}
+    Column column = getter.getDeclaredAnnotation(Column.class);
+    if (column != null) {
+      ensureSingleColumnType(columnTypeLocal, getter);
+      columnName = column.value();
+      forceQuote = column.forceQuote();
+      columnTypeLocal = ColumnType.COLUMN;
+      ordinalLocal = column.ordinal();
+    }
 
-		if (columnName == null || columnName.isEmpty()) {
-			columnName = MappingUtil.getDefaultColumnName(getter);
-		}
+    if (columnName == null || columnName.isEmpty()) {
+      columnName = MappingUtil.getDefaultColumnName(getter);
+    }
 
-		this.columnName = new IdentityName(columnName, forceQuote);
-		this.columnType = columnTypeLocal;
-		this.ordinal = ordinalLocal;
-		this.ordering = orderingLocal;
-	}
+    this.columnName = new IdentityName(columnName, forceQuote);
+    this.columnType = columnTypeLocal;
+    this.ordinal = ordinalLocal;
+    this.ordering = orderingLocal;
+  }
 
-	public IdentityName getColumnName() {
-		return columnName;
-	}
+  public IdentityName getColumnName() {
+    return columnName;
+  }
 
-	public ColumnType getColumnType() {
-		return columnType;
-	}
+  public ColumnType getColumnType() {
+    return columnType;
+  }
 
-	public int getOrdinal() {
-		return ordinal;
-	}
+  public int getOrdinal() {
+    return ordinal;
+  }
 
-	public OrderingDirection getOrdering() {
-		return ordering;
-	}
+  public OrderingDirection getOrdering() {
+    return ordering;
+  }
 
-	private void ensureSingleColumnType(ColumnType columnTypeLocal, Method getter) {
+  private void ensureSingleColumnType(ColumnType columnTypeLocal, Method getter) {
 
-		if (columnTypeLocal != ColumnType.COLUMN) {
-			throw new HelenusMappingException("property can be annotated only by a single column type " + getter);
-		}
-
-	}
-
-	@Override
-	public String toString() {
-		return "ColumnInformation [columnName=" + columnName + ", columnType=" + columnType + ", ordinal=" + ordinal
-				+ ", ordering=" + ordering + "]";
-	}
+    if (columnTypeLocal != ColumnType.COLUMN) {
+      throw new HelenusMappingException(
+          "property can be annotated only by a single column type " + getter);
+    }
+  }
 
+  @Override
+  public String toString() {
+    return "ColumnInformation [columnName="
+        + columnName
+        + ", columnType="
+        + columnType
+        + ", ordinal="
+        + ordinal
+        + ", ordering="
+        + ordering
+        + "]";
+  }
 }

src/main/java/net/helenus/mapping/ColumnType.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -16,5 +17,8 @@
 package net.helenus.mapping;
 
 public enum ColumnType {
-	PARTITION_KEY, CLUSTERING_COLUMN, STATIC_COLUMN, COLUMN;
+  PARTITION_KEY,
+  CLUSTERING_COLUMN,
+  STATIC_COLUMN,
+  COLUMN;
 }

src/main/java/net/helenus/mapping/HelenusEntity.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -16,19 +17,24 @@
 package net.helenus.mapping;
 
 import java.util.Collection;
+import java.util.List;
+import net.helenus.core.cache.Facet;
 
 public interface HelenusEntity {
 
-	HelenusEntityType getType();
+  HelenusEntityType getType();
 
-	boolean isCacheable();
+  boolean isCacheable();
 
-	Class<?> getMappingInterface();
+  Class<?> getMappingInterface();
 
-	IdentityName getName();
+  IdentityName getName();
 
-	Collection<HelenusProperty> getOrderedProperties();
+  Collection<HelenusProperty> getOrderedProperties();
 
-	HelenusProperty getProperty(String name);
+  HelenusProperty getProperty(String name);
 
+  List<Facet> getFacets();
+
+  boolean isDraftable();
 }

src/main/java/net/helenus/mapping/HelenusEntityType.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -16,5 +17,8 @@
 package net.helenus.mapping;
 
 public enum HelenusEntityType {
-	TABLE, TUPLE, UDT;
+  TABLE,
+  VIEW,
+  TUPLE,
+  UDT;
 }

src/main/java/net/helenus/mapping/HelenusMappingEntity.java

@@ -1,6 +1,7 @@
 /*
  *
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
  *   You may obtain a copy of the License at
@@ -15,256 +16,356 @@
  */
 package net.helenus.mapping;
 
-import java.lang.reflect.Method;
-import java.util.*;
-
-import com.datastax.driver.core.*;
+import com.datastax.driver.core.DefaultMetadata;
+import com.datastax.driver.core.Metadata;
 import com.google.common.collect.ImmutableList;
 import com.google.common.collect.ImmutableMap;
-
-import com.google.common.collect.ImmutableSet;
-import com.google.common.reflect.TypeToken;
+import java.lang.reflect.Method;
+import java.util.*;
+import javax.validation.ConstraintValidator;
 import net.helenus.config.HelenusSettings;
 import net.helenus.core.Helenus;
 import net.helenus.core.annotation.Cacheable;
+import net.helenus.core.cache.Facet;
+import net.helenus.core.cache.UnboundFacet;
 import net.helenus.mapping.annotation.*;
+import net.helenus.mapping.validator.DistinctValidator;
 import net.helenus.support.HelenusMappingException;
+import org.apache.commons.lang3.ClassUtils;
+import org.apache.commons.lang3.StringUtils;
 
 public final class HelenusMappingEntity implements HelenusEntity {
 
-	private final Class<?> iface;
-	private final HelenusEntityType type;
-	private final IdentityName name;
-	private final boolean cacheable;
-	private final ImmutableMap<String, Method> methods;
-	private final ImmutableMap<String, HelenusProperty> props;
-	private final ImmutableList<HelenusProperty> orderedProps;
+  private final Class<?> iface;
+  private final HelenusEntityType type;
+  private final IdentityName name;
+  private final boolean cacheable;
+  private final boolean draftable;
+  private final ImmutableMap<String, Method> methods;
+  private final ImmutableMap<String, HelenusProperty> props;
+  private final ImmutableList<HelenusProperty> orderedProps;
+  private final List<Facet> facets;
 
-	public HelenusMappingEntity(Class<?> iface, Metadata metadata) {
-		this(iface, autoDetectType(iface), metadata);
-	}
+  public HelenusMappingEntity(Class<?> iface, Metadata metadata) {
+    this(iface, autoDetectType(iface), metadata);
+  }
 
-	public HelenusMappingEntity(Class<?> iface, HelenusEntityType type, Metadata metadata) {
+  public HelenusMappingEntity(Class<?> iface, HelenusEntityType type, Metadata metadata) {
 
-		if (iface == null || !iface.isInterface()) {
-			throw new IllegalArgumentException("invalid parameter " + iface);
-		}
+    if (iface == null || !iface.isInterface()) {
+      throw new IllegalArgumentException("invalid parameter " + iface);
+    }
 
-		this.iface = iface;
-		this.type = Objects.requireNonNull(type, "type is empty");
-		this.name = resolveName(iface, type);
+    this.iface = iface;
+    this.type = Objects.requireNonNull(type, "type is empty");
+    this.name = resolveName(iface, type);
 
-		HelenusSettings settings = Helenus.settings();
+    HelenusSettings settings = Helenus.settings();
 
+    Map<String, Method> methods = new HashMap<String, Method>();
+    for (Method m : iface.getDeclaredMethods()) {
+      methods.put(m.getName(), m);
+    }
 
-		List<Method> methods = new ArrayList<Method>();
-
-        methods.addAll(Arrays.asList(iface.getDeclaredMethods()));
-		for (Class<?> c : iface.getInterfaces()) {
-            methods.addAll(Arrays.asList(c.getDeclaredMethods()));
+    for (Class<?> c : ClassUtils.getAllInterfaces(iface)) {
+      if (c.getDeclaredAnnotation(Table.class) != null
+          || c.getDeclaredAnnotation(InheritedTable.class) != null) {
+        for (Method m : c.getDeclaredMethods()) {
+          Method o = methods.get(m.getName());
+          if (o != null) {
+            // Prefer overridden method implementation.
+            if (o.getDeclaringClass().isAssignableFrom(m.getDeclaringClass())) {
+              methods.put(m.getName(), m);
+            }
+          } else {
+            methods.put(m.getName(), m);
+          }
         }
+      }
+    }
 
-		List<HelenusProperty> propsLocal = new ArrayList<HelenusProperty>();
-		ImmutableMap.Builder<String, HelenusProperty> propsBuilder = ImmutableMap.builder();
-		ImmutableMap.Builder<String, Method> methodsBuilder = ImmutableMap.builder();
+    List<HelenusProperty> propsLocal = new ArrayList<HelenusProperty>();
+    ImmutableMap.Builder<String, HelenusProperty> propsBuilder = ImmutableMap.builder();
+    ImmutableMap.Builder<String, Method> methodsBuilder = ImmutableMap.builder();
 
-		for (Method method : methods) {
+    for (Method method : methods.values()) {
 
-			if (settings.getGetterMethodDetector().apply(method)) {
+      if (settings.getGetterMethodDetector().apply(method)) {
 
-				methodsBuilder.put(method.getName(), method);
+        methodsBuilder.put(method.getName(), method);
 
-				if (metadata != null) {
-					HelenusProperty prop = new HelenusMappingProperty(this, method, metadata);
+        if (metadata != null) {
+          HelenusProperty prop = new HelenusMappingProperty(this, method, metadata);
 
-					propsBuilder.put(prop.getPropertyName(), prop);
-					propsLocal.add(prop);
-				}
-
-			}
-
-		}
-
-		this.methods = methodsBuilder.build();
-		this.props = propsBuilder.build();
-
-		Collections.sort(propsLocal, TypeAndOrdinalColumnComparator.INSTANCE);
-		this.orderedProps = ImmutableList.copyOf(propsLocal);
-
-		validateOrdinals();
-
-		cacheable = (null != iface.getDeclaredAnnotation(Cacheable.class));
-	}
-
-	@Override
-	public HelenusEntityType getType() {
-		return type;
-	}
-
-	@Override
-	public boolean isCacheable() {
-		return cacheable;
-	}
-
-	@Override
-	public Class<?> getMappingInterface() {
-		return iface;
-	}
-
-	@Override
-	public Collection<HelenusProperty> getOrderedProperties() {
-		return orderedProps;
-	}
-
-	@Override
-	public HelenusProperty getProperty(String name) {
-	    HelenusProperty property = props.get(name);
-	    if (property == null && methods.containsKey(name)) {
-            property = new HelenusMappingProperty(this, methods.get(name), new DefaultMetadata());
-            return property; //TODO(gburd): review adding these into the props map...
+          propsBuilder.put(prop.getPropertyName(), prop);
+          propsLocal.add(prop);
         }
-		return props.get(name);
-	}
+      }
+    }
 
-	@Override
-	public IdentityName getName() {
-		return name;
-	}
+    this.methods = methodsBuilder.build();
+    this.props = propsBuilder.build();
 
-	private static IdentityName resolveName(Class<?> iface, HelenusEntityType type) {
+    Collections.sort(propsLocal, TypeAndOrdinalColumnComparator.INSTANCE);
+    this.orderedProps = ImmutableList.copyOf(propsLocal);
 
-		switch (type) {
+    validateOrdinals();
 
-			case TABLE :
-				return MappingUtil.getTableName(iface, true);
+    // Caching
+    cacheable = (null != iface.getDeclaredAnnotation(Cacheable.class));
 
-			case TUPLE :
-				return IdentityName.of(MappingUtil.getDefaultEntityName(iface), false);
+    // Draft
+    Class<?> draft;
+    try {
+      draft = Class.forName(iface.getName() + "$Draft");
+    } catch (Exception ignored) {
+      draft = null;
+    }
+    draftable = (draft != null);
 
-			case UDT :
-				return MappingUtil.getUserDefinedTypeName(iface, true);
-		}
+    // Materialized view
+    List<HelenusProperty> primaryKeyProperties = new ArrayList<>();
+    ImmutableList.Builder<Facet> facetsBuilder = ImmutableList.builder();
+    if (iface.getDeclaredAnnotation(MaterializedView.class) == null) {
+      facetsBuilder.add(new Facet("table", name.toCql()).setFixed());
+    } else {
+      facetsBuilder.add(
+          new Facet("table", Helenus.entity(iface.getInterfaces()[0]).getName().toCql())
+              .setFixed());
+    }
+    for (HelenusProperty prop : orderedProps) {
+      switch (prop.getColumnType()) {
+        case PARTITION_KEY:
+        case CLUSTERING_COLUMN:
+          primaryKeyProperties.add(prop);
+          break;
+        default:
+          if (primaryKeyProperties != null && primaryKeyProperties.size() > 0) {
+            facetsBuilder.add(new UnboundFacet(primaryKeyProperties));
+            primaryKeyProperties = null;
+          }
+          for (ConstraintValidator<?, ?> constraint :
+              MappingUtil.getValidators(prop.getGetterMethod())) {
+            if (constraint instanceof DistinctValidator) {
+              DistinctValidator validator = (DistinctValidator) constraint;
+              String[] values = validator.constraintAnnotation.value();
+              UnboundFacet facet;
+              if (values != null && values.length >= 1 && !(StringUtils.isBlank(values[0]))) {
+                List<HelenusProperty> props = new ArrayList<HelenusProperty>(values.length + 1);
+                props.add(prop);
+                for (String value : values) {
+                  for (HelenusProperty p : orderedProps) {
+                    String name = p.getPropertyName();
+                    if (name.equals(value) && !name.equals(prop.getPropertyName())) {
+                      props.add(p);
+                    }
+                  }
+                }
+                facet = new UnboundFacet(props, validator.alone(), validator.combined());
+              } else {
+                facet = new UnboundFacet(prop, validator.alone(), validator.combined());
+              }
+              facetsBuilder.add(facet);
+              break;
+            }
+          }
+      }
+    }
+    if (primaryKeyProperties != null && primaryKeyProperties.size() > 0) {
+      facetsBuilder.add(new UnboundFacet(primaryKeyProperties));
+    }
+    this.facets = facetsBuilder.build();
+  }
 
-		throw new HelenusMappingException("invalid entity type " + type + " in " + type);
+  private static IdentityName resolveName(Class<?> iface, HelenusEntityType type) {
 
-	}
+    switch (type) {
+      case TABLE:
+        return MappingUtil.getTableName(iface, true);
 
-	private static HelenusEntityType autoDetectType(Class<?> iface) {
+      case VIEW:
+        return MappingUtil.getViewName(iface, true);
 
-		Objects.requireNonNull(iface, "empty iface");
+      case TUPLE:
+        return IdentityName.of(MappingUtil.getDefaultEntityName(iface), false);
 
-		if (null != iface.getDeclaredAnnotation(Table.class)) {
-			return HelenusEntityType.TABLE;
-		}
+      case UDT:
+        return MappingUtil.getUserDefinedTypeName(iface, true);
+    }
 
-		else if (null != iface.getDeclaredAnnotation(Tuple.class)) {
-			return HelenusEntityType.TUPLE;
-		}
+    throw new HelenusMappingException("invalid entity type " + type + " in " + type);
+  }
 
-		else if (null != iface.getDeclaredAnnotation(UDT.class)) {
-			return HelenusEntityType.UDT;
-		}
+  private static HelenusEntityType autoDetectType(Class<?> iface) {
 
-		throw new HelenusMappingException("entity must be annotated by @Table or @Tuple or @UserDefinedType " + iface);
-	}
+    Objects.requireNonNull(iface, "empty iface");
 
-	private void validateOrdinals() {
+    if (null != iface.getDeclaredAnnotation(Table.class)) {
+      return HelenusEntityType.TABLE;
+    } else if (null != iface.getDeclaredAnnotation(MaterializedView.class)) {
+      return HelenusEntityType.VIEW;
+    } else if (null != iface.getDeclaredAnnotation(Tuple.class)) {
+      return HelenusEntityType.TUPLE;
+    } else if (null != iface.getDeclaredAnnotation(UDT.class)) {
+      return HelenusEntityType.UDT;
+    }
 
-		switch (getType()) {
+    throw new HelenusMappingException(
+        "entity must be annotated by @Table or @Tuple or @UserDefinedType " + iface);
+  }
 
-			case TABLE :
-				validateOrdinalsForTable();
-				break;
+  @Override
+  public HelenusEntityType getType() {
+    return type;
+  }
 
-			case TUPLE :
-				validateOrdinalsInTuple();
-				break;
+  @Override
+  public boolean isCacheable() {
+    return cacheable;
+  }
 
-			default :
-				break;
-		}
+  @Override
+  public boolean isDraftable() {
+    return draftable;
+  }
 
-	}
+  @Override
+  public Class<?> getMappingInterface() {
+    return iface;
+  }
 
-	private void validateOrdinalsForTable() {
+  @Override
+  public Collection<HelenusProperty> getOrderedProperties() {
+    return orderedProps;
+  }
 
-		BitSet partitionKeys = new BitSet();
-		BitSet clusteringColumns = new BitSet();
+  @Override
+  public HelenusProperty getProperty(String name) {
+    HelenusProperty property = props.get(name);
+    if (property == null && methods.containsKey(name)) {
+      property = new HelenusMappingProperty(this, methods.get(name), new DefaultMetadata());
+      return property; // TODO(gburd): review adding these into the props map...
+    }
+    return props.get(name);
+  }
 
-		for (HelenusProperty prop : getOrderedProperties()) {
+  @Override
+  public List<Facet> getFacets() {
+    return facets;
+  }
 
-			ColumnType type = prop.getColumnType();
+  @Override
+  public IdentityName getName() {
+    return name;
+  }
 
-			int ordinal = prop.getOrdinal();
+  private void validateOrdinals() {
 
-			switch (type) {
+    switch (getType()) {
+      case TABLE:
+        validateOrdinalsForTable();
+        break;
 
-				case PARTITION_KEY :
-					if (partitionKeys.get(ordinal)) {
-						throw new HelenusMappingException(
-								"detected two or more partition key columns with the same ordinal " + ordinal + " in "
-										+ prop.getEntity());
-					}
-					partitionKeys.set(ordinal);
-					break;
+      case TUPLE:
+        validateOrdinalsInTuple();
+        break;
 
-				case CLUSTERING_COLUMN :
-					if (clusteringColumns.get(ordinal)) {
-						throw new HelenusMappingException("detected two or clustering columns with the same ordinal "
-								+ ordinal + " in " + prop.getEntity());
-					}
-					clusteringColumns.set(ordinal);
-					break;
+      default:
+        break;
+    }
+  }
 
-				default :
-					break;
-			}
+  private void validateOrdinalsForTable() {
 
-		}
+    BitSet partitionKeys = new BitSet();
+    BitSet clusteringColumns = new BitSet();
 
-	}
+    for (HelenusProperty prop : getOrderedProperties()) {
 
-	private void validateOrdinalsInTuple() {
-		boolean[] ordinals = new boolean[props.size()];
+      ColumnType type = prop.getColumnType();
 
-		getOrderedProperties().forEach(p -> {
+      int ordinal = prop.getOrdinal();
 
-			int ordinal = p.getOrdinal();
+      switch (type) {
+        case PARTITION_KEY:
+          if (partitionKeys.get(ordinal)) {
+            throw new HelenusMappingException(
+                "detected two or more partition key columns with the same ordinal "
+                    + ordinal
+                    + " in "
+                    + prop.getEntity());
+          }
+          partitionKeys.set(ordinal);
+          break;
 
-			if (ordinal < 0 || ordinal >= ordinals.length) {
-				throw new HelenusMappingException("invalid ordinal " + ordinal + " found for property "
-						+ p.getPropertyName() + " in " + p.getEntity());
-			}
+        case CLUSTERING_COLUMN:
+          if (clusteringColumns.get(ordinal)) {
+            throw new HelenusMappingException(
+                "detected two or clustering columns with the same ordinal "
+                    + ordinal
+                    + " in "
+                    + prop.getEntity());
+          }
+          clusteringColumns.set(ordinal);
+          break;
 
-			if (ordinals[ordinal]) {
-				throw new HelenusMappingException(
-						"detected two or more properties with the same ordinal " + ordinal + " in " + p.getEntity());
-			}
+        default:
+          break;
+      }
+    }
+  }
 
-			ordinals[ordinal] = true;
+  private void validateOrdinalsInTuple() {
+    boolean[] ordinals = new boolean[props.size()];
 
-		});
+    getOrderedProperties()
+        .forEach(
+            p -> {
+              int ordinal = p.getOrdinal();
 
-		for (int i = 0; i != ordinals.length; ++i) {
-			if (!ordinals[i]) {
-				throw new HelenusMappingException("detected absent ordinal " + i + " in " + this);
-			}
-		}
+              if (ordinal < 0 || ordinal >= ordinals.length) {
+                throw new HelenusMappingException(
+                    "invalid ordinal "
+                        + ordinal
+                        + " found for property "
+                        + p.getPropertyName()
+                        + " in "
+                        + p.getEntity());
+              }
 
-	}
+              if (ordinals[ordinal]) {
+                throw new HelenusMappingException(
+                    "detected two or more properties with the same ordinal "
+                        + ordinal
+                        + " in "
+                        + p.getEntity());
+              }
 
-	@Override
-	public String toString() {
+              ordinals[ordinal] = true;
+            });
 
-		StringBuilder str = new StringBuilder();
-		str.append(iface.getSimpleName()).append("(").append(name.getName()).append(") ")
-				.append(type.name().toLowerCase()).append(":\n");
+    for (int i = 0; i != ordinals.length; ++i) {
+      if (!ordinals[i]) {
+        throw new HelenusMappingException("detected absent ordinal " + i + " in " + this);
+      }
+    }
+  }
 
-		for (HelenusProperty prop : getOrderedProperties()) {
-			str.append(prop.toString());
-			str.append("\n");
-		}
-		return str.toString();
-	}
+  @Override
+  public String toString() {
 
+    StringBuilder str = new StringBuilder();
+    str.append(iface.getSimpleName())
+        .append("(")
+        .append(name.getName())
+        .append(") ")
+        .append(type.name().toLowerCase())
+        .append(":\n");
+
+    for (HelenusProperty prop : getOrderedProperties()) {
+      str.append(prop.toString());
+      str.append("\n");
+    }
+    return str.toString();
+  }
 }

src/main/java/net/helenus/mapping/HelenusMappingProperty.java

@@ -1,5 +1,6 @@
 /*
- *      Copyright (C) 2015 The Helenus Authors
+ *      Copyright (C) 2015 The Casser Authors
+ *      Copyright (C) 2015-2018 The Helenus Authors
  *
  *   Licensed under the Apache License, Version 2.0 (the "License");
  *   you may not use this file except in compliance with the License.
@@ -15,15 +16,13 @@
  */
 package net.helenus.mapping;
 
+import com.datastax.driver.core.Metadata;
 import java.lang.annotation.Annotation;
 import java.lang.reflect.Method;
 import java.lang.reflect.Type;
 import java.util.Optional;
 import java.util.function.Function;
-
 import javax.validation.ConstraintValidator;
-
-import com.datastax.driver.core.Metadata;
 import net.helenus.core.SessionRepository;
 import net.helenus.mapping.javatype.AbstractJavaType;
 import net.helenus.mapping.javatype.MappingJavaTypes;
@@ -31,176 +30,187 @@ import net.helenus.mapping.type.AbstractDataType;
 
 public final class HelenusMappingProperty implements HelenusProperty {
 
-	private final HelenusEntity entity;
-	private final Method getter;
+  private final HelenusEntity entity;
+  private final Method getter;
 
-	private final String propertyName;
-	private final Optional<IdentityName> indexName;
-	private final boolean caseSensitiveIndex;
+  private final String propertyName;
+  private final Optional<IdentityName> indexName;
+  private final boolean caseSensitiveIndex;
+  private final boolean idempotent;
 
-	private final ColumnInformation columnInfo;
+  private final ColumnInformation columnInfo;
 
-	private final Type genericJavaType;
-	private final Class<?> javaType;
-	private final AbstractJavaType abstractJavaType;
-	private final AbstractDataType dataType;
+  private final Type genericJavaType;
+  private final Class<?> javaType;
+  private final AbstractJavaType abstractJavaType;
+  private final AbstractDataType dataType;
+  private final ConstraintValidator<? extends Annotation, ?>[] validators;
+  private volatile Optional<Function<Object, Object>> readConverter = null;
+  private volatile Optional<Function<Object, Object>> writeConverter = null;
 
-	private volatile Optional<Function<Object, Object>> readConverter = null;
-	private volatile Optional<Function<Object, Object>> writeConverter = null;
+  public HelenusMappingProperty(HelenusMappingEntity entity, Method getter, Metadata metadata) {
+    this.entity = entity;
+    this.getter = getter;
 
-	private final ConstraintValidator<? extends Annotation, ?>[] validators;
+    this.propertyName = MappingUtil.getPropertyName(getter);
+    this.indexName = MappingUtil.getIndexName(getter);
+    this.caseSensitiveIndex = MappingUtil.caseSensitiveIndex(getter);
 
-	public HelenusMappingProperty(HelenusMappingEntity entity, Method getter, Metadata metadata) {
-		this.entity = entity;
-		this.getter = getter;
+    this.columnInfo = new ColumnInformation(getter);
 
-		this.propertyName = MappingUtil.getPropertyName(getter);
-		this.indexName = MappingUtil.getIndexName(getter);
-		this.caseSensitiveIndex = MappingUtil.caseSensitiveIndex(getter);
+    switch (this.columnInfo.getColumnType()) {
+      case PARTITION_KEY:
+      case CLUSTERING_COLUMN:
+        this.idempotent = true;
+        break;
+      default:
+        this.idempotent = MappingUtil.idempotent(getter);
+    }
 
-		this.columnInfo = new ColumnInformation(getter);
+    this.genericJavaType = getter.getGenericReturnType();
+    this.javaType = getter.getReturnType();
+    this.abstractJavaType = MappingJavaTypes.resolveJavaType(this.javaType);
 
-		this.genericJavaType = getter.getGenericReturnType();
-		this.javaType = getter.getReturnType();
-		this.abstractJavaType = MappingJavaTypes.resolveJavaType(this.javaType);
+    this.dataType =
+        abstractJavaType.resolveDataType(
+            this.getter, this.genericJavaType, this.columnInfo.getColumnType(), metadata);
 
-		this.dataType = abstractJavaType.resolveDataType(this.getter, this.genericJavaType,
-				this.columnInfo.getColumnType(), metadata);
+    this.validators = MappingUtil.getValidators(getter);
+  }
 
-		this.validators = MappingUtil.getValidators(getter);
-	}
+  @Override
+  public HelenusEntity getEntity() {
+    return entity;
+  }
 
-	@Override
-	public HelenusEntity getEntity() {
-		return entity;
-	}
+  @Override
+  public Class<?> getJavaType() {
+    return (Class<?>) javaType;
+  }
 
-	@Override
-	public Class<?> getJavaType() {
-		return (Class<?>) javaType;
-	}
+  @Override
+  public AbstractDataType getDataType() {
+    return dataType;
+  }
 
-	@Override
-	public AbstractDataType getDataType() {
-		return dataType;
-	}
+  @Override
+  public ColumnType getColumnType() {
+    return columnInfo.getColumnType();
+  }
 
-	@Override
-	public ColumnType getColumnType() {
-		return columnInfo.getColumnType();
-	}
+  @Override
+  public int getOrdinal() {
+    return columnInfo.getOrdinal();
+  }
 
-	@Override
-	public int getOrdinal() {
-		return columnInfo.getOrdinal();
-	}
+  @Override
+  public OrderingDirection getOrdering() {
+    return columnInfo.getOrdering();
+  }
 
-	@Override
-	public OrderingDirection getOrdering() {
-		return columnInfo.getOrdering();
-	}
+  @Override
+  public IdentityName getColumnName() {
+    return columnInfo.getColumnName();
+  }
 
-	@Override
-	public IdentityName getColumnName() {
-		return columnInfo.getColumnName();
-	}
+  @Override
+  public Optional<IdentityName> getIndexName() {
+    return indexName;
+  }
 
-	@Override
-	public Optional<IdentityName> getIndexName() {
-		return indexName;
-	}
+  @Override
+  public boolean caseSensitiveIndex() {
+    return caseSensitiveIndex;
+  }
 
-	@Override
-	public boolean caseSensitiveIndex() {
-		return caseSensitiveIndex;
-	}
+  @Override
+  public boolean isIdempotent() {
+    return idempotent;
+  }
 
-	@Override
-	public String getPropertyName() {
-		return propertyName;
-	}
+  @Override
+  public String getPropertyName() {
+    return propertyName;
+  }
 
-	@Override
-	public Method getGetterMethod() {
-		return getter;
-	}
+  @Override
+  public Method getGetterMethod() {
+    return getter;
+  }
 
-	@Override
-	public Optional<Function<Object, Object>> getReadConverter(SessionRepository repository) {
+  @Override
+  public Optional<Function<Object, Object>> getReadConverter(SessionRepository repository) {
 
-		if (readConverter == null) {
-			readConverter = abstractJavaType.resolveReadConverter(this.dataType, repository);
-		}
+    if (readConverter == null) {
+      readConverter = abstractJavaType.resolveReadConverter(this.dataType, repository);
+    }
 
-		return readConverter;
-	}
+    return readConverter;
+  }
 
-	@Override
-	public Optional<Function<Object, Object>> getWriteConverter(SessionRepository repository) {
+  @Override
+  public Optional<Function<Object, Object>> getWriteConverter(SessionRepository repository) {
 
-		if (writeConverter == null) {
-			writeConverter = abstractJavaType.resolveWriteConverter(this.dataType, repository);
-		}
+    if (writeConverter == null) {
+      writeConverter = abstractJavaType.resolveWriteConverter(this.dataType, repository);
+    }
 
-		return writeConverter;
-	}
+    return writeConverter;
+  }
 
-	@Override
-	public ConstraintValidator<? extends Annotation, ?>[] getValidators() {
-		return validators;
-	}
+  @Override
+  public ConstraintValidator<? extends Annotation, ?>[] getValidators() {
+    return validators;
+  }
 
-	@Override
-	public String toString() {
+  @Override
+  public String toString() {
 
-		StringBuilder str = new StringBuilder();
+    StringBuilder str = new StringBuilder();
 
-		String columnName = this.getColumnName().getName();
-		str.append("  ");
-		str.append(this.getDataType());
-		str.append(" ");
-		str.append(this.getPropertyName());
-		str.append("(");
-		if (!columnName.equals(this.getPropertyName())) {
-			str.append(columnName);
-		}
-		str.append(") ");
+    String columnName = this.getColumnName().getName();
+    str.append("  ");
+    str.append(this.getDataType());
+    str.append(" ");
+    str.append(this.getPropertyName());
+    str.append("(");
+    if (!columnName.equals(this.getPropertyName())) {
+      str.append(columnName);
+    }
+    str.append(") ");
 
-		ColumnType type = this.getColumnType();
+    ColumnType type = this.getColumnType();
 
-		switch (type) {
+    switch (type) {
+      case PARTITION_KEY:
+        str.append("partition_key[");
+        str.append(this.getOrdinal());
+        str.append("] ");
+        break;
 
-			case PARTITION_KEY :
-				str.append("partition_key[");
-				str.append(this.getOrdinal());
-				str.append("] ");
-				break;
+      case CLUSTERING_COLUMN:
+        str.append("clustering_column[");
+        str.append(this.getOrdinal());
+        str.append("] ");
+        OrderingDirection od = this.getOrdering();
+        if (od != null) {
+          str.append(od.name().toLowerCase()).append(" ");
+        }
+        break;
 
-			case CLUSTERING_COLUMN :
-				str.append("clustering_column[");
-				str.append(this.getOrdinal());
-				str.append("] ");
-				OrderingDirection od = this.getOrdering();
-				if (od != null) {
-					str.append(od.name().toLowerCase()).append(" ");
-				}
-				break;
+      case STATIC_COLUMN:
+        str.append("static ");
+        break;
 
-			case STATIC_COLUMN :
-				str.append("static ");
-				break;
+      case COLUMN:
+        break;
+    }
 
-			case COLUMN :
-				break;
-
-		}
-
-		Optional<IdentityName> idx = this.getIndexName();
-		if (idx.isPresent()) {
-			str.append("index(").append(idx.get().getName()).append(") ");
-		}
-
-		return str.toString();
-	}
+    Optional<IdentityName> idx = this.getIndexName();
+    if (idx.isPresent()) {
+      str.append("index(").append(idx.get().getName()).append(") ");
+    }
 
+    return str.toString();
+  }
 }