apache jackrabbit 实现 webdav 客户端怎么设置主体

Posted 2023-05-07

　　WebDAV 概述

　　WebDAV（Web Distributed Authoring and Versioning）是一种基于 HTTP 的通信协议，是对 HTTP 的一种扩展，它在 HTTP 协议的 GET、HEAD、POST 等方法的基础上添加了一些新的方法，使得用户可以通过客户端编辑和管理存储在远程的文件。这些方法包括 PROPFIND、PROPPATCH、MKCOL、COPY、MOVE、LOCK、UNLOCK 等方法。

　　顾名思义，WebDAV 关注的是创作（Authoring）和版本控制（Versioning）的功能，所以它在自己的协议（RFC 2518）里增加了文档属性、资源集合、锁、命名空间等概念和机制。

　　虽然 WebDAV 的最初是为了方便远程创作和版本管理，但有了以上机制和方法，WebDAV 经常用来和 FTP、SFTP 等网络传输协议进行对比，WebDAV 可以看作是对文件传输协议的一种补充和选择。由于使用的是 HTTP 的端口，WebDAV 可以方便地穿越防火墙。而且由于可以使用 HTTPS，WebDAV 在安全性上并不逊色于 SFTP。

　　WebDAV 在实际中已有广泛的应用。服务器方面，如 Apache HTTP Server 和 Microsoft IIS 上都可以找到 WebDAV 的身影。客户端方面，IBM Lotus、Microsoft Office 等办公自动化软件都可以通过 WebDAV 编辑远程的文档。

　　JCR 及 Apache Jackrabbit 简介

　　JCR 是 Content Repository for Java Technology API 的缩写，译为 Java 内容存储规范，其规范定义在 JSR170 和 JSR283，两者分别定义了 JCR 的 1.0 和 2.0 版本。其目的是简化 Java 的数据管理，并希望建立起一种基于内容仓库（Repository）而不是传统数据库（例如 RDBMS）的编码模型。内容仓库的一个典型应是内容管理系统（CMS）。JCR 是内容仓库的抽象，因为实际的内容仓库可以基于数据库，可能基于文件系统或者其他适合的存储机制，例如 WebDAV 仓库。而内容仓库的访问也有多种方式，包括直接访问（如应用程序的本地仓库），或者作为资源来访问（如通过 JNDI 来访问 Java EE 的容器），也可以使用 HTTP 或者 RMI 方式通过网络访问。

　　Apache Jackrabbit 是由 Apache Foundation 提供的 JCR 的开源实现。其起源可以追溯到 2002 年的 Apache Jakarta Slide 项目，该项目计划实现 JSR170 定义的内容仓库。随后在 2004 年，关于 JCR 的开源实现成为一个单独的项目，并命名为“Jackrabbit”。关于 Jakarta 和 Slide 项目，最初的 Jakarta 是一个包含 Ant、Maven、JMeter 等著名子项目的集合，Slide 也是其中的一个子项目。Slide 项目的主要内容是内容仓库，其中一个重要功能就是对 WebDAV 的支持，WebDAV 也可以看作是内容仓库的重要基石。但 Slide 项目在 2004 年以后便没有更新，并于 2007 年正式关闭。目前对 WebDAV 的支持主要来自 Jackrabbit 项目，实现 JCR1.0 的最新版本为 Jackrabbit1.6，实现 JCR2.0 的最新版本为 Jackrabbit2.4。

　　使用 Jackrabbit 实现 WebDAV 客户端

　　在进行编码前，只需要在自己的工程中包含 Jackrabbit 的 JAR 文件（例如 jackrabbit-standalone-2.4.3.jar），并使得可以在代码中成功导入 jackrabbit 库文件的资源。本文以在 Eclipse 开发环境中开发 WebDAV 客户端为例，介绍使用 Jackrabbit 实现 WebDAV 的客户端。如图所示，首先需要在新建的 WebDAV 客户端工程中导入 Jackrabbit JAR 文件。

　　图 1. 导入 Jackrabbit JAR 文件

　　一般情况下，可以按照图 2 所示的流程来实现 WebDAV 客户端，首先需要建立 HTTP 网络连接，即创建一个 HttpClient 对象，然后调用所需的 WebDAV 方法，并获取方法调用的状态码和返回值，并根据状态码和返回值决定是否调用或调用何种其他 WebDAV 方法。

　　图 2. 实现 WebDAV 客户端

　　第一步：建立网络连接。

