17.20. Return a List of Accessible Repositories

A typical conversation might start with a request to the server to dynamically discover the available repositories.

GET http://www.example.com/modeshape-rest

GET http://www.example.com/modeshape-rest

This request would generate a response that mapped the names of the available repositories to metadata information about the repositories:

{
   "eds" : { 
      "repository" : 
      {
         "name" : "eds",
         "resources" : {  "workspaces":"/modeshape-rest/eds" }
      }
   }
}

{
   "eds" : { 
      "repository" : 
      {
         "name" : "eds",
         "resources" : {  "workspaces":"/modeshape-rest/eds" }
      }
   }
}

The actual response would not be pretty-printed like the example, but the format would be the same. The name of the repository ("repository" URL-encoded) is mapped to a repository object that contains a name (the redundant "repository") and a list of available resources within the repository and their respective URIs. Note that Metadata Repository supports deploying multiple JCR repositories side-by-side on the same server, so this response could easily contain multiple repositories in a real deployment.