Generating UML Diagramns with Maven

1. Install Graphviz. After installation confirm that it is part of your PATH.
2. Configure your maven pom files to make sure that you can get to the following repository: http://mirrors.ibiblio.org/pub/mirrors/maven2 because it has the second piece of the puzzle, the binaries for UMLGraph. You can see all the options for use in <additionalparam/> here.
   
3. To generate UML diagrams as part of the "mvn javadoc:javadoc" command, add the following (+/-) to your pom.xml file's <build/> section.
   
         <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-javadoc-plugin</artifactId>
           <configuration>
             <doclet>org.umlgraph.doclet.UmlGraphDoc</doclet>
             <docletArtifact>
               <groupId>org.umlgraph</groupId>
               <artifactId>doclet</artifactId>
               <version>5.1</version>
             </docletArtifact>
             <additionalparam>-views</additionalparam>
             <destDir>target/uml</destDir>
             <show>private</show>
           </configuration>
         </plugin>
4. To generate UML diagrams as part of the "mvn site" command, add the following (+/-) to your pom.xml file's <reporting/> section.
   
     <reporting>
       <plugins>
         <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-javadoc-plugin</artifactId>
           <reportSets>
             <reportSet>
               <id>uml</id>
               <configuration>
                 <doclet>org.umlgraph.doclet.UmlGraphDoc</doclet>
                 <docletArtifact>
                   <groupId>org.umlgraph</groupId>
                   <artifactId>doclet</artifactId>
                   <version>5.1</version>
                 </docletArtifact>
                 <additionalparam>-views</additionalparam>
                 <destDir>target/uml</destDir>
                 <show>private</show>
               </configuration>
               <reports>
                 <report>javadoc</report>
               </reports>
             </reportSet>
           </reportSets>
         </plugin>
       </plugins>
     </reporting>
5. That's it, you should now be reaping the benefits as your javadocs will have UML diagrams inside each class's landing page. I used the following post to put all this info together: http://wiki.wsmoak.net/cgi-bin/wiki.pl?UMLGraph