jackrabbit官方英文文档加补充(转载）

关于Jackrabbit

To get started with Jackrabbit you should first become familiar with the JCR API. Download the JSR 170 specification, browse the API documentation, check our introduction to JCR levels, or read some of the JCR articles to understand the content repository model that Jackrabbit implements. You can also take a look at the various JCR and Jackrabbit applications to get an idea of what to do with a content repository.

jackRabbit是一个符合JCR2.0 JSR170和JSR283规范;基于java JCR API的开源内容存储库，提供了如版本控制、全文检索，访问控制，内容分类、内容事件监视等内容服务.

2 例子

import javax.jcr.Repository;

import javax.jcr.Session;

import org.apache.jackrabbit.core.TransientRepository;

public class FirstHop {

public static void main(String[] args) throws Exception {

Repository repository = new TransientRepository();//获得一个库实例

Session session = repository.login();//获得一个登陆的session实例

try {

String user = session.getUserID();

String name = repository.getDescriptor(Repository.REP_NAME_DESC);

System.out.println(

"Logged in as " + user + " to a " + name + " repository.");

} finally {

session.logout();

}

}

}

3 总体架构

jackRabbit总体架构分为三个部分：
1、内容应用（内容库API与JCR API相互配合而成）
2、内容库API 
3、内容库实现（主要基于JCR API）
总体架构图可以通过官方文档查看。

JCR API主要包括如下内容：
   javax.jcr：提供内容库interfaces and classes的Java技术
   javax.jcr.lock：提供内容库锁功能的interfaces and classes 
   javax.jcr.nodetype：提供了内容库节点类型功能的interfaces and classes 
   javax.jcr.observation：提供了内容库事件观察功能的interfaces and classes 
   javax.jcr.query：提供了内容库搜索功能的interfaces and classes 
   javax.jcr.query.qom：提供了内容库对象查询模式的interfaces and classes 
   javax.jcr.retention：提供了内容库保留管理功能的interfaces and classes 
   javax.jcr.security：提供了内容库访问控制管理功能interfaces and classes 
   javax.jcr.util：提供了内容库实用工具类API 
   javax.jcr.version：提供了内容库版本功能的interfaces and classes

4  jackrabbit 如何工作

下图说明了jackRabbit是如何的工作!

所有的工作都是基于JCR API来操作的。包括有工作区（workSpace）、会话（Session）、缓存（Cache）、查询搜索（index）、持久存储（Persistence Store）。

5 组件简介

Jackrabbit分成多个组件，包括

Jackrabbit API　：包括标准API之外jackrabbit实现的扩展接口，可以使用这个API访问jackrabbit特定的功能；

Jackrabbit JCR Commons：包括使用JCR API时的一些公用类；

Jackrabbit JCR Tests：包括一组用以测试实现兼容性的测试案例；

Jackrabbit Core　：jackrabbit的实现核心；

Jackrabbit Text Extractors　：允许jackrabbit从二进制数据中抽取文本内容进行全文索引；

Jackrabbit JCR-RMI：允许远程访问内容存储库，这个组件适用于所有JCR实现；

Jackrabbit WebDAV Library　：提供了建立WebDAV服务器和客户端时所需的接口和公共服务类；

Jackrabbit JCR Server：包括两个基于WebDAV的JCR服务器实现；

Jackrabbit Web Application：提供servlet以访问Jackrabbit存储库；

Jackrabbit JCA Resource Adapter：将内容存储库作为JCA 1.0规范的资源适配器，这样就可以各种应用服务器中部署JCR；

Jackrabbit SPI　：定义一个分隔层，支持客户－服务器架构，减化JCR　API的实现。应用程序一般不会直接使用这个组件；

Jackrabbit SPI Commons：SPI公共类及部件接口的缺省实现；