Posted on 2010-04-19 23:59
不需要解释 阅读(1876)
评论(0) 编辑 收藏 所属分类:
ant 、
maven
最近在看一些项目的代码，总是发现很少项目提供出uml图，或者就是提供uml图的也有可能并没有和代码对应上，如果有正确的uml图，可以非常方便的为大家更好的理解代码层次逻辑。其实我们可以使用使用UMLGraph来生成uml图，直接使用java代码来生成UMLGraph。对于大部分项目来说，我们一般使用maven和ant（还在使用ant，你out了）来作为项目的编译工具。
在maven中，我们可以在pom.xml增加：
<reporting>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.6.1</version>
<configuration>
<doclet>org.umlgraph.doclet.UmlGraphDoc</doclet>
<!-- <docletPath>/path/to/UmlGraph.jar</docletPath> -->
<docletArtifact>
<groupId>org.umlgraph</groupId>
<artifactId>doclet</artifactId>
<version>5.1</version>
</docletArtifact>
<additionalparam>-views</additionalparam>
<useStandardDocletOptions>true</useStandardDocletOptions>
</configuration>
</plugin>
</plugins>
</reporting>
使用javadoc:aggregate 就可以生成出整个项目按照package的uml图了。
如果是使用ant，在build.xml中增加target
<target name="genuml">
<property name="uml.dir" value="${basedir}/uml"/>
<property name="src.uml.dir" value="${src.dir}/uml"/>
<mkdir dir="${uml.dir}"/>
<path id="uml.source.path">
<pathelement path="${src.uml.dir}/"/>
<pathelement path="${src.java.dir}"/>
</path>
<javadoc sourcepathref="uml.source.path" packagenames="*" package="true">
<doclet name="org.umlgraph.doclet.UmlGraph" path="${basedir}/lib/UmlGraph.jar">
<param name="-d" value="${uml.dir}"/>
</doclet>
</javadoc>
<apply executable="dot" dest="${uml.dir}" parallel="false">
<arg value="-Tpng"/>
<arg value="-o"/>
<targetfile/>
<srcfile/>
<fileset dir="${uml.dir}" includes="*.dot"/>
<mapper type="glob" from="*.dot" to="*.png"/>
</apply>
</target>
注意：要正常使用 UMLGraph，您必须先安装 Graphviz 工具，请自己google相关信息。