|
此版本仍在开发中,尚未被视为稳定版本。如需最新稳定版本,请使用 Spring Boot 4.0.4! |
Spring HATEOAS
如果您开发了一个利用超媒体的 RESTful API,Spring Boot 提供了适用于 Spring HATEOAS 的自动配置,该配置可与大多数应用程序良好协作。
此自动配置取代了手动使用 @EnableHypermediaSupport 的需要,并注册了若干 Bean,以简化超媒体驱动型应用程序的构建工作,其中包括一个 LinkDiscoverers(用于客户端支持)以及一个已配置为将响应正确序列化为所需表示形式的 ObjectMapper。
ObjectMapper 可通过设置各类 spring.jackson.* 属性进行自定义;若存在,则也可通过一个 Jackson2ObjectMapperBuilder Bean 进行自定义。
您可以通过使用 @EnableHypermediaSupport 来控制 Spring HATEOAS 的配置。
请注意,这样做会禁用前面所述的 ObjectMapper 自定义功能。
spring-boot-starter-hateoas 专用于 Spring MVC,不应与 Spring WebFlux 混用。
若要在 Spring WebFlux 中使用 Spring HATEOAS,可直接添加对 org.springframework.hateoas:spring-hateoas 的依赖,并同时添加 spring-boot-starter-webflux 的依赖。 |
默认情况下,接受 application/json 的请求将收到 application/hal+json 响应。
要禁用此行为,请将 spring.hateoas.use-hal-as-default-json-media-type 设置为 false,并定义一个 HypermediaMappingInformation 或 HalConfiguration,以配置 Spring HATEOAS,满足您的应用程序及其客户端的需求。