• Rest Api Documentation 참조
• Swagger도 참조

• SpringDoclet JavaDoc for Springframework

Add Gradle example · Issue #3 · scottfrederick/springdoclet 참조.

configurations {
    springDoclet
}
 
dependencies {
    springDoclet files("libs/springdoclet-0.0.1-jar-with-dependencies.jar")
}
 
task generateRestApiDocs(type: Javadoc) {
    source = sourceSets.main.allJava
    destinationDir = file("${buildDir}/docs/springdoc")
 
    classpath = configurations.runtime
    options.docletpath = configurations.springDoclet.files.asType(List)
    options.doclet = "org.springdoclet.SpringDoclet"
    // options.docTitle = "${project.name} Spring Doc"  // 안됨. 패치 고려
}

• classpath = configurations.runtime이 빠지면 의존 클래스 미확보로 작동하지 않는다.

• 혹은 https://github.com/thilko/gradle-springdoc-plugin

• Rest Doclet Spring MVC 기반 REST API Doclet

• versly/wsdoc