問題タブ [raml]

オブジェクト内のオブジェクトのコレクションの JSON スキーマを作成する方法を探しています。

シンボル beta(ß-arrestin) などの文字を含む科学アプリケーション用の長いパラグラフを含むフォームがあります。Mule で実行されている JSON サービスは、データを取得して Oracle データベースに永続化します。長い段落を持つこの特定の要素により、RAML/JSON でエラーが発生しています。以下はエラーです

科学者が書き込むフォーム要素は、私たちには制御できません。したがって、Mule 側では、java が URLEncoded を行っているように、これらの文字を自動的にエスケープするにはどうすればよいでしょうか。どうもありがとう

次のような resourceType を宣言するときに、RAML がさまざまなスキーマを動的に参照できる方法が気に入っています。

ここで私はこれを次のように使用できます

また、RAML はuserGET と POST からのスキーマ応答を提供し、userCreatePOST 要求の送信にもスキーマを使用します。涼しい！これで、大量の異なるスキーマでコレクション定義を再利用できます。

<<schema>>しかし、すべてのサンプルjsonも必要になったので、別の方法でvarを利用して「コードの再利用」を活用したいと考えていました。できることを願っていた

残念ながら、これは機能しません。というエラーが表示されます

したがって、これをすべてのコレクションに手動で追加することに頼り、/users上記の例は次のようになりました

私にとって、これは例を追加するだけでもかなりのオーバーヘッドです。特に、多くのリソースでパターンを繰り返したい場合。

質問:これを達成する方法はありますか?

raml を使い始めて (仕様を読んで)、API を文書化するために必要なものがあるかどうかを確認します。

サーバー URL を定義するためにルート レベルで必要な baseUri プロパティについて懸念があります。私は、API が多くの異なるドメインで提供されるシナリオにいます。

baseUril を raml ドキュメントが提供された URL として定義することは可能ですか?

仕様を見ただけでは、方法がわかりませんでした。もちろん、展開する前に raml doc をスクラブしたり、特定の展開用に定義された変数を持つ適切なドメイン raml ファイルを含めたりする方法はおそらくいくつかあります。しかし、私はそれを本当に避けたいです。