2016-03-07 8 views
7

Ben TypeScipt yazılmış bir projenin parçası ve ben Swagger ile uyumlu olacak typescript Web Sunucusu eklemek çalışıyorum bir dayı web hizmeti oluşturmak için uygun yolu budur. Kolay korunabilirliğe dikkate bunu uygulamaya en temel strateji nedir
.typescript

  • Typescript için TipScript Arabirimi'nden bir JSON Modeli oluşturmak için 'Typson' kitaplığı olduğunu fark ettim. o Fiyakamla için JSON modeller ekleyerek destekler beri Swagger için

  • , ben, 'dayı-düğüm-restify' kitaplığı kullanarak çalıştılar.

Ancak, bazı sorunlarla karşılaşabilirsiniz:

    Typson İthalat ait typescript sözdizimi desteklemiyor
  1. - Ben swagger-düğüm-restify uygulamaya çalışmıştır (import {Server} from "restify")
  2. 'örnek (Pet Örnek) Ancak localhost tEPKİ: 8080/API-docs.json GET isteği API tüm SPEC verileri eksik. {"apiVersion":"0.1","swaggerVersion":"1.1","basePath":"http://localhost:8080","apis":[{"path":"/api-docs.{format}/pet","description":"none"}]}

cevap

3

Ben yaml veya json ve üzere sunucuyu bundan oluşturmak kullanarak Swagger uyumlu API tarif etmek düşündürmektedir. swagger-server gerçek zamanlı olarak (kaynak kod üretilemez) API'ler oluşturabilir.

JavaScript kod jeneratörleri vardır:

  • Çağrı -l nodejs-server

  • swagger-node ile dayı-codegen istemci harika bir alternatiftir ama ile entegre etmek zor görünüyor TypeScript

+0

Bu en iyi yaklaşımdır. Birçok proje, kod -> swagger'dan hizmet oluşturma çabası içindedir, ancak bunun en iyi yaklaşım olmadığını düşünüyorum. JSON'da (Json şemasının entegrasyonu nedeniyle YAML'den daha standart olan) daha hızlı bir özellik yazarak API'nizin belgelerini belirli bir çalışma zamanı ortamına veya uygulamasına bağlıyorsunuz. Bunun yerine, bir spreye yazıyorsunuz ve daha sonra swagger-codegen'i kullanarak o speklerden istemcileri veya sunucuları oluşturuyorsunuz. – coding