Skip to content

Automatically generate PlantUML diagrams in javadoc

License

Notifications You must be signed in to change notification settings

talsma-ict/umldoclet

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CI build Maven Version Javadoc Codebeat badge Coverage Status

UMLDoclet

Doclet for javadoc to automatically add UML diagrams to Java documentation.

Generate UML diagrams

The UML Doclet uses available javadoc metadata to automatically generate the following UML diagrams and embeds them in your HTML documentation. The diagrams are embedded as clickable SVG objects by default and link to package and class documentation where available.

Package dependency diagram

The UML Doclet will warn about (and optionally fail on) cyclic package dependencies.

The dependency diagram links to package documentation containing:

Package diagram

The package diagram links to class documentation containing:

Class diagram

(These examples are from the latest UML Doclet javadoc page. Please feel free to take a look to get an idea of the final result)

Requirements

To use the UML Doclet, the following is required.

  • Javadoc version 9 or higher.
    For versions of javadoc from earlier JDKs, please use the latest 1.x UML Doclet version. If you compile your java 8 or older javadocs with a more recent JDK (Javadoc version 9 or higher), you need to use the 2.x version.
  • The UML Doclet, the usage page shows how. An apache-licensed version of PlantUML is already included in the umldoclet jar.

Releases

Released versions can be found in the maven central repository or on github.

Usage

  • Please see the separate usage page on how to use the UML Doclet in your own Java projects.

Feedback

  • We welcome new issues. Please search the current issues to avoid filing a duplicate.
  • If at all possible, please provide an example when sending in bugs. This will make fixing them that much easier!

Contributing

Thanks

  • First of all a big thanks to Arnaud Roques, the developer of the excellent PlantUML project without whom this project wouldn't exist!
  • And of course thank you for using UML Doclet. I hope it may be of benefit to your project!

License