Tag: contract first

WADL /使用Jersey以合同为先的方式生成XSD

我一直在使用Jersey进行REST Web服务工作几天，并设法使所有的CRUD操作工作，有几种交换格式：XML，JSON，Google Protobuf。 不过，我正面临一些与自动生成的WADL和XSD有关的问题。 上下文 为了定义以这三种格式交换的对象，我遵循了“合同优先”的方法 ： 从我写的XSD中，我使用JAXB生成了我的模型类; 从我写的一个等价的原始文件中，我生成了Google Protobuf类（并且在内部有一种将这些类转换为JAXB生成的对象的方法，以便拥有一个独特的模型）。 但是，因为我希望我的用户也能够生成他们的类 ，所以我想共享这些模式文件（.xsd和.proto），并将它们与自动生成的WADL很好地集成在一起 。 为此，感谢这个 wiki页面： 我已经暴露了两个文件下 /schema/schema.xsd /schema/schema.proto 我已经添加了一个应用程序语法文件： <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <grammars xmlns="http://wadl.dev.java.net/2009/02" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xi="http://www.w3.org/1999/XML/xinclude"> <include href="../schema/schema.xsd" /> </grammars> 我已经添加了一个定制的WADL生成器： public class RichWadlGeneratorConfig extends WadlGeneratorConfig { @Override public List<WadlGeneratorDescription> configure() { return generator(WadlGeneratorApplicationDoc.class) .prop("applicationDocsStream", "application-doc.xml") .generator(WadlGeneratorGrammarsSupport.class) .prop("grammarsStream", "application-grammars.xml") .descriptions(); } } 这样下面出现在WADL中，当我打到/rest/application.wadl ： […]