Standardize Javadoc example headings

Replaced Javadoc example section labels from `<p>Example Usage:` to `<h3>Example Usage</h3>` across discovery, service registry, fault-tolerance, and OpenFeign components. This aligns documentation formatting for clearer rendered structure and consistent API docs throughout the modules.

Author: mercyblitz

microsphere-spring-cloud-commons/src/main/java/io/microsphere/spring/cloud/client/discovery/ReactiveDiscoveryClientAdapter.java

@@ -43,7 +43,7 @@ public class ReactiveDiscoveryClientAdapter implements DiscoveryClient {
      * Create a new {@link ReactiveDiscoveryClientAdapter} that wraps the given
      * {@link ReactiveDiscoveryClient} as a blocking {@link DiscoveryClient}.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * ReactiveDiscoveryClient reactiveClient = new SimpleReactiveDiscoveryClient(properties);
      * DiscoveryClient adapter = new ReactiveDiscoveryClientAdapter(reactiveClient);
@@ -59,7 +59,7 @@ public ReactiveDiscoveryClientAdapter(ReactiveDiscoveryClient reactiveDiscoveryC
     /**
      * Delegates to the underlying {@link ReactiveDiscoveryClient#description()} method.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * String desc = adapter.description();
      * }</pre>
@@ -75,7 +75,7 @@ public String description() {
      * Returns a blocking list of {@link ServiceInstance} objects for the given service ID
      * by collecting results from the underlying {@link ReactiveDiscoveryClient}.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * List<ServiceInstance> instances = adapter.getInstances("test-service");
      * }</pre>
@@ -93,7 +93,7 @@ public List<ServiceInstance> getInstances(String serviceId) {
      * Returns a blocking list of service names by collecting results from the
      * underlying {@link ReactiveDiscoveryClient}.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * List<String> services = adapter.getServices();
      * }</pre>
@@ -110,7 +110,7 @@ public List<String> getServices() {
      * Delegates to the underlying {@link ReactiveDiscoveryClient#probe()} method to
      * verify the discovery client is operational.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * adapter.probe();
      * }</pre>
@@ -123,7 +123,7 @@ public void probe() {
     /**
      * Returns the order value from the underlying {@link ReactiveDiscoveryClient}.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * int order = adapter.getOrder();
      * }</pre>

microsphere-spring-cloud-commons/src/main/java/io/microsphere/spring/cloud/client/discovery/UnionDiscoveryClient.java

@@ -39,7 +39,7 @@
 /**
  * The {@link DiscoveryClient} implementation for a union of the given {@link DiscoveryClient}
  *
- * <p>Example Usage:
+ * <h3>Example Usage</h3>
  * <pre>{@code
  * // Register UnionDiscoveryClient as a Spring bean, then retrieve merged service instances
  * UnionDiscoveryClient unionDiscoveryClient = applicationContext.getBean(UnionDiscoveryClient.class);
@@ -60,7 +60,7 @@ public final class UnionDiscoveryClient implements DiscoveryClient, ApplicationC
     /**
      * Returns a human-readable description of this {@link DiscoveryClient}.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * String desc = unionDiscoveryClient.description();
      * }</pre>
@@ -76,7 +76,7 @@ public String description() {
      * Returns a merged list of {@link ServiceInstance} objects from all registered
      * {@link DiscoveryClient} instances for the given service ID.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * List<ServiceInstance> instances = unionDiscoveryClient.getInstances("test");
      * }</pre>
@@ -101,7 +101,7 @@ public List<ServiceInstance> getInstances(String serviceId) {
      * Returns a deduplicated list of service names from all registered {@link DiscoveryClient}
      * instances, preserving insertion order.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * List<String> services = unionDiscoveryClient.getServices();
      * }</pre>
@@ -126,7 +126,7 @@ public List<String> getServices() {
      * {@link CompositeDiscoveryClient} and this instance itself. The list is lazily initialized
      * from the {@link ApplicationContext} on first access and cached for subsequent calls.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * UnionDiscoveryClient unionClient = applicationContext.getBean(UnionDiscoveryClient.class);
      * List<DiscoveryClient> clients = unionClient.getDiscoveryClients();
@@ -158,7 +158,7 @@ public List<DiscoveryClient> getDiscoveryClients() {
      * Returns the order value of this client. This client uses {@code HIGHEST_PRECEDENCE}
      * to ensure it takes priority over other {@link DiscoveryClient} implementations.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * int order = unionDiscoveryClient.getOrder();
      * }</pre>
@@ -174,7 +174,7 @@ public int getOrder() {
      * Callback invoked after all singleton beans have been instantiated. Eagerly initializes
      * the internal list of {@link DiscoveryClient} instances.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * // Automatically called by the Spring container after singleton initialization
      * unionDiscoveryClient.afterSingletonsInstantiated();
@@ -188,7 +188,7 @@ public void afterSingletonsInstantiated() {
     /**
      * Clears the cached list of {@link DiscoveryClient} instances when this bean is destroyed.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * // Automatically called by the Spring container on shutdown
      * unionDiscoveryClient.destroy();
@@ -204,7 +204,7 @@ public void destroy() throws Exception {
     /**
      * Sets the {@link ApplicationContext} used to look up {@link DiscoveryClient} beans.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * // Automatically called by the Spring container
      * unionDiscoveryClient.setApplicationContext(applicationContext);

microsphere-spring-cloud-commons/src/main/java/io/microsphere/spring/cloud/client/discovery/autoconfigure/DiscoveryClientAutoConfiguration.java

@@ -76,7 +76,7 @@ public static class UnionConfiguration {
          * Creates a {@link UnionDiscoveryClient} bean that aggregates all {@link DiscoveryClient}
          * instances in the {@link org.springframework.context.ApplicationContext}.
          *
-         * <p>Example Usage:
+         * <h3>Example Usage</h3>
          * <pre>{@code
          * // Activated when microsphere.spring.cloud.client.discovery.mode=union
          * UnionDiscoveryClient client = applicationContext.getBean(UnionDiscoveryClient.class);

microsphere-spring-cloud-commons/src/main/java/io/microsphere/spring/cloud/client/discovery/autoconfigure/ReactiveDiscoveryClientAutoConfiguration.java

@@ -58,7 +58,7 @@ public static class BlockingConfiguration {
          * Creates a {@link ReactiveDiscoveryClientAdapter} bean that adapts a
          * {@link ReactiveDiscoveryClient} to the blocking {@link org.springframework.cloud.client.discovery.DiscoveryClient} interface.
          *
-         * <p>Example Usage:
+         * <h3>Example Usage</h3>
          * <pre>{@code
          * // Auto-configured when both reactive and blocking discovery are enabled
          * DiscoveryClient client = applicationContext.getBean(ReactiveDiscoveryClientAdapter.class);

microsphere-spring-cloud-commons/src/main/java/io/microsphere/spring/cloud/client/service/registry/InMemoryServiceRegistry.java

@@ -40,7 +40,7 @@ public class InMemoryServiceRegistry implements ServiceRegistry {
      * Registers the given {@link Registration} instance in the in-memory storage,
      * keyed by its instance ID.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * InMemoryServiceRegistry registry = new InMemoryServiceRegistry();
      * Registration registration = createRegistration();
@@ -58,7 +58,7 @@ public void register(Registration registration) {
     /**
      * Removes the given {@link Registration} instance from the in-memory storage.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * InMemoryServiceRegistry registry = new InMemoryServiceRegistry();
      * Registration registration = createRegistration();
@@ -77,7 +77,7 @@ public void deregister(Registration registration) {
     /**
      * Closes this registry by clearing all stored {@link Registration} instances.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * InMemoryServiceRegistry registry = new InMemoryServiceRegistry();
      * registry.register(registration);
@@ -93,7 +93,7 @@ public void close() {
      * Sets the status of the given {@link Registration} by storing it in
      * the registration's metadata under the {@code _status_} key.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * InMemoryServiceRegistry registry = new InMemoryServiceRegistry();
      * registry.register(registration);
@@ -114,7 +114,7 @@ public void setStatus(Registration registration, String status) {
     /**
      * Retrieves the status of the given {@link Registration} from its metadata.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * InMemoryServiceRegistry registry = new InMemoryServiceRegistry();
      * registry.register(registration);
@@ -138,7 +138,7 @@ public Object getStatus(Registration registration) {
      * Retrieves the metadata {@link Map} for the given {@link Registration}
      * from the in-memory storage.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * InMemoryServiceRegistry registry = new InMemoryServiceRegistry();
      * registry.register(registration);

microsphere-spring-cloud-commons/src/main/java/io/microsphere/spring/cloud/client/service/registry/MultipleAutoServiceRegistration.java

@@ -25,7 +25,7 @@ public class MultipleAutoServiceRegistration extends AbstractAutoServiceRegistra
      * {@link MultipleRegistration}, {@link ServiceRegistry}, and
      * {@link AutoServiceRegistrationProperties}.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * MultipleRegistration registration = new MultipleRegistration(registrations);
      * ServiceRegistry<MultipleRegistration> serviceRegistry = new InMemoryServiceRegistry();
@@ -50,7 +50,7 @@ public MultipleAutoServiceRegistration(MultipleRegistration multipleRegistration
      * Returns the configuration object for this auto service registration.
      * This implementation always returns {@code null}.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * MultipleAutoServiceRegistration autoReg = ...;
      * Object config = autoReg.getConfiguration(); // null
@@ -67,7 +67,7 @@ protected Object getConfiguration() {
      * Determines whether this auto service registration is enabled based on the
      * {@link AutoServiceRegistrationProperties}.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * MultipleAutoServiceRegistration autoReg = ...;
      * boolean enabled = autoReg.isEnabled();
@@ -83,7 +83,7 @@ protected boolean isEnabled() {
     /**
      * Returns the {@link MultipleRegistration} managed by this auto service registration.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * MultipleAutoServiceRegistration autoReg = ...;
      * MultipleRegistration registration = autoReg.getRegistration();
@@ -100,7 +100,7 @@ protected MultipleRegistration getRegistration() {
      * Returns the management {@link MultipleRegistration}, which is the same as
      * the primary registration in this implementation.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * MultipleAutoServiceRegistration autoReg = ...;
      * MultipleRegistration mgmtRegistration = autoReg.getManagementRegistration();

microsphere-spring-cloud-commons/src/main/java/io/microsphere/spring/cloud/client/service/registry/MultipleRegistration.java

@@ -34,7 +34,7 @@ public class MultipleRegistration implements Registration {
      * {@link Registration} instances. The last registration in the collection becomes
      * the default registration.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * DefaultRegistration registration = new DefaultRegistration();
      * registration.setServiceId("test-service");
@@ -59,7 +59,7 @@ public MultipleRegistration(Collection<Registration> registrations) {
     /**
      * Returns the instance ID from the default {@link Registration}.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
      * String instanceId = multipleRegistration.getInstanceId();
@@ -75,7 +75,7 @@ public String getInstanceId() {
     /**
      * Returns the service ID from the default {@link Registration}.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
      * String serviceId = multipleRegistration.getServiceId();
@@ -91,7 +91,7 @@ public String getServiceId() {
     /**
      * Returns the host from the default {@link Registration}.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
      * String host = multipleRegistration.getHost();
@@ -107,7 +107,7 @@ public String getHost() {
     /**
      * Returns the port from the default {@link Registration}.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
      * int port = multipleRegistration.getPort();
@@ -123,7 +123,7 @@ public int getPort() {
     /**
      * Returns whether the default {@link Registration} is secure.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
      * boolean secure = multipleRegistration.isSecure();
@@ -139,7 +139,7 @@ public boolean isSecure() {
     /**
      * Returns the {@link URI} from the default {@link Registration}.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
      * URI uri = multipleRegistration.getUri();
@@ -156,7 +156,7 @@ public URI getUri() {
      * Returns the aggregated {@link RegistrationMetaData} that synchronizes metadata
      * across all underlying {@link Registration} instances.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
      * Map<String, String> metadata = multipleRegistration.getMetadata();
@@ -173,7 +173,7 @@ public Map<String, String> getMetadata() {
      * Returns the default {@link Registration} instance, which is the last registration
      * provided during construction.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
      * Registration defaultReg = multipleRegistration.getDefaultRegistration();
@@ -189,7 +189,7 @@ public Registration getDefaultRegistration() {
      * Retrieves a specific {@link Registration} by its class type. If the specified
      * class is {@link Registration} itself, returns this {@link MultipleRegistration}.
      *
-     * <p>Example Usage:
+     * <h3>Example Usage</h3>
      * <pre>{@code
      * MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
      * DefaultRegistration specific = multipleRegistration.special(DefaultRegistration.class);