Support for relative href links?

[pimlottc]

The Stateless.co HAL documentation and IETF draft spec both use relative URLs (with absolute paths) in all their examples, e.g.

{ "_links": { "self": { "href": "/orders/523" } } }

However, the links generated by ControllerLinkBuilder and EntityLink are all absolute:

{ "_links": { "self": { "href": "http://localhost:8080/orders/523" } } }

Is there any way to make them generate relative links instead?

[odrotbohm]

hrefs are entirely in your control:

Link link = new Link("/orders/523", "self")

[pimlottc]

As I said, I'm talking about links generated by the framework, e.g.

entityLinks.linkToCollectionResource(Project.class);

or

ControllerLinkBuilder.linkTo(methodOn(LanguagesController.class).getAllLanguages());

[moravcik]

Actually, absolute links which are generated automatically are causing problems in my project too.
I am using Spring Boot with Spring Data Rest on server side and AngularJS with Restangular on client side. Development mode goes through browserSync with proxy to server. So all requests based on resource links (PUT, DELETE, GET) are failing on 'Access-Control-Allow-Origin' error.
I would be nice to have an option to enable/disable relative links generation.

[gregturn]

Spring HATEOAS observes x-forwarded-* headers. Case in point: http://spring-a-gram.cfapps.io forwards /api calls to spring-a-gram-backend.cfapps.io. Look at the following calls done to each, and you'll see the hostnames adjust properly.

$ curl -v -u greg:turnquist spring-a-gram.cfapps.io/api
{
  "_links" : {
    "galleries" : {
      "href" : "http://spring-a-gram.cfapps.io/api/galleries{?page,size,sort}",
      "templated" : true
    },
    "items" : {
      "href" : "http://spring-a-gram.cfapps.io/api/items{?page,size,sort,projection}",
      "templated" : true
    },
    "profile" : {
      "href" : "http://spring-a-gram.cfapps.io/api/alps"
    }
  }
}

Here is the same call straight to the backend:

$ curl -v -u greg:turnquist spring-a-gram-backend.cfapps.io/api
{
  "_links" : {
    "galleries" : {
      "href" : "http://spring-a-gram-backend.cfapps.io/api/galleries{?page,size,sort}",
      "templated" : true
    },
    "items" : {
      "href" : "http://spring-a-gram-backend.cfapps.io/api/items{?page,size,sort,projection}",
      "templated" : true
    },
    "profile" : {
      "href" : "http://spring-a-gram-backend.cfapps.io/api/alps"
    }
  }
}

To use shortcut tactics like relative paths to evade CORS sounds like the wrong solution and a band-aid response in lieu of configuring your proxy with proper headers. If your angular app is not served from the location as your API gateway, a proper CORS policy is also a necessary setting.

[milanov]

I also needed that same funcitonality so I came up with this, which is not that sophisticated but works good (for now).

[moravcik]

Yes, setting proper X-Forwarded-Host header worked for me.

In my case I needed to add to browserSync proxy function:

req.headers["X-Forwarded-Host"] = req.headers.host;

[Doogiemuc]

I also support this: There should be at least a configuration so that the href URIs genreated by spring hateoas are relative. If you look at it from a REST client perspective: Most REST clients libraries have some kind of "backendBasePath" configured in a central place. Now if that client want's to follow a _link then it is always necessary to strip the backendBasePath from the URI to construct the request for the linked resource.

[odrotbohm]

Actually, IMO that's exactly arguing the wrong way around. Why would you bother the client with having to concatenate Strings if the alternative is just using what's available in href as is? That's basically throwing a key benefit of URIs away: the fact that you can hand them anyone and they stay resolvable. You can always come up with some weird stunts some clients do, but I am not sure I'd want to support introducing additional complexity.

What I am trying to say is: go ahead and create those URIs that are basically unresolvable as is for a client, but I am not sure we should elevate this suboptimal habit to a first-class framework featured style.

[Doogiemuc]

Hello Oliver!
I can understand both sides. Also your argument: "The URI actually IS the ID of that entitry" is a very valid argument.

But every REST client I have ever seen (might be just my liit personal experience) does have a backendBaseURL. (Think: While testing I want to use server A and in production I want to use server B). And that backendBaseURL is prepended to any request.

Examples for clients that behave like this: node-rest-client , restful.js etc.

In any client I know of it is actually the exception and needs some additional work, if you want to GET from an absolute URL.

Anyway: How can I configure relative URLs? I got it working half way:

  @Bean
  public ResourceProcessor<Resource<IdeaModel>> ideaProcessor() {
    return new ResourceProcessor<Resource<IdeaModel>>() {
      @Override
      public Resource<IdeaModel> process(Resource<IdeaModel> resource) {
        resource.add(new Link("/myideaLink/1", "idea"));
        return resource;
      }
    };
  }

But this adds a second href to "_links.idea" :-( I saw that the Link class actually uses UriTemplate which has a basURI. How do I set this?