Update Compatible.java

Author: mercyblitz

microsphere-java-core/src/main/java/io/microsphere/util/Compatible.java

@@ -26,10 +26,56 @@
 import static java.util.Optional.ofNullable;
 
 /**
- * Compatible
+ * A utility class to conditionally execute logic based on version comparison.
  *
- * @author <a href="mailto:mercyblitz@gmail.com">Mercy</a>
- * @since 1.0.0
+ * <p>{@link Compatible} allows defining conditional logic that is executed only if the current version meets a specified
+ * condition relative to another version. It supports common version comparison operations such as equal to, greater than,
+ * less than, and their inclusive counterparts.</p>
+ *
+ * <h3>Example Usage</h3>
+ *
+ * <h4>Example 1: Basic Usage</h4>
+ * <pre>{@code
+ * Version currentVersion = Version.of("1.2.3");
+ * Compatible<Void, String> compatible = new Compatible<>(currentVersion, v -> "Matched Condition");
+ *
+ * // Execute logic only if current version is greater than "1.2.0"
+ * Optional<String> result = compatible.on(">", "1.2.0", v -> "Executed").call();
+ * System.out.println(result.orElse("Not Matched")); // Output: Executed
+ * }</pre>
+ *
+ * <h4>Example 2: Chaining Conditions</h4>
+ * <pre>{@code
+ * Version currentVersion = Version.of("2.0.0");
+ * Compatible<Void, String> base = new Compatible<>(currentVersion, null);
+ *
+ * // Apply multiple conditions in sequence
+ * Optional<String> result = base
+ *     .on("<", "1.9.0", v -> "Older")
+ *     .on("==", "2.0.0", v -> "Exact Match")
+ *     .on(">=", "2.0.0", v -> "At least 2.0.0")
+ *     .call();
+ *
+ * System.out.println(result.orElse("No condition matched")); // Output: Exact Match
+ * }</pre>
+ *
+ * <h4>Example 3: Using with Class-based Version</h4>
+ * <pre>{@code
+ * // Automatically fetches version from the manifest of the JAR containing MyComponent.class
+ * Compatible<MyComponent, Boolean> compatibilityCheck = Compatible.of(MyComponent.class);
+ *
+ * boolean isSupported = compatibilityCheck
+ *     .on(">=", "1.5.0", v -> true)
+ *     .on("<", "1.5.0", v -> false)
+ *     .get() != null;
+ *
+ * System.out.println("Feature supported: " + isSupported);
+ * }</pre>
+ *
+ * @param <T> the type of context object associated with this compatibility check (not used directly in logic)
+ * @param <R> the return type of the conditional function
+ * @see Version
+ * @see Version.Operator
  */
 public class Compatible<T, R> {