Re: [gatein-dev] REST API Specification

Hi Nick, here are my initial comments remarks 1/ for pagination I see "page=2&per-page=10" can it work in a reliable manner with concurrency ? (i.e if I go on page 2 and someone added a result meanwhile). 2/ at some point there will a few improvements in application management, in particular we should have the capability to scope applications per site (like pages and navigations). The current proposal to use /applications/app-type/app-id will be an issue as it will not be possible to scope an application to a site. And the existing application registry should be seen as a "parent" registry. 3/ for site based API : why do we have the scheme /something/site-type/site-name/foobar and not /sites/site-type/site-name/concern/foobar ? this would enable to have /applications per site (see remark 2) and have a global /applications for current application registry without conflicts. 4/ the current model for application registry is broken and prevents to do a correct API (java or rest). I want to change that for the next major version, you should be prepared to this change. Basically an application is seen in the application registry as en entry of /production/app:applications/category/application but the corresponding configuration application is a node under /production/mop:workspace/mop:customizations/application For instance "/production/mop:workspace/mop:customizations/mop:Todo" and "/production/app:applications/app:Gadgets/app:Todo" This is broken because an application can be described twice with different data, i.e there can be several entries under app:applications/* that can point to the same customization (the real application). Worse than that the same application can appear twice in the application registry with different security permissions. I want to fix this and instead remove the application part of the app:applications. Instead use mixins to put on a customization to add the data that will describe it (i.e enhance it) with the mixins gtn:described and gtn:protectedresource we have already in gatein. The app:applications would somehow remain but it would be a simple relationship to the customization itself instead of en entity. This would allow the same application to appear in several categories. There would be a new mixin to make an application point to several categories to put on an application. This would provide the many-to-many relationship between application and categories. That's the only major changes I foresee so far in MOP for the next major version. On Mar 30, 2012, at 10:00 PM, Nick Scavelli wrote: