Achilles is an open source Persistence Manager for Apache Cassandra. Among all the features:

• Advanced bean mapping (compound primary key, composite partition key, timeUUID...)
• Display of DML scripts & DDL statements
• JUnit @Rule with embedded Cassandra server for productive development
• Native collections and map support
• Advanced queries (slice, native or typed)
• Native support for counters
• Runtime setting of consistency level, ttl and timestamp
• Batch mode for atomic commits in next major release (along side with migration to Cassandra 2.0)
• Dirty check and lazy loading
• And more to come ...

To use Achilles, just add the following dependency in your pom.xml:

For CQL version:

<dependency>	
	<groupId>info.archinnov</groupId>
	<artifactId>achilles-cql</artifactId>
	<version>2.0.8</version>
</dependency>  

Warning!!! The Thrift version is experimental and will be dropped in the next major release. Please migrate to CQL3

For Thrift version:

<dependency>	
	<groupId>info.archinnov</groupId>
	<artifactId>achilles-thrift</artifactId>
	<version>2.0.8</version>
</dependency> 

For now, Achilles depends on the following libraries:

1. cassandra 1.2.8
2. cassandra-driver-core 1.0.2 for the CQL version
3. hector-core 1.1-4 for the Thrift version
4. CGLIB nodep 2.2.2 for proxy building
5. Jackson asl, mapper & xc 1.9.3

To boostrap quickly with Achilles, you can check the 5 minutes tutorial

To be productive quickly with Achilles. Most of useful examples are given in the Quick Reference

To get a deeper look on how you can use Achilles, check out the Twitter Demo application and read the Advanced Tutorial section

All the documentation and tutorial is available in the Wiki

Copyright 2012 DuyHai DOAN

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this application 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.

• 2.0.8:

  • Provide an HTML client (AngularJS) for the Twitter Demo
  • Fixes #34 When it is impossible to call a setter on an entity, Achilles should report a better error
  • BREAKING CHANGE stop importing JPA jar. The number of annotations used (5) does not worth pulling JPA dependencies
  • Add custom Jackson serializer & deserializer on Counter interface to fix issue during serialization when CounterImpl is present
  • Rework on ResourceBuilder for JUnit

• 2.0.7:

  • BREAKING CHANGE Rename all xxEntityManagerxx to xxPersistenceManagerxx
  • Fixes #30 Create partition row key
  • BREAKING CHANGE Remove join feature. Is usage is not relevant enough in real use-cases
  • Fixes #29 [All] Separate Achilles annotations and custom types in a dedicated achilles-model Maven module
  • Allow injection of CQL3 cluster and session object into CQLEntityManagerFactory
  • Fixes #27 [CQL] Cannot map compound primary key from CQL resulset back to entity for typed queries
  • Fixes #25 [CQL] Introduce new @TimeUUID annotation to translate into timeuuid in Cassandra enhancement
  • Fix #26 Lift the constraint on mandatory "entityPackages" parameters and mandatory entity class to bootstrap Achilles in CQL3
  • Fixes #13 Redesign collections & map impl to match the one used in CQL3
  • Add Eclipse cleanUp, codeTemplates and formatter for contributors

• 2.0.6:

  • Add cleaning of embedded Cassandra data files before launching the server in JUnit rule
  • Upgrade to Hector 1.1-4 for Achilles Thrift

• 2.0.5:

  • Minor refactor for embedded Cassandra server and test resources
  • Display bound values in DML debug messages for bound statements
  • Introduce Options to simplify setting of TTL and Timestamp
  • Force initialization of counter type when calling initialize()
  • Bug with bi-directional relation with a cascade persist/merge and 'achilles.consistency.join.check' option set to true

• 2.0.4:

  • Migrate to Cassandra 1.2.8
  • Fix NPE when no join entity in collection/map for CQL
  • Remove Cassandra Unit library to avoid dependency on Hector for CQL version
  • Add Cassandra Embedded server. Add JUnit rule to bootstrap Cassandra embedded server and Achilles together

• 2.0.3:

  • Fix buggy implementation of FactoryBean for Spring integration
  • Fix bug in decoding enums for Slice Queries

• 2.0.2:

  • Internal refactoring of PropertyMeta
  • Support for value-less entities
  • Remove @CompoundKey annotation, un-used

• 2.0.1:

  • Add Spring Integration for CQL
  • Add new parameters for CQLEntityManagerFactory
  • Enhance SliceQueryBuilder API
  • Fix bug on Thrift clustered entity validation
  • Fix small bug on CQL RawTyped queries

• 2.0.0:

  • Official support for CQL3. See docs for more details
  • Remove custom Pair type, use the one provided by Cassandra
  • Fixes bug during entities parsing when List/Set/Map have parameterized typse
  • Add removeById() to EntityManager to avoid read-before-write pattern
  • BREAKING CHANGE, removal of WideMap<K,V> structure because its use cases are not consistent
  • Add DML logs to display CQL statements at runtime
  • Serialize enum types using name()
  • BREAKING CHANGE, removal of @WideRow annotation, replaced by clustered entities and slice queries for getting data (see doc for more details) .

• 1.8.2:

  • Support immutability for @CompoundKey classes (Issue #5). See doanduyhai#5 (comment) for more details on new syntax
  • BREAKING CHANGE, for @CompoundKey, enum types are serialized as String instead of Object (Issue #8)
  • BREAKING CHANGE, replace @Key(order=1) by @Order(1) annotation (Issue #6)
  • Throw Exception instead of having NPE when keyspace is not created in Cassandra (Issue #10)
  • BREAKING CHANGE, replace MultiKeyinterface by @CompoundKey annotation (Issue #15)
  • It is no longer required to implements Serializableon all entities (Issue #11)
  • Enforce consistency im ThriftImpl on persist() by removing all row data first (Issue #14 & Issue #7)
  • Add timestamp meta data to KeyValye<K,V> type (Issue #9)
  • Add initAndUnwrap() shortcut to EntityManager (Issue #2)
  • Fix bug on dirty check on join collection/map

• 1.8.1:

  • Add TTL to persist and merge operations
  • Rework of runtime consistency level
  • Fix small bug in the Column Family comment for wide rows
  • BREAKING CHANGES simplify PropertyType byte flag for Thrift persistence layer. Need data migration
  • Rename 'unproxy' to 'unwrap'
  • Fix bug with cyclic join entities during merge and persist operations
  • Fix buggy property removal after merging
  • Ignore un-mapped properties instead of raising exception
  • Renamming in core package
  • Upgrade to Cassandra 1.2.4

• 1.8.0:

  • Use the org.reflections.reflections package for entity parsing
  • Split the project into 3 modules: core, thrift and cql

• 1.7.3:

  • Rework of em.getReference() to avoid hitting the database
  • Refactor generics
  • Migrate to JPA 2

• 1.7.2:

  • Add commons-collections 3.2.1 to compile dependency
  • Enhance error message for entity mapping
  • Fix bug about default consistency level hard-coded to QUORUM for WideMap and Counters
  • Add firstFirstMatching() and findLastMatching() to the WideMap API
  • Fix bug. Do not load join entity if no join primary keys

• 1.7.1: fix bug because key validation class & comparator type has changed from Cassandra 1.1 to 1.

• 1.7: stable release