//***************************************************************************
// (c) Copyright IBM Corp. 2007 All rights reserved.
//
// The following sample of source code ("Sample") is owned by International
// Business Machines Corporation or one of its subsidiaries ("IBM") and is
// copyrighted and licensed, not sold. You may use, copy, modify, and
// distribute the Sample in any form without payment to IBM, for the purpose of
// assisting you in the development of your applications.
//
// The Sample code is provided to you on an "AS IS" basis, without warranty of
// any kind. IBM HEREBY EXPRESSLY DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR
// IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
// MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do
// not allow for the exclusion or limitation of implied warranties, so the above
// limitations or exclusions may not apply to you. IBM shall not be liable for
// any damages you suffer as a result of using, copying, modifying or
// distributing the Sample, even if IBM has been advised of the possibility of
// such damages.
//***************************************************************************
//
// SOURCE FILE NAME: UDFcli.java
//
// SAMPLE: Call the UDFs in UDFsrv.java
//
// Parameter Style used in this program is "DB2GENERAL".
//
// Steps to run the sample with command line window:
//
// I) If you have a compatible make/nmake program on your system,
// do the following:
// 1. Compile the server source file UDFsrv (this will also compile
// the Utility file, erase the existing library/class files and
// copy the newly compiled class files, UDFsqlsv.class and
// Person.class from the current directory to the
// $(DB2PATH)\function directory):
// nmake/make UDFsrv
// 2. Compile the client source file UDFcli (this will also call
// the script 'udfcat' to catalog the UDFs):
// nmake/make UDFcli
// 3. Run the client UDFcli:
// java UDFcli
//
// II) If you don't have a compatible make/nmake program on your system,
// do the following:
// 1. Compile the utility file and the server source file with:
// javac Util.java
// javac UDFsrv.java
// 2. Erase the existing library/class files (if exists),
// UDFsrv.class and Person.class from the following path,
// $(DB2PATH)\function.
// 3. copy the class files, UDFsrv.class and Person.class from
// the current directory to the $(DB2PATH)\function.
// 4. Register/catalog the UDFs with:
// udfcat
// 5. Compile UDFcli with:
// javac UDFcli.java
// 6. Run UDFcli with:
// java UDFcli
//
// SQL Statements USED:
// SELECT
//
//
// Output will vary depending on the JDBC driver connectivity used.
//***************************************************************************
//
// For more information on the sample programs, see the README file.
//
// For information on developing Java applications see the Developing Java Applications book.
//
// For information on using SQL statements, see the SQL Reference.
//
// For the latest information on programming, compiling, and running DB2
// applications, visit the DB2 Information Center at
// http://publib.boulder.ibm.com/infocenter/db2luw/v9r7/index.jsp
//**************************************************************************/
import java.sql.*; // JDBC classes
class UDFcli
{
public static void main(String argv[])
{
try
{
Db db = new Db(argv);
System.out.println();
System.out.println("THIS SAMPLE SHOWS HOW TO WORK WITH UDFs.");
// connect database
db.connect();
demoExternalScratchpadScalarUDF(db.con);
demoExternalScalarUDFReturningErr(db.con);
demoExternalTableUDF(db.con);
}
catch (Exception e)
{
JdbcException jdbcExc = new JdbcException(e);
jdbcExc.handle();
}
} // main
static void demoExternalScratchpadScalarUDF(Connection con)
{
System.out.println();
System.out.println(
"----------------------------------------------------------\n" +
"USE THE SQL STATEMENTS:\n" +
" SELECT\n" +
"TO WORK WITH SCRATCHPAD SCALAR UDF.");
try
{
Statement stmt = con.createStatement();
// use SCRATCHPAD scalar UDF
System.out.println();
System.out.println(
" Use the SCRATCHPAD scalar UDF:\n" +
" SELECT scratchpadScUDF(), name, job\n" +
" FROM staff\n" +
" WHERE name LIKE 'S%'");
ResultSet rs = stmt.executeQuery(
"SELECT scratchpadScUDF(), name, job " +
" FROM staff " +
" WHERE name LIKE 'S%' ");
System.out.println(" COUNTER NAME JOB\n" +
" ------- ---------- -------");
int counter;
String name;
String job;
while (rs.next())
{
counter = rs.getInt(1);
name = rs.getString(2);
job = rs.getString(3);
System.out.println(" " + Data.format(counter, 7) +
" " + Data.format(name, 10) +
" " + Data.format(job, 7));
}
rs.close();
// close statement
stmt.close();
}
catch (Exception e)
{
JdbcException jdbcExc = new JdbcException(e, con);
jdbcExc.handle();
}
} // demoExternalScratchpadScalarUDF
static void demoExternalScalarUDFReturningErr(Connection con)
{
System.out.println();
System.out.println(
"----------------------------------------------------------\n" +
"USE THE SQL STATEMENTS:\n" +
" SELECT\n" +
"TO WORK WITH SCALAR UDF THAT RETURNS ERROR.");
try
{
Statement stmt = con.createStatement();
// use scalar UDF
System.out.println();
System.out.println(
" Use the scalar UDF that returns error:\n" +
" SELECT name, job, scUDFReturningErr(salary, 0.00)\n"+
" FROM staff\n" +
" WHERE name LIKE 'S%'");
ResultSet rs = stmt.executeQuery(
"SELECT name, job, scUDFReturningErr(salary, 0.00)\n" +
" FROM staff " +
" WHERE name LIKE 'S%'");
System.out.println(" NAME JOB COMM\n" +
" ------- ---------- --------");
String name;
String job;
double comm;
while (rs.next())
{
name = rs.getString(1);
job = rs.getString(2);
comm = rs.getDouble(3);
System.out.println(" " + Data.format(name, 7) +
" " + Data.format(job, 10) +
" " + Data.format(comm, 7, 2));
}
rs.close();
// close statement
stmt.close();
}
catch (SQLException e)
{
if (e.getSQLState().equals("38999"))
{
System.out.println();
System.out.println("--------- Expected Error ---------\n");
}
JdbcException jdbcExc = new JdbcException(e, con);
jdbcExc.handle();
}
catch (Exception e)
{
JdbcException jdbcExc = new JdbcException(e, con);
jdbcExc.handle();
}
} // demoExternalscalarUDFReturningErr
static void demoExternalTableUDF(Connection con)
{
System.out.println();
System.out.println(
"----------------------------------------------------------\n" +
"USE THE SQL STATEMENTS:\n" +
" SELECT\n" +
"TO WORK WITH TABLE UDF.");
try
{
Statement stmt = con.createStatement();
// use table UDF
System.out.println();
System.out.println(
" Use the table UDF:\n" +
" SELECT udfTb.name, udfTb.job, udfTb.salary\n" +
" FROM TABLE(TableUDF(1.5)) AS udfTb");
ResultSet rs = stmt.executeQuery(
"SELECT udfTb.name, udfTb.job, udfTb.salary " +
" FROM TABLE(TableUDF(1.5)) AS udfTb ");
System.out.println(" NAME JOB SALARY\n" +
" ------- ---------- --------");
String name;
String job;
double newSalary;
while (rs.next())
{
name = rs.getString(1);
job = rs.getString(2);
newSalary = rs.getDouble(3);
System.out.println(" " + Data.format(name, 7) +
" " + Data.format(job, 10) +
" " + Data.format(newSalary, 7, 2));
}
rs.close();
// close statement
stmt.close();
}
catch (Exception e)
{
JdbcException jdbcExc = new JdbcException(e, con);
jdbcExc.handle();
}
} // demoExternalTableUDF
} // UDFcli