users@jax-rs-spec.java.net

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

From: Markus KARG <markus_at_headcrashing.eu>
Date: Wed, 17 Oct 2012 18:05:31 +0200

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.

> -----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