jsr339-experts@jax-rs-spec.java.net

[jsr339-experts] Re: [jax-rs-spec users] Re: 'Link' in the spec

From: Santiago Pericas-Geertsen <Santiago.PericasGeertsen_at_oracle.com>
Date: Wed, 17 Oct 2012 13:02:06 -0400

On Oct 17, 2012, at 12:05 PM, Markus KARG wrote:

> Hm... I think HATEOS is such an essential part of REST that it is worth
> naming a chapter "Hypermedia", even if it would only contain a few lines.

 OK, thanks for the feedback. I'll explore the idea of a new chapter for hypermedia and the use of class Link in the client and server APIs.

-- Santiago

>
>> -----Original Message-----
>> From: Santiago Pericas-Geertsen
>> [mailto:Santiago.PericasGeertsen_at_oracle.com]
>> Sent: Mittwoch, 17. Oktober 2012 15:04
>> To: jsr339-experts_at_jax-rs-spec.java.net
>> Subject: [jsr339-experts] Re: [jax-rs-spec users] 'Link' in the spec
>>
>> Jan,
>>
>> Yes, there's a few a features that are only documented in the
>> Javadocs, this is one of them. I think we should add something to the
>> spec about the use of Link; there just doesn't seem to be enough for a
>> new chapter so we'll need to figure out where it can fit.
>>
>> -- Santiago
>>
>> On Oct 17, 2012, at 5:35 AM, Jan Algermissen wrote:
>>
>>> Hi,
>>>
>>> I feel kind of extremely stupid to ask this, but since a plain text
>> search through the draft doesn't help, here it goes:
>>>
>>> Support for linking was added in 2.0 - but where is that mentioned in
>> the spec except for the tiny sentence
>>>
>>> "Link A URI with additional meta-data such as a media type, a
>> relation, a title, etc."
>>>
>>> on page 3 of PR?
>>>
>>> Is the intention that implementors of JAX-RS 2.0 only use this
>> sentence and the API docs as reference?
>>>
>>> Or am I missing something?
>>>
>>> Jan
>
>