Java SQL basics 1 : Processing SQL statements with JDBC

In general, to process any SQL statement with JDBC, you follow these steps:

• Establishing a connection.
• Create a statement.
• Execute the query.
• Process the ResultSet object.
• Close the connection.

  public static void viewTable(Connection con, String dbName) throws SQLException {
    Statement stmt = null;
    String query = "select COF_NAME, SUP_ID, PRICE, SALES, TOTAL from " + dbName + ".COFFEES";
    try {
      stmt = con.createStatement();
      ResultSet rs = stmt.executeQuery(query);
      while (rs.next()) {
        String coffeeName = rs.getString("COF_NAME");
        int supplierID = rs.getInt("SUP_ID");
        float price = rs.getFloat("PRICE");
        int sales = rs.getInt("SALES");
        int total = rs.getInt("TOTAL");
        System.out.println(coffeeName + "\t" + supplierID + "\t" + price + "\t" + sales + "\t" + total);
      }
    } catch (SQLException e ) {
      JDBCTutorialUtilities.printSQLException(e);
    } finally {
      stmt.close();
    }


Lets break each step and understand the code



Establishing Connections

First, establish a connection with the data source you want to use.
A data source can be a DBMS, a legacy file system, or some other source of data with a corresponding JDBC driver. This connection is represented by a Connection object.

Creating Statements

A Statement is an interface that represents a SQL statement.
You execute Statement objects, and they generate ResultSet objects, which is a table of data representing a database result set.You need a Connection object to create a Statement object.

For example, CoffeesTables.viewTable creates a Statement object with the following code:

      stmt = con.createStatement();

There are three different kinds of statements:

• Statement: Used to implement simple SQL statements with no parameters.
• PreparedStatement: (Extends Statement.) Used for precompiling SQL statements that might contain input parameters. 
• CallableStatement: (Extends PreparedStatement.) Used to execute stored procedures that may contain both input and output parameters. 

Executing Queries

To execute a query, call an execute method from Statement such as the following:

execute: Returns true if the first object that the query returns is a ResultSet object.
Use this method if the query could return one or more ResultSet objects.
Retrieve the ResultSet objects returned from the query by repeatedly calling Statement.getResutSet.
executeQuery: Returns one ResultSet object.
executeUpdate: Returns an integer representing the number of rows affected by the SQL statement. Use this method if you are using INSERT, DELETE, or UPDATE SQL statements.

For example, CoffeeTables.viewTable executed a Statement object with the following code:

      ResultSet rs = stmt.executeQuery(query);

Processing ResultSet Objects

You access the data in a ResultSet object through a cursor.
Note that this cursor is not a database cursor.
This cursor is a pointer that points to one row of data in the ResultSet object.
Initially, the cursor is positioned before the first row.
You call various methods defined in the ResultSet object to move the cursor.

For example, CoffeesTables.viewTable repeatedly calls the method ResultSet.next to move the cursor forward by one row.
Every time it calls next, the method outputs the data in the row where the cursor is currently positioned:

    try {
      stmt = con.createStatement();
      ResultSet rs = stmt.executeQuery(query);
      while (rs.next()) {
        String coffeeName = rs.getString("COF_NAME");
        int supplierID = rs.getInt("SUP_ID");
        float price = rs.getFloat("PRICE");
        int sales = rs.getInt("SALES");
        int total = rs.getInt("TOTAL");
        System.out.println(coffeeName + "\t" + supplierID + "\t" + price + "\t" + sales + "\t" + total);
      }

Closing Connections

When you are finished using a Statement, call the method Statement.close to immediately release the resources it is using.
When you call this method, its ResultSet objects are closed.

For example, the method CoffeesTables.viewTable ensures that the Statement object is closed at the end of the method,
regardless of any SQLException objects thrown, by wrapping it in a finally block:


    } finally {
      stmt.close();
    }
JDBC throws an SQLException when it encounters an error during an interaction with a data source.