Add Failsafe.with(Policy[]) for backwards binary compatibility

Author: jhalterman

CHANGELOG.md

@@ -1,3 +1,9 @@
+# 2.4.3
+
+### Bug Fixes
+
+- Fixed #289 - Binary imcompatibility with code that was compiled against previous Failsafe versions.
+
 # 2.4.2
 
 ### Improvements

src/main/java/net/jodah/failsafe/Failsafe.java

@@ -18,6 +18,7 @@
 import net.jodah.failsafe.internal.util.Assert;
 
 import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.Collections;
 import java.util.List;
 
@@ -60,6 +61,38 @@ public static <R, P extends Policy<R>> FailsafeExecutor<R> with(P outerPolicy, P
     return new FailsafeExecutor<>(policyList);
   }
 
+  /**
+   * Creates and returns a new {@link FailsafeExecutor} instance that will handle failures according to the given {@code
+   * policies}. The {@code policies} are composed around an execution and will handle execution results in reverse, with
+   * the last policy being applied first. For example, consider:
+   * <p>
+   * <pre>
+   *   Failsafe.with(fallback, retryPolicy, circuitBreaker).get(supplier);
+   * </pre>
+   * </p>
+   * This results in the following internal composition when executing the {@code supplier} and handling its result:
+   * <p>
+   * <pre>
+   *   Fallback(RetryPolicy(CircuitBreaker(Supplier)))
+   * </pre>
+   * </p>
+   * This means the {@code CircuitBreaker} is first to evaluate the {@code Supplier}'s result, then the {@code
+   * RetryPolicy}, then the {@code Fallback}. Each policy makes its own determination as to whether the result
+   * represents a failure. This allows different policies to be used for handling different types of failures.
+   *
+   * @param <R> result type
+   * @param <P> policy type
+   * @throws NullPointerException if {@code policies} is null
+   * @throws IllegalArgumentException if {@code policies} is empty
+   * @deprecated Use {@link #with(Policy, Policy[])} instead
+   */
+  @Deprecated
+  public static <R, P extends Policy<R>> FailsafeExecutor<R> with(P[] policies) {
+    Assert.notNull(policies, "policies");
+    Assert.isTrue(policies.length > 0, "At least one policy must be supplied");
+    return new FailsafeExecutor<>(Arrays.asList(policies));
+  }
+
   /**
    * Creates and returns a new {@link FailsafeExecutor} instance that will handle failures according to the given {@code
    * policies}. The {@code policies} are composed around an execution and will handle execution results in reverse, with