Details for bookmark nested under 'bookmark' for HATEOAS about tut-rest HOT 4 CLOSED

This tutorial is in need of some love. The document posted above isn't a HAL document, hinting that one of the controller endpoints isn't returning a ResourceSupport/Resource/Resources/PagedResources type, hence NOT engaging the HAL serializers. HAL serializers would NOT render the extra attributes when they are null.

from tut-rest.

Took a clean copy of the repo and getting the same results (but with less nulls as you mentioned). However this may be a misunderstanding on my end. Running on the URL http://localhost:8080/dsyer/bookmarks/3:

{
    "bookmark": {
        "id": 3,
        "uri": "http://bookmark.com/1/dsyer",
        "description": "A description"
    },
    "_links": {
        "bookmark-uri": {
            "href": "http://bookmark.com/1/dsyer"
        },
        "bookmarks": {
            "href": "http://localhost:8080/dsyer/bookmarks"
        },
        "self": {
            "href": "http://localhost:8080/dsyer/bookmarks/3"
        }
    }
}

However I was expecting bookmarks to not be nested, like so:

{
    "id": 3,
    "uri": "http://bookmark.com/1/dsyer",
    "description": "A description",
    "_links": {
        "bookmark-uri": {
            "href": "http://bookmark.com/1/dsyer"
        },
        "bookmarks": {
            "href": "http://localhost:8080/dsyer/bookmarks"
        },
        "self": {
            "href": "http://localhost:8080/dsyer/bookmarks/3"
        }
    }
}

Details in http://stateless.co/hal_specification.html are where I am making the assumption that I shouldn't be nesting, however I have been unable to find a clear demonstration.

from tut-rest.

The class definition of BookmarkResource is:

class BookmarkResource extends ResourceSupport {

	private final Bookmark bookmark;
    ...
}

That is why Bookmark is nested. Because it's nested inside the BookmarkResource. This is fine in the HAL spec, since it matches the class structure.

That being said, I'm in the middle of overhauling this tutorial, and frankly, it looks like we could just use Resource<Bookmark> to accomplish the same thing. That would be one less type of manage and would have the next effect of simplifying the HAL structure as you imagine it, but not having this structure.

from tut-rest.

This tutorial was completely rewritten as of 63d3937.

I suggest you read it from the top and be sure to let us know if you spot any issues!

from tut-rest.