enunciate

0熱

2答えて

私は文書（バージョン2.3.0）を生成しようとしています。応答サンプルの特定のフィールドを無視するためのドキュメントに従って、次のいずれかを使用できます。私はそれらを使用しようとしましたが、ドキュメントはそのフィールドを持つサンプルJsonを作成します。 @JsonIgnore -- com.fasterxml.jackson.annotation.JsonIgnore @Ignore -- c

9熱

1答えて

Enunciateで生成されたドキュメントにJSONレスポンス本文の形式を含めるにはどうすればよいですか？

現在、EnunciateはREST APIのドキュメントを生成しますが、レスポンスボディにはレスポンスのJSON構造に関する情報が含まれていません。私の理解では、JerseyからJSONにシリアライズ/デシリアライズされたデータエンティティをクラスに含めると、enunciateはそのドキュメントを生成することができます。データエンティティは、発音する文書で提案されているようにそのソースにパッケー

0熱

2答えて

どのようにして/ target内のディレクトリをSpringブートを伴う結果のJARに追加するのですか？

Enunciateを使用して、RESTアプリケーションを構築する際にRESTドキュメントを生成しています。 Enunicateは/target/docsにドキュメントを出力します。私は/docsディレクトリを結果のJARファイルに追加して（名前を変更して）ドキュメントを静的コンテンツとして提供できるようにしたいと思います。どうすればよいですか？私は、これらの静的ファイル（ビルド時に生成される）を

8熱

4答えて

REST APIをどのように文書化していますか？

どのようにREST APIを文書化していますか？リソースの内容だけでなく、実際に要求で送信されるデータと、応答で返されるデータとは何か。何かがXMLの送信を期待し、XMLを返すことを知るには十分有用ではありません。またはJASN。または何でも。要求で送信されるデータと応答で返されるデータをどのように文書化しますか？これまでのところ、REST APIとデータ要素を文書化できるEnunciateツー

3熱

1答えて

Spring MVCのSwagger JSONの生成：SpringfoxまたはEnunciate

Spring MVCプロジェクトにSwagger UIドキュメンテーションを生成する場合、基本的にEnunciateとSpringFoxの2つのオプションがあります。私は被験者に没頭しましたが、どちらかというと良い意見がありませんでした。私の見解では、Enunciateはあなたのプロジェクトにとって完全に外部的なので好ましいと思われます。特別なBeanをコンフィグレーションで追加する必要はあり

1熱

1答えて

Swagger - ファイルを返すサービスを呼び出すことが正しく動作しない

hereとhereと同様の問題が発生しています。私はContent-Dispositionヘッダーで添付ファイルとしてpdfファイルを返すサービスを持っています。これはブラウザからエンドポイントを呼び出すと機能します。ファイルがダウンロードされています。私swagger.jsonが発音する（バージョン2.3.0）によって生成される注：SWAGGER UIに私は、しかし、そのリンクが空のpdfファ

0熱

1答えて

enunciateで既存のxsdを参照するドキュメントを生成する

jax-rsサービスのドキュメントを生成するためにenunciate 2.6.0を使用しています。 1つのメソッドについては、カスタムMessageBodyWriterを使用してxmlにシリアライズします。私は応答を記述するxsdファイルを持っています。そのスキーマのドキュメントにenunciateを指すことは可能ですか？デフォルトでは、enunciateは基本的に空のns0.xsdを生成します。

0熱

1答えて

SpringのEnumiateリクエストparam

enunciateでSpring APIを文書化したいと思います。正常に動作しますが、一部のエンドポイントには要求パラメータが含まれています。これらはenunciateによって文書化されることはありません。 /** * Does some magic. * * @HTTP 201 Successful Request. */ @PostMapping(value = "/{id}", p

5熱

1答えて

Canジェネリック型を扱うAPI用のドキュメントを生成することができますか？

は抽象的、一般的なリソースクラスと具体的な実装を考える： public abstract class AbstractResource<T> { @Autowired private SomeService<T> service; @Path("/{id}") @GET public T get(@PathParam("id") String

5熱

2答えて

Enunciateはcxf-jaxrs-servlet.xmlファイルを自動的に生成し、org.codehaus.jackson.jaxrs.JacksonJaxbJsonProviderをJAX-RSプロバイダとして指定します。このクラスは、最新のJacksonライブラリのcom.fasterxml.jackson.jaxrs.JacksonJaxbJsonProviderに変更されました。 E