問題タブ [raml]

ミュール アプリケーションを作成し、ローカル マシンで正常に実行/デプロイできました。ポートをPrivateに変更してcloudHubにデプロイしたところ、RAMLのコンソールの読み込みが完了しません。

同じ質問が下のリンクにも投稿されています。

MULE ESB サーバー: 長時間の RAML ロード

誰かが私を助けてくれませんか。

古い API を RAML で記述しなければならず、構文に苦労しています。時間の問題により、古い API 呼び出しを保持する必要があります。

次の呼び出しについて説明しようとしています。

?Call=GetData&suuid=1234567 ?Call=AddNewData&dataid=12345suuid=1234567 ?Call=DeleteData&dataid=12345suuid=1234567

それはRAMLで可能ですか？

事前にt​​hnx！

次のような一般的な Java 型があります。

RAML 1.0（私が初めての場合）で同様のものを作成したいと考えています。

私の最初のアプローチは

そしてそれを使用するとき

API-Workbench から、「Response から継承されたプロパティ データの無効なオーバーライド」が常に表示されます。

他のアイデアは、次を使用することrepeatです：

そしてそれぞれ

不正なオーバーライドはなくなりましたが、API コンソールで「Uncaught TypeError」が表示されるようになりました。

それを解決する方法は？それとも、まったく別のアプローチが必要ですか? 何か案が？

これは次と同じエラーです: Getting java.lang.NoSuchFieldError: VALUE in RamlValidationService

ただし、その場合、deps に Maven を使用していないことが問題でしたが、私はそうしています。

私の単純な RAML ファイル:

私の単純な Java の使用法:

私の単純なpom.xml：

そして、ここに楽しいエラーがあります：

編集 1: そのまま SnakeYAML を使用すれば、すべて問題ありません。

RAMLで POST パラメータがサポートされているかどうかお尋ねしたいと思います。そして、もしあれば - 構文は何ですか。spec 0.8と spec 1.0を大まかにブラウジングしました (実際には0.8、多くのツールがまだサポートされていないため、に縛られています1.0)。POST パラメーターのサポートが見つかりませんでしたが、何か見逃していたのかもしれません。

では、POST パラメーターとはどういう意味ですか? これらは2つのいずれかです（申し訳ありませんが、正式な名前がある場合はわかりません）：

• HTTP プレーン パラメータ、key=value、各パラメータを 1 行にまとめたもの。

  name=John Doe amount=5 これはあまり便利ではありません (例: ネストなし)

• JSON object としてのパラメーター、すべての構文が許可された JSON のみ (サーバー側でこの json を解析する必要があります)。そのような：

  {"name":"John Doe","amount":"5"}

異なるサーバー側 API 実装では、1 つ目または 2 つ目のいずれかが使用されます。とにかく、RAML はこれらをどのようにサポートしていますか?

質問:ファイル間で Swagger 定義を分割するにはどうすればよいですか? その分野での可能性は何ですか？質問の詳細は次のとおりです。

私が欲しいものの例 - RAMLで

私はRAMLの経験があり、私がしていることは、たとえば次のとおりです。

ここで最後の 2 行が重要です - Theones with !include <filepath>- RAML では、コントラクト全体を RAML パーサーによって動的に含まれる多くのファイルに分割できます (RAML パーサーは、RAML に基づくすべてのツールで使用されます)。

これによる私の利点は次のとおりです。

• スキーマがインライン化されていないため、コントラクトがより明確になり、保守が容易になります
• しかし、これは非常に重要です。他のツール内でスキーマ ファイルを再利用して、検証、モック生成、スタブ、テストの生成などを行うことができます。つまり、このようにして、コントラクト (RAML、この場合) と他のツール (非 RAML、非スワガー、JSONschema ベースのもののみ) の両方でスキーマ ファイルを再利用できます。

スワガーに戻る

私が読んだ限りでは、swagger は$ref外部ファイルをロードできるキーワードをサポートしています。しかし、そのファイルは HTTP/AJAX を介して取得されたものですか、それとも単なるローカル ファイルでしょうか?

そして、それは仕様全体でサポートされていますか?それとも、それをサポートするツールとサポートしないツールだけですか?

ここで見つけたのは、swagger の入力は 1 つのファイルでなければならないということです。そして、これは大きなプロジェクトにとって非常に不便です:

• サイズのせいで
• また、闊歩でないものを使用したい場合、スキーマを再利用できないため

または、言い換えれば、ファイルを分割するという点で、RAMLでできるのと同じことをswaggerで達成できますか?

私のAPIには、のマップを含むタイプがありますuuid->Drive。それを定義するために Map type[1] を使用しました:

それは機能しますが、パターンをより正確にしたいと思います。しかし、私はそれを機能させることができません。

• ["(a-zA-Z0-9){8}-(a-zA-Z0-9){4}-(a-zA-Z0-9){4}-(a-zA-Z0-9){4}-(a-zA-Z0-9){12}"]:正規表現としては使わないようです。
• [(a-zA-Z0-9){8}-(a-zA-Z0-9){4}-(a-zA-Z0-9){4}-(a-zA-Z0-9){4}-(a-zA-Z0-9){12}]:フロー コレクション エントリ間のカンマが抜けていると言う

RAML 1.0 を使用して Map タイプで複雑な式を使用するにはどうすればよいですか?

(私はAPI Workbenchを使用しています)

[1] http://docs.raml.org/specs/1.0/#raml-10-spec-map-types

件名のように、2 つの RAML ファイルがあり、1 つは v1 API バージョンに関連し、もう 1 つは v2 API バージョンに属します。私の問題は、API ドキュメントを含むルート URL を誰かに渡した場合、誰かが API v1 ページに入ったときに、その人が何らかの情報を参照できるかどうか確信が持てないことです (「これは古い API バージョンです。API に移動してください。 v2: link") とリンクを API v2 にリダイレクトしますか?

このリダイレクト リンクを v1 RAML ファイルに入れる方法はありますか?

返信ありがとうございます