通过DAV对JCR节点进行版本控制 - 如何

Question

背景：我一直在考虑采用包括Apache Sling，Jackrabbit和Jetty在内的服务组合，用于网站设计中的内容管理。在这一点上，我想想象有可能使用DAV创建一个移动内容创建平台来访问JCR内容存储库。JCR 2.0 (JSR-283( 中的版本控制问题让我想知道，如何通过 HTTP 进行 JCR 版本控制操作？

更详细地说：我正在查看我认为是JSR-283的第15节，该部分以Adobe的HTML格式提供。在该部分中，JSR-283 提出了 JCR 节点的版本控制概念。

那么，我知道在JSR-283兼容的Jackrabbit版本中有一个VersionManager API。这有助于解释如何通过API进行JCR(JSR-283(版本控制操作。那么，用户代理如何通过DAV进行版本控制操作呢？

我想自己回答这个问题，但我什至不知道从哪里开始。

JSR-283 是否有另一部分解释了版本签入/签出操作如何转换为 HTTP 请求？ 这是简单的DAV属性问题吗？我甚至接近目标吗？

/需要同行评审，哈哈

Answer 1

在 Jackrabbit

网站上有一个文档(JCR_Webdav_Protocol.doc - Apache Jackrabbit(描述了 WebDAV 方法调用和 Jackrabbit JCR API 调用之间的映射：

http://jackrabbit.apache.org/JCR_Webdav_Protocol.doc

虽然本文档最后更新于 2006 年 3 月 29 日，但我发现迈出第一步非常有帮助。

我已经使用Word和Wireshark针对我的Jackrabbit默认存储库跟踪了与Microsoft Office 2010的会话。下面的 shell 脚本在 *nix 上使用 curl 和 libreoffice 执行相同的操作。

---

如您所见，删除、上传、版本控制文档 WebDAV 调用是在 Word 中的操作之前执行的。

浏览目录会在 Internet Explorer 实例中打开 URL。

Microsoft Word 检索文档属性 (PROPFIND(，然后打开 (GET( 并锁定文档。它还出于未知原因请求 %EE%B3%B0 上的属性(Unicode 字符集专用范围的 UTF-8(十六进制(0xEE 0xB3 0xB0 (eeb3b0( 或 UTF-16 "\uECF0"又名""(。

将文档保存在 Word Microsoft后，它将上载 (PUT( 并更新文档节点的属性 (PROPPATCH(，以包括 Win32CreationTime、Win32LastModifiedTime 和 Win32LastAccessTime 戳。

在 Word 中关闭文档将使用解锁释放获取的锁。

再次手动执行 CHECKIN 文档，以使版本生命周期完整。

版本树报告也可以从WebDAV获得。

#!/bin/sh
# Delete document
curl -A Microsoft-WebDAV-MiniRedir/6.1.7601 -X DELETE -v http://localhost:7001/repository/default/test.docx
# Upload document
curl -A Microsoft-WebDAV-MiniRedir/6.1.7601 -X PUT -v http://localhost:7001/repository/default/test.docx --data-binary "@test.docx"
# Version-Control document
curl -A Microsoft-WebDAV-MiniRedir/6.1.7601 -X VERSION-CONTROL -v http://localhost:7001/repository/default/test.docx 
# Checkout document
curl -A Microsoft-WebDAV-MiniRedir/6.1.7601 -X CHECKOUT -v http://localhost:7001/repository/default/test.docx
# Browse directory
curl -A "Mozilla/5.0 (Windows NT 6.1; WOW64; Trident/7.0; rv:11.0) like Gecko" -X GET -v http://localhost:7001/repository/default/ 
# Open document in Word
curl -A Microsoft-WebDAV-MiniRedir/6.1.7601 -X PROPFIND -v http://localhost:7001/repository/default/test.docx | xmllint --format -
curl -A Microsoft-WebDAV-MiniRedir/6.1.7601 -X GET -v http://localhost:7001/repository/default/test.docx -O
curl -A Microsoft-WebDAV-MiniRedir/6.1.7601 -X PROPFIND -v http://localhost:7001/repository/default/test.docx%EE%B3%B0
cat > LOCK_document.xml <<EOF
<?xml version="1.0" encoding="utf-8" ?>
<D:lockinfo xmlns:D="DAV:">
  <D:lockscope>
    <D:exclusive/>
  </D:lockscope>
  <D:locktype>
    <D:write/>
  </D:locktype>
  <D:owner>
    <D:href>WINDOWSDOMAINUSER</D:href>
  </D:owner>
</D:lockinfo>
EOF
curl -A Microsoft-WebDAV-MiniRedir/6.1.7601 -X LOCK -v http://localhost:7001/repository/default/test.docx --data "@LOCK_document.xml" | xmllint --format - | tee LOCK_document.txt
export LOCK_token=$(grep opaquelocktoken LOCK_document.txt | sed 's/^.*opaquelocktoken:/<opaquelocktoken:/' | sed 's/</D:href>.*$/>/')
curl -A "Microsoft Office Existence Discovery" -X HEAD -v http://localhost:7001/repository/default/test.docx
curl -A Microsoft-WebDAV-MiniRedir/6.1.7601 -X OPTIONS -v http://localhost:7001/ -H "translate: f"
# Edit document in Word
libreoffice test.docx 
# Save document in Word
curl -A Microsoft-WebDAV-MiniRedir/6.1.7601 -X HEAD -v http://localhost:7001/repository/default/test.docx
curl -A Microsoft-WebDAV-MiniRedir/6.1.7601 -X PUT -v http://localhost:7001/repository/default/test.docx -H "If: (${LOCK_token})" --data-binary "@test.docx"
cat > PROPPATCH_document.xml <<EOF
<?xml version="1.0" encoding="utf-8" ?>
<D:propertyupdate xmlns:D="DAV:" xmlns:Z="urn:schemas-microsoft-com:">
  <D:set>
    <D:prop>
      <Z:Win32CreationTime>Mon, 09 Mar 2015 15:24:36 GMT</Z:Win32CreationTime>
      <Z:Win32LastAccessTime>Mon, 16 Mar 2015 13:22:40 GMT</Z:Win32LastAccessTime>
      <Z:Win32LastModifiedTime>Mon, 16 Mar 2015 13:22:40 GMT</Z:Win32LastModifiedTime>
    </D:prop>
  </D:set>
</D:propertyupdate>
EOF
curl -A Microsoft-WebDAV-MiniRedir/6.1.7601 -X PROPPATCH -v http://localhost:7001/repository/default/test.docx -H "If: (${LOCK_token})" --data "@PROPPATCH_document.xml" | xmllint --format -
# Close document in Word
curl -A "Microsoft Office Existence Discovery" -X HEAD -v http://localhost:7001/repository/default/test.docx
curl -A Microsoft-WebDAV-MiniRedir/6.1.7601 -X UNLOCK -v http://localhost:7001/repository/default/test.docx -H "Lock-Token: ${LOCK_token}"
# Checkin document
curl -A Microsoft-WebDAV-MiniRedir/6.1.7601 -X CHECKIN -v http://localhost:7001/repository/default/test.docx
# Version tree report on document
cat > REPORT_version-tree.xml <<EOF
<?xml version="1.0" encoding="utf-8" ?>
<D:version-tree xmlns:D="DAV:">
 <D:prop>
   <D:version-name/>
 </D:prop>
</D:version-tree>
EOF
curl -A Microsoft-WebDAV-MiniRedir/6.1.7601 -X REPORT -v http://localhost:7001/repository/default/test.docx --data "@REPORT_version-tree.xml" | xmllint --format -

我只对Jackrabbit的自动版本功能有问题，这些功能显然尚未实现。

https://issues.apache.org/jira/browse/JCR-1348

#<!--
# see http://www.webdav.org/specs/rfc3253.html#PROPERTY_auto-version
#      <D:auto-version>checkout-checkin</D:auto-version>
#      <D:auto-version>checkout-unlocked-checkin</D:auto-version>
#      <D:auto-version>checkout</D:auto-version>
#      <D:auto-version>locked-checkout</D:auto-version>
#-->
cat > PROPPATCH_auto-version.xml <<EOF
<?xml version="1.0" encoding="utf-8" ?>
<D:propertyupdate xmlns:D="DAV:">
  <D:set>
    <D:prop>
      <D:auto-version>checkout-checkin</D:auto-version>
    </D:prop>
  </D:set>
</D:propertyupdate>
EOF
curl -A Microsoft-WebDAV-MiniRedir/6.1.7601 -X PROPPATCH -v http://localhost:7001/repository/default/test.docx -H "If: (${LOCK_token})" --data "@PROPPATCH_auto-version.xml" | xmllint --format -

Answer 2

我知道JCR版本控制框架有效地围绕mix：versionable JCR mixin节点类型(Jackrabbit Wiki(进行了透视。因此，如果一个节点被创建为mix：versionable类型，那么我假设传统的WebDAV签入和签出操作 - 可以用WebDAV API封装 - 这些可能是在可版本化节点上执行JCR签入/签出操作的方式。我认为，这将回答大部分问题

。

我没有看到任何确切的 DAV 对 JCR 检查点操作的补充，但如果这只是签入后签出，正如文档所解释的那样，那么通过 DAV 模拟就很容易了 - 从而补充了该 JCR 操作。