有没有简单的方法在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采取这种方法。