spring-framework/framework-docs/modules/ROOT/pages/integration/jmx
Sam Brannen 1af6480217 Revise reference documentation for Spring JMX annotations
This commit revises the reference documentation for Spring JMX
annotations for various reasons including, but not limited to, the
following.

- Type names such as ManagedResource are often ambiguous, especially
  when discussing an annotation like @⁠ManagedResource instead of
  org.springframework.jmx.export.metadata.ManagedResource which is a
  class.
- AnnotationTestBean implements IJmxTestBean, even though an annotated
  MBean is not required to implement any interfaces, and in fact the
  example is meant to demonstrate that an annotated POJO suffices.
- @⁠ManagedOperationParameter annotations are unnecessarily declared in
  the @⁠ManagedOperationParameters container.
- The documentation sometimes refers to JmxTestBean when it should
  instead refer to AnnotationTestBean.
- Inconsistent and confusing wording for annotation attributes,
  properties, managed attributes, etc.
- The tables refer to "source-level metadata types/parameters" when
  they should refer to Spring JMX annotations and their attributes.
- The annotation and attribute tables have inconsistent ordering and
  naming for column headers.
- @⁠ManagedNotification and @⁠ManagedMetric are not mentioned.
- The AutodetectCapableMBeanInfoAssembler example is broken since it
  uses the non-annotated JmxTestBean instead of the AnnotationTestBean.

As a side note, the JmxTestBean in our test suite still contains
XDoclet "annotations" which can be safely removed. 😉

Closes gh-33466
2024-09-02 18:18:10 +02:00
..
exporting.adoc Modernize the integration section of the refdoc 2024-05-06 16:05:35 +02:00
interface.adoc Revise reference documentation for Spring JMX annotations 2024-09-02 18:18:10 +02:00
jsr160.adoc Split files 2023-05-04 15:35:05 +01:00
naming.adoc Modernize the integration section of the refdoc 2024-05-06 16:05:35 +02:00
notifications.adoc Extract recurring asciidoc links to attributes, cleanup old doc files 2023-11-21 15:59:24 +01:00
proxy.adoc Split files 2023-05-04 15:35:05 +01:00
resources.adoc Extract recurring asciidoc links to attributes, cleanup old doc files 2023-11-21 15:59:24 +01:00