Интерфейс аннотации DescriptorKey

Метааннотация, описывающая связь элемента аннотации с полем в Descriptor. Это может быть дескриптор MBean или атрибута, операции либо конструктора в MBean, а также параметра операции или конструктора.

Например, рассмотрим эту аннотацию:

@Documented
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Units {
    @DescriptorKey("units")
    String value();
}

и такое использование аннотации:

public interface CacheControlMBean {
    @Units("bytes")
    public long getCacheSize();
}

Когда из CacheControlMBean создается стандартный MBean, согласно обычным правилам у него будет атрибут с именем CacheSize типа long. Аннотация @Units, согласно приведенному выше определению, гарантирует, что MBeanAttributeInfo для этого атрибута будет иметь Descriptor с полем units, которому соответствует значение bytes.

Аналогично, если аннотация выглядит так:

@Documented
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Units {
    @DescriptorKey("units")
    String value();

    @DescriptorKey("descriptionResourceKey")
    String resourceKey() default "";

    @DescriptorKey("descriptionResourceBundleBaseName")
    String resourceBundleBaseName() default "";
}

и используется так:

public interface CacheControlMBean {
    @Units("bytes",
           resourceKey="bytes.key",
           resourceBundleBaseName="com.example.foo.MBeanResources")
    public long getCacheSize();
}

то в результирующем Descriptor будут содержаться следующие поля:

Аннотацию, такую как @Units, можно применить к:

• интерфейсу стандартного MBean или MXBean;
• методу в таком интерфейсе;
• параметру метода в интерфейсе стандартного MBean или MXBean, если этот метод является операцией (а не геттером или сеттером атрибута);
• открытому конструктору класса, реализующего стандартный MBean или MXBean;
• параметру такого конструктора.

Другие варианты использования аннотации игнорируются.

Аннотации интерфейса проверяются только в точном интерфейсе, определяющем интерфейс управления стандартного MBean или MXBean, но не в его родительских интерфейсах. Аннотации методов проверяются только в наиболее специализированном интерфейсе, в котором встречается метод; другими словами, если дочерний интерфейс переопределяет метод родительского интерфейса, учитываются только аннотации @DescriptorKey в методе дочернего интерфейса.

Поля дескриптора, добавляемые таким образом разными аннотациями одного и того же элемента программы, должны быть согласованы. То есть две разные аннотации или два элемента одной аннотации не должны задавать разные значения для одного и того же поля дескриптора. Поля из аннотаций метода-геттера также должны быть согласованы с полями из аннотаций соответствующего метода-сеттера.

Дескриптор, полученный из этих аннотаций, будет объединен с любыми полями дескриптора, предоставленными реализацией, например с полем immutableInfo для MBean. Поля из аннотаций должны быть согласованы с этими полями, предоставленными реализацией.

Элемент аннотации, преобразуемый в поле дескриптора, может иметь любой тип, разрешенный языком Java, кроме аннотации или массива аннотаций. Значение поля определяется на основе значения элемента аннотации следующим образом: