A fluent client Api
Introduction
As we move more and more application logic to the client applications such as SPA and mobile applications, we often need to wrap complex restful service in a client api.
In my recent projects I have tried some Mbass service providers such as Leancloud.cn, Loopback, Parse.com. None of them has a React friendly client SDK. It seems that many of those sdks uses stateful data objects, which is not good for immutable nature of flux/redux Store. Instead of keep stateful objects all around, I would like to have a stateless api good enough to express data relations. Fluent interface seems to be a good candidate for this approach. Following are some examples
js: Project.find(filter)
http: GET /projects?filter=....
js: Project(1234).delete()
http: DELETE /projects/1234
js: Project(1234).owner.set(userId)
http: PUT /projects/1234/owner
js: Project(1234).task.find()
http: GET /projects/1234/tasks
js: Project(1234).task(456).update(data)
http: PUT /projects/1234/tasks/456
Problems
- Express fluent api interface by configuration and js code.
- How to encode request and decode response for an acceptable content-type.
- Customize request headers (adding access token and stats)
- Customize request params (adding access token and stats)