Re: [Jersey] Re: Hypermedia clarification

From: Mark Derricutt <>
Date: Wed, 17 Feb 2010 10:52:35 +1300

Does anyone have a pointer to the current Link: header spec? All I
can find are draft specs from 1999 and 2006 and an endless circular
google hunt through various HTML5 and Web mailing lists.

This topic is quite timely as we're just looking into how to actually
DO HATEAOS, currently we have resource URLs embedded inside the JSON
documents we return, such as:

 "products": {
            "INBOUND_SCRUB": {
                "current": true,
                "resources": {
                    "POLICY_SETS": {
                        "description": "Policy Sets",
                    "EVENTS_SEARCH": {
                        "description": "Events Search",

but this just feels wrong - I feel as thou the resource content
shouldn't know, or say "where" things are. I'm thinking ideally, I'd
continue to include the "products" collection, as that makes up the
state of the customer, but everything under the "resources" for that
product, should be a flat collection of Link: headers

Confused REST guy.

Pull me down under...
On Tue, Feb 16, 2010 at 11:26 AM, Roy T. Fielding <> wrote:
> Link is part of the representation metadata (that's its whole reason to exist).
> Content-Location is representation metadata for the URI of this content.
> Location is a response header used as part of the redirect aspects of HTTP.