Compass---Connection
Compass实例的唯一必要配置就是它的connection.
connection控制着索引将保存在那里，换一句话说就是索引的存储路径。
有下面几种存储方式：
1 文件系统存储
到目前为止，最受欢迎的而且是最简单的存储方法是在文件系统上保持索引，下面是一个基于connection配置的
简单文件系统例子，将索引保存在target/test-index路径下<compass name="default"><connection><file path="target/test-index"/></connection></compass>compass.engine.connection=file://target/test-index
?
?
?
?
另一种文件系统方法的配置是基于使用Java 1.4 NIO mmap特性
<compass name="default"><connection><mmap path="target/test-index"/></connection></compass>compass.engine.connection=mmap://target/test-index<compass name="default"><connection><niofs path="target/test-index"/></connection></compass>compass.engine.connection=niofs://target/test-index
?
2 随机存储
使用随机存储器的索引存储，索引数据可以保存在内存中。对于存储的代价来说，这样方便快速索引和搜索。
下面是配置的例子：
?
<compass name="default"><connection><ram path="/index"/></connection></compass>compass.engine.connection=ram://index
?
3 JDBC存储
JDBC存储connection类型允许索引数据保存到数据库中。保存索引的机制实际是模仿基于树的文件系统，子索引
表里的每行都代表着一个二进制数据的文件。
Compass实现，JdbCDirectory，它是建立在Lucene directory提取之上的，完全与其他的Compass解耦合，并且能够用于单纯的Lucene应用。当在Compass中使用时，它可以更简单地配置，尤其是事务管理和jdbc数据源管理方面。
下面是一个简单使用jdbc存储索引的例子，例子的配置是假定一个不变的配置，没有数据源池：
<compass name="default"><connection><jdbc><dataSourceProvider><driverManager url="jdbc:hsqldb:mem:test"username="sa" password=""driver/></dataSourceProvider></jdbc></connection></compass>
?
?
以上的配置在jdbc元素上没有定义方言属性。Compass将尝试自动检测基于数据库元数据的数据库方言，如果检测
失败，方言将被设置，在我们的例子里，它应该是
dialect="org.apache.lucene.store.jdbc.dialect.HSQLDialect".
(1)管理环境
当达到一个jdbc索引存储的时候了解Compass是否工作在一个“受管理”的环境下是很重要的。一个管理环境是Compass不能控制事务管理的环境。如果Compass可以控制事务，比如说是有本地事务工厂，它就不会被认为是一个管理环境。
??? 如果工作在一个无管理环境下，Compass将会用ransactionAwareDataSourseProxy封装数据源，并且可以提交/回滚 jdbc 连接。当工作在一个管理环境下，不会出现封装，并且Compass将会让外部事务管理者去提交/回滚 连接。
??? 通常，并不是总是，当工作在一个管理环境下，jdbc数据源使用的是来自外部系统/配置。大多数情况下它会是JNDI或外部数据源提供者（比如说Spring）。
??? 默认情况下，Compass工作在非管理环境下，那么jdbc元素的managed属性应该设为true.
(2) 数据源提供者
Compass考虑到不同的jdbc数据源提供者。DataSourceProvider实现的职责是为了配置和提供一个jdbc数据源实例。当谈到性能，尤其是在共享特性的时候，数据源的实现是非常重要的。
???
??? 所有Compass支持的不同数据源都允许配置自动提交标志。自动提交有三个值：false,true和external(不要明确地设置自动提交，假定它已经在其他位置配置了)。自动提交模式的默认值是false并且是推荐值（external可以使用，但是必须确定将真实数据源设置为false）
?
a 驱动器管理器
所有提供者里最简单的，不需要任何外部的库或系统。主要的缺点是性能，因为它没有实现任何种类的共享。
b Jakarta Commons DBCP
? Compass能够使用Jakarta Commons DBCP作为数据源提供者配置，相对于驱动器管理提供者的性能而言，这是一个推荐的选择，下面是使用时的例子：
<compass name="default"><connection><jdbc><dataSourceProvider><dbcp url="jdbc:hsqldb:mem:test"username="sa" password=""drivermaxWait="5" maxIdle="2" initialSize="3" minIdle="4"poolPreparedStatements="true" /></dataSourceProvider></jdbc></connection></compass>
?
?
配置显示不同的设置可以用于dbcp数据源提供者，他们的值没有其他含义，是典型系统的推荐值，想获取更多信息，请查看Jakarta Commons DBCP文档。
c c3p0
Compass可以使用c3p0作为数据源配置，相对于驱动器管理的性能原因，她也是一个推荐的选择（你想使用它或上一节的Jakarta Commons DBCP），这取决于你，下面是使用例子：
<compass name="default"><connection><jdbc><dataSourceProvider><c3p0 url="jdbc:hsqldb:mem:test"username="testusername" password="testpassword"driver/></dataSourceProvider></jdbc></connection></compass>
?
?
c3p0数据源提供者将使用c3p0的ComboPooledDataSource,其他另外的设置可以使用c3p0.perperties文件设置，这个文件作为高级资源保存在同一个LASSPATH/classloader加载c3p0的jar文件的位置。请参考c3p0文档获取更多设置。
d JNDI
Compass也可以通过使用JNDI寻找数据源来配置,下面是使用的例子：
<compass name="default"><connection><jdbc><dataSourceProvider><jndi lookup="testds" username="testusername" password="testpassword" /></dataSourceProvider></jdbc></connection></compass>
?
?
jndi查找环境 ，包括java.naming.factory.initial和java.naming.provider.url的JDNI设置，可以配置在其他的jndi标签内，直接在Compass标签下面，注意，username和password用于数据源，而且是完全可选的。
e 外部
Compass可以使用ExteranlDataSourceProvider.类的外部数据源来配置，它使用java线程本地保存数据源为了之后数据源提供者使用。设置数据源在ExteranlDataSourceProvider上使用静态方法setDataSource(DataSource
dataSource)，下面是一个如何配置的例子：
<compass name="default"><connection><jdbc><dataSourceProvider><external username="testusername" password="testpassword"/></dataSourceProvider></jdbc></connection></compass>
?
?
?
注意，username和password是用于数据源的，而且是可选的。
?
?
?
还有一些，有时间补上
?
