在Jersey中使用HAL实现HATEOAS

Question

构建RESTful API的关键之一是HATEOAS。 现在，泽西岛提供了很好的链接能力（见这个链接 ）。 但我已经看到了HAL规范的草案，它似乎是一个经过深思熟虑的工作。

如果有一些lib可以很容易地在泽西岛坚持HAL，我感兴趣。 我已经看到草案中提到的引用，如https://github.com/HalBuilder 。 但是我使用的是直接POJO编组，我不知道如何将它与Halbuilder混合使用。

那么，是否已经有一些将HAL纳入泽西的库？ 或者我可以使用某种过滤器手动增强生成的POJO？ 如果是的话，有人可以给我一个线索在哪里看到下一步来完成这个？

Answer 1

我在泽西岛找不到任何直接的支持，但是应该有方法来定制Jersey用来将你的POJO转换为JSON的编组器。 （通过使用HalBuilder，或创建一些自己的HAL兼容代码）

如果您使用基于 Jerseys JAXB的JSON支持 ，请查看jettison源代码中的BootstrapTypeConverterTest ，该代码演示了如何使用转换器来定制JSON输出。 对JSON进行单元测试转换应该是一项简单的任务，而jettison-project有很好的例子可供查看。

如果您使用Jerseys “POJO Support”方法 ，请查看JacksonHowToCustomSerializers，了解有关如何创建自定义序列化程序的类似示例。

（如果涉及到JAXB，您还可以执行诸如处理自定义注释之类的很酷的事情。）

您可能非常了解对象（输入）的外观以及您期望的JSON代码（输出），因此为这些转换创建单元测试应该是一项相对简单的任务。

Answer 2

即使这不是一个真正的答案，我没有足够的字符把它放在评论中:)

如果你真的是REST的新手，我认为你的开始可能是错误的。 我不确切地知道你的要求，但是如果你只想学习，从简单的REST服务开始，使用.net中的Web API或类似的Java（一个简单的servlet就足够了）并尝试实现一个服务仅使用http提供的工具（动词，请求标头和有效负载，响应消息）。 来自MarcMassé的REST API设计规则手册可以成为学习的好参考。 使用POJO或POCO创建自己的通信协议，一旦您确实可以执行REST以及它如何工作，您就可以使用框架来简化您的工作。

如果您从框架开始，您可能会错过概念的本质......

我希望它有所帮助！

Answer 3

遵守HAL所需要的很少。 我建议您滚动自己的迷你库，在那里将POJO包装在HAL对象中。 通过这种方式，您可以按照自己喜欢的方式获取代码，这将比HalBuilder更简单。