在spring引导应用程序中访问spring-restdocs生成的内容

Question

我在Spring Boot (1.4.1)应用程序中使用Spring Restdocs (1.1.2)。

在Gradle构建文件的jar任务中，我将生成的输出复制到public/docs中：

jar {
  dependsOn asciidoctor
  from ("${asciidoctor.outputDir}/html5") {
    into 'public/docs'
  }
}

我在生成的JAR中看到文档在

BOOT-INF/classes/public/docs/api-guide.html

但是，当我运行JAR时，我似乎无法在/docs、/public/docs等位置处理api-guide.html。

有人能解释一下我做错了什么吗？

谢谢!

--约翰

buildscript {
    ext {
        springBootVersion = '1.4.1.RELEASE'
    }
}

plugins {
    id "org.asciidoctor.convert" version "1.5.3"
}

apply plugin: 'groovy'
apply plugin: 'spring-boot'

ext {
    snippetsDir = file('build/generated-snippets')
    springRestdocsVersion = '1.1.2.RELEASE'
}


test {
    outputs.dir snippetsDir
}

asciidoctor {
    attributes 'snippets': snippetsDir
    inputs.dir snippetsDir
    dependsOn test
}

jar {
    dependsOn asciidoctor
    from ("${asciidoctor.outputDir}/html5") {
        into 'public/docs'
    }
}

dependencies {
    compile('org.springframework.boot:spring-boot-starter-data-rest')
    testCompile("org.springframework.restdocs:spring-restdocs-mockmvc:${springRestdocsVersion}")
}

=============================================================

下面是应用程序配置：

@SpringBootApplication
@EnableJpaRepositories
@EnableScheduling
class Application {
    static void main(String[] args) {
        SpringApplication.run Application, args
    }
}

和测试配置：

@RunWith(SpringJUnit4ClassRunner)
@SpringApplicationConfiguration(classes = Application)
class ApplicationTests {
    ...
}

Answer 1

好了，我终于知道我做错了什么。我启用了spring-boot-actuator docs：

compile('org.springframework.boot:spring-boot-actuator-docs')

它正在“接管”/docs的道路。一旦我将生成的restdocs重新定位到不同的路径，例如

jar {
    dependsOn asciidoctor
    from ("${asciidoctor.outputDir}/html5") {
        into 'static/api'
    }
}

一切都很好。

感谢Andy对我的问题和非常酷的Spring REST Docs项目的关注！