Merge branch 'main' into 1371_java11_refactor

Signed-off-by: jarebudev <[email protected]>

Author: jarebudev

.github/workflows/lint-pr.yml

@@ -18,6 +18,6 @@ jobs:
     name: Validate PR title
     runs-on: ubuntu-latest
     steps:
-      - uses: amannn/action-semantic-pull-request@04501d43b574e4c1d23c629ffe4dcec27acfdeff
+      - uses: amannn/action-semantic-pull-request@335288255954904a41ddda8947c8f2c844b8bfeb
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/pullrequest.yml

@@ -29,7 +29,7 @@ jobs:
             cache: maven
 
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@4ffa2364a07d4fa8656211f550f36d44e8148dae
+        uses: github/codeql-action/init@ed51cb5abd90d0e898e492d5e3f24423da71c2fb
         with:
           languages: java
 
@@ -55,4 +55,4 @@ jobs:
           verbose: true # optional (default = false)
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@4ffa2364a07d4fa8656211f550f36d44e8148dae
+        uses: github/codeql-action/analyze@ed51cb5abd90d0e898e492d5e3f24423da71c2fb

.github/workflows/release.yml

@@ -20,11 +20,10 @@ jobs:
 
     # Release-please creates a PR that tracks all changes
     steps:
-      - uses: google-github-actions/release-please-action@e4dc86ba9405554aeba3c6bb2d169500e7d3b4ee
+      - uses: googleapis/release-please-action@v4
         id: release
         with:
-          token: ${{secrets.GITHUB_TOKEN}}
-          target-branch: main
+          token: ${{secrets.RELEASE_PLEASE_ACTION_TOKEN}}
 
       # These steps are only run if this was a merged release-please PR
       - name: checkout

.github/workflows/static-code-scanning.yaml

@@ -33,12 +33,12 @@ jobs:
 
       # Initializes the CodeQL tools for scanning.
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@4ffa2364a07d4fa8656211f550f36d44e8148dae
+        uses: github/codeql-action/init@ed51cb5abd90d0e898e492d5e3f24423da71c2fb
         with:
           languages: java
 
       - name: Autobuild
-        uses: github/codeql-action/autobuild@4ffa2364a07d4fa8656211f550f36d44e8148dae
+        uses: github/codeql-action/autobuild@ed51cb5abd90d0e898e492d5e3f24423da71c2fb
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@4ffa2364a07d4fa8656211f550f36d44e8148dae
+        uses: github/codeql-action/analyze@ed51cb5abd90d0e898e492d5e3f24423da71c2fb

README.md

@@ -104,7 +104,12 @@ public void example(){
 
     // configure a provider
     OpenFeatureAPI api = OpenFeatureAPI.getInstance();
-    api.setProviderAndWait(new InMemoryProvider(myFlags));
+    try {
+        api.setProviderAndWait(new InMemoryProvider(myFlags));
+    } catch (Exception e) {
+        // handle initialization failure
+        e.printStackTrace();
+    }
 
     // create a client
     Client client = api.getClient();
@@ -149,7 +154,12 @@ To register a provider in a blocking manner to ensure it is ready before further
 
 ```java
     OpenFeatureAPI api = OpenFeatureAPI.getInstance();
-    api.setProviderAndWait(new MyProvider());
+    try {
+        api.setProviderAndWait(new MyProvider());
+    }  catch (Exception e) {
+        // handle initialization failure
+        e.printStackTrace();
+    }
 ```  
 
 #### Asynchronous    

release-please-config.json

@@ -1,5 +1,6 @@
 {
   "bootstrap-sha": "c701a6c4ebbe1170a25ca7636a31508b9628831c",
+  "signoff": "OpenFeature Bot <[email protected]>",
   "packages": {
     ".": {
       "package-name": "dev.openfeature.sdk",

src/main/java/dev/openfeature/sdk/OpenFeatureAPI.java

@@ -207,7 +207,13 @@ public void setProvider(String domain, FeatureProvider provider) {
     }
 
     /**
-     * Set the default provider and wait for initialization to finish.
+     * Sets the default provider and waits for its initialization to complete.
+     *
+     * <p>Note: If the provider fails during initialization, an {@link OpenFeatureError} will be thrown.
+     * It is recommended to wrap this call in a try-catch block to handle potential initialization failures gracefully.
+     *
+     * @param provider the {@link FeatureProvider} to set as the default.
+     * @throws OpenFeatureError if the provider fails during initialization.
      */
     public void setProviderAndWait(FeatureProvider provider) throws OpenFeatureError {
         try (AutoCloseableLock __ = lock.writeLockAutoCloseable()) {
@@ -224,8 +230,12 @@ public void setProviderAndWait(FeatureProvider provider) throws OpenFeatureError
     /**
      * Add a provider for a domain and wait for initialization to finish.
      *
+     * <p>Note: If the provider fails during initialization, an {@link OpenFeatureError} will be thrown.
+     * It is recommended to wrap this call in a try-catch block to handle potential initialization failures gracefully.
+     *
      * @param domain   The domain to bind the provider to.
      * @param provider The provider to set.
+     * @throws OpenFeatureError if the provider fails during initialization.
      */
     public void setProviderAndWait(String domain, FeatureProvider provider) throws OpenFeatureError {
         try (AutoCloseableLock __ = lock.writeLockAutoCloseable()) {