java 读写doc maven_maven 生成javadoc常见

1  乱码问题

2自定义标签

org.apache.maven.plugins

maven-javadoc-plugin

${maven_javadoc_version}

true

checkstyle

a

attach-javadoc

jar

compile

属性

说明

name

标签名

placement

标签适用的位置

head

前置提示

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

其添加方式如下：

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

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

3 忽略告警、错误

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

网上常见的配置如下：

org.apache.maven.plugins

maven-javadoc-plugin

2.10.3

attach-javadocs

jar

-Xdoclint:none

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

org.apache.maven.plugins

maven-javadoc-plugin

3.0.1

none