JAX-RS Analyzer Gradle Plugin

License	The Apache Software License, Version 2.0
Categories	Gradle Build Tools
GroupId	com.github.grimmjo
ArtifactId	jaxrs-analyzer-gradle-plugin
Last Version	0.3
Release Date	Mar 24, 2019
Type	jar
Description	JAX-RS Analyzer Gradle Plugin JAX-RS Analyzer Gradle Plugin
Project URL	https://github.com/grimmjo/jaxrs-analyzer-gradle-plugin
Source Code Management	https://github.com/grimmjo/jaxrs-analyzer-gradle-plugin

Download jaxrs-analyzer-gradle-plugin

Filename	Size
jaxrs-analyzer-gradle-plugin-0.3.pom
jaxrs-analyzer-gradle-plugin-0.3.jar	19 KB
jaxrs-analyzer-gradle-plugin-0.3-sources.jar	3 KB
jaxrs-analyzer-gradle-plugin-0.3-javadoc.jar	261 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.grimmjo/jaxrs-analyzer-gradle-plugin/ -->
<dependency>
    <groupId>com.github.grimmjo</groupId>
    <artifactId>jaxrs-analyzer-gradle-plugin</artifactId>
    <version>0.3</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.grimmjo/jaxrs-analyzer-gradle-plugin/
implementation 'com.github.grimmjo:jaxrs-analyzer-gradle-plugin:0.3'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.grimmjo/jaxrs-analyzer-gradle-plugin/
implementation ("com.github.grimmjo:jaxrs-analyzer-gradle-plugin:0.3")

Apache Buildr

'com.github.grimmjo:jaxrs-analyzer-gradle-plugin:jar:0.3'

Apache Ivy

<dependency org="com.github.grimmjo" name="jaxrs-analyzer-gradle-plugin" rev="0.3">
  <artifact name="jaxrs-analyzer-gradle-plugin" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.grimmjo', module='jaxrs-analyzer-gradle-plugin', version='0.3')
)

Scala SBT

libraryDependencies += "com.github.grimmjo" % "jaxrs-analyzer-gradle-plugin" % "0.3"

Leiningen

[com.github.grimmjo/jaxrs-analyzer-gradle-plugin "0.3"]

Dependencies

compile (1)

Group / Artifact	Type	Version
com.sebastian-daschner : jaxrs-analyzer	jar	0.17

Project Modules

There are no modules declared in this project.

JAX-RS Analyzer Gradle Plugin

Gradle plugin for the JAX-RS Analyzer.

Using the plugin:

buildscript {
    dependencies {
        classpath 'com.github.grimmjo:jaxrs-analyzer-gradle-plugin:0.2'
    }
    repositories {
        jcenter()
    }
}

apply plugin: "jaxrs-analyzer-gradle-plugin"

After building your project, the documentation resides under 'build/jaxrs-analyzer/'.

Changelog

Version 0.3

• updates jax-rs-analyzer dependency to 0.17

• updates gradle to 4.10.2

Version 0.2

• adds gradle’s cache support to analyze task

• generate documentation for multiple backends

• updates jax-rs-analyzer dependency to 0.16

• adds a example build

Roadmap

Version 0.4

• support groovy and kotlin classes for analysis

Full Example

A full working example can be found here

Configuration

jaxRsAnalyzer {
    // Available backends are plaintext, asciidoc and swagger (default)
    backend 'swagger', 'asciidoc'
    // Domain of the deployed project, defaults to ""
    domain 'localhost:8080'
    // Comma separated list of Swagger schemes (only for if backend is swagger, defaults to http)
    schemes 'http', 'https'
    // Enables rendering of Swagger tags (defaults to false -> default tag will be used)
    renderTags true
    // The number at which path position the Swagger tags will be extracted (defaults to 0)
    tagPathOffset 0
    // Directory (relative to buildDir) where resources will be generated (defaults to jaxrs-analyzer)
    outputDirectory 'jaxrs-analyzer'
}

Output directory

The outputDirectory parameter defines the relative path to the build directory.

Backend

The backend parameter specifies the output format of the analysis. The available formats are plaintext, asciidoc and swagger. Multiple values are allowed. E.g. jaxRsAnalyzer { // Available backends are plaintext (default), swagger and asciidoc backend 'swagger', 'asciidoc' …​ } This would generate the documentation for swagger and asciidoc.

For further use of the created formats see the JAX-RS Analyzer documentation.

Domain

With domain the user may specify the URL which will contain the REST API later on. Tools like Swagger make use of this information (and offer possibilities to send calls directly, etc.).

Swagger options

• schemes The comma separated list of Swagger schemes: http (default), https, ws, wss

• renderTags Enables rendering of Swagger tags (defaults to false, then the default tag will be used)

• tagPathOffset The number at which path position the Swagger tags will be extracted (defaults to 0)

Contributing

Feedback, bug reports and ideas for improvement are very welcome! Feel free to fork, comment, file an issue, etc. ;-)

Versions

Version
0.3 Mar 24, 2019
0.2 Aug 7, 2018
0.1 Jul 6, 2018