Re: Client POC

2015-11-07 19:15 GMT+01:00 Karol Szczepański <karol.szczepanski@gmail.com>:

> I've just comitted a working demo of an angularJS client talking to the .net
> ReST API, both from my Ultimate ResT API (URSA) framework.
> The demo is available at http://www.szczepanscy.priv.pl/ursa/

Fantastic! While I don't have any feedback to give as of yet, I'll be
sure to get my hands dirty with this source code and figure out how I
can best use it to solve pretty much exactly the same problem. I hope
it can be combined with Pomona[1], which is an HTTP API framework
similar to ASP.NET Web API[2], but based on Nancy[3] and on a
"convention over configuration" approach.

The work we're doing in Pomona now is replacing the current
serialization format from POCO JSON to JSON-LD and a more URI
reference based approach. We're at the same time exploring the
possibility to replace the current JSON Schema based type inference
with Hydra. The plan is to also use Hydra as a basis for autogenerated
GUI and user browsable (self hosted) documentation.

I think URSA can help with many of these problems. So thanks for this! :-)

> 2. Another issue I had was with pagination. Again, API Documentation is
> silent in this area.

Doesn't the new PagedCollection fix this?

> 3. Hydra's model also doesn't fit to ... datatypes (in terms of RDF/XSD
> datatypes). In order to denote that an operation returns values of type
> xsd:string I had to elevate it to hydra:Class, which I think is not very
> elegant.

Returning simple types is discouraged anyway, so I don't see that as a
big problem. RFC 7493[4] states:

   For maximum interoperability with such implementations,
   protocol designers SHOULD NOT use top-level JSON texts
   that are neither objects nor arrays.

____
[1] http://pomona.io/
[2] http://www.asp.net/web-api
[3] http://nancyfx.org/
[4] http://www.rfc-editor.org/rfc/rfc7493.txt

-- 
Asbjørn Ulsberg           -=|=-        asbjorn@ulsberg.no
«He's a loathsome offensive brute, yet I can't look away»

Received on Monday, 9 November 2015 09:04:24 UTC