Java中的注释提供了一种描述类、字段和方法的方法。本质上，它们是添加到Java源文件中的一种元数据形式，它们不能直接影响程序的语义。但是，注释可以在运行时使用反射读取&这个过程被称为内省。然后，它可以用来修改类、字段或方法。

这个特性，经常被库和sdk (hibernate, JUnit, Spring Framework)利用来简化或减少程序员在使用这些库或sdk时需要做的代码量。因此，可以公平地说，注释和反射在Java中是齐头并进的。

我们还将注释的可用性限制在编译时或运行时。下面是一个创建自定义注释的简单示例

Driver.java

package io.hamzeen;

import java.lang.annotation.Annotation;

public class Driver {

    public static void main(String[] args) {
        Class<TestAlpha> obj = TestAlpha.class;
        if (obj.isAnnotationPresent(IssueInfo.class)) {

            Annotation annotation = obj.getAnnotation(IssueInfo.class);
            IssueInfo testerInfo = (IssueInfo) annotation;

            System.out.printf("%nType: %s", testerInfo.type());
            System.out.printf("%nReporter: %s", testerInfo.reporter());
            System.out.printf("%nCreated On: %s%n%n",
                    testerInfo.created());
        }
    }
}

TestAlpha.java

package io.hamzeen;

import io.hamzeen.IssueInfo;
import io.hamzeen.IssueInfo.Type;

@IssueInfo(type = Type.IMPROVEMENT, reporter = "Hamzeen. H.")
public class TestAlpha {

}

IssueInfo.java

package io.hamzeen;

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

/**
 * @author Hamzeen. H.
 * @created 10/01/2015
 * 
 * IssueInfo annotation definition
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface IssueInfo {

    public enum Type {
        BUG, IMPROVEMENT, FEATURE
    }

    Type type() default Type.BUG;

    String reporter() default "Vimesh";

    String created() default "10/01/2015";
}

它是基于XML的替代品吗 配置吗?

不完全如此，但是与代码结构紧密对应的配置(例如JPA映射或Spring中的依赖注入)通常可以用注释代替，这样通常就不那么冗长、烦人和痛苦了。几乎所有著名的框架都进行了这种转换，尽管旧的XML配置通常仍然是一种选项。

Java EE 5倾向于使用注释而不是XML配置。例如，在EJB3中，EJB方法上的事务属性是使用注释指定的。他们甚至使用注释将pojo标记为ejb，并将特定的方法指定为生命周期方法，而不需要接口的实现。

注释可以在哪里使用

注释可以应用于声明:类、字段、方法和其他程序元素的声明。在声明上使用时，根据约定，每个注释通常出现在自己的行上。

Java SE 8 Update:注释也可以应用于类型的使用。下面是一些例子:

类实例创建表达式: @Interned MyObject(); 类型转换: myString =(@非空字符串)str; 实现条款: 类UnmodifiableList实现 @Readonly List<@Readonly T>{…｝ 抛出的异常声明: void monitorTemperature()抛出 @临界温度异常{…｝

JPA(来自Java EE 5)是(过度)使用注释的一个很好的例子。Java EE 6还将在很多新领域引入注释，比如RESTful webservices和每个老Servlet API下的新注释。

这里有一些资源:

Sun - Java持久性API Java EE 5教程- JPA 介绍Java EE 6平台(查看所有三个页面)。

注释不仅可以接管配置细节，而且还可以用来控制行为。您可以在Java EE 6的JAX-RS示例中看到这一点。

注释有两个视图

在用户视图中，大多数时候，注释就像一个快捷键，为你节省一些按键，或使你的程序更具可读性 从供应商的角度来看，处理器对注释的看法更像是一个轻量级的“接口”，你的程序确实要面对一些东西，但没有显式地“实现”特定的接口(这里也就是注释)。

例如，在jpa中，您可以定义如下内容

@Entity class Foo {...}

而不是

class Foo implements Entity {...}

两者都说了同样的话"Foo是一个实体类"