java注释中,用什么标记表示参数,返回值,异常

2021-01-11 15:22:38 字数 5613 阅读 1616

1楼:匿名用户

你好:应该是类似于我这种吧

/***

*i.企业财务室支付指令查询交易**:qpayper**是否必输:t-必输f-选输

**@paramqryfseqno待查指令包序列号f*@paramqryserialno待查平台交易序列号(判断待查指令包序列号和待查平台交易序列号必须至少有一项有值,如同时有则以后者为准)f

*@paramqryiseqno待查指令包顺序号(待查指令包顺序号和待查平台交易顺序号不能同时为空)f

*@paramqryorderno待查平台交易顺序号f*@return返回执行结果(是由base64加密后的信息)*/publicstaticqpayperresponseentityqpayper(stringqryfseqno,stringqryserialno,stringqryiseqno,stringqryorderno)throwsexception

java注释里的这些标记分别是什么意思?

2楼:河瑞

方法/步骤

java注释,总共有3种注释方法。

1、注释一行(在eclipse里的快捷键是:crtl+/)。快捷键按一下注释,再按一下,取消注释。

//内容

//内容

2、注释多行、块注释(在eclipse里的快捷键是:crtl+shift+/)。快捷键按一下注释,再按一下,不能取消注释。只能人为的删除。

/*内容

内容内容*/

3、文档注释(在eclipse里的快捷键是:/**+enter)。快捷键按一下注释。仅这注释方法可以写入javadoc文档

/** 内容

*内容*内容

*/4、javadoc注释标签语法的一些说明。(你可以输入@,在加alt+/(补全键))

@author 对类的说明--标明开发该类模块的作者

@version 对类的说明--标明该类模块的版本

@param 对方法的说明--方法中某参数的说明

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

@exception 对方法的说明--方法可能抛出的异常的说明

注释的一些要求。

注释内容要简单、明了、含义准确,防止注释的多义性,错误的注释不但无益反而有害。

end注意事项

注释内容是不被编辑的内容,只是解释说明

注释,为了更方便的阅读

每次单行注释、多行注释,要选中要注释的内容

3楼:庚心不变群子

1、 标签用于表示计算机源**或者其他机器可以阅读的文本内容。

2、 标签显示斜体文本效果。

3、一个段落,每个段落之间一般会有一个空行。

4、 增加链接。

5、 标签呈现类似打字机或者等宽的文本效果。

java中注释的问题

4楼:匿名用户

doc注释/**------*/是完全为javadoc服务的会被编译识别。

@打头的表示注解,注解这个东西是jdk1.5提出来的,表示一个类(class)、字段(field)或者方法(method)的属性(attribute)。

javadoc是javaapi的一种方便实现,主要是为了别人对此类的阅读使用的方便,一般不影响类的功能。因为java之前的c/c++的api让你阅读起来非常不方便。

doc注释里面的专门给出doc提示用的,如:注释内的@return 表示方法的返回值类型,它是在方法上的doc注解,即使你这个上面随便瞎写,不会影响类的编译和功能。

而在方法上面直接加的@override,表示这个方法是覆盖来自超类(super class)的已知方法。

如果方法定义和超类的这个方法格式不合适,编译无法通过。

5楼:

javadoc是sun公司提供的一个技术,它从程序源**中抽取类、方法、成员等注释形成一个和源**配套的api帮助文档。也就是说,只要在编写程序时以一套特定的标签作注释,在程序编写完成后,通过javadoc就可以同时形成程序的开发文档了。而所谓特定的标签就是/**、@了,类似这样的:

/*** 获取本季度所有已跑批的异常文档

* @author ***

* @return 文档信息

* @throws sqlexception*/

6楼:手机用户

同意 上楼

sora_no_kiseki

7楼:匿名用户

这是javadoc里的注释方法。其实和学java编程关系不大,不懂也不要紧

java 中的几种注释方式

8楼:犯罪学家拱

我看动力节点的java基础大全301集教中的三种注释方法:

1、单行注释 //注释的内容

2、多行注释/*......*/

3、/**......*/,这种方式和第二种方式相似。这种格式是为了便于javadoc程序自动生成文档。

下面介绍一下javadoc的标记:

特别声明:

(1)javadoc针对public类生成注释文档

(2)javadoc只能在public、protected修饰的方法或者属性之上

(3)javadoc注释的格式化:前导*号和html标签

(4)javadoc注释要仅靠在类、属性、方法之前

下面主要举例说明第三种注释的应用:

(1)首先编写.java文件

(2)在命令行中执行以下dos命令:

javadoc *.java //根据相应的java源**及其说明语句生成html文档

//javadoc标记:是@开头的,对javadoc而言,特殊的标记。

(3)在当前目录下就会产生doc文件夹,里面有一系列的.html文件

附上**:

[java]view plaincopy

*//**javadoc注释的内容

*/publicclasshello

/**这是第1个方法,其作用是...*/

publicstaticvoidf1()

}[java]view plaincopy

