JDBC for Oracle - Herong's Tutorial Examples - v3.13, by Herong Yang
JDBC Driver Connection URL
This section describes the connection URL format and how to create connection objects with the DriverManager class.
If you want to use the DriverManager class to create connection objects, you need to know how to make a connection URL that provides access information to the Oracle server. The Oracle connection URL for the thin client-side driver ojdbc6.jar has the following format:
jdbc:oracle:thin:[user/password]@[host][:port]:SID jdbc:oracle:thin:[user/password]@//[host][:port]/SID user - The login user name defined in the Oracle server. password - The password for the login user. host - The host name where Oracle server is running. Default is 127.0.0.1 - the IP address of localhost. port - The port number where Oracle is listening for connection. Default is 1521. SID - System ID of the Oracle server database instance. SID is a required value. By default, Oracle Database 10g Express Edition creates one database instance called XE.
Here are some example connection URLs:
jdbc:oracle:thin:Herong/TopSecret@localhost:1521:XE jdbc:oracle:thin:Herong/TopSecret@:1521:XE jdbc:oracle:thin:Herong/TopSecret@//localhost:1521/XE jdbc:oracle:thin:Herong/TopSecret@//:1521/XE jdbc:oracle:thin:Herong/TopSecret@//localhost/XE jdbc:oracle:thin:Herong/TopSecret@///XE
I wrote the following program to validate some of the connection URLs listed above:
/* OracleConnectionUrl.java * Copyright (c) HerongYang.com. All Rights Reserved. */ import java.sql.*; public class OracleConnectionUrl { public static void main(String [] args) { Connection con = null; try { // Load the Oracle JDBC driver - not needed in JDK 1.8 or newer // Class.forName("oracle.jdbc.OracleDriver") ; // System.out.println("Oracle JDBC driver loaded ok."); con = DriverManager.getConnection( "jdbc:oracle:thin:Herong/TopSecret@localhost:1521:XE"); System.out.println("Connected with @localhost:1521:XE."); con.close(); con = DriverManager.getConnection( "jdbc:oracle:thin:Herong/TopSecret@:1521:XE"); System.out.println("Connected with @:1521:XE."); con.close(); con = DriverManager.getConnection( "jdbc:oracle:thin:Herong/TopSecret@//localhost:1521/XE"); System.out.println("Connected with @//localhost:1521/XE."); con.close(); con = DriverManager.getConnection( "jdbc:oracle:thin:Herong/TopSecret@//:1521/XE"); System.out.println("Connected with @//:1521/XE."); con.close(); con = DriverManager.getConnection( "jdbc:oracle:thin:Herong/TopSecret@//localhost/XE"); System.out.println("Connected with @//localhost/XE."); con.close(); con = DriverManager.getConnection( "jdbc:oracle:thin:Herong/TopSecret@///XE"); System.out.println("Connected with @///XE."); con.close(); con = DriverManager.getConnection( "jdbc:oracle:thin:Herong/TopSecret@//localhost:1521"); System.out.println("Connected with @//localhost:1521."); con.close(); } catch (Exception e) { e.printStackTrace(); } } }
Here is the output of the above program:
herong> javac OracleConnectionUrl.java herong> java -cp .;ojdbc11.jar OracleConnectionUrl Connected with @localhost:1521:XE. Connected with @:1521:XE. Connected with @//localhost:1521/XE. Connected with @//:1521/XE. Connected with @//localhost/XE. Connected with @///XE. Connected with @//localhost:1521.
As a comparison, when executing the same program with JDK 1.6, Oracle 10.2 and ojdbc14.jar, I got the following:
herong> Progra~1\java\jdk1.6.0_2\bin\java -cp .;ojdbc14.jar \ OracleConnectionUrl Connected with @localhost:1521:XE. Connected with @:1521:XE. Connected with @//localhost:1521/XE. Connected with @//:1521/XE. Connected with @//localhost/XE. Connected with @///XE. Exception: Listener refused the connection with the following error: ORA-12514, TNS:listener does not currently know of service requested in connect descriptor The Connection descriptor used by the client was: //localhost:1521
The last URL test failed, because SID was not specified. The Oracle HTTP listener could not connect the request to a database service, the SID.
Table of Contents
JDBC (Java Database Connectivity) Introduction
Oracle Express Edition Installation on Windows
JDBC Thin Client-Side Driver Installation
Loading JDBC Driver Class - ojdbc16.jar
Creating Connections with DataSource Class
DataSource Error - makeURL() Failed
Getting Driver and Server Information
"CREATE TABLE" - Creating New Tables
"INSERT INTO" - Inserting New Data Rows
Oracle - Reference Implementation of JdbcRowSet
Oracle - JBDC CallableStatement
Oracle CLOB (Character Large Object) - TEXT
Oracle BLOB (Binary Large Object) - BLOB