Aloha,

Yesterday we did a little hackday to explore Jackrabbit Oak the HTTP interface 
and discovered that since last summer quite a few things have changed there. In 
general the changes seem to make the API more RESTful, f.e. no longer support 
appending ".json" to get a JSON response and instead requiring the use of 
Accept headers.

However some important features seem to have been lost in Oak:

1) ability to fetch multiple nodes in one HTTP request: 
https://issues.apache.org/jira/browse/OAK-1923
2) ability to specify a fetch depth: 
https://issues.apache.org/jira/browse/OAK-1924

Furthermore we were struggling with the lack of documentation and we could also 
not find any test cases to help us figure out other changes. Like it seems the 
REPORT HTTP method is no longer used, which previously allowed us to fetch the 
node types.

BTW this wiki entry should likely be removed 
http://wiki.apache.org/jackrabbit/Oak-over-HTTP
or linked to 
https://github.com/apache/jackrabbit-oak/blob/trunk/oak-http/README.md which is 
more up to date/complete.

So if anyone has a hint on how we can best get a grip on the new HTTP API we 
would very much appreciate it! For the previous version of the HTTP we found 
http://jukkaz.wordpress.com/2009/11/24/jackrabbit-over-http/ very useful but 
did "reverse engineer" quite a lot by trail and error which isn't the most 
efficient way to get going :)

regards,
Lukas Kahwe Smith

Reply via email to