需求

近期要对一个项目结构例如以下的Maven项目生成JavaDoc文档。

Project

                        |-- pom.xml

                        |-- Module1

                                |   `-- pom.xml

                        |-- Module2

                                |   `-- pom.xml

                        |-- Module3

                                |-- pom.xml

这个就须要用到本文将要提出的一个Maven插件：javadoc。

基本使用

插件的基本配置非常easy：

<plugin>

	<groupId>org.apache.maven.plugins</groupId>

	<artifactId>maven-javadoc-plugin</artifactId>

	<version>2.9.1</version>

</plugin>

假设对于一个普通的Maven项目，那么这个配置就能够让你输出一个JavaDoc文档了（使用javadoc:javadoc命令）。

多模块Maven项目

而我们如今是一个多模块的Maven项目，那么就须要一些额外的配置来完毕此操作：

<plugin>

	<groupId>org.apache.maven.plugins</groupId>

	<artifactId>maven-javadoc-plugin</artifactId>

	<version>2.9.1</version>

	<configuration>

        <aggregate>true</aggregate>

	</configuration>

</plugin>

就是一个aggregate设置为true，就能够让你在父项目执行javadoc:javadoc的时候，就会将子模块的JavaDoc生成在父项目的target下，而且会将其整合成一个JavaDoc。

自己定义标签

如今问题来了：

我们的类中的方法凝视例如以下

/**

 * @author     : 张三

 * @group      : group

 * @Date       : 2014-01-26 21:14:49

 * @Comments   : 页面所含操作增删改查的ejb接口

 * @Version    : 1.0.0

 */

public interface IOperationBean {

	    /**

	     * @MethodName	: getOperationByID

	     * @Description	: 依据Id获得页面所含操作

	     * @param ID 页面所含操作ID

	     */

	     PageOperation getOperationByID(String ID);

}

而我们在生成JavaDoc后，并没有看到Description和MethodName这两个注解中相应的内容。也就导致了方法的说明不翼而飞了。

经过实验，要想像jdk那样让方法的描写叙述紧跟在方法名后面，是须要这样加入凝视的：

/**

 * 依据Id获得页面所含操作

 * @param ID 页面所含操作ID

 */

 PageOperation getOperationByID(String ID);

已经到了项目后期。如今再让大家去改这些有些说只是去，查了下官网，发现有自己定义标签。正好解决的就是这种问题。

而这次问题的出现。还是源于我们对于JavaDoc生成不熟悉。

废话不多说，直接看样例：

<plugin>

	<groupId>org.apache.maven.plugins</groupId>

	<artifactId>maven-javadoc-plugin</artifactId>

	<version>2.9.1</version>

	<configuration>

        <aggregate>true</aggregate>

        <tags>

            <tag>

                <name>Description</name>

                <placement>a</placement>

                <head>用途</head>

            </tag>

        </tags>

	</configuration>

</plugin>

说明：

1.name为你Java代码中的注解的名字

2. placement这个在官网上有8种，我也自己试了下。事实上这个就是说你要把哪些（方法、字段、类）上面的注解放到JavaDoc中

3.head。假设不写这个，用的就是name，假设写了，那么显示效果例如以下：

这样。你就既能够定义自己的凝视规范。又能够生成对应的JavaDoc文档了

自己定义路径

 
      这个功能一般不会用到，仅仅是顺便看了一下。就写下来吧。

 
      在这里须要叨念两句关于约定优于配置，在最初我用Maven的时候，就看到过这种话，Maven文件夹能够不这样设置么？能够，你能够自己改。
 
      仅仅能说我们在大部分时候，是不须要改这个，但不意味着我们在做的时候就能够把这个做死，这样于用户，于今后的维护来说，都不是一个好的选择。
 
      两句叨念完了，如今来看怎么设置吧：
<plugin>

	<groupId>org.apache.maven.plugins</groupId>

	<artifactId>maven-javadoc-plugin</artifactId>

	<version>2.9.1</version>

	<configuration>

        <reportOutputDirectory>../myoutput</reportOutputDirectory>

        <destDir>myapidocs</destDir>

	</configuration>

</plugin>

说明：

 
      1.reportOutputDirectory是说的路径
 
      2.destDir是说的目标目录
 
      
 
      到这里Maven多模块下使用javadoc插件生成JavaDoc文档过程中遇到的问题就都攻克了。

