12

3 级RESTful API 的功能自定义媒体类型application/vnd.service.entity.v1+json，例如，。在我的例子中，我使用HAL在我的 JSON 中提供相关资源之间的链接。

我不清楚使用 HAL+JSON 的自定义媒体类型的正确格式。我目前拥有的，看起来像application/vnd.service.entity.v1.hal+json。我最初选择了application/vnd.service.entity.v1+hal+json，但+hal后缀未注册，因此违反了 RFC6838 的第 4.2.8 节。

现在 Spring HATEOAS 支持开箱即用的 JSON 链接，但对于 HAL-JSON，您需要使用@EnableHypermediaSupport(type=EnableHypermediaSupport.HypermediaType.HAL). 就我而言，因为我使用的是 Spring Boot，所以我将它附加到我的初始化程序类（即，扩展类SpringBootServletInitializer）。但是 Spring Boot 不会立即识别我的自定义媒体类型。因此，为此，我必须弄清楚如何让它知道它需要将 HAL 对象映射器用于表单的媒体类型application/vnd.service.entity.v1.hal+json。

对于我的第一次尝试，我在 Spring Boot 初始化程序中添加了以下内容：

@Bean
public HttpMessageConverters customConverters() {
    MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();
    converter.setSupportedMediaTypes(Arrays.asList(
            new MediaType("application", "json", Charset.defaultCharset()),
            new MediaType("application", "*+json", Charset.defaultCharset()),
            new MediaType("application", "hal+json"),
            new MediaType("application", "*hal+json")
    ));

    CurieProvider curieProvider = getCurieProvider(beanFactory);
    RelProvider relProvider = beanFactory.getBean(DELEGATING_REL_PROVIDER_BEAN_NAME, RelProvider.class);
    ObjectMapper halObjectMapper = beanFactory.getBean(HAL_OBJECT_MAPPER_BEAN_NAME, ObjectMapper.class);

    halObjectMapper.registerModule(new Jackson2HalModule());
    halObjectMapper.setHandlerInstantiator(new Jackson2HalModule.HalHandlerInstantiator(relProvider, curieProvider));

    converter.setObjectMapper(halObjectMapper);

    return new HttpMessageConverters(converter);
}

