我已经使用Jersey工作了几天的REST Web服务,并设法让所有CRUD操作工作,有几种交换格式:XML,JSON,Google Protobuf.

但是,我面临一些与自动生成的WADL和XSD相关的问题.

上下文

为了定义以这三种格式交换的对象,我遵循了"契约优先"的方法:

• 从我写的XSD中,我使用JAXB生成了我的模型类;
• 从我写的等效原型文件中,我生成了Google Protobuf类(并且内部有一种方法可以将这些转换为JAXB生成的对象,以便拥有一个独特的模型).

但是,由于我希望我的用户也能够生成他们的类,我想分享这些模式文件(.xsd和.proto)并将它们与自动生成的WADL很好地集成.

为此,感谢这个维基页面:

• 我已经公开了这两个文件
  • /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>
  

  Run Code Online (Sandbox Code Playgroud)

• 我添加了一个自定义的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();
      }
   }
  

  Run Code Online (Sandbox Code Playgroud)

这样,当我点击时,下面出现在WADL中/rest/application.wadl:

<grammars>
     <include href="../schema/schema.xsd"/>
     <include href="application.wadl/xsd0.xsd">
          <doc title="Generated" xml:lang="en"/>
     </include>
</grammars>

问题

/rest/application.wadl/xsd0.xsd是从我的课程自动生成的,但与我最初的课程有很大的不同schema.xsd.除此之外,调用像wadl2java这个WADL 这样的工具失败了,大概是因为

• /schema/schema.xsd …

哪种是开发Web服务的更好方法; 合同第一或合同最后？
各有哪些优缺点？

你有哪些经验？

编辑 这个问题是关于Web服务的实现(读取:SOAP)问题是实现类是否应该首先编码,WSDL和XSD模式是从那里生成的(最后合同)还是首先编写的WSDL和XSD模式以及生成的实现类(合同优先)

在实际情况中,这个问题更多的是探索人们在社区中所做的事情,而非特定目标问题.我已经对此进行了广泛的搜索,虽然我发现许多博客主张提出契约优先服务设计并且有一些评论支持它们,但我还没有找到关于实施与WCF合同优先的实用信息,优缺点我在最近对SOA进行了一些广泛的研究,主要是通过Thomas Erl的书籍,他提倡的主要概念之一是契约优先设计.

我的问题如下:

1. 您如何使用.NET和WCF实现契约优先服务设计？
2. 除了svcutil之外还有其他工具可以从合同生成客户端和服务吗？(任何与VS集成的东西都是理想的)
3. 合约优先设计和wCF遇到了哪些真实的专业人士？
4. 合同优先设计和WCF遇到了什么现实世界的缺点？

合同优先发展的主要问题之一似乎是工具.Svcutil是我发现的唯一可以从合同生成服务代码的东西,它有一些非常差的输出.它的单个文件,充满了属性和代码生成工件,它基本上需要在合同更新时重新生成和替换.我更喜欢更好的方法,最好是不需要再生更换的方法.我甚至可以手动创建服务端合同,假设它在实际场景中是实用的.

编辑:

虽然WCSF解决了我的迫切需求,但了解协议缓冲区和服务工厂都是有趣的工具,我相信这些工具将在未来帮助我.

我手动创建了一个WSDL,它只有一个没有输入参数且没有输出参数的操作.

当我尝试从此WSDL创建客户端时,我收到以下错误:

无法导入wsdl:portType详细信息:运行WSDL导入扩展时抛出异常:System.ServiceModel.Description.DataContractSerializerMessageContractImporter错误:具有目标命名空间的架构" http://www.xmlns.mycompany.com/GAME/service/Associate/ 1.1 / '无法找到.XPath到错误源:// wsdl:definitions [@ targetNamespace =' http://www.xmlns.mycompany.com/GAME/service/Associate/1.1/']/wsdl:portType [@ name ='GAMEAssociateIntf'] C :\工具箱\ BlueTest\BloodRedTest\BloodRedTest \服务

的types (在客户机中使用)需要从本WSDL中的XML生成.我认为,在添加服务引用时,由于XML中的一些错误,该工具无法创建它.该XSD似乎是问题.

需要在WSDL中进行哪些更改才能创建代理？

注意:我试图包含WSDL本身定义的xml类型.[我不需要单独的文件进行架构保护]

WSDL

<?xml version="1.0" encoding="UTF-8"?>
<definitions name="GAMEAssociate" 
         targetNamespace="http://www.xmlns.mycompany.com/GAME/service/Associate/1.1/"
         xmlns:tns="http://www.xmlns.mycompany.com/GAME/service/Associate/1.1/"
         xmlns="http://schemas.xmlsoap.org/wsdl/" 
         xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" 
         xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" 
         xmlns:xsd="http://www.w3.org/2001/XMLSchema"
         xmlns:wsp="http://www.w3.org/ns/ws-policy"
         >

<types>
<xsd:schema>
</xsd:schema>

<xsd:element name="myData">
  <xsd:complexType />
</xsd:element>

<xsd:element name="myDataResponse">
  <xsd:complexType />
</xsd:element>

</types>

<message name="getAllVicePresidentsRequest">
<part element="tns:myData" name="getAllVicePresidentsRequest"/>
</message>

<message name="getAllVicePresidentsResponse">
<part element="tns:myDataResponse" name="getAllVicePresidentsResponse"/>
</message>

<portType name="GAMEAssociateIntf">
<operation name="getAllVicePresidents">
  <input message="tns:getAllVicePresidentsRequest"/>
  <output message="tns:getAllVicePresidentsResponse"/>
</operation>
</portType>

<binding name="GAMEAssociateIntfBinding" type="tns:GAMEAssociateIntf"> …

我使用SvcUtil.exe从wsdl文件生成IClassName.cs文件,这是正常的.我的问题是我不知道如何使用SvcUtil.exe的命令参数生成ClassName.svc文件.

运行SvcUtil.exe之后,我想获得WCF服务,就像从包含所有类*.svc,*.cs和interface的Visual Studio向导创建时一样.

谢谢,Skrch

我正在尝试使用Swagger Codegen » 2.2.1生成一些 Web 服务定义

https://springboot-base-save-return.appdes.xnet/saveBackendReturn

https://springboot-base-save-return.appdes.xnet/v1/saveBackendReturn

swagger: '2.0'
info:
  description: My Project
  version: 1.0.0
  title: Save Backend Return
host: springboot-base-save-return.appdes.xnet
basePath: /v1
tags:
  - name: saveBackendReturn
    description: Save Backend Return
schemes:
  - https
paths:
  /saveBackendReturn:
    post:
      tags:
        - saveBackendReturn
      summary: Save Backend Return
      description: My Project
      operationId: saveBackendReturn
      consumes:
        - application/json
      produces:
        - application/json
      parameters:
        - …