SpringBoot中的HATEOAS詳情

2022-05-17 10:01:14

簡介

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);

總結

上講解的Link，URI templates，Link relations和RepresentationModel就是Spring HATEOAS的基礎，掌握了他們基本上就掌握了Spring HATEOAS。

到此這篇關於SpringBoot中的HATEOAS詳情的文章就介紹到這了,更多相關HATEOAS內容請搜尋it145.com以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援it145.com！

SpringBoot中的HATEOAS詳情

目錄

簡介

連結Links

URI templates

Link relations

Representation models

總結

熱門文章