Apache Jackrabbit入门

产品里需要包含一个文档（内容）管理的功能，找了一些开源的：

KnowledgeTree，Alfresco，OpenKM。
经过试用，相中了OpenKM的各种功能。
但是--公司的产品前台是swing（已经好多年了，不是我能改变的），而OpenKM是web的，如果直接嵌入（把浏览器嵌入swing中），登陆、权限控制等是个大问题，而且以后扩展起来也比较麻烦，后患无穷啊。。。
看了下介绍，OpenKM是基本Apache Jackrabbit引擎实现的，那我们能不能直接用Jackrabbit来做后台，swing做前台呢？
贴一段Apache Jackrabbit的简介，来自http://www.oschina.net/p/jackrabbit
Apache Jackrabbit 是由 Apache Foundation 提供的 JSR-170 的开放源码实现..

随着内容管理应用程序的日益普及，对用于内容仓库的普通、标准化 API 的需求已凸现出来。Content Repository for Java Technology API (JSR-170) 的目标就是提供这样一个接口。JSR-170 的一个主要优点是，它不绑定到任何特定的底层架构。例如，JSR-170 实现的后端数据存储可以是文件系统、WebDAV 仓库、支持 XML 的系统，甚至还可以是 SQL 数据库。此外，JSR-170 的导出和导入功能允许一个集成器在内容后端与 JCR 实现之间无缝地切换。

----------------------------------------------------------------------
注：上面说的JSR-170指jcr1.0，而现在已经是jsr283了--jcr2.0了

官方主页：
http://jackrabbit.apache.org/

Jackrabbit的资料相对比较少，就找到这么一篇比较详细的，但时间是2006年的，当时还是jcr1.0
http://www.ibm.com/developerworks/cn/java/j-jcr/

不管怎么样，试试吧。
下载2.4的源代码，maven2编译一下。

把jar包导入到新建的工程中。

然后根据文章说的，照猫画虎，折腾2个小时，终于搞定了。
过程：

1.初始化仓库。

 

// 初始化
        String configFile = "F:\\jackrabbit_repository\\repository.xml";
        String repHomeDir = "F:\\jackrabbit_repository\\repository";
        Hashtable<String, Object> env = new Hashtable<String, Object>();
        env.put(Context.INITIAL_CONTEXT_FACTORY,
                DummyInitialContextFactory.class.getName());
        env.put(Context.PROVIDER_URL, "localhost");
        InitialContext ctx = new InitialContext(env);
        RegistryHelper.registerRepository(ctx, "repo", configFile, repHomeDir,
                true);
        Repository r = (Repository) ctx.lookup("repo");

 2.登陆，这里注意一点，需要以管理员的身份登陆，否则很多操作都没有权限，默认用户名和密码都是admin

 

 Repository r = (Repository) ctx.lookup("repo");

        // 登陆
        SimpleCredentials cred = new SimpleCredentials("admin",
                "admin".toCharArray());
        Session session = r.login(cred, null);

 3.注册工作区命名空间

 

  // 根节点
        Node rn = session.getRootNode();

        // 注册命名空间
        Workspace ws = session.getWorkspace();
        ws.getNamespaceRegistry().registerNamespace("wiki",
                "http://localhost/wiki/1.0");

 4.增加内容。

 

Node encyclopedia = rn.addNode("wiki:encyclopedia");
        Node p = encyclopedia.addNode("wiki:entry");
        p.setProperty("wiki:title", toStringValue("rose"));
        p.setProperty("wiki:content",
                toStringValue("A rose is a flowering shrub."));
        p.setProperty("wiki:category", new Value[] { toStringValue("flower"),
                toStringValue("plant"), toStringValue("rose") });

        Node n = encyclopedia.addNode("wiki:entry");
        n.setProperty("wiki:title", toStringValue("Shakespeare"));
        n.setProperty("wiki:content",
                toStringValue("A famous poet who likes roses."));
        n.setProperty("wiki:category", toStringValue("poet"));
        // 保存
        session.save();

 可以看出，里面是以属性结构存储的，可以想象出修改和删除的操作了吧。

无非是root.getNode（），然后修改或者删除就可以了，当然，最后别忘了保存

5.看个查找的例子吧

 

 // 查找
        QueryManager qm = ws.getQueryManager();
        Query q = qm.createQuery(
                "//wiki:encyclopedia/wiki:entry[@wiki:title = 'rose']",
                Query.XPATH);// deprecated
        QueryResult result = q.execute();// 执行查询
        NodeIterator it = result.getNodes();
        // 然后就可以了遍历了
        while (it.hasNext()) {
            Node entry = it.nextNode();
            // 简单的输出，后面会有输出详细内容的方法
            System.out.println(entry.toString());
        }

 6。前面都是字符串的，如果想存文件怎么办？

大家注意到，setProperty有个String，InputStream参数的，对，就是它了。

 

// 加入文件
        File file = new File("f:\\2012-03-07_111233.png");
        MimeTable mt = MimeTable.getDefaultTable();
        String mimeType = mt.getContentTypeFor(file.getName());
        if (mimeType == null) {
            mimeType = "application/octet-stream";
        }
        Node fileNode = rn.addNode(file.getName(), "nt:file");
        Node resNode = fileNode.addNode("jcr:content", "nt:resource");
        resNode.setProperty("jcr:mimeType", mimeType);
        resNode.setProperty("jcr:encoding", "");
        // 这里--用流加入
        resNode.setProperty("jcr:data", new FileInputStream(file));

        Calendar lastModified = Calendar.getInstance();
        lastModified.setTimeInMillis(file.lastModified());
        resNode.setProperty("jcr:lastModified", lastModified);
        // 保存
        session.save();

 写完后，可以运行，但编译器警告：deprecated

那用什么代替呢？

查看了jcr2.0，使用setPropery(String,Binary)代替

 

Binary fileBinary = new BinaryImpl(new FileInputStream(file));
        resNode.setProperty("jcr:data", fileBinary);

 

7.由于是树形结构，我们可以递归打出所有的信息：

 

private static void printAll(Node node) throws RepositoryException {
        printFormat(node.toString());
        PropertyIterator propertys = node.getProperties();
        while (propertys.hasNext()) {
            Property entry = propertys.nextProperty();
            if (entry.isMultiple()) {
                Value[] values = entry.getValues();
                if (values == null) {
                    continue;
                }
                for (Value v : values) {
                    printFormat(v.getString());
                }
            } else {
                printFormat(entry.getValue().getString());
            }
        }

        NodeIterator entries = node.getNodes();
        while (entries.hasNext()) {
            Node entry = entries.nextNode();
            printAll(entry);
        }
    }

 

完整代码见附件

另外附件中的jcr2.0.jar就是jcr2.0的规范接口，编译后的 jackrabbit 是不带的（我找了好几个地方才找到）



由于目前最新版本已经使用了jcr2.0，所以有必要看一下2.0与1.0的区别：
API Differences between jcr-1.0 and jcr-2.0
http://www.day.com/maven/jdiff-jcr1-jcr2/changes.html