DriverManager.getConnection() and Connection URL

<< Microsoft JDBC Driver for SQL Server - sqljdbc.jar

<< JDBC Tutorials - Herong's Tutorial Notes

This section describes how to use DriverManager.getConnection() and connection URL for the Microsoft JDBC driver.

Once the JDBC driver class is loaded, you are ready to connect to a SQL Server by using the DriverManager.getConnection(connection_url) method. The connection URL, connection_url, is a string with the following syntax:

jdbc:sqlserver://server_name;user=login;password=****

The tutorial program below shows you a good example of using getConnection() and connection URL:

/**
 * ConnectionTest2.java
 * Copyright (c) 2007 by Dr. Herong Yang. All rights reserved.
 */
import java.sql.*;
public class ConnectionTest2 {
  public static void main(String [] args) {
    Connection con = null;
    try {

// Load Microsoft JDBC Driver 1.0
      Class.forName(
        "com.microsoft.sqlserver.jdbc.SQLServerDriver");

// Obtaining a connection to SQL Server
      con = DriverManager.getConnection(
          "jdbc:sqlserver://localhost;"
        + "user=sa;password=HerongYang");

    } catch (java.lang.ClassNotFoundException e) {
      System.err.println("ClassNotFoundException: "
        +e.getMessage());
    } catch (SQLException e) {
      System.err.println("SQLException: "
        +e.getMessage());
    }
  }
}

If you run this program, you may get a surprising error like this:

C:\>\progra~1\java\jdk1.6.0_02\bin\javac ConnectionTest2.java

C:\>\progra~1\java\jdk1.6.0_02\bin\java -cp .;\local\lib\sqljdbc.jar
   ConnectionTest2

SQLException: The TCP/IP connection to the host  has failed. 
java.net.ConnectException: Connection refused: connect

The error is probably caused by the port number where the SQL Server is listening for the client connection. If port number is different than the default number, you must specify the port number in the connection url as shown in the next tutorial.

Sections in This Chapter

Installing Microsoft JDBC Driver for SQL Server

Loading Driver Class with Class.forName()

DriverManager.getConnection() and Connection URL

Specifying Port Number in Connection URL

Closing the Database Connection - con.close()

Specifying Database Name in Connection URL

Incorrect Database Name in Connection URL

Creating Connections with DataSource Class