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

Мета-аннотация, описывающая, как элемент аннотации относится к полю в Descriptor. Это может быть 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();
 }
 

Когда Standard MBean создается из CacheControlMBean, стандартные правила означают, что он будет иметь атрибут, названный 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, может быть применена к:

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

Другие применения аннотации игнорируются.

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

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

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

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