Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
.settings updated eclipse project files
docs CMP-890
lib CMP-919 JacksonContentConverter doesn't work with current Jackson rel…
samples CMP-874 Change all DTD and schema files from 2.2 version to 2.3 version
src/main CMP-363 ability to specify schema in db2
.classpath CMP-363 ability to specify schema in db2
build.xml CMP-909 Downloadable is missing a…
compass.iml initial support for Datanuclues JPA
compass.ipr CMP-919 JacksonContentConverter doesn't work with current Jackson rel…
pom.xml.template CMP-848 Upgrade to Lucene 2.4.1 (from 2.4.0) CMP-889 fixing compass-manifest-version value
readme.txt Change Mx notation to BETAx notation
release.txt releasing 2.1.0 M1
running-tests.txt more schema configuration support
upgrade.txt Change Mx notation to BETAx notation


COMPASS, Release 2.3.0 beta 1


Compass is a powerful, transactional Object to Search Engine Mapping (OSEM) Java framework. 
Compass allows you to declaratively map your Object domain model to the underlying Search Engine, 
synchronizing data changes between Index and different datasources. Compass provides a high level 
abstraction on top of the Lucene low level API. Compass also implements fast index operations and 
optimization and introduces transaction capabilities to the Search Engine.


Compass requires J2SE 1.4 and (optionally) J2EE 1.3 (Servlet 2.3, JSP 1.2, JTA 1.0, EJB 2.0). 
JDK 1.5 is required for building Compass.

Integration is provided with Log4J 1.2, Hibernate 2.1/3.0/3.1, JDO 1.0/2.0, JPA 1.0, Apache OJB 1.0, 
iBATIS SQL Maps 2.0/2.1, Spring 1.2/2.0 .

Release contents:
* "src" contains the Java source and test files for Compass
* "dist" contains various Compass distribution jar files
* "lib" contains all third-party libraries needed for running the samples and/or building compass
* "docs" contains general documentation and API javadocs
* "samples" contains demo applications and skeletons

The "lib" directory is just included in the "-with-dependencies" download. Make sure to download this full
distribution ZIP file if you want to run the sample applications and/or build compass yourself.
Ant build scripts for compass and the samples are provided. The standard samples can be built with
the included Ant runtime by invoking the corresponding "build.bat" files (see samples subdirectories).

Latest info is available at the public website:

Compass is released under the terms of the Apache Software License (see license.txt).
All libraries included in the "-with-dependencies" download are subject to their respective licenses.
This product includes software developed by the Apache Software Foundation (
This product includes software developed by Clinton Begin (


The "dist" directory contains the following distinct jar files for use in applications. The "compass.jar"
is the full Java 1.5 compass jar. The "compass14.jar" is a retro translated jar file supporting Java 1.4. 


Documentation can be found in the "docs" directory:
* the Compass reference documentation

Documented sample applications and skeletons can be found in "samples":
* library
* petclinic
Something went wrong with that request. Please try again.