首先,ModeShape 的 RESTful 服务中没有从存储库返回所有节点的方法。一个存储库可以有数百万个包含大量内容的节点,所以这样的请求是没有意义的,并且可能会产生非常大的响应。相反,有一些方法可以返回父级下的部分/所有子级(或达到一定深度的后代)。
其次,“上下文”是在基于 servlet 的应用程序中使用的术语,通常是指应用程序在服务器中启动的位置。默认情况下这是“ modeshape-rest
”,尽管您可以通过修改web.xml
WAR 文件中的 将其更改为其他内容。
“响应格式”通常是 JSON。
RESTful 服务可以访问部署在同一台服务器上的多个仓库,所以采用 URL 格式
http://<host>:<port>/<context>/<repository_name>/<workspace_name>/items/<node_path>
尖括号中的变量(例如,“ <repository_name>
”)将替换为实际值。例如,如果 RESTful 服务可在modeshape-rest
名为“my-repository
带有工作空间”的存储库中的默认应用程序上下文“”中的端口 8080 上的本地计算机上访问,则可以通过发出 HTTP GET 请求default
来获取路径“”处的节点/a/b/c
在这个网址:
http://localhost:8080/modeshape-rest/my-repository/default/items/a/b/c HTTP/1.1
实际的 HTTP 请求可能如下所示:
GET /modeshape-rest/my-repository/default/items/a/b/c HTTP/1.1
Host: http://localhost:8080
Accept: application/json
并且响应将是描述节点的 JSON 文件。RESTful 服务上的所有其他方法都使用类似的模式,并在服务文档中进行了描述。