Java函数中的注解（Annotations）

Java中的注解（Annotations）是一种元数据（Meta data）的形式，它可以被附加到Java代码的各个部分中，比如类、方法、变量、接口、构造函数等。它们提供了一种可扩展的、基于标记的方式来声明类、方法或其他Java元素的描述和额外信息。

注解不影响程序代码的实际行为，它们只是提供了程序的额外信息和标记。注解的存在可以使代码更加清晰、易于理解，并且可以帮助开发人员在代码中附加额外的元数据来支持某些框架或工具。

Java中的注解是用特定的符号（@）来标识的，这个符号通常称为“AT符号”。在编写注解时，我们必须使用Java语言中所定义的注解元素来指定注解的行为和属性。以下是一些Java中常用的注解：

1. @Override：这个注解可以用于方法上，表示该方法重写了该类的父类中的方法。

2. @Deprecated：这个注解用于标注应该停止使用的类、方法或字段等。

3. @SuppressWarnings：用于忽略编译器对某些语法的警告提示，它可以被用于整个类或单个方法中。

4. @SafeVarargs：用于标注声明的方法或构造函数是安全的，即没有可变参数类型的警告。

5. @FunctionalInterface：用于标注一个接口，以表明它是一个函数式接口，须符合lambda表达式和Method Reference的规范。

6. @Retention：注解的保留策略，即在注解被读取时应该保留到哪个时期，有三种策略：

- SOURCE：注解只保留在源代码中，并在编译成.class文件时被丢弃。

- CLASS：注解被保留到.class文件中，但在运行时不会被读取。

- RUNTIME：注解被保留到.class文件中，并在运行时被读取。

7. @Documented：用于指定该注解应该出现在文档中。

8. @Inherited：用于指定该注解应该被继承。

Java提供了许多内置的注解，也允许开发人员自定义自己的注解。自定义注解需要定义注解类型，其本质上是Java接口，我们可以使用@Target注解来指定自定义注解可以用于哪些元素上，使用@Retention注解来指定自定义注解的保留策略。

下面是一个简单的例子，展示如何定义和使用自定义注解：

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface MyAnnotation {
    String value() default "";
}

public class Example {

    @MyAnnotation(value = "Hello World!")
    public void sayHello() {
        System.out.println("Hello World!");
    }

    public static void main(String[] args) throws Exception {
        Example example = new Example();

        MyAnnotation annotation = example.getClass()
            .getMethod("sayHello")
            .getAnnotation(MyAnnotation.class);

        System.out.println(annotation.value());
    }
}

在上面的例子中，我们定义了一个名为MyAnnotation的注解，它可以用于方法元素上，并且使用@Retention(RetentionPolicy.RUNTIME)指定了它的保留策略。然后我们在Example类中的sayHello方法上使用了该注解，并给注解一个值“Hello World!”。

在使用自定义注解时需要使用反射API获取注解对象，我们可以通过调用方法的Class对象的getMethod方法获取方法上的注解对象。最后，我们可以通过访问注解对象的value属性来获取注解的值。

总结：

Java中的注解提供了一种元数据的形式来反映代码的附加信息，使得代码更加清晰而且易于理解。Java语言内置了许多常用的注解，同时也支持自定义注解，可以通过自定义注解来为代码附加额外的信息、支持某些框架或工具的特定行为。