問題タブ [asp.net-mvc-apiexplorer]

WebサービスのコントローラーにOptionsメソッドを実装しようとしています。このメソッドは、コントローラーに関連付けられたURIエンドポイントの有効なHTTPメソッドを含むメッセージを返します。私のOptionsメソッドは次のようになります。

Get、Post、およびDeleteメソッドを使用して、コントローラー内の新しいWeb Apiプロジェクト（含意：変更されていないルーティング）で上記のメソッドを試しました。予想どおり、「Allow：GET、POST、DELETE」の応答が返されます。私は問題を抱えていますが、これを私が取り組んでいるより大きなプロジェクトに追加します。大規模なプロジェクトでは、ApiExplorer内のApiDescriptionsリストに要素が含まれていません。どうしてこれなの？実装されているカスタムルーティングが原因であると思われますが、その疑いの唯一の根拠は次のリンクです。

http://forums.asp.net/t/1821651.aspx/1

他の誰かがこの空のApiDescriptionリストを経験しましたか？もしそうなら、あなたは救済策を見つけましたか？

注：私はMCV4RCを使用しています

このブログ投稿に基づいてhttp://codebetter.com/johnvpetersen/2012/08/01/documenting-your-asp-net-web-apis/上記のリンク。ただし、次の呼び出しを行うと

「このメソッドは、アプリケーションの開始前の初期化フェーズ中に呼び出すことはできません。」というInvalidOperationExceptionが表示されます。私はASP.NETを見てきました:このメソッドは、アプリケーションの開始前の初期化段階では呼び出すことができませんが、私にとっては解決しませんでした。私は ASP.NET Web API 4.20710.0 を使用しています。これは NuGet によると最新のものです (はい?)。

この問題について誰か助けてくれませんか？f.exですか？ApiDescriptions を呼び出す前に、開始前の初期化フェーズを強制的に終了させることはできますか? それとも、別の方法で微調整できますか？

ご意見ありがとうございます。

編集

呼び出しは GET 内から行われます

上記のリンクは完全な例を提供します。

ASP.NET Web APIヘルプページと関連するMVC.ApiExplorerを使用している場合、http経由でアクセスできる有効なルートがありますが、ApiExplorerでは検出されません。これらのルートは、一般的なルーティングルールが使用されている場合にのみ検出されます。より具体的なルールを（一般的なルールと組み合わせて）使用すると、ApiExplorerからルートが隠されるようです。

3つのルールの例では、2つのルートがコントローラーメソッドのGETアクションとPOSTアクションに関連しており、クエリパラメーターはMIAに送信されません。

のルーティングルールを使用する場合

ルートは、ApiExplorerによって適切に検出されます。

• POST：api / SomeController
• GET：api / SomeController
• GET：api / SomeController / {id}

しかし、あまり一般的ではなく、より意味のあるルールを追加する場合

ApiExplorerはのみを返します

• GET：api / somecontroller / {id}

一部のルートが見つからない原因は何ですか？

ApiExplorerプロジェクトページの問題レポートへのリンクを編集

こんにちはBaseController : ApiController

とTestController : BaseController

コントローラー名とTestControllerの関連詳細を取得する方法

以下のコードを使用して

詳細（ ApiDescriptions）を取得できますBaseController

TestControllerの詳細 ( ApiDescriptions )を取得するには?

Web API (asp mvc4 アプリケーション内) の作成で忙しいです。ドキュメントを生成するために asp.net サイトで提案されているライブラリを使用しています ( http://www.asp.net/web-api/overview/creating-web-apis/creating-api-help-pages )。

私の問題は、パラメーターがモデルの場合、生成されたヘルプ ページでモデルに含まれるプロパティを指定できないことです。

次に例を示します。

モデル：

アクション：

モデルのパラメーターのみが生成されます。

ドキュメント用に生成された xml ドキュメントを調べたところ、他のパラメーターが追加されています。

ただし、ヘルプ ページでは、パラメーター モデルのみが生成されます。

XMLからパラメータを取得するメソッドまでた​​どりました。

これは、自動生成される HelpPageConfigurationExtentions.cs にあります。

私はこれに間違った方法でアプローチしていますか? 回避策を知っている人はいますか？

任意の提案や解決策をいただければ幸いです。

ApiExplorer にリクエスト サンプルを自動生成させる方法はありますか?

私は使用してみました：

HelpPageConfig.csで、しかし2つの問題が発生しました:

1. 特定のコントローラーとアクションの特定のタイプを定義する必要があり、新しいコントローラー\タイプが追加された場合にコードの追加\変更を必要としない、より一般的なものを探しています。

2. コントローラー/アクションごとに 1 つの型しか使用できないため、要求本文で2 つの複合型を受け取るアクションの完全な要求サンプルを生成できません。

これらの問題を解決/アプローチする方法についてのアイデアはありますか?

http://www.asp.net/web-api/overview/creating-web-apis/creating-api-help-pagesドキュメント ガイドを使用し、これらを各パブリック API コントローラに適用

しかしどういうわけか、XML ジェネレーター ApiExplorer は、私のサマリー コメントのどれも取得しません。

何かご意見は？？