从 Swagger 生成 .NET 客户端 [关闭]

Question

我可以使用什么工具来生成 .NET 客户端以从 Swagger 定义中使用？

例如，我开始尝试 NSwag Studio，我希望能够生成看起来像我习惯创建的 Repository 类的代码。

希望删除问题的选民注意：问题的答案和 cmets 对读者有用，因此删除不是一个好主意。 由于 SO 不允许针对书籍、工具、软件库寻求建议的问题，因此该问题应保持关闭状态或（甚至更好）考虑迁移到 http://softwarerecs.stackexchange.com

Answer 1

您可以使用 swagger 项目中的 swagger-codegen 工具。它生成的 C# 文件使用

• RestClient 用于 HTTP 调用
• Newtonsoft.Json 用于 json 编组
• .NET DataContract 用于模型。

您可以下载cli app 或使用online editor。 petstore 示例模型如下所示：

using System;
using System.Text;
using System.Collections;
using System.Collections.Generic;
using System.Runtime.Serialization;
using Newtonsoft.Json;

namespace IO.Swagger.Model {

    /// <summary>
    /// 
    /// </summary>
    [DataContract]
    public class Order {
      /// <summary>
      /// Gets or Sets Id
      /// </summary>
      [DataMember(Name="id", EmitDefaultValue=false)]
      [JsonProperty(PropertyName = "id")]
      public long? Id { get; set; }

      /// <summary>
      /// Gets or Sets PetId
      /// </summary>
      [DataMember(Name="petId", EmitDefaultValue=false)]
      [JsonProperty(PropertyName = "petId")]
      public long? PetId { get; set; }
 .... snip ....
}

Answer 2

您可能想试试 OpenAPI Generator (https://github.com/OpenAPITools/openapi-generator)，它同时支持 OpenAPI 规范 v2 和 v3。 （OpenAPI 规范 v2 以前称为 Swagger 规范 v2）

有 3 种不同的 C# 客户端生成器：

• csharp
• csharp-netcore
• csharp-dotnet2

该项目还包括 2 个 C# 服务器生成器：csharp-nancyfx、aspnetcore

如果您需要帮助，请在 Github 存储库中打开一个问题。

披露：我是 OpenAPI Generator 和 Swagger Codegen 的主要贡献者。