Jackrabbit独立服务器

以下内容来自jackrabbit官方文档
官方跳转链接:独立服务器.
独立服务器
每个Jackrabbit版本都附带一个预构建的且可运行的独立服务器jar。
这是开始使用Jackrabbit的最简单方法,只需下载并启动jar,即可获得功能齐全的JCR内容存储库。
该页面的其余部分介绍了独立服务器可以执行的其他操作。
运行独立服务器
您需要Java版本5或更高版本才能运行Jackrabbit独立服务器。
要启动服务器,请双击独立的jar文件,或在命令行上调用它。

$ java -jar jackrabbit-standalone-1.6.0.jar
Welcome to Apache Jackrabbit!
-------------------------------
Using repository directory jackrabbit
Writing log messages to jackrabbit/log
Starting the server...
Apache Jackrabbit is now running at http://localhost:8080/
^C
Shutting down the server...
-------------------------------
Goodbye from Apache Jackrabbit!

启动服务器后,可以将浏览器指向http:// localhost:8080 /,以查看Jackrabbit的运行情况。
如果默认端口8080已被另一个程序使用,请使用–port命令行选项指定其他选项。
这是服务器在浏览器中的外观:
Jackrabbit独立服务器_第1张图片
默认情况下,服务器将在./jackrabbit目录中查找内容存储库,并在存储库目录内的repository.xml文件中搜索存储库配置文件。
如果存储库目录不存在,则会自动创建该目录,如果找不到配置,则会创建具有默认配置的配置文件。
服务器,访问和存储库日志消息将写入存储库目录内log子目录中的日志文件。
您可以通过按Ctrl-C或发送标准终止信号来停止服务器。
然后,服务器将关闭内容存储库并干净地退出。
命令行选项
您可以使用以下命令行选项(括号内为默认值)来自定义独立服务器的操作。

$ java -jar jackrabbit-standalone-1.6.0.jar --help
usage: java -jar jackrabbit-standalone-1.6.0.jar [-?][-b][-c ][-C ]
       [-d][-f ][-h ][-l][-n][-p ][-q][-r ][-R ]

options:
 -?,--help              print this message
 -b,--backup            create a backup of the repository
 -c,--conf         repository configuration file
 -C,--backup-conf  backup repository configuration file
 -d,--debug             enable debug logging
 -f,--file         location of this jar file
 -h,--host         IP address of the HTTP server
 -l,--license           print license information
 -n,--notice            print copyright notices
 -p,--port         TCP port of the HTTP server (8080)
 -q,--quiet             disable console output
 -r,--repo         repository directory (jackrabbit)
 -R,--backup-repo  backup repository directory (jackrabbit-backupN)

您可能希望增加可用于Java虚拟机的最大堆内存量,尤其是当您计划有大量并发客户端访问存储库或要执行大型批处理操作时。

$ java -Xmx256m -jar jackrabbit-standalone-1.6.0.jar

网页界面
您在http:// localhost:8080 /上看到的Web界面是一个基于内容存储库顶部的简单Web应用程序。
它包含有关如何访问存储库的一些基本说明,并带有以下实用工具:

  • 填充http:// localhost:8080 / populate.jsp
    该工具使用基于Google搜索的网络上的示例文档填充默认工作空间。
    这是将一些半随机测试内容放入存储库的简便方法。
  • 搜索http:// localhost:8080 / search.jsp
    该工具使用全文本搜索功能在存储库的默认工作空间中查找内容。
    要查看运行中的搜索功能,请首先使用“填充”工具向存储库中添加一些内容,然后尝试使用“搜索”工具搜索文档。
  • 浏览http:// localhost:8080 / repository / default /
    内置的WebDAV功能使您可以浏览存储库中的文件(nt:file)和文件夹(nt:folder)节点。
    有关使用此工具可以执行的所有其他操作,请参见下面的WebDAV部分!
    请注意,服务器默认情况下将接受任何用户名和密码组合。

WebDAV访问
您可以在http:// localhost:8080 / repository / default /上看到的简单存储库浏览器实际上是由内容存储库支持的功能齐全的WebDAV服务器。
您可以将该地址作为WebDAV共享安装到普通文件系统,并像对待任何共享网络文件夹一样对待它。
此功能对于将大量文件或文件夹复制到存储库或从存储库复制特别有用。
请注意,此功能仅限于标准文件和文件夹,任何更细粒度的JCR内容将根本不可见。
该存储库还在http:// localhost:8080 / server /处公开了另一个WebDAV访问点,以实现更细粒度的内容访问。
此访问点实现了许多高级WebDAV功能,这些功能通常在基于普通文件的WebDAV服务器中不常见。
您将需要功能丰富的WebDAV或HTTP客户端来访问此接口的全部功能。
使用Jackrabbit spi2dav组件,您甚至可以通过WebDAV功能获得完全的远程JCR访问,并可以通过此访问点获得一些自定义扩展。

RMI访问
除了WebDAV访问点之外,独立服务器还支持通过RMI进行远程JCR访问。
在将JCR API和jackrabbit-jcr-rmi jar添加到类路径之后,您可以使用以下代码远程访问存储库:

import org.apache.jackrabbit.rmi.repository.URLRemoteRepository;
Repository repository = new URLRemoteRepository("http://localhost:8080/rmi");

备份和迁移
您也可以使用独立服务器jar备份现有存储库,或将其迁移到其他配置。
备份模式通过–backup命令行选项激活。
备份模式的基本命令行选项及其默认值为:

$ java -jar jackrabbit-standalone-1.6.0.jar --backup \
       --repo jackrabbit \
       --conf jackrabbit/repository.xml \
       --backup-repo jackrabbit-backupN \
       --backup-conf jackrabbit-backupN/repository.xml

请注意,使用此功能时,源存储库一定不能运行。
如果目标存储库已经存在,则覆盖其中的所有内容。
还要注意,仅在下一次启动存储库时才会生成目标存储库的搜索索引。
这样可以使备份的磁盘大小更小,但是如果需要还原该备份,则会导致明显的启动延迟,尤其是对于大型存储库。
要将存储库迁移到其他配置,只需将–backup-conf选项指向自定义存储库配置文件。
请注意,默认情况下,备份是使用默认的Jackrabbit存储库配置进行的,而不管源存储库的配置如何。

缺点
Jackrabbit独立服务器的设计主要是为了快速,轻松地启动和运行内容存储库以用于测试和开发目的。
对于更复杂的部署方案和配置选项,您应该查看Jackrabbit Web应用程序和Jackrabbit JCA资源适配器软件包。
还要注意,RMI远程处理层尚未针对性能进行优化,因此,当前建议在性能关键的应用程序中访问JCR API的地方是使存储库在本地运行,与客户端应用程序在同一进程中。

你可能感兴趣的:(jackrabbit)