　　在 java 中建立网络连接要简单许多，只需要创建 HttpClient 以及 Credentials 对象。并用新建的 Credentials 实例设置 HttpClient 实例的状态。其中 Credentials 对象保存了认证的用户名和密码。本例中的“admin”和“password”分别是 Apache HTTP 服务器中设定的用户名和密码。

　　清单 1. 建立 HttpClient 对象

　　HttpClient client = new HttpClient();
   Credentials creds = new UsernamePasswordCredentials("admin", "password");
   client.getState().setCredentials(AuthScope.ANY, creds);

　　第二步：调用 DavMethod 方法。

　　首先需要建立一个 DavMethod 对象，然后用第一步建立的 HttpClient 实例调用该方法。清单 2 中 MkColMethod 方法的作用是新建一个集合（Collection），其中 WebDAV 中的集合概念可以理解为目录，本例的作用是在 Web 服务器中的相对路径下建立 uploads/test/ 的目录，MkColMethod 的输入参数为新建目录的 URI。

　　清单 2. 调用 DavMethod 对象

　　// MKCOL method
   DavMethod mkCol = new MkColMethod("http://127.0.0.1/uploads/test");
   client.executeMethod(mkCol);

　　第三步：获取方法的返回状态。

　　调用完 WebDAV 的方法后，可以从该方法的对象中获得方法执行的状态信息。例如清单 3 的返回结果可能是“201”，“Created”和“HTTP/1.1 201 Created”。可以看出这些返回信息的格式和 HTTP 协议的返回值是一致的。

　　清单 3. 获取状态码

　　int statusCode = mkCol.getStatusCode();
String statusText = mkCol.getStatusText();
StatusLine statusLine = mkCol.getStatusLine();

　　第四步：分析返回值。

　　通过返回值，我们不仅可以知道方法调用是否成功，还能获取有用的数据进行下一步分析，例如对于一个完整的客户端实现，往往需要首先调用 PROPFIND 方法得到当前目录下的所有文件，然后再决定如何进行下一步操作。

　　清单 4. 获取返回值

　　// PROPFIND Method
   DavMethod find = new PropFindMethod("http://127.0.0.1/uploads/test/",
   DavConstants.PROPFIND_ALL_PROP, DavConstants.DEPTH_1);
   client.executeMethod(find);
   MultiStatus multiStatus = find.getResponseBodyAsMultiStatus();
   MultiStatusResponse [] responses = multiStatus.getResponses();
   System.out.println("Folders and files:");
   for(int i = 0; i < responses.length; i++)
       System.out.println(responses[i].getHref());
   

　　通过对以上调用方法的使用介绍，我们已经可以调用 WebDAV 的各种方法，读者应该已经可以根据自己的需求开发 WebDAV 客户端了。

　　WebDAV 环境的的搭建与测试

　　在开发客户端的时候，往往需要和服务器一起进行调试，本节简要介绍如何搭建 WebDAV 服务器，并对开发的客户端进行了测试和验证。

　　WebDAV 服务器的搭建

　　由于 WebDAV 是对 HTTP 协议的扩展，所以一般 HTTP 服务器均支持 WebDAV。本文选择 Apache HTTP Server（也称为“httpd”）作为 WebDAV 服务器。以 Windows 环境为例，用户在安装了 Apache HTTP Server 之后，WebDAV 服务并不是默认运行的，还需要进行如下设置，才能打开 WebDAV 功能。

　　配置 httpd.conf 文件

　　打开 DAV 功能的注释

　　# Distributed authoring and versioning (WebDAV)
 Include conf/extra/httpd-dav.conf

　　打开加载以下关于 DAV 的模块的注释

　　LoadModule dav_module modules/mod_dav.so
LoadModule dav_fs_module modules/mod_dav_fs.so
LoadModule dav_lock_module modules/mod_dav_lock.so

　　打开加载以下关于 auth_digest 的注释

　　LoadModule auth_digest_module modules/mod_auth_digest.so

　　为 admin 用户生成 user.passwd 文件

　　图 3. 运行 htdigest 生成 user.passwd 文件

　　新建所需目录

　　例如 D:\\Program Files\\Apache Software Foundation\\Apache2.2\\uploads 等。

　　重启 httpd 服务

　　图 4. 重启 httpd 服务

　　在搭建 WebDAV 服务器的时候，可以选择其他第三方的 WebDAV 客户端进行验证，例如 BitKinex 等免费工具。另外，在配置 WebDAV 服务器的时候，要注意文件目录的权限问题，例如 user.passwd 文件是否能正确生成。

　　WebDAV 客户端的测试

　　在 Eclipse 环境中运行示例代码的输出结果如下所示：

