Skip to content

Updated sample to include one-way TLS URL and updated the comments #469

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
nsundara wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Updated sample to include one-way TLS URL and updated the comments #469

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
d154b64
Clarify connection URL usage in ADBQuickStart.java
nsundara Feb 7, 2026
a5bec57
Refine comments and set DB_PASSWORD in ADBQuickStart
nsundara Feb 7, 2026
6320129
Update JDBC connection sample documentation
nsundara Feb 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 18 additions & 6 deletions java/jdbc/ConnectionSamples/ADBQuickStart.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

/*
DESCRIPTION
The code sample demonstrates establishing a connection to Autonomous Database (ATP/ADW) using
The code sample demonstrates establishing a connection to Oracle Autonomous Database using
Oracle JDBC driver and Universal Connection Pool (UCP). It does the following.

(a) Set the connection factory class name to
Expand All @@ -17,8 +17,11 @@ Oracle JDBC driver and Universal Connection Pool (UCP). It does the following.
Step 1: Enter the Database details DB_URL and DB_USER.
You will need to enter the DB_PASSWORD of your Autonomous Database through console
while running the sample.
Step 2: Download the latest Oracle JDBC driver(ojdbc8.jar) and UCP (ucp.jar)
Step 2: Download the latest Oracle JDBC driver(ojdbc17.jar) and UCP (ucp17.jar) from Oracle 26ai release.
along with oraclepki.jar, osdt_core.jar and osdt_cert.jar and add to your classpath.
https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html
-- For 26ai and 23ai clients: only oraclepki.jar is required in the classpath.
-- Older versions, 21c or 19c: oraclepki.jar, osdt_core.jar, and osdt_cert.jar are required in the classpath.
Refer to https://www.oracle.com/database/technologies/maven-central-guide.html
Step 3: Compile and Run the sample.

Expand All @@ -34,6 +37,7 @@ online transaction processing operations. The Star Schema Benchmark (SSB) sample

MODIFIED (MM/DD/YY)
nbsundar 11/09/2020 - Creation
nbsundar 2/6/2026 - Update
*/
package com.oracle.jdbctest;

Expand All @@ -53,14 +57,22 @@ online transaction processing operations. The Star Schema Benchmark (SSB) sample
public class ADBQuickStart {

public static void main(String args[]) throws Exception {
// Make sure to have Oracle JDBC driver 18c or above
// to pass TNS_ADMIN as part of a connection URL.
// TNS_ADMIN - Should be the path where the client credentials zip (wallet_dbname.zip) file is downloaded.
// Case 1: Use the below URL when Mutual Authentication is enabled and Oracle Wallets are required.
// Make sure to have Oracle JDBC driver 18c or above to pass TNS_ADMIN as part of a connection URL.
// TNS_ADMIN - Should be the path where the client credentials zip (wallet_dbname.zip) file is downloaded
// and the required Oracle SSO Wallets are available.
// dbname_medium - It is the TNS alias present in tnsnames.ora.
final String DB_URL="jdbc:oracle:thin:@dbname_medium?TNS_ADMIN=/Users/test/wallet_dbname/";

// Case 2: Use below URL when One-way Authentication is enabled and Oracle Wallets are not required.
// Copy the TLS URL from the OCI console by navigating to your Autonomous AI Database Details page
// and clicking on Database Connection. Under TLS Authentication, select TLS to copy the connection string for the database.
// The connection string looks like the one below.
// final String DB_URL="jdbc:oracle:thin:@(description=(retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1521)(host=adb.us-phoenix-1.oraclecloud.com))(connect_data(service_name=testservice_jdbctestdb_high.adb.oraclecloud.com))(security=(ssl_server_dn_match=yes)))";

// Update the Database Username and Password to point to your Autonomous Database
final String DB_USER = "admin";
String DB_PASSWORD = null ;
String DB_PASSWORD = "changepassword" ;
final String CONN_FACTORY_CLASS_NAME="oracle.jdbc.pool.OracleDataSource";

// For security purposes, you must enter the password through the console
Expand Down