Apache Jackrabbit简介及入门

拼搏现实的明天。 2022-12-30 12:59 255阅读 0赞

### 文章目录 ###

*   *  1.什么是JCR
     *   *   *  1.1 JCR 是什么
             *  1.2 JCR的内容仓库模型
     *  2.什么是Jackrabbit
     *  3.使用Jackrabbit
     *   *   *  3.1 配置Jackrabbit环境
             *  3.2使用Jackrabbit

## 1.什么是JCR ##

#### 1.1 JCR 是什么 ####

**Java Content Repository API（JSR-170）试图建立一套标准的API去访问内容仓库。**  
内容仓库可以理解为一个用来存储文本和二进制数据（图片，word文档，PDF等等）的数据存储应用程序。  
 你不用关心你真正的数据到底存储在什么地方，是关系数据库？是文件系统？还是XML？  
 通过JSR-170，你开发代码只需要引用 javax.jcr.\* 这些类和接口。它适用于任何兼容JSR-170规范的内容仓库。

JSR-170 API对不同的人员提供了不同的好处

*  对于开发者无需了解厂家的仓库特定的API，只要兼容JSR-170就可以通过JSR-170访问其仓库。
 *  对于使用CMS的公司则无需花费资金用于在不同种类CMS的内容仓库之间进行转换。
 *  对于CMS厂家，无需自己开发内容仓库，而专注于开发CMS应用。

#### 1.2 JCR的内容仓库模型 ####

*  JCR的内容仓库是一个树状结构
 *  树上的元素（Item）分为两类：节点（node）和属性（property）。
 *  1个节点：有且只有一个父亲，有任意数目的孩子（子节点）和任意数目的属性。
 *  1个属性：有且只有一个父亲（节点），它没有子节点，由一个名字和一个或多个值组成。
 *  属性值的类型可以是：布尔（Boolean）、日期（Date）、双精度（Double）、长整型（Long）、字符串（String）或流（Stream）。
 *  属性可以被用来存储信息，节点则被用来创建树内部的“路径”（类似文件系统的结构，节点是目录，属性是实际的文件）  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNTk2NTY4_size_16_color_FFFFFF_t_70_pic_center]  
     由于JCR的节点和属性具有很多相同的特性，因此它们都实现了Item接口中定义的通用方法，此外它们还添加了各自特有的功能方法。下图是JCR树状数据存储模型的UML结构图  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNTk2NTY4_size_16_color_FFFFFF_t_70_pic_center 1]

除了 Node 和 Property 之外，API中还有几个重要的对象。Repository 代表整个内容仓库，Credentials 代表一个用户身份，Ticket 代表进入该内容仓库的门票。

## 2.什么是Jackrabbit ##

JackRabbit就是一种面向文档的数据库，它和MongoDB，CouchDB的功能十分接近，优势在于JackRabbit遵从JCR标准，日后可以迁移到其他同样兼容JCR的性能更好的商业解决方案上。  
 Jackrabbit（内容仓库）是一个高级的信息管理系统，该系统是传统的数据仓库的扩展，它提供了诸如版本控制、全文检索、访问控制、内容分类、内容事件监视等内容服务。Jackrabbit里面有一个DataStore类，该类有两个实现，DbDataStore和FileDataStore，可以保存元数据和二进制数据。

## 3.使用Jackrabbit ##

#### 3.1 配置Jackrabbit环境 ####

1.  引入依赖

<dependencies> 
         
        <dependency> 
            <groupId>javax.jcr</groupId> 
            <artifactId>jcr</artifactId> 
            <version>2.0</version> 
        </dependency> 
    
         
        <dependency> 
            <groupId>org.apache.jackrabbit</groupId> 
            <artifactId>jackrabbit-core</artifactId> 
            <version>2.12.1</version>
        </dependency> 
    
         
        <dependency> 
            <groupId>org.slf4j</groupId> 
            <artifactId>slf4j-log4j12</artifactId> 
            <version>1.5.11</version> 
        </dependency> 
    </dependencies>

1.  配置仓库repository.xml

<?xml version="1.0" encoding="ISO-8859-1"?>
    <Repository>
        <FileSystem
                 class="org.apache.jackrabbit.core.fs.local.LocalFileSystem">
            <param name="path" value="${rep.home}/repository"/>
        </FileSystem>
        <Security appName="Jackrabbit">
            <AccessManager
                     class="org.apache.jackrabbit.core.security.
                             SimpleAccessManager"/>
        </Security>
        <Workspaces
                 rootPath="${rep.home}/workspaces"
                         defaultWorkspace="default" />
        <Workspace name="${wsp.name}">
            <FileSystem
                     class="org.apache.jackrabbit.core.fs.local.
                             LocalFileSystem">
                <param name="path" value="${wsp.home}"/>
            </FileSystem>
            <PersistenceManager
                class="org.apache.jackrabbit.core.state.xml.
                         XMLPersistenceManager" />
            <SearchIndex
                     class="org.apache.jackrabbit.core.query.lucene.
                             SearchIndex">          
                <param name="path" value="${wsp.home}/index" />
            </SearchIndex>
        </Workspace>
        <Versioning rootPath="${rep.home}/versions">
            <FileSystem
                     class="org.apache.jackrabbit.core.fs.local.
                             LocalFileSystem">
                <param name="path" value="${rep.home}/versions"/>
            </FileSystem>
            <PersistenceManager
                class="org.apache.jackrabbit.core.state.xml.
                         XMLPersistenceManager" />
        </Versioning>
    </Repository>

