incubator-photark-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Henry Saputra <henry.sapu...@gmail.com>
Subject Re: PhotArk Gallery API
Date Thu, 03 Jun 2010 04:13:35 GMT
+1 for making Album and Gallery as separate object model.

I think this is inline with questions from others regarding Album and
Gallery SCA services act as creator, object model, and service providers.

-Henry


On Mon, May 31, 2010 at 5:07 PM, Luciano Resende <luckbr1975@gmail.com>wrote:

> On Sun, May 16, 2010 at 11:22 AM, Luciano Resende <luckbr1975@gmail.com>
> wrote:
> > I'd like to start working on defining a more robust API to access
> > photoArk galleries, I'm planning to start by creating a new module
> > (most likely a copy of current photark module) to avoid disrupting the
> > current web application. I'd start by applying REST with JSON as the
> > default wire format, and once we are ok with the new API, we could
> > start migrating the existent app to use this new API.
> >
> > Thoughts ?
> >
>
>
> I have started playing with a REST API for PhotArk at my sandbox [1].
>
> I have started by introducing a clear separation of Model and
> Services, and you can see that I created things like Gallery, Album
> and Image as pure model objects. This will makes things clear and
> improve performance by allowing more atomic client/server
> communications with the Gallery/Album services.
>
> The second area is applying REST and Hypermedia principles to our API,
> and the idea is that client (such as our UI) would interact with the
> PhotArk gallery treating it as resources, and a call to retrieve
>
> GET http://localhost:8085/gallery
>
> would get a response similar to :
>
> {
>    "albums": [
>        {
>            "ref": "http://localhost:8080/gallery/album1",
>            "name": "Album 1",
>            "coverImageRef": null
>        },
>        {
>            "ref": "http://localhost:8080/gallery/album2",
>            "name": "Album 2",
>            "coverImageRef": null
>        }
>    ]
> }
>
> Note that this initial response has all the information to build the
> "gallery index" with a list of all available albums, and also provides
> direct link to calling further service api to retrieve extra
> information (e.g the album details via album:ref attribute ).
>
> Please let me know your thoughts on this, and if people are ok with
> this direction, I'll start investigating what's the best way to
> integrate this to trunk.
>
> [1]
> http://svn.apache.org/repos/asf/incubator/photark/sandbox/lresende/photark-rest/
>
>
> --
> Luciano Resende
> http://people.apache.org/~lresende
> http://twitter.com/lresende1975
> http://lresende.blogspot.com/
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message