有沒有簡單的方法在spring-restdocs中創建單獨的片段？

Question

我剛剛進入spring-restdocs，我非常喜歡如何記錄我的API。現在我想通過python擴展生成的例子。意思是我需要像python那樣的片段。

這是我發現至今：

我將創建自己的模板，像默認捲曲request.snippet。是不是正確的做法是通過org.springframework.restdocs.snippet.TemplatedSnippet擴展自己的實現？

Answer 1

如果您想使用模板來生成代碼段，那麼您所描述的是正確的方法。

請注意，您不必使用模板。您可以選擇直接實施Snippet界面，然後您可以使用任何您喜歡的方式自由生成代碼段。 Here's a snippet implementation from a third-party extensions採取這種方法。