Upgrade JDBC driver to ojdbc17.jar and add modern driver support

- Upgrade all workflows from ojdbc11.jar 23.3 to ojdbc17.jar 23.26.1
- Add ojdbc17, ojdbc11, and ojdbc8 to JDBC driver search list in
  jdbc_connection.rb, matched to Java version requirements
- Update README with current JDBC driver names and download link

Ref: https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: yahonda

.github/workflows/jruby_head.yml

@@ -57,7 +57,7 @@ jobs:
         echo "/opt/oracle/instantclient_23_26" >> $GITHUB_PATH
     - name: Install JDBC Driver
       run: |
-        wget -q https://download.oracle.com/otn-pub/otn_software/jdbc/233/ojdbc11.jar -O ./lib/ojdbc11.jar
+        wget -q https://download.oracle.com/otn-pub/otn_software/jdbc/23261/ojdbc17.jar -O ./lib/ojdbc17.jar
     - name: Create database user
       run: |
         ./ci/setup_accounts.sh

.github/workflows/test.yml

@@ -62,7 +62,7 @@ jobs:
         echo "/opt/oracle/instantclient_23_26" >> $GITHUB_PATH
     - name: Install JDBC Driver
       run: |
-        wget -q https://download.oracle.com/otn-pub/otn_software/jdbc/233/ojdbc11.jar -O ./lib/ojdbc11.jar
+        wget -q https://download.oracle.com/otn-pub/otn_software/jdbc/23261/ojdbc17.jar -O ./lib/ojdbc17.jar
     - name: Create database user
       run: |
         ./ci/setup_accounts.sh

.github/workflows/test_11g.yml

@@ -67,19 +67,19 @@ jobs:
         echo "/opt/oracle/instantclient_21_15" >> $GITHUB_PATH
     - name: Install JDBC Driver
       run: |
-        wget -q https://download.oracle.com/otn-pub/otn_software/jdbc/233/ojdbc11.jar -O ./lib/ojdbc11.jar
+        wget -q https://download.oracle.com/otn-pub/otn_software/jdbc/23261/ojdbc17.jar -O ./lib/ojdbc17.jar
     - name: Configure ORA_TZFILE to match Oracle 11g server
       run: |
-        # Oracle 11g XE uses timezone file v14; Instant Client 21.15 embeds v35.
-        # This mismatch causes ORA-01805 when ruby-oci8 fetches DATE/TIMESTAMP
+        # Oracle 11g XE uses timezone file v14; Instant Client 21.15 embeds
+        # v35. This mismatch causes ORA-01805 when fetching DATE/TIMESTAMP
         # values. Copy the v14 files from the 11g container and point the
         # Instant Client at them via ORA_TZFILE.
-        ORACLE_CONTAINER=$(docker ps --filter "ancestor=gvenzl/oracle-xe:11" -q)
-        sudo mkdir -p /opt/oracle/instantclient_21_15/oracore/zoneinfo
+        ORACLE_CONTAINER="${{ job.services.oracle.id }}"
+        sudo mkdir -p "$ORACLE_HOME/oracore/zoneinfo"
         docker cp "$ORACLE_CONTAINER":/u01/app/oracle/product/11.2.0/xe/oracore/zoneinfo/timezlrg_14.dat /tmp/timezlrg_14.dat
         docker cp "$ORACLE_CONTAINER":/u01/app/oracle/product/11.2.0/xe/oracore/zoneinfo/timezone_14.dat /tmp/timezone_14.dat
-        sudo mv /tmp/timezlrg_14.dat /opt/oracle/instantclient_21_15/oracore/zoneinfo/
-        sudo mv /tmp/timezone_14.dat /opt/oracle/instantclient_21_15/oracore/zoneinfo/
+        sudo mv /tmp/timezlrg_14.dat "$ORACLE_HOME/oracore/zoneinfo/"
+        sudo mv /tmp/timezone_14.dat "$ORACLE_HOME/oracore/zoneinfo/"
         echo "ORA_TZFILE=timezlrg_14.dat" >> $GITHUB_ENV
     - name: Create database user
       run: |

.github/workflows/test_gemfiles.yml

@@ -84,7 +84,7 @@ jobs:
         echo "/opt/oracle/instantclient_23_26" >> $GITHUB_PATH
     - name: Install JDBC Driver
       run: |
-        wget -q https://download.oracle.com/otn-pub/otn_software/jdbc/233/ojdbc11.jar -O ./lib/ojdbc11.jar
+        wget -q https://download.oracle.com/otn-pub/otn_software/jdbc/23261/ojdbc17.jar -O ./lib/ojdbc17.jar
     - name: Create database user
       run: |
         ./ci/setup_accounts.sh

README.md

@@ -154,7 +154,7 @@ In addition install either ruby-oci8 (for MRI/YARV) or copy Oracle JDBC driver t
 If you are using MRI Ruby implementation then you need to install ruby-oci8 gem (version 2.1 or higher)
 as well as Oracle client, e.g. [Oracle Instant Client](http://www.oracle.com/technetwork/database/features/instant-client/index-097480.html).
 
-If you are using JRuby then you need to download latest [Oracle JDBC driver](http://www.oracle.com/technetwork/database/enterprise-edition/jdbc-112010-090769.html) - either ojdbc7.jar for Java 8 and 7, ojdbc6.jar for Java 6, 7, 8 or ojdbc5.jar for Java 5. You can refer [the support matrix](http://www.oracle.com/technetwork/database/enterprise-edition/jdbc-faq-090281.html#01_03) for details.
+If you are using JRuby then you need to download latest [Oracle JDBC driver](https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html) - ojdbc17.jar for Java 17+, ojdbc11.jar for Java 11+, or ojdbc8.jar for Java 8+.
 
 And copy this file to one of these locations. JDBC driver will be searched in this order:
 

lib/plsql/jdbc_connection.rb

@@ -2,21 +2,23 @@
   require "java"
   require "jruby"
 
-  # ojdbc6.jar or ojdbc5.jar file should be in JRUBY_HOME/lib or should be in ENV['PATH'] or load path
+  # Oracle JDBC driver jar should be in JRUBY_HOME/lib or should be in ENV['PATH'] or load path
 
   java_version = java.lang.System.getProperty("java.version")
-  ojdbc_jars = if java_version =~ /^1.5/
-    %w(ojdbc5.jar)
-  elsif java_version =~ /^1.6/
-    %w(ojdbc6.jar)
-  elsif java_version >= "1.7"
-    # Oracle 11g client ojdbc6.jar is also compatible with Java 1.7
-    # Oracle 12c client provides new ojdbc7.jar
-    %w(ojdbc7.jar ojdbc6.jar)
+  java_major = if java_version =~ /^1\.(\d+)/
+    $1.to_i
   else
-    []
+    java_version.to_i
   end
 
+  ojdbc_jars = []
+  ojdbc_jars << "ojdbc17.jar" if java_major >= 17
+  ojdbc_jars << "ojdbc11.jar" if java_major >= 11
+  ojdbc_jars << "ojdbc8.jar"  if java_major >= 8
+  ojdbc_jars << "ojdbc7.jar"  if java_major >= 7
+  ojdbc_jars << "ojdbc6.jar"  if java_major >= 6
+  ojdbc_jars << "ojdbc5.jar"  if java_major == 5
+
   if ENV_JAVA["java.class.path"] !~ Regexp.new(ojdbc_jars.join("|"))
     # On Unix environment variable should be PATH, on Windows it is sometimes Path
     env_path = (ENV["PATH"] || ENV["Path"] || "").split(File::PATH_SEPARATOR)