@ManagedOperationParameter not marked with @Target/@Retention/@Documented/@Repeatable [SPR-13700]

[spring-projects-issues]

Allan Jones opened SPR-13700 and commented

All annotations in org.springframework.jmx.export.annotation package contain the annotation @Documented, therefore they could be part of any javadoc documentation. The only exception is @org.springframework.jmx.export.annotation.ManagedOperationParameter which contains two important fields: name and description.

Current Scenario:
My project has several JMX-exposed methods annotated with @ManagedOperation and @ManageOperationParameters/@ManageOperationParameter. I use the description on both annotations to guide the clients when using a JMX console. A javadoc is also generated as a guide/reference for clients that use this service through a different tool, and the parameters name/description are missing in the javadoc.

A small note: @Target, @Retention annotations are also missing.

---

Affects: 4.2.3

Issue Links:

• Allow the ManagedResource/Attribute/Metric/Operation to be placed on interface [SPR-13138] #17729 Allow the ManagedResource/Attribute/Metric/Operation to be placed on interface

Referenced from: commits 3aefc96

[spring-projects-issues]

Juergen Hoeller commented

In fact, @ManagedOperationParameter not only misses @Target, @Retention and @Documented but also @Repeatable which it should have according to Spring 4's general mission of declaring all applicable annotations as repeatable on Java 8. The latter is also missing from @ManagedNotification, so I'm also adding it there.