如何建立网站的英文版,深圳优美网络科技有限公司,给个网站你们知道的,wordpress.文章缩略图一、javadoc注解标记#xff1a; author#xff1a;作者-类、接口级别 version#xff1a;版本-类、接口级别 deprecated#xff1a;不推荐使用的方法 param#xff1a;方法、构造函数的参数 return#xff1a;方法的返回类型 see#xff1a;用于指定参考的内容 author作者-类、接口级别 version版本-类、接口级别 deprecated不推荐使用的方法 param方法、构造函数的参数 return方法的返回类型 see用于指定参考的内容一般会带有链接或文本条目 exception抛出的异常 throws抛出的异常和exception同义 since: 标识此更改或功能子指定的版本、时间开始存在
二、maven-javadoc-plugin插件 !-- 生成API文档插件 --plugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-javadoc-plugin/artifactIdversion3.3.2/versionexecutionsexecutionidattach-javadocs/idgoalsgoaljar/goal/goals/execution/executions/plugin在java项目中打包时会引入maven-javadoc-plugin插件将java注解打包到一个jar包中但是如果java的注解不够标准的话则会抛出异常无法正常的打包如下异常
Command line was: /Library/Java/JavaVirtualMachines/jdk-11.0.10.jdk/Contents/Home/bin/javadoc options packagesRefer to the generated Javadoc files in /Users/xx/Documents/IDE/workplace-java/spring-parent/emily-spring-boot-logger/target/apidocs dir.解决方案添加failOnError参数控制构建过程中出现错误是否停止构建如下配置 !-- 生成API文档插件 --plugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-javadoc-plugin/artifactIdversion3.3.2/versionconfigurationfailOnErrorfalse/failOnError/configurationexecutionsexecutionidattach-javadocs/idgoalsgoaljar/goal/goals/execution/executions/plugin将failOnError参数设置为false即在生成文档时出现错误时不会停止构建过程。 三、排除指定的包构建过程中检查javadoc文档是否正确
可以通过excludePackageNames参数指定要排除哪些包或者注解 configuration!--控制构建过程中如果出现错误是否停止构建--failOnErrorfalse/failOnError!--排除指定的包可以使用: or , or ; 三种符号分割--excludePackageNamescom.emily.cloud.test.*,com.emily.infrastructure.test.*/excludePackageNames/configurationGitHub地址https://github.com/mingyang66/spring-parent
