問題タブ [spring-restdocs]

私の Rest API では、境界ボックス内にあるデータを取得できるはずです。境界ボックスには 4 つの座標があるため、境界ボックスを JSON として受け入れるように GET 要求を設計したいと考えています。したがって、JSON 文字列を URL パラメーターとして送信および文書化できる必要があります。

テスト自体は機能しますが、これらのリクエストを Spring RestDocs (1.0.0.RC1) で文書化することはできません。より簡単な方法で問題を再現しました。下記参照：

.andDo(document("ping_username"))テストパスを削除すると。

スタックトレース：

URL をエンコードするという提案を受け取った後、試してみましたが、問題は残ります。

私のテストでURIを作成するために使用される文字列は現在/ping?name%3D%7B%22user%22%3A%22M%C3%BCller%22%7Dです。

スタックトレースに表示されるクラスを確認するMockMvcOperationRequestFactoryと、79 行目で次のコードが実行されます。

ここでの問題は、エンコードされていない文字列が使用され (私の場合http://localhost:8080/ping?name={"user":"Müller"})、URI の作成が失敗することです。

述べる：

Andy Wilkinson の答えは、この問題の解決策です。David Sinfield は正しいと思いますが、URL をシンプルに保つために JSON は避けるべきです。私のバウンディング ボックスでは、WMS 1.1で使用されているように、カンマ区切りの文字列を使用します。BBOX=x1,y1,x2,y2

spring-restdocsに基づいて Rest API ドキュメントを生成しようとしています

次のコードでは、 apply()でコンパイル時エラーが発生します。

メソッド apply(RestDocumentationMockMvcConfigurer) は、型 DefaultMockMvcBuilder に対して未定義です

spring-restdoc を使用して、安らかなサービスを文書化しています。私は今動いており、私が公開しているイベントも公開したいと思っています. これらをドキュメントに組み込む適切な方法は何でしょうか?

に似たクラスを作成することにしました。 は引数としてRestDocument取ることClassができ、同様の流暢なインターフェースを介してそのクラスのすべてのプロパティを文書化できます。

Spring Rest Docは REST API のドキュメント化に最適だと思います。しかし、それはに基づいており、私の grails アプリ (Grails 3.0.5) でSpring MVC Test使用する方法がわかりません。Spring MVC Test

@Configurationgrails コンポーネントをテスト コンテキストにスキャンするために構成クラス (およびを使用) を使用しようとしました@ComponentScanが、何もロードされていないようです ( への http 要求を実行すると、mockmvc404 が返されました)。

また、grails コントローラーを直接構成しようとしたところ、実行時エラーが発生しました。

フィールドを自動配線できませんでした: プライベート reactor.bus.EventBus

@Integrationまた、テスト クラスに (grails から) 追加しようとしましたが、同じエラーが発生しました。

助けてください。

いくつかのコード サンプルを次に示します。私が試したのは、構成クラスまたはクラスの場所または grails コントローラーを以下のテスト クラスの ContextConfiguration に追加することでした。そして、テストクラス自体は基本的に次のspring rest docリファレンスです。

構成クラス (使用しない):

Spring REST Docs は、テスト時に非常に便利な curl スニペットを生成します。ドキュメントに記載されている呼び出しと同等ですがMockMvc、ホスト部分をテストサーバーのホスト名 (ポートを含む) に置き換えることができれば良いでしょうlocalhost。現在のバージョンでそれを達成することは可能ですか？

私は持っていることを知っfieldWithPath()ていますが、オプションoptional()にする方法が見つかりませんでした。parameterWithName()