　　清单 5. 客户端记录

　　mkcol test folder:201 Created
put image file:201 Created
copy image file:201 Created
move image file:201 Created
lock image file:200 OK
unlock image file:204 No Content
Folders and files:
/uploads/test/
/uploads/test/lena2.jpg
/uploads/test/lena3.jpg
delete test folder:204 No Content

　　同时在 WebDAV 服务器中的 log 文件中记录了如下信息：

　　清单 6. 服务器日志

　　127.0.0.1 - - [25/Sep/2012:16:58:25 +0800] "MKCOL /uploads/test HTTP/1.1" 401 401
127.0.0.1 - admin [25/Sep/2012:16:58:25 +0800] "MKCOL /uploads/test HTTP/1.1" 201 187
127.0.0.1 - - [25/Sep/2012:16:58:25 +0800] "PUT /uploads/test/img.jpg HTTP/1.1" 401 401
127.0.0.1 - admin [25/Sep/2012:16:58:25 +0800] "PUT /uploads/test/img.jpg HTTP/1.1"
201 193
127.0.0.1 - - [25/Sep/2012:16:58:25 +0800] "COPY /uploads/test/img.jpg HTTP/1.1" 401 401
127.0.0.1 - admin [25/Sep/2012:16:58:25 +0800] "COPY /uploads/test/img.jpg HTTP/1.1"
201 198
127.0.0.1 - - [25/Sep/2012:16:58:25 +0800] "MOVE /uploads/test/img.jpg HTTP/1.1" 401 401
127.0.0.1 - admin [25/Sep/2012:16:58:25 +0800] "MOVE /uploads/test/img.jpg HTTP/1.1"
201 198
127.0.0.1 - - [25/Sep/2012:16:58:25 +0800] "LOCK /uploads/test/img.jpg HTTP/1.1" 401 401
127.0.0.1 - admin [25/Sep/2012:16:58:25 +0800] "LOCK /uploads/test/img.jpg HTTP/1.1"
200 414
127.0.0.1 - - [25/Sep/2012:16:58:25 +0800] "UNLOCK /uploads/test/img.jpg HTTP/1.1" 401
401
127.0.0.1 - admin [25/Sep/2012:16:58:25 +0800] "UNLOCK /uploads/test/img.jpg HTTP/1.1"
204 -
127.0.0.1 - - [25/Sep/2012:16:58:25 +0800] "PROPFIND /uploads/test/ HTTP/1.1" 401 401
127.0.0.1 - admin [25/Sep/2012:16:58:25 +0800] "PROPFIND /uploads/test/ HTTP/1.1" 207
2434
127.0.0.1 - - [25/Sep/2012:16:58:25 +0800] "DELETE /uploads/test/ HTTP/1.1" 401 401
127.0.0.1 - admin [25/Sep/2012:16:58:25 +0800] "DELETE /uploads/test/ HTTP/1.1" 204 -

　　说明示例客户端程序和服务器进行了交互，执行并验证了 WebDAV 协议中的方法的使用。

　　WebDAV 是一个重要的网络通信协议，基于 WebDAV 可以开发出丰富多彩的应用程序，例如云计算、办公自动化、数据仓库、流媒体等。本文首先介绍了 WebDAV、JCR 的概念，并介绍了如何使用 Jackrabbit 实现一个 WebDAV 的客户端，最后验证了该客户端在 WebDAV 服务器上各项基本功能的使用

参考技术A 使用 Jackrabbit 实现 WebDAV 客户端
在进行编码前，只需要在自己的工程中包含 Jackrabbit 的 JAR 文件（例如 jackrabbit-standalone-2.4.3.jar），并使得可以在代码中成功导入 jackrabbit 库文件的资源。本文以在 Eclipse 开发环境中开发 WebDAV 客户端为例，介绍使用 Jackrabbit 实现 WebDAV 的客户端。如图所示，首先需要在新建的 WebDAV 客户端工程中导入 Jackrabbit JAR 文件。
图 1. 导入 Jackrabbit JAR 文件
一般情况下，可以按照图 2 所示的流程来实现 WebDAV 客户端，首先需要建立 HTTP 网络连接，即创建一个 HttpClient 对象，然后调用所需的 WebDAV 方法，并获取方法调用的状态码和返回值，并根据状态码和返回值决定是否调用或调用何种其他 WebDAV 方法。
图 2. 实现 WebDAV 客户端
第一步：建立网络连接。
在 java 中建立网络连接要简单许多，只需要创建 HttpClient 以及 Credentials 对象。并用新建的 Credentials 实例设置 HttpClient 实例的状态。其中 Credentials 对象保存了认证的用户名和密码。本例中的“admin”和“password”分别是 Apache HTTP 服务器中设定的用户名和密码。
清单 1. 建立 HttpClient 对象
HttpClient client = new HttpClient();
Credentials creds = new UsernamePasswordCredentials("admin", "password");
client.getState().setCredentials(AuthScope.ANY, creds);

