[jira] [Created] (JCR-4802) Document servlets provided by Jackrabbit legacy, and Jackrabbit Oak

["Graham Leggett (Jira)" <ji...@apache.org>]

Graham Leggett created JCR-4802:
-----------------------------------

             Summary: Document servlets provided by Jackrabbit legacy, and Jackrabbit Oak
                 Key: JCR-4802
                 URL: https://issues.apache.org/jira/browse/JCR-4802
             Project: Jackrabbit Content Repository
          Issue Type: Improvement
            Reporter: Graham Leggett


At this time, there is significant confusion over the remoting capabilities of Jackrabbit.

In Jackrabbit legacy, we have two servlets:

- Simple Webdav Server
- JCR Webdav Server

In Jackrabbit Oak, we have what seems to be a different servlet:

- OakServlet

The confusion comes about because at first past, the end user gets the impression that the server in oak-run is the Simple Webdav Server and JCR Webdav Server from jackrabbit legacy.

Only after deploying the server and start digging into the source to get an explanation of the behaviour of the oak server, we find the OakServlet, which appears to contain an undocumented ad-hoc HTTP API, which is in turn hard coded to accept Basic Authentication only.

https://github.com/apache/jackrabbit-oak/blob/trunk/oak-http/src/main/java/org/apache/jackrabbit/oak/http/OakServlet.java

Ideally the docs for the server part of the oak-run tool needs to be updated to clearly indicate that the API bears no relation to past APIs, on this page:

https://github.com/apache/jackrabbit-oak/blob/trunk/oak-run/README.md




--
This message was sent by Atlassian Jira
(v8.20.7#820007)