Merge branch 'main' into chore/remove-unecessary-versions

Author: aepfli

.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

@@ -13,23 +13,23 @@ jobs:
             build:
                 - java: 17
                   profile: codequality
-                - java: 8
-                  profile: java8
+                - java: 11
+                  profile: java11
     name: with Java ${{ matrix.build.java }}
     runs-on: ${{ matrix.os}}
     steps:
       - name: Check out the code
         uses: actions/checkout@85e6279cec87321a52edac9c87bce653a07cf6c2
 
-      - name: Set up JDK 8
+      - name: Set up JDK 11
         uses: actions/setup-java@f4f1212c880fdec8162ea9a6493f4495191887b4
         with:
             java-version: ${{ matrix.build.java }}
             distribution: 'temurin'
             cache: maven
 
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@f843d94177a3bba7c0d0366e9bb9ff7de65547a9
+        uses: github/codeql-action/init@5eb3ed6614230b1931d5c08df9e096e4ba524f21
         with:
           languages: java
 
@@ -55,4 +55,4 @@ jobs:
           verbose: true # optional (default = false)
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@f843d94177a3bba7c0d0366e9bb9ff7de65547a9
+        uses: github/codeql-action/analyze@5eb3ed6614230b1931d5c08df9e096e4ba524f21

.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@f843d94177a3bba7c0d0366e9bb9ff7de65547a9
+        uses: github/codeql-action/init@5eb3ed6614230b1931d5c08df9e096e4ba524f21
         with:
           languages: java
 
       - name: Autobuild
-        uses: github/codeql-action/autobuild@f843d94177a3bba7c0d0366e9bb9ff7de65547a9
+        uses: github/codeql-action/autobuild@5eb3ed6614230b1931d5c08df9e096e4ba524f21
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@f843d94177a3bba7c0d0366e9bb9ff7de65547a9
+        uses: github/codeql-action/analyze@5eb3ed6614230b1931d5c08df9e096e4ba524f21

README.md

@@ -46,7 +46,7 @@
 
 ### Requirements
 
-- Java 8+ (compiler target is 1.8)
+- Java 11+ (compiler target is 11)
 
 Note that this library is intended to be used in server-side contexts and has not been evaluated for use on mobile devices.
 
@@ -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    

pom.xml

@@ -10,15 +10,15 @@
     <properties>
         <toolchain.jdk.version>[17,)</toolchain.jdk.version>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-        <maven.compiler.source>1.8</maven.compiler.source>
+        <maven.compiler.source>11</maven.compiler.source>
         <maven.compiler.target>${maven.compiler.source}</maven.compiler.target>
         <org.mockito.version>5.17.0</org.mockito.version>
         <!-- exclusion expression for e2e tests -->
         <testExclusions>**/e2e/*.java</testExclusions>
         <module-name>${project.groupId}.${project.artifactId}</module-name>
         <skip.tests>false</skip.tests>
         <!-- this will throw an error if we use wrong apis -->
-        <maven.compiler.release>8</maven.compiler.release>
+        <maven.compiler.release>11</maven.compiler.release>
     </properties>
 
     <name>OpenFeature Java SDK</name>
@@ -636,14 +636,14 @@
                 </plugins>
             </build>
         </profile>
-        <!-- profile for running tests under java 8 (used mostly in CI) -->
-        <!-- selected automatically by JDK activeation (see https://maven.apache.org/guides/introduction/introduction-to-profiles.html#implicit-profile-activation) -->
+        <!-- profile for running tests under java 11 (used mostly in CI) -->
+        <!-- selected automatically by JDK activation (see https://maven.apache.org/guides/introduction/introduction-to-profiles.html#implicit-profile-activation) -->
         <profile>
-            <id>java8</id>
+            <id>java11</id>
             <!-- with the next block we can define a set of sdks which still support java 8, if any of the sdks is not supporting java 8 anymore -->
             <!--<modules><module></module></modules>-->
             <properties>
-                <toolchain.jdk.version>(1.8,9)</toolchain.jdk.version>
+                <toolchain.jdk.version>[11,)</toolchain.jdk.version>
                 <skip.tests>true</skip.tests>
             </properties>
 

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()) {