第二步：调用 DavMethod 方法。
首先需要建立一个 DavMethod 对象，然后用第一步建立的 HttpClient 实例调用该方法。清单 2 中 MkColMethod 方法的作用是新建一个集合（Collection），其中 WebDAV 中的集合概念可以理解为目录，本例的作用是在 Web 服务器中的相对路径下建立 uploads/test/ 的目录，MkColMethod 的输入参数为新建目录的 URI。
清单 2. 调用 DavMethod 对象
// MKCOL method
DavMethod mkCol = new MkColMethod("http://127.0.0.1/uploads/test");
client.executeMethod(mkCol);

第三步：获取方法的返回状态。
调用完 WebDAV 的方法后，可以从该方法的对象中获得方法执行的状态信息。例如清单 3 的返回结果可能是“201”，“Created”和“HTTP/1.1 201 Created”。可以看出这些返回信息的格式和 HTTP 协议的返回值是一致的。
清单 3. 获取状态码
int statusCode = mkCol.getStatusCode();
String statusText = mkCol.getStatusText();
StatusLine statusLine = mkCol.getStatusLine();

第四步：分析返回值。
通过返回值，我们不仅可以知道方法调用是否成功，还能获取有用的数据进行下一步分析，例如对于一个完整的客户端实现，往往需要首先调用 PROPFIND 方法得到当前目录下的所有文件，然后再决定如何进行下一步操作。
清单 4. 获取返回值
// PROPFIND Method
DavMethod find = new PropFindMethod("http://127.0.0.1/uploads/test/",
DavConstants.PROPFIND_ALL_PROP, DavConstants.DEPTH_1);
client.executeMethod(find);
MultiStatus multiStatus = find.getResponseBodyAsMultiStatus();
MultiStatusResponse [] responses = multiStatus.getResponses();
System.out.println("Folders and files:");
for(int i = 0; i < responses.length; i++)
System.out.println(responses[i].getHref());


通过对以上调用方法的使用介绍，我们已经可以调用 WebDAV 的各种方法，读者应该已经可以根据自己的需求开发 WebDAV 客户端了。本文完整的程序代码见附件。
回页首
WebDAV 环境的的搭建与测试
在开发客户端的时候，往往需要和服务器一起进行调试，本节简要介绍如何搭建 WebDAV 服务器，并对开发的客户端进行了测试和验证。
WebDAV 服务器的搭建
由于 WebDAV 是对 HTTP 协议的扩展，所以一般 HTTP 服务器均支持 WebDAV。本文选择 Apache HTTP Server（也称为“httpd”）作为 WebDAV 服务器。以 Windows 环境为例，用户在安装了 Apache HTTP Server 之后，WebDAV 服务并不是默认运行的，还需要进行如下设置，才能打开 WebDAV 功能。
配置 httpd.conf 文件
打开 DAV 功能的注释
# Distributed authoring and versioning (WebDAV)
Include conf/extra/httpd-dav.conf

打开加载以下关于 DAV 的模块的注释
LoadModule dav_module modules/mod_dav.so
LoadModule dav_fs_module modules/mod_dav_fs.so
LoadModule dav_lock_module modules/mod_dav_lock.so

打开加载以下关于 auth_digest 的注释
LoadModule auth_digest_module modules/mod_auth_digest.so

为 admin 用户生成 user.passwd 文件
图 3. 运行 htdigest 生成 user.passwd 文件
新建所需目录
例如 D:\Program Files\Apache Software Foundation\Apache2.2\uploads 等。
重启 httpd 服务
图 4. 重启 httpd 服务
在搭建 WebDAV 服务器的时候，可以选择其他第三方的 WebDAV 客户端进行验证，例如 BitKinex 等免费工具。另外，在配置 WebDAV 服务器的时候，要注意文件目录的权限问题，例如 user.passwd 文件是否能正确生成。
WebDAV 客户端的测试
在 Eclipse 环境中运行示例代码的输出结果如下所示：
清单 5. 客户端记录
mkcol test folder:201 Created
put image file:201 Created
copy image file:201 Created
move image file:201 Created
lock image file:200 OK
unlock image file:204 No Content
Folders and files:
/uploads/test/
/uploads/test/lena2.jpg
/uploads/test/lena3.jpg
delete test folder:204 No Content

