SpringBoot中的HATEOAS详情
作者：??程序那些事???? 发布时间：2022-12-27 03:12:31
简介
SpringBoot提供了HATEOAS的便捷使用方式，本文详细讲解SpringBoot提供的这些基本方法。
链接Links
HATEOAS的一个非常重要的特征就是在resources资源中包含超媒体，而超媒体最简单的表示就是链接。
Spring HATEOAS为我们简化了封装Links的功能。
我们看一个HTML中的link标签的例子：
<head>
<link rel="stylesheet" type="text/css" href="theme.css" rel="external nofollow" />
</head>
可以看到一个link有两个比较重要的属性，一个是href代表link的链接，还有一个属性是rel表示的当前文档与被链接文档之间的关系。
我们看下Link中的关键方法：
public static Link of(String href) {
return new Link(href);
}
public static Link of(String href, String relation) {
return new Link(href, relation);
}
public static Link of(String href, LinkRelation relation) {
return new Link(href, relation);
}
可以传入href和relation来构建一个Link对象。
看下面的例子：
Link link = Link.of("/something");
link = Link.of("/something", "my-rel")
其中LinkRelation是关联关系的一个封装接口，注意，它是一个接口，我们可以使用IanaLinkRelations中的具体实现来对其赋值，如下所示：
LinkRelation REL_SELF = IanaLinkRelations.SELF;
LinkRelation REL_FIRST = IanaLinkRelations.FIRST;
LinkRelation REL_PREVIOUS = IanaLinkRelations.PREV;
LinkRelation REL_NEXT = IanaLinkRelations.NEXT;
LinkRelation REL_LAST = IanaLinkRelations.LAST;
URI templates
上面的例子中link是指定好的，是静态的。有时候我们希望link可以根据参数进行变换，那么这样的link就是动态的link，我们可以通过定义URI模板来实现。
所以Link还可以通过UriTemplate来构建：
public static Link of(UriTemplate template, String relation) {
return new Link(template, relation);
}
public static Link of(UriTemplate template, LinkRelation relation) {
return new Link(template, relation);
}
UriTemplate是对URI模板的封装，我们看一个使用的例子：
Link link = Link.of("/{segment}/something{?parameter}");
Map<String, Object> values = new HashMap<>();
values.put("segment", "path");
values.put("parameter", 42);
assertThat(link.expand(values).getHref())
.isEqualTo("/path/something?parameter=42");
上面的例子中，通过string来构建一个link，然后调用expand传入参数对应的map，来构建真实的href值。
除了直接使用string之外，还可以传入UriTemplate：
UriTemplate template = UriTemplate.of("/{segment}/something")
.with(new TemplateVariable("parameter", VariableType.REQUEST_PARAM);
assertThat(template.toString()).isEqualTo("/{segment}/something{?parameter}");
Link relations
Link relations指的是link中的ref属性。代表的是当前文档与被链接文档之间的关系。Spring HATEOAS中有一个LinkRelation类来表示。
IANA（Internet Assigned Numbers Authority）预定义了一些relations，可以通过IanaLinkRelations这个类来获取，如下所示：
Link link = Link.of("/some-resource"), IanaLinkRelations.NEXT);
assertThat(link.getRel()).isEqualTo(LinkRelation.of("next"));
assertThat(IanaLinkRelation.isIanaRel(link.getRel())).isTrue();
Representation models
我们需要访问的是一个个的资源，然后需要在一个个的资源中加入link，Spring HATEOAS为我们提供了一个简单的类叫做RepresentationModel。它包含了Links和一些很方便的方法来帮助我们创建带链接的资源。
最简单的使用方法就是创建一个RepresentationModel的子类：
public class BookModel extends RepresentationModel<BookModel> {
private final Book content;
}
我们通过add方法来对其添加link：
bookModel.add(linkTo(methodOn(BookController.class).getBook(id)).withSelfRel());
注意：在这种情况下，我们的Accept类型应该是application/hal+json。
对于简单类型，我们可以直接使用EntityModel对其进行封装：
Person person = new Person("Dave", "Matthews");
EntityModel<Person> model = EntityModel.of(person);
对于集合，可以使用CollectionModel：
Collection<Person> people = Collections.singleton(new Person("Dave", "Matthews"));
CollectionModel<Person> model = CollectionModel.of(people);
来源：https://juejin.cn/post/7098227610496270343
0
投稿猜你喜欢
- 本文实例讲述了Android实现ListView数据动态加载的方法。分享给大家供大家参考，具体如下：list.setOnScrollList
我相信现在绝大部分App几乎避免不了消息推送，其实原理还是使用了长连接，通过服务端将消息推给客户端。市面上也有不少三方库，例如极光、友盟、个- 1.JSON数据交互1.1 JSON概述JSON 是一种轻量级的数据交换格式，是一种理想的数据交互语言，它易于阅读和编写，同时也易于机器解析
- class MyThreadScopeData { // 单例 &nbs
- Android中实现进度条有很多种方式，自定义进度条一般是继承progressBar或继承view来实现，本篇中讲解的是第二种方式。先上效果
- 1.with 函数首先先从with函数开始，with函数接受两个参数，第一个参数可以是一个任意类型的对象，第二个参数是一个Lambda表达式
- 前言在电商的应用中，最常见的就是在首页或完成某事件之后，弹出一堆的活动/广告。假如重叠弹出，很丑，给用户的体验也不好，所以一般都会依次依条件
- 前言可能对于很多新人来讲，看到这个题目，想到的能接收输入法输入的内容大概只有EditText和TextView这两个控件了，其实不然，只要是
- 一、mybatis-plus简介：Mybatis-Plus（简称MP）是一个 Mybatis 的增强工具，在 Mybatis 的基础上只做增
- 1.数据类型的分类Java的数据类型主要分为两类：基本数据类型、引用数据类型Java中的字符串String属于引用数据类型。因为String
- 前言你一定会好奇：“老周，你去哪开飞机了？这么久没写博客了。”老周：“我买不起飞机，开了个铁矿，挖了一年半的石头。谁知铁矿垮了，压死了几条蜈
- 一、ViewPageIndicator开源框架的基本用法 我们先得去Github上面下载这个库，下载地址：https://github.co
- 一、进行粒子效果生成练习1、生成一个空项目Assets->Import Package->Custom Package->
- 本文实例讲述了C#接口在派生类和外部类中的调用方法。分享给大家供大家参考，具体如下：C#的接口通过interface关键字进行创建，在接口中
- C#是一门支持多线程的语言，因此线程的使用也是比较常见的。由于线程的知识在Win32编程的时候已经说得过多，所以在.Net中很少介绍这部分（
- API:接口概念：API(Application Programming Interface),应用程序编程接口，Java API是一本程序
- 本文实例讲述了Java实现的对称加密算法AES定义与用法。分享给大家供大家参考，具体如下：一 简介1、AES是目前使用最多的对称加密算法。2
- 前言在上一篇 Spring boot + LayIM + t-io 文件上传、 监听用户状态的实现 中，已经介绍了两个小细节：用户的在离线状
- 背景在做社交类平台开发的小伙伴都躲不开选择社交个性标签的业务需求，那么实现这个UI效果我想大伙第一时间想到的必定是RecycleView或G
- 本文实例讲述了java生成随机数的方法。分享给大家供大家参考。具体实现方法如下：package com.tool.code; import
