maven 生成javadoc常见

时间 2019-11-21

原文原文链接

1 乱码问题java

2自定义标签apache

<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>${maven_javadoc_version}</version>
<configuration>
<aggregate>true</aggregate>
<tags>
<tag>
<name>checkstyle</name>
<placement>a</placement>
<head>略过checkstyle规则</head>
</tag>
</tags>
</configuration>
<executions>
<execution>
<id>attach-javadoc</id>
<goals>
<goal>jar</goal>
</goals>
<phase>compile</phase>
</execution>
</executions>
</plugin>
maven

属性说明

name 标签名

placement 标签适用的位置

head 前置提示

属性	说明
name	标签名
placement	标签适用的位置
head	前置提示

该三个参数和用使用generate javadoc 生成时，第三步添加自定义标签基本一致spa

其添加方式以下：.net

-tag Date:a:"生成日期"插件

-tag Desc:a:"功能描述"code

3 忽略告警、错误blog

常见的如@return和@param 后面没有描述等等ci

网上常见的配置以下：get

<plugin>

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

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

<version>2.10.3</version>

<executions>

<execution>

<id>attach-javadocs</id>

<goals>

<goal>jar</goal>

</goals>

<configuration>

<additionalparam>-Xdoclint:none</additionalparam>

</configuration>

</execution>

</executions>

</plugin>

这种方式的缺点是只能使用老版本插件，新版的maven是不支持的。新版的配置以下

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>3.0.1</version>
    <configuration>
        <doclint>none</doclint>
    </configuration>
</plugin>

1. maven生成javadoc文件
2. 生成javadoc
3. eclipse生成javadoc
4. eclipse 生成JavaDoc
5. myeclipise生成javadoc
6. IntelliJIDEA生成JavaDoc
7. Java生成javadoc
8. Intellij 生成 JavaDoc
9. Eclipse生成javaDoc
10. IEDA生成javadoc
更多相关文章...
• Eclipse 生成jar包 - Eclipse 教程
• Maven 构建生命周期 - Maven教程
• 常用的分布式事务解决方案
• Java Agent入门实战（一）-Instrumentation介绍与使用