前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >java文档注释报错,java文档注释主要使用方法「建议收藏」

java文档注释报错,java文档注释主要使用方法「建议收藏」

作者头像
全栈程序员站长
发布2022-11-15 18:02:31
8000
发布2022-11-15 18:02:31
举报
文章被收录于专栏:全栈程序员必看

一、java包含哪些注释

1.//用于单行注释。

2./*…*/用于多行注释,从/*开始,到*/结束,不能嵌套。

3./**…*/则是为支持jdk工具javadoc.exe而特有的注释语句。这个也就是我们所知的文档注释

在命名控制台:使用命令行在目标文件所在目录输入javadoc +文件名.java。

二、文档注释的关键名词

/**

标记 用于 作用

* @author 类或方法 一般用于描述开放者

* @version 类 版本说明

* @see 对类、属性、方法的说明            参考转向,也就是相关主题

* @param 方法 对方法参数的说明

* @throws 方法 对异常的说明

* @return 方法 对返回值的说明

* {@value} 方法,类 、属性 可以用于生成被标记的常量字段的值。

* {@inheritDoc} 方法、类 可以集成上一个文档的注释

* {@link} 类、方法 链接标签

* {@linkplain} 类、方法 链接标签、与上一个标签唯一的不同就是因为字体不同,如果 label 是个纯文本,那就使用 linkplain

* @since 类、方法 表达的是被标记元素是哪个发布版本引入的

* @exception 方法 跟@throws的用法相同

* @serialData

*

代码语言:javascript
复制
          方法、类                                    没错,这就是那个 HTML 标签,用于显示“原始样子”的。

Jetbrains全家桶1年46,售后保障稳定

*/

三、一个例子

public void aa(){

}

/**一般这几个注解够开放使用了

* @author mingge

* @since 1.0

* @see #aa() 查看aa方法

* @param a 参数a

* @return 返回值描述

* @throws 异常说明

*/

public int test(int a) throws Exception{

return a;

}

我觉得很多细节还需要学习,天天学习,天天进步!

JAVA 文档注释,类的说明,HTML说明文档的生成

有的时候,我们会写一些类,编译成.class文件,给别人使用,那么,别人不知道这个类有哪些方法,如何调用. 所以我们需要做一个类的说明文档. 可以采用在.java类里面进行注释,通过注释来生成类的说明 …

Java – 34 Java 文档注释

Java 文档注释 Java只是三种注释方式.前两种分别是// 和/* */,第三种被称作说明注释,它以/** 开始,以 */结束. 说明注释允许你在程序中嵌入关于程序的信息.你可以使用javadoc …

Java-Runoob-高级教程:Java 文档注释

ylbtech-Java-Runoob-高级教程:Java 文档注释 1.返回顶部 1. Java 文档注释 Java 支持三种注释方式.前两种分别是 // 和 /* */,第三种被称作说明注释,它以 …

Java 学习(20):Java Applet 基础 & Java 文档注释

— Java Applet 基础 — Java 文档注释 Java Applet 基础 Applet 是一种 Java 程序.它一般运行在支持 Java 的 Web 浏览器内.因为它有完整的 Ja …

java文档注释规范(一)

https://blog.csdn.net/huangsiqian/article/details/82725214 Javadoc工具将从四种不同类型的“源”文件生成输出文档:Java语言类的源文件 …

如何为我们的程序编写开发文档——Java文档注释

Java文档注释是用于生成Java API文档的注释,通过在程序中的类.属性.方法部分加上注释,就可以用javadoc命令生成漂亮的API文档,是程序员进阶的必备技能. 注意,文档注释只说明紧跟其后的 …

java文档注释–javadoc的用法

1.前言 Java中有三种注释方式.前两种分别是 // 和 /* */,主要用于代码的注释,以此来方便代码的可读性.第三种被称作说明注释或文档注释,它以 /** 开始,以 */结束,文档注释允许你在程 …

JAVA文档注释标签

1 常用Java注释标签(Java comment tags) @author 作者 @param 输入参数的名称 说明 @return 输出参数说明 @since JDK版本 @version …

随机推荐

java编译做了哪些事?

Javac编译器,主要做了如下的事情:1.解析与填充符号表: 2.注解处理器: 3.语义分析与字节码生成: 3.1.标注检查 3.2.数据及控制流分析 …

InnoDB关键特性之insert buffer

insert buffer 是InnoDB存储引擎所独有的功能.通过insert buffer,InnoDB存储引擎可以大幅度提高数据库中非唯一辅助索引的插入性能. 数据库对于自增主键值的插入是顺序的 …

vue2入坑随记(一)

都说Vue2简单,上手容易,但小马过河,自己试了才晓得,除了ES6语法和webpack的配置让你感到陌生,重要的是思路的变换,以前随便拿全局变量和修改dom的锤子不能用了,变换到关注数据本身.vue的 …

[code segments] OpenCV3.0 SVM with C++ interface

talk is cheap, show you the code: /***************************************************************** …

js数字串传参时变科学计数法

例1:οnclick=channel_info_listFt(\”‘+val.gid+’\”,’+val.deviceIdOwner+’,’+val.gname+’) 当长度过长的 …

Mac环境下 elasticsearch-6.0.1 和 elasticsearch-head 完整安装过程

安装步骤: 安装java jdk 安装elasticsearch-6.0.1 及中文分词 anslysis-ik-6.0.1 安装elasticsearch-head 下载jdk https://w …

SQLI DUMB SERIES-16

(1)无论怎么输入,都没有回显,但当输入 admin”)#时,显示登录成功.若通过其他方法获取数据库的用户名,可通过这个方法登录成功. (2)获取其他信息可用考虑时间延迟注入.方法同15.

CSS实现移动端横向滑动

html:

&lt …

MYSQL问题解决

1. MySQL错误日志里出现: 140331 10:08:18 [ERROR] Error reading master configuration 140331 10:08:18 [ERROR] …

关于java学习中的一些易错点(基础篇)

由JVM来负责Java程序在该系统中的运行,不同的操作系统需要安装不同的JVM,这样Java程序只需要跟JVM打交道,底层的操作由JVM去执行. JRE(Java Runtime Environmen …

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

发布者:全栈程序员栈长,转载请注明出处:https://javaforall.cn/230819.html原文链接:https://javaforall.cn

本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2022年10月31日,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
相关产品与服务
Elasticsearch Service
腾讯云 Elasticsearch Service(ES)是云端全托管海量数据检索分析服务,拥有高性能自研内核,集成X-Pack。ES 支持通过自治索引、存算分离、集群巡检等特性轻松管理集群,也支持免运维、自动弹性、按需使用的 Serverless 模式。使用 ES 您可以高效构建信息检索、日志分析、运维监控等服务,它独特的向量检索还可助您构建基于语义、图像的AI深度应用。
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档