RepreZen API Studio 1.5 將 Swagger 帶入您的 IDE

  2017 年 2 月 23 日

RepreZen API Studio 是一個真正的 API 開發 IDE,具備您設計、記錄和開發端對端 API 解決方案所需的一切。其中一些主要功能包括:

  • 全功能 Swagger-OpenAPI 編輯器,具有內容輔助、可自訂的程式碼範本、即時驗證、多檔案支援等等。
  • 即時圖表、文件和 Swagger-UI檢視,內建模擬服務,用於互動式沙箱測試。
  • 自訂程式碼產生,具有強大的範本驅動框架,並且完全支援 Swagger-Codegen。
  • 外掛團隊協作,具備 Git、Github和其他版本控制、問題追蹤和 ALM 工具。

RepreZen 讓您在開發過程中將 OpenAPI 描述語言和 Swagger 程式庫作為一級工具使用。隨著 1.5 版本的發布,RepreZen 透過強大的多檔案支援、拖放 Eclipse 安裝,以及經過改進和擴展的程式碼產生,將這一點更進一步。

多檔案,一路到底

API 可能會變大。API 程式可能會變得更大,擁有跨職能團隊、不斷發展的微服務架構,以及推動跨 API 標準化和重複使用定義的趨勢。

在這樣的環境中,嘗試在單一檔案中管理您的 API 規格會受到很大的限制,而且最終不切實際。因此,如果您的 API 規格開始感覺像一個單體,RepreZen 可讓您分而治之。

API Studio 建構在開放原始碼 Eclipse 平台上,其 DNA 中包含多檔案專案。基於 JSON 參考標準的 OpenAPI $ref 屬性,提供了基本機制。而且 API Studio 將其整合到 API 設計體驗的每個方面:內容輔助、超連結和快速大綱導覽、程式碼產生以及我們改進的文件檢視。這些都支援多檔案,並且已為您最大、最複雜的專案做好準備。

https://www.youtube.com/watch?v=xKhNAQuq1x0&feature=youtu.be

透過 Swagger Normalizer 整合和簡化

並非每個 Swagger 程式碼產生器或文件檢視器都能正確處理 $ref 屬性。事實上,OpenAPI 有許多規則是這些下游元件必須遵守的,才能正確解譯 Swagger 規格。

Swagger Normalizer 透過解析參考、明確化預設值,以及將繼承的屬性直接嵌入它們的使用位置來解決這個問題。RepreZen API Studio 自動將 Swagger Normalizer 作為即時檢視和程式碼產生的預處理器;您可以使用它作為獨立產生器,將複雜的多檔案專案整合和簡化為單一 JSON 或 YAML Swagger 規格。

合約就是程式碼。

API 規格具有強大的表達能力,可以描述您的 API,不僅可以描述給其他開發人員,還可以描述給整個生態系統中的用戶端應用程式、服務、閘道和其他元件。

那麼為什麼您自己的 API 實作應該有所不同呢?

如果您使用程式碼優先註釋,則您正在實作程式碼即合約。對於許多開發人員來說,這是讓 API 文件和實作保持同步的理想方式。但是,在許多情況下,API 優先或合約優先工作流程具有明顯的優勢。

RepreZen API Studio 將 API 設計和程式碼產生直接帶入開發環境,實現真正的合約即程式碼。

API Studio 完全支援 Swagger-Codegen,具有簡單的 YAML 設定,現在還包含用於 .NET、Web API 和 TypeScript 的熱門 NSwag 工具鏈。您甚至可以使用 RepreZen 強大的 程式碼產生框架來建置您自己的產生器。

所有產生器都可以從 IDE、命令列或使用 Maven 或 Gradle 的自動化 CI/CD 建置中執行。

https://youtu.be/BltFUgXRhhI

現已在 Eclipse Marketplace 上推出

對於 Eclipse 使用者來說是個好消息!現在有兩種方法可以使用 RepreZen API Studio

  • 在 Windows、MacOS 或 Linux 上安裝為獨立的 API 工作台。

    在此處註冊以開始使用。

  • 從下列位置拖放安裝到您的 Eclipse IDE(Mars.2、Neon 或 Oxygen):

    Eclipse Marketplace

Drag to your running Eclipse workspace.

讓我們建置一些 API!

試用 RepreZen API Studio 的免費試用版,並將您的 A 級水準帶入 API 優先開發。

Try RepreZen API Studio Free!