Mar 18, 2016

Generating REST-API Documentation during compile with JAXRS-ANALYZER

Today I found in the OTN Java Newsletter from Oracle a hint to JAXRS-ANALYZER  from
Sebastian Daschner.

This is such an easy tool to use. Just add the build plugin into your pom and compile.


<plugin>
    <groupId>com.sebastian-daschner</groupId>
    <artifactId>jaxrs-analyzer-maven-plugin</artifactId>
    <version>0.9</version>
    <executions>
        <execution>
            <goals>
                <goal>analyze-jaxrs</goal>
            </goals>
            <configuration>
                <!-- Available backends are plaintext (default), swagger and asciidoc -->
                <backend>asciidoc</backend>
                <!-- Domain of the deployed project, defaults to example.com -->
              <deployedDomain>example.com</deployedDomain>
            </configuration>
        </execution>
   </executions>
</plugin>

The target document can be adjusted as plaintext swagger and asciidoc.

Te resulting document can be found in the target/jaxrs-analyzer folder of your maven-project.

Here is a screenshot from an asciidoc seen in AsciidocFX of a simple demo JAX-RS resource,
which I implemented to learn a little bit of wildfly-swarm.



Looks like a good starting point, since there is no Annotation or XML-Configuration or anything
else necessary in the source code, because JAXRS-Analyzer does reflection and bytecode analysis.

Mar 17, 2016

opening a file in an external tool from within netbeans

The netbeans IDE can collect a bunch of files as a project, but sometimes it is necessary to open
a file from the project with an external tool.

How to do this?

The answer is in the NewAndNoteworthyNB81 under C/C++ 10.9.

The C/C++ Plugin brings a sendTo-Utility, which is configurable.

On my linux-box I can configure gedit in the miscellaneous options :




Now you can select some files and select the gedit within the context menu:

Tools->Send To.. -> gedit. 

This context-menu also contains a shortcut to the configuration.