1.  初始化仓库

String configFile = "repository.xml";
    String repHomeDir = "repository";
     
    Hashtable env = new Hashtable();
             env.put(Context.INITIAL_CONTEXT_FACTORY,
                     "org.apache.jackrabbit.core.jndi" +
                     ".provider.DummyInitialContextFactory");
     
    env.put(Context.PROVIDER_URL, "localhost");
     
    InitialContext ctx = new InitialContext(env);
     
    RegistryHelper.registerRepository(ctx,
             "repo",
             configFile,
             repHomeDir,
             true);
     
    Repository r = (Repository) ctx.lookup("repo");

1.  登陆（需要以管理员的身份登陆，否则很多操作都没有权限，默认用户名和密码都是admin）

Session session = repository.login( 
            new SimpleCredentials("admin", "admin".toCharArray()));

1.  注册工作区命名空间（非必须）

// 注册命名空间
    Workspace ws = session.getWorkspace();

#### 3.2使用Jackrabbit ####

1.  简单的CRUD操作

public static void main(String[] args) throws Exception {
         
        Repository repository = JcrUtils.getRepository();
            Session session = repository.login( 
            new SimpleCredentials("admin", "admin".toCharArray()));
            try {
         
                Node root = session.getRootNode(); 
    
                // 存储内容 
                Node hello = root.addNode("hello"); 
                Node world = hello.addNode("world"); 
                world.setProperty("message", "Hello, World!"); 
                session.save(); 
    
                // 检索内容
                Node node = root.getNode("hello/world"); 
                System.out.println(node.getPath()); 
                System.out.println(node.getProperty("message").getString()); 
    
                // 删除内容 
                root.getNode("hello").remove(); 
                session.save(); 
            } finally {
         
                session.logout(); 
            } 
        }

1.  将xml文件存入

public static void main(String[] args) throws Exception {
         
            Repository repository = JcrUtils.getRepository();
                Session session = repository.login( 
                new SimpleCredentials("admin", "admin".toCharArray()));
                try {
         
                    Node root = session.getRootNode(); 
    
                    // 导入XML文件，除非已经导入
                    if (!root.hasNode("importxml")) {
         
                        System.out.print("Importing xml... "); 
    
                        // 创建一个node在其下导入XML
                        Node node = root.addNode("importxml", "nt:unstructured"); 
    
                        // 将文件“ test.xml”导入到创建的节点下
                        FileInputStream xml = new FileInputStream("test.xml");
                        session.importXML( 
                        node.getPath(), xml, ImportUUIDBehavior.IMPORT_UUID_CREATE_NEW); 
                        xml.close();
                        session.save(); 
                        System.out.println("done."); 
                    } 
    
                    //输出存储库内容
                    dump(root); 
                } finally {
         
                    session.logout(); 
                } 
            }

1.  输入存储内容

private static void dump(Node node) throws RepositoryException {
         
            // 首先输出节点路径
            System.out.println(node.getPath()); 
            // 跳过这个虚拟子树
            if (node.getName().equals("jcr:system")) {
         
                return; 
            } 
    
            // 输出属性
            PropertyIterator properties = node.getProperties(); 
            while (properties.hasNext()) {
         
                Property property = properties.nextProperty(); 
                if (property.getDefinition().isMultiple()) {
         
                    // 多值属性，打印所有值
                    Value[] values = property.getValues(); 
                    for (int i = 0; i < values.length; i++) {
         
                        System.out.println( 
                        property.getPath() + " = " + values[i] .getString()); 
                    } 
                } else {
         
                    // 单值属性
                    System.out.println( 
                    property.getPath() + " = " + property.getString()); 
                } 
            } 
    
            // 最后以递归方式输出所有子节点
            NodeIterator nodes = node.getNodes(); 
            while (nodes.hasNext()) {
         
                dump(nodes.nextNode()); 
            } 
        }

参考文章  
[Jackrabbit的来源][Jackrabbit]  
[Apache Jackrabbit学习][Apache Jackrabbit]  
[Apache Jackrabbit入门][Apache Jackrabbit 1]  
[Java Content Repository API 简介][Java Content Repository API]  
[Apache Jackrabbit官方文档][Apache Jackrabbit 2]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNTk2NTY4_size_16_color_FFFFFF_t_70_pic_center]: /images/20221120/24e0e34332a44d3fad1d188849026417.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNTk2NTY4_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221120/f43b6da25e7a47dd80ec630ed7988a11.png
[Jackrabbit]: https://www.cnblogs.com/wangchunlan1299/p/7716732.html
[Apache Jackrabbit]: https://blog.csdn.net/blog_szhao/article/details/29592503
[Apache Jackrabbit 1]: https://blog.csdn.net/iteye_13094/article/details/82297964
[Java Content Repository API]: https://www.ibm.com/developerworks/cn/java/j-jcr/
[Apache Jackrabbit 2]: http://jackrabbit.apache.org/jcr/index.html