同时在 WebDAV 服务器中的 log 文件中记录了如下信息：
清单 6. 服务器日志
127.0.0.1 - - [25/Sep/2012:16:58:25 +0800] "MKCOL /uploads/test HTTP/1.1" 401 401
127.0.0.1 - admin [25/Sep/2012:16:58:25 +0800] "MKCOL /uploads/test HTTP/1.1" 201 187
127.0.0.1 - - [25/Sep/2012:16:58:25 +0800] "PUT /uploads/test/img.jpg HTTP/1.1" 401 401
127.0.0.1 - admin [25/Sep/2012:16:58:25 +0800] "PUT /uploads/test/img.jpg HTTP/1.1"
201 193
127.0.0.1 - - [25/Sep/2012:16:58:25 +0800] "COPY /uploads/test/img.jpg HTTP/1.1" 401 401
127.0.0.1 - admin [25/Sep/2012:16:58:25 +0800] "COPY /uploads/test/img.jpg HTTP/1.1"
201 198
127.0.0.1 - - [25/Sep/2012:16:58:25 +0800] "MOVE /uploads/test/img.jpg HTTP/1.1" 401 401
127.0.0.1 - admin [25/Sep/2012:16:58:25 +0800] "MOVE /uploads/test/img.jpg HTTP/1.1"
201 198
127.0.0.1 - - [25/Sep/2012:16:58:25 +0800] "LOCK /uploads/test/img.jpg HTTP/1.1" 401 401
127.0.0.1 - admin [25/Sep/2012:16:58:25 +0800] "LOCK /uploads/test/img.jpg HTTP/1.1"
200 414
127.0.0.1 - - [25/Sep/2012:16:58:25 +0800] "UNLOCK /uploads/test/img.jpg HTTP/1.1" 401
401
127.0.0.1 - admin [25/Sep/2012:16:58:25 +0800] "UNLOCK /uploads/test/img.jpg HTTP/1.1"
204 -
127.0.0.1 - - [25/Sep/2012:16:58:25 +0800] "PROPFIND /uploads/test/ HTTP/1.1" 401 401
127.0.0.1 - admin [25/Sep/2012:16:58:25 +0800] "PROPFIND /uploads/test/ HTTP/1.1" 207
2434
127.0.0.1 - - [25/Sep/2012:16:58:25 +0800] "DELETE /uploads/test/ HTTP/1.1" 401 401
127.0.0.1 - admin [25/Sep/2012:16:58:25 +0800] "DELETE /uploads/test/ HTTP/1.1" 204 -

说明示例客户端程序和服务器进行了交互，执行并验证了 WebDAV 协议中的方法的使用。

如何学习使用内容存储库和 Apache JackRabbit？

【中文标题】如何学习使用内容存储库和 Apache JackRabbit？

【英文标题】：How to learn using content repository and Apache JackRabbit?

【发布时间】：2013-07-20 23:13:02

【问题描述】：

在 Apache JackRabbit 网站中完成“第一跳”之后，我该去哪里？我不明白如何创建不在内存中的存储库以及如何配置它等等。

【参考方案1】：

您还可以查看Silverpeas 代码。 它使用 Jackrabbit 和一些简单的代码来创建节点、浏览它们等。例如看看https://github.com/Silverpeas/Silverpeas-Core/blob/master/lib-core/src/main/java/org/silverpeas/attachment/repository/DocumentRepository.java 测试在内存存储库中使用，但最终使用的是“真实”存储库。

您还可以查看JBoss Modeshape，它是 JCR API 的另一个实现。一些文档是交叉实现的。 还有Crash 可以让您将shell 添加到正在运行的存储库中。

【参考方案2】：

欢迎来到我的世界。 Jackrabbit 文档到处都是。你将不得不做一些认真的谷歌搜索。

不过，Wiki 是一个不错的起点。从Examples page 开始。只需尝试将新记录添加到 CMS 中。然后实施版本控制。不必担心将其嵌入到应用程序中。在这个阶段我会使用独立版本。

如果您愿意，还可以下载Apache Sling 源代码。查看 JCR 包。您将获得一些关于如何在 Web 应用程序中使用它的提示。

【讨论】：

好吧，所以不只是我在努力控制它。虽然我不会使用 Apache Sling，但它仍然是一个学习的好地方吗？浏览完示例页面和 wiki 后你做了什么？