多模块Maven项目怎样使用javadoc插件生成文档的更多相关文章

  1. 多模块Maven项目如何使用javadoc插件生成文档

    版权声明:本文为博主原创文章,未经博主允许不得转载.   目录(?)[+]   需求 最近要对一个项目结构如下的Maven项目生成JavaDoc文档. Project                  ...

  2. <转>创建支持eclipse的多模块maven项目

    如何使用eclipse创建Maven工程及其子模块 1,首先创建一个父类工程   子模块继承父类工程      并在父类工程的pom.xml文件中定义引入的jar及其版本号     子模块可以引用 2 ...

  3. 使用eclipse生成文档（javadoc）

    使用eclipse生成文档(javadoc)主要有三种方法:1,在项目列表中按右键,选择Export(导出),然后在Export(导出)对话框中选择java下的javadoc,提交到下一步.在Java ...

  4. 使用Sphinx为你的python模块自动生成文档

    Sphinx是一个可以用于Python的自动文档生成工具,可以自动的把docstring转换为文档,并支持多种输出格式包括html,latex,pdf等. 安装 创建一个sphinx项目 下面的命令会 ...

  5. 使用eclipse生成文档（javadoc）主要有三种方法：

    使用eclipse生成文档(javadoc)主要有三种方法: 1,在项目列表中按右键,选择Export(导出),然后在Export(导出)对话框中选择java下的javadoc,提交到下一步. 在Ja ...

  6. 使用swagger在netcorewebapi项目中自动生成文档

    一.背景 随着前后端分离模式大行其道,我们需要将后端接口撰写成文档提供给前端,前端可以查看我们的接口,并测试,提高我们的开发效率,减少无效的沟通.在此情况下,通过代码自动生成文档,这种需求应运而生,s ...

  7. idea运行javadoc生成文档以及 报错编码gbk的不可映射字符坑

    将项目类信息生成文档 idea整合了javadoc的操作,可以一键生成doc文档 方法: 选中你要生成文档的项目 点击上方tools->Generate JavaDoc 运行即可 注意这里有一个 ...

  8. 第4天 JavaDoc生成文档&Java流程控制（第一节：用户交互Scanner）

    JavaDoc生成文档 javadoc命令是用来生成自己的API文档 参数信息: @author 作者名 @version 版本号 @since 指明需要最早使用的jdk版本 @param 参数名 @ ...

  9. 为Unity项目生成文档(二)

    Unity项目生成文档 接着上篇文章:为Unity项目生成文档(一) .Net项目可在VS配置XML 我们可以在VS中通过配置来生成xml文件,但是unity的project,就算同样配置了xml文档 ...

随机推荐

  1. BZOJ 3385: [Usaco2004 Nov]Lake Counting 数池塘

    题目 3385: [Usaco2004 Nov]Lake Counting 数池塘 Time Limit: 1 Sec  Memory Limit: 128 MB Description     农夫 ...

  2. Android多线程断点续传下载

    这个月接到一个项目.要写一个像360助手一样的对于软件管理的APP:当中.遇到了一个问题:多线程断点下载 这个 ,因为之前没有写过这方面的应用功能.所以.不免要自学了. 然后就在各个昂站上收索并整理了 ...

  3. css精灵（css script 技术）

    上班差不多有15天了,感觉每天都有写不完的也页面,每天都有不同的东西需要学习进步,很充实哦.今天接触到css精灵这个东西.其实之前有看过这种技术,但是没有操作过,只是听说这个技术很强大,能干嘛干嘛,但 ...

  4. js得到分页栏

    自己写的,感觉返回html代码蠢蠢的,但是新手并不知道怎么写更好的,感觉这样子也蛮简单.记录下来,以后来越改越好. //获得分页栏.注意indexSize为奇数,这样也比较好看 //totalNum: ...

  5. 杭电ACM 偶数求和

    偶数求和 Time Limit: 2000/1000 MS (Java/Others)    Memory Limit: 65536/32768 K (Java/Others) Total Submi ...

  6. JDBC_获取插入记录的主键值

    <span style="font-size:24px;">package src.com.JDBC2DAO.java; import static org.junit ...

  7. HYSBZ 2301

    /*** 对于给出的n个询问,每次求有多少个数对(x,y),满足a≤x≤b,c≤y≤d,且gcd(x,y) = k,gcd(x,y)函数为x和y的最大公约数 **/ #include <iost ...

  8. 基于visual Studio2013解决C语言竞赛题之0302字符数出

     题目 解决代码及点评 根据题目要求,只要根据用户输入的字母,判断字母之后,给出相应的输出即可 在以下代码中,f32函数实现了该功能,通过if条件判断语句 #include <stdio.h ...

  9. java学习之字符流与字节流的转换

    package com.io; import java.io.File; import java.io.FileInputStream; import java.io.FileNotFoundExce ...

  10. ACM 中常用的算法有哪些？

    在网上看到别人ACM学习的心得,转载过来,源地址不记得了,当时是百度的.内容如下: 网络上流传的答案有很多,估计提问者也曾经去网上搜过.所以根据自己微薄的经验提点看法. 我ACM初期是训练编码能力,以 ...