postgres/src/interfaces/jdbc/example/basic.java

package example;

import java.io.*;
import java.sql.*;
import java.text.*;

/**
 *
 * $Id: basic.java,v 1.6 2001/01/31 08:26:01 peter Exp $
 *
 * This example tests the basic components of the JDBC driver, and shows
 * how even the simplest of queries can be implemented.
 *
 * To use this example, you need a database to be in existence. This example
 * will create a table called basic.
 *
 * Note: This will only work with post 7.0 drivers.
 *
 */

public class basic
{
  Connection db;	// The connection to the database
  Statement  st;	// Our statement to run queries with

  public basic(String args[]) throws ClassNotFoundException, FileNotFoundException, IOException, SQLException
  {
    String url = args[0];
    String usr = args[1];
    String pwd = args[2];

    // Load the driver
    Class.forName("org.postgresql.Driver");

    // Connect to database
    System.out.println("Connecting to Database URL = " + url);
    db = DriverManager.getConnection(url, usr, pwd);

    System.out.println("Connected...Now creating a statement");
    st = db.createStatement();

    // Clean up the database (in case we failed earlier) then initialise
    cleanup();

    // Now run tests using JDBC methods
    doexample();

    // Clean up the database
    cleanup();

    // Finally close the database
    System.out.println("Now closing the connection");
    st.close();
    db.close();

    //throw postgresql.Driver.notImplemented();
  }

  /**
   * This drops the table (if it existed). No errors are reported.
   */
  public void cleanup()
  {
    try {
      st.executeUpdate("drop table basic");
    } catch(Exception ex) {
      // We ignore any errors here
    }
  }

  /**
   * This performs the example
   */
  public void doexample() throws SQLException
  {
    System.out.println("\nRunning tests:");

    // First we need a table to store data in
    st.executeUpdate("create table basic (a int2, b int2)");

    // Now insert some data, using the Statement
    st.executeUpdate("insert into basic values (1,1)");
    st.executeUpdate("insert into basic values (2,1)");
    st.executeUpdate("insert into basic values (3,1)");

    // This shows how to get the oid of a just inserted row
    // updated for 7.1
    st.executeUpdate("insert into basic values (4,1)");
    int insertedOID = ((org.postgresql.jdbc2.Statement)st).getInsertedOID();
    System.out.println("Inserted row with oid "+insertedOID);

    // Now change the value of b from 1 to 8
    st.executeUpdate("update basic set b=8");
    System.out.println("Updated "+st.getUpdateCount()+" rows");

    // Now delete 2 rows
    st.executeUpdate("delete from basic where a<3");
    System.out.println("deleted "+st.getUpdateCount()+" rows");

    // For large inserts, a PreparedStatement is more efficient, because it
    // supports the idea of precompiling the SQL statement, and to store
    // directly, a Java object into any column. PostgreSQL doesnt support
    // precompiling, but does support setting a column to the value of a
    // Java object (like Date, String, etc).
    //
    // Also, this is the only way of writing dates in a datestyle independent
    // manner. (DateStyles are PostgreSQL's way of handling different methods
    // of representing dates in the Date data type.)
    PreparedStatement ps = db.prepareStatement("insert into basic values (?,?)");
    for(int i=2;i<5;i++) {
      ps.setInt(1,4);		// "column a" = 5
      ps.setInt(2,i);		// "column b" = i
      ps.executeUpdate();	// executeUpdate because insert returns no data
    }
    ps.close();			// Always close when we are done with it

    // Finally perform a query on the table
    System.out.println("performing a query");
    ResultSet rs = st.executeQuery("select a, b from basic");
    if(rs!=null) {
      // Now we run through the result set, printing out the result.
      // Note, we must call .next() before attempting to read any results
      while(rs.next()) {
	int a = rs.getInt("a");	// This shows how to get the value by name
	int b = rs.getInt(2);	// This shows how to get the value by column
	System.out.println("  a="+a+" b="+b);
      }
      rs.close();	// again, you must close the result when done
    }

    // Now run the query again, showing a more efficient way of getting the
    // result if you don't know what column number a value is in
    System.out.println("performing another query");
    rs = st.executeQuery("select * from basic where b>1");
    if(rs!=null) {
      // First find out the column numbers.
      //
      // It's best to do this here, as calling the methods with the column
      // numbers actually performs this call each time they are called. This
      // really speeds things up on large queries.
      //
      int col_a = rs.findColumn("a");
      int col_b = rs.findColumn("b");

      // Now we run through the result set, printing out the result.
      // Again, we must call .next() before attempting to read any results
      while(rs.next()) {
	int a = rs.getInt(col_a); // This shows how to get the value by name
	int b = rs.getInt(col_b); // This shows how to get the value by column
	System.out.println("  a="+a+" b="+b);
      }
      rs.close();	// again, you must close the result when done
    }

    // Now test maxrows by setting it to 3 rows
    st.setMaxRows(3);
    System.out.println("performing a query limited to "+st.getMaxRows());
    rs = st.executeQuery("select a, b from basic");
    while(rs.next()) {
      int a = rs.getInt("a");	// This shows how to get the value by name
      int b = rs.getInt(2);	// This shows how to get the value by column
      System.out.println("  a="+a+" b="+b);
    }
    rs.close();	// again, you must close the result when done

    // The last thing to do is to drop the table. This is done in the
    // cleanup() method.
  }

  /**
   * Display some instructions on how to run the example
   */
  public static void instructions()
  {
    System.out.println("\nThis example tests the basic components of the JDBC driver, demonstrating\nhow to build simple queries in java.\n");
    System.out.println("Useage:\n java example.basic jdbc:postgresql:database user password [debug]\n\nThe debug field can be anything. It's presence will enable DriverManager's\ndebug trace. Unless you want to see screens of items, don't put anything in\nhere.");
    System.exit(1);
  }

  /**
   * This little lot starts the test
   */
  public static void main(String args[])
  {
    System.out.println("PostgreSQL basic test v6.3 rev 1\n");

    if(args.length<3)
      instructions();

    // This line outputs debug information to stderr. To enable this, simply
    // add an extra parameter to the command line
    if(args.length>3)
      DriverManager.setLogStream(System.err);

    // Now run the tests
    try {
      basic test = new basic(args);
    } catch(Exception ex) {
      System.err.println("Exception caught.\n"+ex);
      ex.printStackTrace();
    }
  }
}