add sample for blocking async

Author: jaeopt

android-sdk/src/main/java/com/optimizely/ab/android/sdk/OptimizelyUserContextAndroid.java

@@ -266,21 +266,25 @@ public void decideAllAsync(@NonNull OptimizelyDecisionsCallback callback) {
     /**
      * Returns a decision result ({@link OptimizelyDecision}) for a given flag key and a user context, which contains all data required to deliver the flag.
      * <p>
-     * Note: Despite the "Async" name, this method performs blocking synchronous decision-making.
-     * For true asynchronous decision-making with callbacks, use the callback-based decideAsync() methods.
+     * Note: This method blocks the calling thread until the decision is complete.
+     * It should only be called from a background thread.
+     * For callback-based asynchronous decision-making, use decideAsync() methods.
      * </p>
      * @param key A flag key for which a decision will be made.
      * @param options A list of options for decision-making.
      * @return A decision result.
      */
     public OptimizelyDecision decideAsync(@NonNull String key,
-                                          @NonNull List<OptimizelyDecideOption> options) {
+                                                   @NonNull List<OptimizelyDecideOption> options) {
         return coreDecide(key, options);
     }
 
     /**
      * Returns a decision result ({@link OptimizelyDecision}) for a given flag key and a user context, which contains all data required to deliver the flag.
-     *
+     * <p>
+     * Note: This method blocks the calling thread until the decision is complete.
+     * It should only be called from a background thread.
+     * </p>
      * @param key A flag key for which a decision will be made.
      * @return A decision result.
      */
@@ -315,7 +319,10 @@ public Map<String, OptimizelyDecision> decideForKeysAsync(@NonNull List<String>
 
     /**
      * Returns a key-map of decision results ({@link OptimizelyDecision}) for all active flag keys.
-     *
+     * <p>
+     * Note: This method blocks the calling thread until decisions are complete.
+     * It should only be called from a background thread.
+     * </p>
      * @param options A list of options for decision-making.
      * @return All decision results mapped by flag keys.
      */
@@ -325,7 +332,10 @@ public Map<String, OptimizelyDecision> decideAllAsync(@NonNull List<OptimizelyDe
 
     /**
      * Returns a key-map of decision results ({@link OptimizelyDecision}) for all active flag keys.
-     *
+     * <p>
+     * Note: This method blocks the calling thread until decisions are complete.
+     * It should only be called from a background thread.
+     * </p>
      * @return A dictionary of all decision results, mapped by flag keys.
      */
     public Map<String, OptimizelyDecision> decideAllAsync() {

test-app/src/main/java/com/optimizely/ab/android/test_app/Samples/APISamplesInJava.java

@@ -30,6 +30,7 @@
 import com.optimizely.ab.android.event_handler.EventRescheduler;
 import com.optimizely.ab.android.sdk.OptimizelyClient;
 import com.optimizely.ab.android.sdk.OptimizelyManager;
+import com.optimizely.ab.android.sdk.OptimizelyUserContextAndroid;
 import com.optimizely.ab.android.sdk.cmab.CmabClientHelperAndroid;
 import com.optimizely.ab.android.sdk.cmab.DefaultCmabClient;
 import com.optimizely.ab.android.test_app.R;
@@ -123,7 +124,7 @@ static public void samplesForCmab(Context context) {
         Map<String, Object> attributes = new HashMap<>();
         attributes.put("country", "us");
         attributes.put("extra-1", 100);
-        OptimizelyUserContext user = optimizelyClient.createUserContext(userId, attributes);
+        OptimizelyUserContextAndroid user = optimizelyClient.createUserContext(userId, attributes);
 
         String flagKey = "cmab-flag";
 
@@ -141,7 +142,7 @@ static public void samplesForCmab(Context context) {
         }
         Log.d("Samples","=================================================================");
 
-        // decideAsync
+        // decideAsync with callback
 
         Log.d("Samples","=================================================================");
         Log.d("Samples","[CMAB] calling async decision for cmab...");
@@ -165,6 +166,31 @@ static public void samplesForCmab(Context context) {
             Thread.currentThread().interrupt();
         }
 
+        // decideAsync with blocking
+
+        Log.d("Samples","=================================================================");
+        Log.d("Samples","[CMAB] calling async blocking decision for cmab...");
+        Log.d("Samples","=================================================================");
+        final CountDownLatch latch_2 = new CountDownLatch(1);
+        Thread thread = new Thread(() -> {
+            OptimizelyDecision blockDecision = user.decideAsync(flagKey, options);
+            Log.d("Samples","=================================================================");
+            Log.d("Samples","[CMAB] async blocking decision for cmab: " + blockDecision.toString());
+            if (!blockDecision.getEnabled()) {
+                Log.e("Samples","[ERROR] " + flagKey + " is expected to be enabled for this user!");
+            }
+            Log.d("Samples","=================================================================");
+            latch_2.countDown();
+        });
+        thread.start();
+
+        try {
+            latch_2.await(60, TimeUnit.SECONDS);
+            Log.d("Samples", "[CMAB] Latch released. Async operation completed.");
+        } catch (InterruptedException e) {
+            e.printStackTrace();
+            Thread.currentThread().interrupt();
+        }
     }
 
     static public void samplesForCmabConfig(Context context) {