spring-restdocs - Spring REST Docs：从 .adoc 文件中读取 Spring 属性

Question

我正在使用很棒的 Spring REST Docs 来生成我的 Spring Data Rest 应用程序的文档。为此，我将生成的片段包含在.adoc文件中，然后以 HTML 呈现（完全如 Spring REST Docs 文档中所述）。

我的问题：是否有可能从.adoc文件中读取 Spring 属性（例如在application.properties中定义）？

谢谢 ：）

Answer 1

@Andy Wilkinson：非常感谢您的快速回答！

事实上，使用 Gradle 可以做到这一点。我没有意识到，但我已经使用默认asciidoctor任务将属性“注入”到 .adoc 文件中，如 Spring REST Docs 文档中所述。

添加自定义属性（build.gradle）：

ext {
    myProperty='here my custom property'
}

asciidoctor {
    ...
    attributes 'my-property': myProperty
}

my-property现在可以在 .adoc 文件中使用。

添加到此并为基本问题提供解决方案，以下是如何在 Spring 属性文件中使用 Gradle 属性。

在build.gradle：

processResources {
    filesMatching('**/*.properties') { expand([
            myProperty: myProperty
    ])}
}

在application.properties 中：

api.myProperty=${myProperty}

属性myProperty现在可以在 Gradle 构建文件中定义一次，然后在 Spring 属性和 asciidoctor 文档中使用。