봄 휴식 문서 생성 된 콘텐츠를 찾을 수 없습니다.

Question

Google API 용 문서를 생성하기 위해 Spring REST Docs를 사용하고 있습니다. 나는 gradle build을 한 후 나는 build/asciidoc에서 디렉토리 파일이 build/generated-snippets도 생성되는 것을 볼 수 있습니다 여기에 튜토리얼 http://docs.spring.io/spring-restdocs/docs/current/reference/html5/

ext { 
    snippetsDir = file('build/generated-snippets') 
} 

test { 
    outputs.dir snippetsDir 
} 

asciidoctor { 
    attributes 'snippets': snippetsDir 
    inputs.dir snippetsDir 
    outputDir "build/asciidoc" 
    dependsOn test 
    sourceDir 'src/main/asciidoc' 
} 

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

을 build.gradle 모든 것을 추가했습니다. 내가 Gradle을 IDEA 작업 bootRun 및 로컬 호스트에 액세스하려고에서 실행할 때

그러나 : 8080/문서/index.html을 내가 404를 찾을 수 없습니다지고있어 그냥 테스트를 위해 내가 resources/static 디렉토리 아래에 몇 가지 index.html 파일을 넣어 시도하고 그런 다음 bootRun을 수행하고 그 후에 localhost:8080/index.html 파일에 액세스 할 수 있습니다.

내 .jar 파일을 열면 정적 파일이 BOOT-INF/classes/static/docs 디렉토리 아래에서 볼 수 있으므로 jar 파일로 압축됩니다.

누군가 같은 문제가 있었습니까?

Answer 1

bootRun을 사용할 때 설명서가 제공되도록하기 위해 수행해야 할 두 가지 작업이 있습니다. 이 새로운 작업이 asciidoctor 작업에 따라 달라

task copyRestDocs(type: Copy) { 
    dependsOn asciidoctor 
    from "${asciidoctor.outputDir}/html5" 
    into "${sourceSets.main.output.resourcesDir}/static/docs" 
} 

참고 : 첫 번째는 bootRun에 의해 사용되는 클래스 패스의 위치에 생성 된 문서를 복사하는 것입니다. 이렇게하면 문서가 복사되기 전에 생성됩니다.

둘째, bootRun 작업이 새로운 copyRestDocs 작업에 의존해야합니다

bootRun { 
    dependsOn copyRestDocs 
}