Question

我正在关注Spring REST的教程，并尝试将HATEOAS链接添加到我的Controller结果中。

我有一个简单的User类和一个CRUD控制器。

class User {
    private int id;
    private String name;
    private LocalDate birthdate;
    // and getters/setters
}

服务：

@Component
class UserService {
    private static List<User> users = new ArrayList<>();
    List<User> findAll() {
        return Collections.unmodifiableList(users);
    }
    public Optional<User> findById(int id) {
        return users.stream().filter(u -> u.getId() == id).findFirst();
    }
    // and add and delete methods of course, but not important here
}

一切正常，除了在我的控制器中，我想将所有用户列表中的链接添加到单个用户：

import static org.springframework.hateoas.mvc.ControllerLinkBuilder.linkTo;
import static org.springframework.hateoas.mvc.ControllerLinkBuilder.methodOn;

@RestController
public class UserController {
    @Autowired
    private UserService userService;
    @GetMapping("/users")
    public List<Resource<User>> getAllUsers() {
        List<Resource<User>> userResources = userService.findAll().stream()
            .map(u -> new Resource<>(u, linkToSingleUser(u)))
            .collect(Collectors.toList());
        return userResources;
    }
    Link linkToSingleUser(User user) {
        return linkTo(methodOn(UserController.class)
                      .getById(user.getId()))
                      .withSelfRel();
    }

这样，对于结果列表中的每个用户，都会添加一个指向用户自身的链接。

链接本身创建正常，但结果JSON中有多余的条目：

[
    {
        "id": 1,
        "name": "Adam",
        "birthdate": "2018-04-02",
        "links": [
            {
                "rel": "self",
                "href": "http://localhost:8080/users/1",
                "hreflang": null,
                "media": null,
                "title": null,
                "type": null,
                "deprecation": null
            }
        ]
    }
]

具有空值（hreflang，media等）的字段来自哪里，为什么会添加它们？有没有办法摆脱它们？

在构建指向所有用户列表的链接时，它们不会出现：

@GetMapping("/users/{id}")
public Resource<User> getById(@PathVariable("id") int id) {
    final User user = userService.findById(id)
                                 .orElseThrow(() -> new UserNotFoundException(id));
    Link linkToAll = linkTo(methodOn(UserController.class)
                            .getAllUsers())
                            .withRel("all-users");
    return new Resource<User>(user, linkToAll);
}

Answer 1

如果有其他人偶然发现这个问题并进行了进一步的参考，我认为：我在application.properties添加了一个条目，即

spring.jackson.default-property-inclusion=NON_NULL

为什么这对于Link个对象是必要的，但对于我不知道的User是不必要的（并且没有深入分析）。

Answer 2

根据Spring HATEOAS #493，“由于您的顶层结构不是有效的HAL结构，因此绕过了HAL序列化程序。”

要解决此问题，请使用：

return new Resources<>(assembler.toResources(sourceList));

这将在Spring HATEOAS的将来版本中解决，在该版本中toResources（Iterable <>）返回资源或使用SimpleResourceAssembler。

Answer 3

就像半情报所暗示的那样，问题在于您的List返回对象不是有效的HAL类型：

public List<Resource<User>> getAllUsers()

可以通过将返回类型更改为“资源”来轻松解决：

public Resources<Resource<User>> getAllUsers()

然后可以通过将return语句从以下位置更改为

，将Resource <>列表简单地包装到Resources <>对象中：

return userResources;

收件人：

return new Resources<>(userResources)

然后，您应该像对待单个对象一样获得正确的链接序列化。

此方法由以下非常有用的文章提供，以解决此问题：

https://www.logicbig.com/tutorials/spring-framework/spring-hateoas/multiple-link-relations.html

Answer 4

为避免链接中的其他属性"hreflang": null, "media": null, "title": null, ...，我建立了一个包装器类，如：

@JsonInclude(JsonInclude.Include.NON_NULL)
public class WsDtoLink extends Link {
    public WsDtoLink(Link link) {
        super(link.getHref(), link.getRel());
    }
}

然后我将org.springframework.hateoas.Resource扩展为覆盖add(Link link)：

public class WsDtoResource<T extends WsDto> extends Resource<T> {
    @Override
    public void add(Link link) {
        super.add(new WsDtoLink(link));
    }

}

然后，我扩展了org.springframework.data.web.PagedResourcesAssembler，以修复分页链接，如下所示：

public class WsDtoPagedResourceAssembler<T> extends PagedResourcesAssembler<T> {
    public WsDtoPagedResourceAssembler(HateoasPageableHandlerMethodArgumentResolver resolver, UriComponents baseUri) {
        super(resolver, baseUri);
    }

    @Override
    public PagedResources<Resource<T>> toResource(Page<T> page, Link selfLink) {
        PagedResources<Resource<T>> resources = super.toResource(page, new WsDtoLink(selfLink));
        exchangeLinks(resources);
        return resources;
    }

    @Override
    public <R extends ResourceSupport> PagedResources<R> toResource(Page<T> page, ResourceAssembler<T, R> assembler, Link link) {
        PagedResources<R> resources = super.toResource(page, assembler, new WsDtoLink(link));
        exchangeLinks(resources);
        return resources;
    }

    @Override
    public PagedResources<?> toEmptyResource(Page<?> page, Class<?> type, Link link) {
        PagedResources<?> resources = super.toEmptyResource(page, type, new WsDtoLink(link));
        exchangeLinks(resources);
        return resources;
    }

    private void exchangeLinks(PagedResources<?> resources) {
        List<Link> temp = new ArrayList<>(resources.getLinks()).stream()
            .map(WsDtoLink::new)
            .collect(Collectors.toList());
        resources.removeLinks();
        resources.add(temp);
    }
}

但是更好的解决方案是产生正确的媒体类型org.springframework.hateoas.MediaTypes.HAL_JSON_VALUE。在我的情况下，我们制作了org.springframework.http.MediaType.APPLICATION_JSON_VALUE，这是不正确的，但是如果以后进行更改，它将破坏客户。

Answer 5

将此依赖项添加到pom中。检查此链接： https://www.baeldung.com/spring-rest-hal

<dependency>
        <groupId>org.springframework.data</groupId>
        <artifactId>spring-data-rest-hal-browser</artifactId>
</dependency>

它将改变您的回复。

"_links": {
    "next": {
        "href": "http://localhost:8082/mbill/user/listUser?extra=ok&page=11"
    }
}

Spring Hateoas ControllerLinkBuilder添加了空字段

5 个答案: