java - 矩阵变量产生不正确的 HATEOAS 链接

Question

编辑

我现在已经在两个不同的应用程序服务器上对此进行了测试:Tomcat 8.0.15 和 JBoss 6.2 EAP。在 Tomcat 上生成正确的链接，在 JBoss 上生成错误的链接。我还创建了一个小示例项目来演示该问题:

https://github.com/Vile2539/hateoas-link-test/tree/master

原始问题

我最近更改了一些 Spring REST 服务以使用 matrix variables而不是路径变量。然而，这导致 ControllerLinkBuilder 生成一些不正确的 HATEOAS 链接。

我目前拥有的:

Controller 方法

有一个整体@RequestMapping的/test-items关于这一点。另外，根据我的理解和测试，@PathVariable是必需的，因为仅 URL 模板是不够的。这就是为什么 {fullString}存在。

@RequestMapping(value = "/{fullString}/test", method = RequestMethod.GET, produces = {MediaType.APPLICATION_JSON_VALUE + ";charset=UTF-8"})
@ResponseBody
public PagedCollectionResource test(@PathVariable String fullString, @MatrixVariable String testVariable, Pageable pageable) {
    Link link = linkTo(methodOn(TestControllerImpl.class).test(fullString, testVariable, pageable)).withSelfRel();
    Page<TestItem> testItems = testService.getPagedTestItems(testVariable, pageable);
    return testService.getPagedCollectionResource(testItems, link);
}

Spring 配置

<mvc:annotation-driven enable-matrix-variables="true">
    <mvc:path-matching path-helper="pathHelper"/>
    <mvc:argument-resolvers>
        <bean class="org.springframework.data.web.PageableHandlerMethodArgumentResolver"/>
    </mvc:argument-resolvers>
</mvc:annotation-driven>

<bean id="pathHelper" class="org.springframework.web.util.UrlPathHelper">
    <property name="alwaysUseFullPath" value="true"/>
    <property name="urlDecode" value="false"/>
    <property name="removeSemicolonContent" value="false"/>
</bean>

服务电话

http://localhost:8080/testItem/test-items/stringhere;testVariable=036/test

结果

"links":[{"rel":"self","href":"http://localhost:8080/testItem/test-items/stringhere/test-items/stringhere;testVariable=036/test{?page,size,sort}"}]

如您所见，还有一个额外的 /test-items/stringhere因为某些原因。我几乎可以肯定这是由矩阵变量引起的，而且似乎是在 ControllerLinkBuilder 期间。 methodOn打电话，但我不明白为什么。

是否有人对如何解决此问题有任何建议，或者(理想情况下)解决此问题并消除对 {fullString} 的需要？路径变量？

其他问题

此外，使用矩阵变量的原因是为了解决 URL 编码问题。我之前用连字符 - 分隔路径变量，所以类似:

{variable1}-{variable2}

不幸的是，两者都可以包含特殊字符，例如 / , - , &等。使用alwaysUseFullPath和urlDecode上面看到的属性，我能够传递大多数编码的特殊字符 - 因此用正斜杠调用上面的内容将是:

/test-items/%2Fab-v%2Fc/test
variable1 = /ab
variable2 = v/c

但是，这不适用于连字符 - 编码的连字符将未编码并导致错误的路径变量:

/test-items/a%2db-vc/test
variable1 = a
variable2 = b-vc

然而，对连字符进行双重编码确实有效 - 但显然是一个可怕的黑客行为。

如果有人对在维护 GET 调用的同时解决此问题有任何建议，我将非常感激。无法对 URL 中字符的顺序或类型做出任何假设(因此路径变量不能简单地用 2 个连字符分隔)。

Answer 1

更新有点晚，但工作繁忙。

我通过为我自己的 LinkBuilder 类扩展 LinkBuilderSupport 解决了这个问题:

public class RootContextLinkBuilder extends LinkBuilderSupport<RootContextLinkBuilder> {
    ...
}

初始实现的问题出在 getBuilder() 方法中。 ControllerLinkBuilder 使用了 ServletUriComponentsBuilder.fromServletMapping(request);，我将其更改为 ServletUriComponentsBuilder.fromContextPath(request);。现在它会生成正确的 href，并以与 ControllerLinkBuilder 相同的方式进行调用。

对于我的附加问题，我们坚持使用矩阵变量，因此没有解决这个问题。