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はそれを分割して攻略できます。

オープンソースのEclipseプラットフォーム上に構築されたAPI Studioは、そのDNAにマルチファイルプロジェクトを持っています。JSON Reference標準に基づいた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は、簡単なYAML設定でSwagger-Codegenを完全にサポートし、現在、.NET、Web API、TypeScript用の人気のあるNSwagツールチェーンを含んでいます。RepreZenの強力なコード生成フレームワークを使用して、独自のジェネレータを構築することもできます。

すべてのジェネレータは、IDE、コマンドライン、またはMavenまたはGradleを使用した自動CI/CDビルドから実行されます。

https://youtu.be/BltFUgXRhhI

Eclipse Marketplaceで入手可能になりました

Eclipseユーザーにとって朗報です！RepreZen API Studioを使用する方法が2つになりました。

• Windows、macOS、またはLinuxにスタンドアロンAPIワークベンチとしてインストールします。

  こちらから登録して開始してください。

• Eclipse IDE (Mars.2, Neon, Oxygen) にドラッグアンドドロップでインストールするには、以下からどうぞ。

  Eclipse Marketplace:

APIを構築しましょう！

RepreZen API Studioの無料トライアルを試して、APIファースト開発で最高のパフォーマンスを発揮しましょう。