Question

我在Spring Boot（v1.4.1）应用程序中使用Spring Restdocs（v1.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')

它是＆＃34;接管＆＃34; / docs路径。一旦我将生成的restdocs重新定位到不同的路径，例如

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

一切都很好。

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

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

1 个答案: