Spring Rest Docs代码段模板被忽略

Question

我试图能够为Spring Rest Docs文档目的创建自定义代码段模板。 我一直在遵循参考指南

我遇到的第一个问题是在src/test/resources/org/springframework/restdocs/templates/asciidoctor/path-parameters.snippet根据指南创建.snippet文件时遇到的问题。 IntelliJ将其注册为jShell片段文件，从一眼看就与AsciiDoc片段不同。 所以我进入Settings -> Editor -> File Types ，并将jShell代码段从* .snippet更改为* .snippetOld。 然后，我创建了一个名为Snippet的文件类型，并将其模式设置为* .snippet。 现在，这解决了将片段模板读取为jShell文件的问题。 因此，我创建的.snippet模板不再遇到编译/验证错误。

但是现在，当我在删除先前的现有adoc文件之后运行我的嘲笑Mvc测试时。 现在，即使没有使用默认模板 ，本来应该使用我的自定义模板的path-perameters.adoc文件也不会生成。

在我的嘲笑Mvc测试中，我有以下内容

//Given
RestDocumentationResultHandler document = makeDocument("name-of-method");
document.document(
    pathParameters(//do path parameters)
    requestParameters(
        parameterWithName("Month").description("The month requested").attributes(
        key("type").value("integer"), key("constraints").value("more than 0 & less than 13.")
        ),
        parameterWithName("Year").description("The year requested").attributes(
            key("type").value("integer"), key("constraints").value("more than 1970 and less than current year")
        )
    ),
    responseField(//Do response fields)
);

// When
mvc.perform(get(REQUEST_PATH, USERID)
          .contentType(MediaType.APPLICATION_JSON)
          .param("month", "8")
          .param("year", "2018"))

          // Then
          .andExpect(status().isOk())
          .andDo(document);

我的代码段模板如下：

   |===
   |Parameter|Description|Type|Constraints

   |{{parameter}}
   |{{description}}
   |{{type}}
   |{{constraints}}

有人可以指出我做错了什么/与参考指南有所不同，以及如何修复它以使模板正常工作？

Answer 1

我怀疑您未获得输出的原因是您将path-parameters与request-parameters混淆了。 您的文档配置指定了请求参数，但是您自定义了路径参数模板

以下是摘要模板的完整列表：

• 卷曲request.snippet
• HTTP-request.snippet
• HTTP-response.snippet
• httpie-request.snippet
• links.snippet
• 路径parameters.snippet
• 请求body.snippet
• 请求fields.snippet
• 请求headers.snippet
• 请求parameters.snippet
• 请求部分body.snippet
• 请求部分fields.snippet
• 请求parts.snippet
• 响应body.snippet
• 响应fields.snippet
• 响应headers.snippet

资源：

• https://github.com/spring-projects/spring-restdocs/tree/master/spring-restdocs-core/src/main/resources/org/springframework/restdocs/templates/asciidoctor