importjava.io.ioexception;

/**javadoc注释内容

*@since1.0

*@version1.1

*@authorbluejey

*链接到另一个文档,就这些

*seehello

*/publicclasshelloworld

/**这是第一个方法,其作用是....

*@deprecated从版本1.2开始,不再建议使用此方法

*/publicstaticvoidf1()

/**这是第二个方法,其作用是....

*@return返回是否ok

*@parami输入参数i

*@seehello

*@throwsioexceptionio异常

*/publicstaticstringf2(inti)throwsioexception

}注意:

如果源文件中有用到@version,@author标记,则在执行javadoc命令时,要加-version-author

javadoc-version-author-ddoc*.java

(其中用-version用于提取源文件中的版本信息-author用于提取源文件中的作者信息)

9楼:沙

三种类型:

1、单选注释:

符号是://

2、块注释: 符号是: /* */ 可以跨多行3、javadoc注释:

符号是: /** */ 可以跨多行,生成javadoc时,这样的注释会被生成标准的javaapi注释。

10楼:匿名用户

1、单选://

2、多行: /* */

3、javadoc注释: /** */ (一般用于某方法或类前面,其它地方调用时,放鼠标上面会看到注释内容)

11楼:匿名用户

// 单行注释/**

*/ 多行和文本注释

java中文档注释各字段的含义是什么?例如author表示作者,para表示参数等 30

12楼:匿名用户

常用java注释标签(java ***ment

tags)@

13楼:天香阁主一

参见https://****tah1986.***/1382.html,以**的形式详细描述,并且附有**。

java方法名前注释问题

14楼:匿名用户

java注解是附加在**中的一些元信息,用于一些工具在编译、运行时进行解析和使用,起到说明、配置的功能。

注解不会也不能影响**的实际逻辑,仅仅起到辅助性的作用。包含在 java.lang.annotation 包中。

1、元注解

元注解是指注解的注解。包括 @retention @target @document @inherited四种。

1.1、@retention: 定义注解的保留策略

@retention(retentionpolicy.source) //注解仅存在于源码中,在class字节码文件中不包含

@retention(retentionpolicy.class) // 默认的保留策略,注解会在class字节码文件中存在,但运行时无法获得,

@retention(retentionpolicy.runtime) // 注解会在class字节码文件中存在,在运行时可以通过反射获取到

1.2、@target:定义注解的作用目标

@target(elementtype.type) //接口、类、枚举、注解

@target(elementtype.field) //字段、枚举的常量

@target(elementtype.method) //方法

@target(elementtype.parameter) //方法参数

@target(elementtype.constructor) //构造函数

@target(elementtype.local_variable)//局部变量

@target(elementtype.annotation_type)//注解

@target(elementtype.package) ///包

由以上的源码可以知道,他的elementtype 可以有多个,一个注解可以为类的,方法的,字段的等等

1.3、@document:说明该注解将被包含在javadoc中。

1.4、@inherited:说明子类可以继承父类中的该注解。

15楼:匿名用户

方法写完后,在方法上面输入“/**”然后回车就都出来了

不过一般完了之后都需要吧参数和返回值的说明修改一下

16楼:许诗文

1、包名:包名由小写英文字母组成。