Introduction to JDBC. JDBC: Java Database Connectivity. Why Access a Database with Java? Compilation. Six Steps. Packages to Import

Transcription

1 Introduction to JDBC JDBC: Java Database Connectivity JDBC is used for accessing databases from Java applications Information is transferred from relations to objects and vice-versa databases optimized for searching/indexing objects optimized for engineering/flexibility Compilation When executing an SQL statement via JDBC, it is not checked for errors until it is run (Not checked during compilation) Why Access a Database with Java? There are queries that can not be computed in SQL: Given a table Bus(Source, Destination) find all pairs of places that it is possible to travel between (paths of any length) Java allows for a convenient user interface to the database Load the driver Six Steps Establish the Connection Create a Statement object Execute a query Process the result Close the connection Packages to Import In order to connect to the Oracle database from java, import the following packages: java.sql.*; javax.sql.* (usually enough) (for advanced features, such as scrollable result sets)

2 Application JDBC Architecture Driver Manager Driver The application creates a driver instance and registers it with the DriverManager. The DriverManager connects a driver to the DB The DriverManager keeps track of registered driver instances and their connections to DBs. The Driver t alks t o a part icular dat abase t hrough the connection Connecting 1. Initializing a driver: new oracle.jdbc.driver.oracledriver() 2. Registering it with the DriverManager: DriverManager.registerDriver( ) 3. Getting a connection: Note: Application Driver Manager Driver DriverManager.getConnection(URL) Stages 1+2 may be combined with Class. f orname( oracle. j dbc. driver. OracleDriver"); In Stage 3, the Manager tries all drivers and assigns a connection to the first driver that succeeds. Connecting to the Database String path = "jdbc:oracle:thin:"; String host = "sol4"; String port = "1521"; String db = "stud"; String login = gidi"; String password = password ; String url = path + login + "/" + password + "@" + host +":" + port + ":" + db; Class.forName("oracle.jdbc.driver.OracleDriver"); Connection con = DriverManager.getConnection(url); Query methods 1. Statement createstatement() returns a new Statement object 2. PreparedStatement preparestatement(string returns a new PreparedStatement object sql) Both are used to send SQL commands to the DB Both are created by the connection prepared because it already includes the query string Statements Statements are used for queries that are only issued once. A statement can activate: 1. executequery(string query): for queries t hat don t change t he DB (select ) 2. executeupdate(string query): for queries which affect the DB (create, delete, drop, etc.) executequery String querystr = "SELECT * FROM Sailors " + "WHERE Name = 'joe smith'"; Statement stmt = con.createstatement(); ResultSet rs = stmt.executequery(querystr); No semicolon(;)!!! The executequery method returns a ResultSet object representing the query result.

3 executeupdate String deletestr = DELETE FROM Sailors " + "WHERE sid = 15"; Statement stmt = con.createstatement(); int delnum = stmt.executeupdate(deletestr); No semicolon(;)!!! executeupdate returns the number of rows modified. PreparedStatement motivation Suppose we would like to run the query SELECT * FROM Emp wher e name=moshe ; But we would like to run this for all employees (separately), not only moshe Could we create a variable instead of moshe which would get a different name every time??.. Prepared Statements Prepared Statements are used for queries that are executed many times with possibly different contents. A PreparedStatement object includes the query and is prepared for execution. Question marks can be inserted as variables. -setstring(i, value) -setint(i, value) The i-th question mark is set to the given value. Querying with PreparedStatement String querystr = "SELECT * FROM Sailors " + "WHERE Name =? and Rating <? ; con.preparestatement(querystr); pstmt.setstring(1, Joe ); pstmt.setint(2, 8); Value to insert 1 st question mark ResultSet rs = pstmt.executequery(); Affecting the DB with PreparedStatement String deletestr = DELETE FROM Boats " + "WHERE Name =? and Color =? ; con.preparestatement(deletestr); pstmt.setstring(1, Fluffy ); pstmt.setstring(2, "red"); int delnum = pstmt.executeupdate(); Statements vs. PreparedStatements: Be Careful! Are these the same? What do they do? String val = Joe ; con.preparestatement( select * from Sailors where sname=? ); pstmt.setstring(1, val); ResultSet rs = pstmt.executequery(); String val = Joe ; Statement stmt = con.createstatement( ); ResultSet rs = stmt.executequery( select * from Sailors where sname= + val);

4 Statements vs. PreparedStatements: Be Careful! Will this always work? Statement stmt = con.createstatement( ); ResultSet rs = stmt.executequery( select * from R where A = + val + ); The moral: When getting input from the user, always use a PreparedStatement Statements vs. PreparedStatements: Be Careful! Will this work? con.preparestatement( select * from? ); pstmt.setstring(1, "Sailors"); No! will attempt to insert sailors, and result in: Select * from sailors We can put? only instead of values Statement createstatement() Statement Connection Prepared Statement setstring(int num,string val) preparestatement (String Q) Connection ExecuteQuery(String Q) ResultSet ExecuteUpdate(String Q) Prepared Statement int ExecuteQuery() ResultSet ExecuteUpdate() int ResultSet A ResultSet is an object which contains the result of a query- a t able. Only one ResultSet per Statement can be open at once(!). A ResultSet maintains a cursor pointing to its current row of data. The 'next' method moves the cursor to the next row As of JDBC 2.0, scrollable ResultSets are available, which also include previous, first, last, et c.. ResultSet cont. Any methods on the resultset will occur on the current row. The cursor is positioned before the first row upon creation. Statement stmt=con.createstatement(); ResultSet rs = stmt.executequery ("SELECT * FROM Table1"); while (rs.next()) { //something ResultSet methods Getting the value in some column (for the current row): String s = rs.getstring( column1"); getstring(int columnnum); getstring(string columnname); getint(int columnnum); getint(string columnname); Et c To check if null was returned, you have to use wasnull() on the ResultSet after getting the value. The driver maps SQL types (varchar, number, ) t o the appropriate Java method (getstring, getint )

5 Mapping Java Types to SQL Types Java method SQL type Example revisited Statement stmt = con.createstatement(); ResultSet rs = stmt.executequery("select a, b, c FROM Table1"); // retrieve and print the values for the current row while (rs.next()) { int i = rs.getint("a"); String s = rs.getstring("b"); float f = rs.getfloat("c"); System.out.println("ROW = " + i + " " + s + " " + f); Advanced ResultSets 1. TYPE_FORWARD_ONLY: The default, simple RS. 2. TYPE_SCROLL_INSENSITIVE: Scrollable RS, does not modify when the DB is modified 3. TYPE_SCROLL_SENSITIVE: Scrollable RS, if its values are changed in the DB, they will also change in the RS. In addition, a ResultSet may be either: 1. CONCUR_READ_ONLY: the programmer cannot change the ResultSet (default) 2. CONCUR_UPDATABLE: the programmer can change the ResultSet Creating advanced ResultSets For Statement: Statement stmt = con.createstatement(resultset.type_scroll_sensitive, ResultSet.CONCUR_UPDATABLE); ResultSet rs = stmt.executequery( "SELECT * from emp"); For PreparedStatement: PreparedStatement pstmt= con.preparestatement("select * FROM Emp where Eid=?, ResultSet.TYPE_SCROLL_SENSITIVE, ResultSet.CONCUR_UPDATABLE); pstmt.setint(1, " "); ResultSet rs = stmt.executequery(); ResultSetMetaData An object created by the ResultSet which holds information about its columns ResultSetMetaData rsmd = rs.getmetadata(); int numcols = rsmd.getcolumncount(); for (int i = 1 ; i <= numcols; i++) { if (i > 1) System.out.print(","); System.out.print(rsmd.getColumnLabel(i)); Printing Query Output: Result Set (2) while (rs.next()) { for (int i = 1 ; i <= numcols; i++) { if (i > 1) System.out.print(","); System.out.print(rs.getString(i)); System.out.println("");

6 Cleaning Up After Yourself Remember to close the Connections, Statements, PreparedStatements and ResultSets con.close(); stmt.close(); pstmt.close(); rs.close(); Highly recommended Recommended Optional (Will otherwise be closed by its calling statement) Dealing With Exceptions An exception may be chained: catch (SQLException e) { while (e!= null) { //human readable message about the exception System.out.println(e.getMessage()); //String describing the reason of the exception System.out.println(e.getSQLState()); //driver- dependant code for the exception System.out.println(e.getErrorCode()); e = e.getnextexception(); What will this output? St r ing t able1= cr eat e t able t able1(col1 int eger, col2 int eger ) ; Statement st=con.createstatement(); int rescreate=st.executeupdate(table1); PreparedStatement ps1 = con.pr epar est at ement ( inser t into Table1 values(?,?) ); for(int i=0;i<10;i++){ ps1.setint(1,i); ps1.setint(2,i*i); ps1.executeupdate(); Statement st2=con.createstatement(); ResultSet rs=execut equery( select col2 f rom Table1 ); while(rs.next()){ System.out.println(rs.getInt(1)); Timeout You can use Stmnt.setQueryTimeOut(int secs) to set a timeout for the driver to wait for a statement to be completed If the operation is not completed in the given time, an SQLException is thrown Transactions Transactions in JDBC Transaction = 2 or more statements which must all succeed (or all fail) together If one fails, the system must reverse all previous actions Also can t leave DB in inconsist ent st at e half way through a transaction COMMIT = complete transaction ROLLBACK = abort

7 Example Suppose we want to transfer money from bank account 13 to account 72: con.preparestatement( update BankAccount set amount = amount +? where accountid =? ); pstmt.setint(1,- 100); pstmt.setint(2, 13); pstmt.executeupdate(); pstmt.setint(1, 100); pstmt.setint(2, 72); pstmt.executeupdate(); What happens if this update fails? Transaction Management The connection has a state called AutoCommit mode if AutoCommit is true, then every statement is automatically committed if AutoCommit is false, then every statement is added to an ongoing transaction Default: true AutoCommit con.setautocommit(boolean val) If you set AutoCommit to false, you must explicitly commit or rollback the transaction using Connection.commit() and Connection.rollback() Fixed Example con.setautocommit(false); try { con.preparestatement( update BankAccount set amount = amount +? where accountid =? ); pstmt.setint(1,- 100); pstmt.setint(2, 13); pstmt.executeupdate(); pstmt.setint(1, 100); pstmt.setint(2, 72); pstmt.executeupdate(); con.commit(); catch (Exception e) { con.rollback(); Useful link regarding JDBC: j2se/ 1.3/ docs/ guide/ jdbc/ getstart/ GettingStartedTOC.fm.html

8 This document was created with Win2PDF available at The unregistered version of Win2PDF is for evaluation or non-commercial use only.