这有效，我以正确的 HAL 格式获取链接。然而，这是巧合。这是因为最终被报告为“兼容”的实际媒体类型application/vnd.service.entity.v1.hal+json是*+json; 它不承认它反对application/*hal+json（见后面的解释）。我不喜欢这个解决方案，因为它污染了现有的 JSON 转换器，担心 HAL。所以，我做了一个不同的解决方案，如下所示：

@Configuration
public class ApplicationConfiguration {

    private static final String HAL_OBJECT_MAPPER_BEAN_NAME = "_halObjectMapper";

    @Autowired
    private BeanFactory beanFactory;

    @Bean
    public HttpMessageConverters customConverters() {
        return new HttpMessageConverters(new HalMappingJackson2HttpMessageConverter());
    }

    private class HalMappingJackson2HttpMessageConverter extends MappingJackson2HttpMessageConverter {
        public HalMappingJackson2HttpMessageConverter() {
            setSupportedMediaTypes(Arrays.asList(
                new MediaType("application", "hal+json"),
                new MediaType("application", "*hal+json")
            ));

            ObjectMapper halObjectMapper = beanFactory.getBean(HAL_OBJECT_MAPPER_BEAN_NAME, ObjectMapper.class);
            setObjectMapper(halObjectMapper);
        }
    }
}

该解决方案不起作用；我最终在我的 JSON 中获得了不符合 HAL 的链接。这是因为application/vnd.service.entity.v1.hal+json不被. application/*hal+json发生这种情况的原因是MimeType，它检查媒体类型兼容性，只识别以*+作为子类型的有效通配符媒体类型开头的媒体类型（例如，application/*+json）。这就是第一个解决方案奏效的原因（巧合）。

所以这里有两个问题：

  • MimeType永远不会识别application/vnd.service.entity.v1.hal+json针对application/*hal+json.
  • MimeType 将application/vnd.service.entity.v1+hal+json识别针对的表单的供应商特定 HAL 媒体类型application/*+hal+json，但是根据 RFC6838 的第 4.2.8 节，这些是无效的 mimetypes 。

似乎唯一正确的方法是 if+hal被识别为有效后缀，在这种情况下，上面的第二个选项就可以了。否则，任何其他类型的通配符媒体类型都无法专门识别供应商特定的 HAL 媒体类型。唯一的选择是用 HAL 问题覆盖现有的 JSON 消息转换器（参见第一个解决方案）。

现在的另一个解决方法是在为消息转换器创建支持的媒体类型列表时指定您正在使用的每个自定义媒体类型。那是：

@Configuration
public class ApplicationConfiguration {

    private static final String HAL_OBJECT_MAPPER_BEAN_NAME = "_halObjectMapper";

    @Autowired
    private BeanFactory beanFactory;

    @Bean
    public HttpMessageConverters customConverters() {
        return new HttpMessageConverters(new HalMappingJackson2HttpMessageConverter());
    }

    private class HalMappingJackson2HttpMessageConverter extends MappingJackson2HttpMessageConverter {
        public HalMappingJackson2HttpMessageConverter() {
            setSupportedMediaTypes(Arrays.asList(
                new MediaType("application", "hal+json"),
                new MediaType("application", "vnd.service.entity.v1.hal+json"),
                new MediaType("application", "vnd.service.another-entity.v1.hal+json"),
                new MediaType("application", "vnd.service.one-more-entity.v1.hal+json")                       
            ));

            ObjectMapper halObjectMapper = beanFactory.getBean(HAL_OBJECT_MAPPER_BEAN_NAME, ObjectMapper.class);
            setObjectMapper(halObjectMapper);
        }
    }
}

这样做的好处是不会污染现有的 JSON 转换器，但似乎不够优雅。有谁知道正确的解决方案？我会完全错了吗？

4

1 回答 1

4

虽然这个问题有点老了，但我最近偶然发现了同样的问题，所以我想把我的 2 美分给这个话题。

我认为这里的问题是对 HAL 对 JSON 的理解。正如您在此处已经指出的那样，所有 HAL 都是 JSON，但并非所有 JSON 都是 HAL。根据我的理解，两者之间的区别在于，HAL 为语义/结构定义了一些约定，比如告诉你在属性后面，_links你会找到一些链接，而 JSON 只是定义了格式key: [value]（如 @zeroflagL 已经提到的）

这就是为什么调用媒体类型的原因application/hal+json。它基本上说它是 JSON 格式的 HAL 样式/语义。这也是存在媒体类型application/hal+xml（source）的原因。

现在使用供应商特定的媒体类型，您可以定义自己的语义，因此您可以替换halinapplication/hal+json而不要扩展它。

如果我理解正确，您基本上想说您有一个自定义媒体类型，它使用 HAL 样式作为它的 JSON 格式。（这样，客户端可以使用一些 HAL 库来轻松解析您的 JSON。）

因此，最后我认为您基本上必须决定是否要区分 JSON 和基于 HAL 的 JSON，以及您的 API 是否应该提供其中之一或两者。

如果要同时提供两者，则必须定义两种不同的媒体类型vnd.service.entity.v1.hal+jsonAND vnd.service.entity.v1+json。对于vnd.service.entity.v1.hal+json媒体类型，您必须添加自定义MappingJackson2HttpMessageConverter的，使用_halObjectMapper返回基于 HAL 的 JSON，而+json默认情况下支持媒体类型，以良好的旧 JSON 返回您的资源。

如果您总是想提供基于 HAL 的 JSON，则必须启用 HAL 作为默认 JSON-Media 类型（例如，通过添加MappingJackson2HttpMessageConverter支持该+json媒体类型并使用_halObjectMapper前面提到的自定义），因此每个请求application/vnd.service.entity.v1+json都由此转换器返回基于 HAL 的 JSON。

在我看来，我认为正确的方法是仅区分 JSON 和 XML 等其他格式，并且在您的媒体类型文档中，您会说您的 JSON 是受 HAL 启发的，客户端可以使用 HAL 库来解析响应.


编辑：

要绕过您必须分别添加每个供应商特定媒体类型的问题，您可以覆盖要添加到自定义媒体类型的isCompatibleWith方法MappingJackson2HttpMessageConverter

converter.setSupportedMediaTypes(Arrays.asList(
            new MediaType("application", "doesntmatter") {
                @Override
                public boolean isCompatibleWith(final MediaType other) {
                    if (other == null) {
                        return false;
                    }
                    else if (other.getSubtype().startsWith("vnd.") && other.getSubtype().endsWith("+json")) {
                        return true;
                    }
                    return super.isCompatibleWith(other);
                }
            }
));
于 2015-04-16T13:36:05.983 回答