java注释的java注解

Posted 2023-05-15

参考技术A

Annotation(注解)是JDK5.0及以后版本引入的。它可以用于创建文档，跟踪代码中的依赖性，甚至执行基本编译时检查。注解是以‘@注解名’在代码中存在的，根据注解参数的个数，我们可以将注解分为：标记注解、单值注解、完整注解三类。它们都不会直接影响到程序的语义，只是作为注解（标识）存在，我们可以通过反射机制编程实现对这些元数据的访问。另外，你可以在编译时选择代码里的注解是否只存在于源代码级，或者它也能在class文件中出现。
元数据的作用
如果要对于元数据的作用进行分类，大致可分为三类：
编写文档：通过代码里标识的元数据生成文档。
代码分析：通过代码里标识的元数据对代码进行分析。
编译检查：通过代码里标识的元数据让编译器能实现基本的编译检查 @Override
Java代码
packagecom.iwtxokhtd.annotation;
/**
* 测试Override注解
*@authorAdministrator
*
*/
publicclassOverrideDemoTest
//@Override
publicString tostring()
return测试注解;


@Deprecated的作用是对不应该在使用的方法添加注解，当编程人员使用这些方法时，将会在编译时显示提示信息，它与javadoc里的@deprecated标记有相同的功能，准确的说，它还不如javadoc @deprecated，因为它不支持参数，使用@Deprecated的示例代码示例如下：
Java代码
packagecom.iwtxokhtd.annotation;
/**
* 测试Deprecated注解
*@authorAdministrator
*
*/
publicclassDeprecatedDemoTest
publicstaticvoidmain(String[] args)
//使用DeprecatedClass里声明被过时的方法
DeprecatedClass.DeprecatedMethod();


classDeprecatedClass
@Deprecated
publicstaticvoidDeprecatedMethod()


@SuppressWarnings,其参数有：
deprecation，使用了过时的类或方法时的警告
unchecked，执行了未检查的转换时的警告
fallthrough，当 Switch 程序块直接通往下一种情况而没有 Break 时的警告
path，在类路径、源文件路径等中有不存在的路径时的警告
serial，当在可序列化的类上缺少serialVersionUID 定义时的警告
finally ，任何 finally 子句不能正常完成时的警告
all，关于以上所有情况的警告 packagecom.iwtxokhtd.annotation;
importjava.util.ArrayList;
importjava.util.List;
publicclassSuppressWarningsDemoTest
publicstaticListlist=newArrayList();
@SuppressWarnings(unchecked)
publicvoidadd(String data)
list.add(data);

java方法名前注释问题

都有返回值的方法，默认加注释，有的会把参数，返回值加上，有的就是空的
/**
*
* @param tidanInfo
* @throws BusinessException
*/

　　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：说明子类可以继承父类中的该注解。 参考技术A 先把方法写完并且保存就会把参数和返回值加上 参考技术B 1、包名：包名由小写英文字母组成。
为了保障每个Java包命名的惟一性，最新的Java编程规范要求程序员在自己定义的包的名称之前加上惟一的前缀。由于互联网上的域名是不会重复的，所以程序员一般采用自己在互联网上的域名作为自己程序包的惟一前缀。例如：net.frontfree.javagroup。
2、类名：类名必须用大写英文字母开头，多单词组合时单词首字母用大写，单词其他字母用小写。
如果类名称由多个单词组成，则建议将每个单词的首字母均用大写，例如TestPage。如果类名称中包含单词缩写，则建议将这个词的每个字母均用大写，如：XMLExample。由于类是设计用来代表对象的，所以建议在命名类时应尽量选择名词。例如：NameStandardTest。
3、常量名：常量用final来修饰，表明一般情况下，代码中只用它而不能再改变它的值。
常量的名字应该都使用大写字母，并且指出该常量完整含义。如果一个常量名称由多个单词组成，则建议用下划线来分割这些单词。
例如：MAX_VALUE。
4：方法名：一般首单词首字母用小写英文，其他单词首字母用大写。
方法的名字的第1个单词应以小写字母开头，后面的单词则建议用大写字母开头。
例如：sendMessge()。
5：参数名：与方法名规范相同。
参数的命名规范和方法的命名规范相同，而且为了避免阅读程序时造成迷惑，请在尽量保证在参数名称为一个单词的情况下，参数的命名尽可能明确。例如：methodTest(String stringName)。

6: 注释

Java除了可以采用常见的注释方式之外，Java语言规范还定义了一种特殊的注释，也就是通常所说的Javadoc注释，它是用来记录代码中的API的。Javadoc注释是一种多行注释，以/**开头，而以*/结束，注释可以包含一些HTML标记符和专门的关键词。使用Javadoc注释的好处是编写的注释可以被自动转化为在线文档，省去了单独编写程序文档的麻烦。例如：

/**
*This is an example of
* Javadoc
*
*@author darchon
*@version 0.1, 10/11/2002
*/
在每个程序的最开始部分，一般都用Javadoc注释进行程序的总体描述以及版权信息。在主程序中可以为每个类、接口、方法、变量添加Javadoc注释，每个注释的开头部分先用一句话概括该类、接口、方法、变量所完成的功能，这句话应单独占据一行以突出其概括作用，在这句话后面可以跟随更加详细的描述段落。
在描述性段落之后还可以跟随一些以Javadoc注释标签开头的特殊段落，例如上面例子中的@auther和@version，这些段落将在生成的文档中以特定方式显示。
虽然添加注释不会使一个设计低劣的程序变成好的程序，但是如果按照编程规范编写程序，并且为程序添加良好的注释，却可以帮助编写出设计优美、运行高效且易于理解的程序，尤其在多人合作完成同一项目时，编程规范非常重要。 参考技术C 方法写完后，在方法上面输入“/**”然后回车就都出来了
不过一般完了之后都需要吧参数和返回值的说明修改一下 参考技术D 是这样的，你想达到什么效果呀？