Update project to Java 21, Gradle 8.5, and modernize CI/CD

Summary of changes:
- Upgraded Java target to version 21.
- Updated Gradle wrapper to version 8.5 for Java 21 compatibility.
- Refactored SerpApi.java to remove incorrect inheritance from Exception.
- Updated GitHub Actions workflow to use Java 21 and gradle-setup-java action.
- Switched environment variable for API keys to SERPAPI_KEY in tests and CI.
- Reorganized tests: moved engine examples to src/test/java/serpapi/example/.
- Fixed failures in LocationApiTest and GoogleReverseImageTest.

Author: jvmvik

.github/workflows/gradle.yml

@@ -15,14 +15,17 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v2
-    - name: Set up JDK 1.8
-      uses: actions/setup-java@v1
+    - uses: actions/checkout@v4
+    - name: Set up JDK 21
+      uses: actions/setup-java@v4
       with:
-        java-version: 1.8
+        java-version: '21'
+        distribution: 'temurin'
     - name: Grant execute permission for gradlew
       run: chmod +x gradlew
+    - name: Build with Gradle
+      uses: gradle/actions/setup-gradle@v3
     - name: test
       run: ./gradlew test
       env:
-        API_KEY: ${{secrets.API_KEY}}
+        SERPAPI_KEY: ${{secrets.SERPAPI_KEY}}

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2018-2024 SerpApi
+Copyright (c) 2018-2025 SerpApi
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -123,7 +123,7 @@ it prints the first 3 location matching Austin (Texas, Texas, Rochester)
 Let's run a search to get a search_id.
 ```java
 Map<String, String> auth = new HashMap<>();
-auth.put("api_key", System.getenv("API_KEY"));
+auth.put("api_key", System.getenv("SERPAPI_KEY"));
 SerpApi serpapi = new SerpApi(auth);
 
 Map<String, String> parameter = new HashMap<>();

README.md.erb

@@ -135,7 +135,7 @@ it prints the first 3 location matching Austin (Texas, Texas, Rochester)
 Let's run a search to get a search_id.
 ```java
 Map<String, String> auth = new HashMap<>();
-auth.put("api_key", System.getenv("API_KEY"));
+auth.put("api_key", System.getenv("SERPAPI_KEY"));
 SerpApi serpapi = new SerpApi(auth);
 
 Map<String, String> parameter = new HashMap<>();

build.gradle

@@ -9,12 +9,12 @@ plugins {
 
 // Package default
 archivesBaseName = 'serpapi'
-version = '1.0.0'
+version = '1.1.0'
 group = 'com.github.serpapi'
 
 // java version 
-sourceCompatibility = 1.8
-targetCompatibility = 1.8
+sourceCompatibility = 21
+targetCompatibility = 21
 
 // Load repositories
 repositories {
@@ -65,6 +65,6 @@ publishing {
 }
 
 wrapper {
-    gradleVersion = "7.3.3"
+    gradleVersion = "8.5"
     distributionType = Wrapper.DistributionType.ALL
 }

demo/Makefile

@@ -1,9 +1,9 @@
 .PHONY: build
 
-ifndef API_KEY
-$(error "API_KEY must be defined")
+ifndef SERPAPI_KEY
+$(error "SERPAPI_KEY must be defined")
 else
-$(info "found API_KEY variable")
+$(info "found SERPAPI_KEY variable")
 endif
 
 all: init clean build run

demo/build.gradle

@@ -14,6 +14,9 @@ plugins {
     id 'application'
 }
 
+sourceCompatibility = 21
+targetCompatibility = 21
+
 repositories {
     mavenCentral()
 

gradle/wrapper/gradle-wrapper.properties

@@ -1,5 +1,5 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-7.3.3-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-all.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists

src/main/java/serpapi/SerpApi.java

@@ -11,7 +11,7 @@
 /**
  * SerpApi wraps HTTP interaction with the service serpapi.com
  */
-public class SerpApi extends Exception {
+public class SerpApi {
 
  /** 
   * client parameters