1.7 Доступ к хранимым функциям и процедурам

Доступ к хранимым процедурам и функциям выполняется с помощью интерфейса java.sql.CallableStatement и синтаксиса управляющих последовательностей SQL. Интерфейс CallableStatement расширяет интерфейс PreparedStatement, который, в свою очередь, расширяет интерфейс Statement. Интерфейс CallableStatement существует для того, чтобы предоставлять дополнительные методы, специально предназначенные для вызова хранимых процедур и функций и обработки выходных параметров.

Синтаксис управляющих последовательностей SQL для вызова хранимой процедуры из интерфейса JDBC имеет следующую общую форму:

{call proc_name(arg1,arg2,…)}

А вызов функции, выполняемой через интерфейс JDBC, имеет следующую общую форму:

{?=call func_name(arg1,arg2,…)}

Ссылку на объект CallableStatement можно получить непосредственно из интерфейса Connection, почти так же как ссылку на объект PreparedStatement. Хотя объекты PreparedStatement можно получить с помощью метода preparedStatement(), объекты CallableStatement можно получить с помощью метода ргерагеСаll(). Допустим, что существует хранимая процедура Oracle c именем delete_rows,предназначенная для удаления из некоторой таблицы тех записей, в которых одно из полей больше одного числа, но меньше другого (оба эти числа передаются через параметры). Код JDBC для выполнения операции вставки данных может иметь следующий вид:

int min=10; String max="20";

String querySql="{call delete_rows (?,?)}";// текст запроса

CallableStatement cstmt = conn.prepareCall(query,Sql); // создание запроса

cstmt.setInt(1,min); // установка значения первого аргумента процедуры

cstmt.setString(2,max); // установка значения второго аргумента процедуры

cstmt.executeUpdate(); // выполнение запроса

conn.commit(); // фиксация изменений

cstmt.close(); // освобождение ресурсов запроса

В действительности эту процедуру можно было бы выполнить с помощью интерфейса PreparedStatement, а не интерфейса CallableStatement, поскольку в этом случае нужны только те методы класса CallableStatement, которые унаследованы от класса PreparedStatement. Однако рекомендуется использовать интерфейс CallableStatement для выполнения процедур, что позволяет свести к минимуму влияние изменений в базовой процедуре. Интерфейс CallableStatement необходимо использовать для доступа к выходным параметрам, которые рассматриваются в следующем разделе.

1.8 Применение выходных параметров

Нередко в процедурах и функциях Oracle полезным оказывается применение выходных параметров. Интерфейс CallableStatement, входящий в состав интерфейса JDBC, предоставляет методы выборки этих значений. Допустим, что операция удаления данных из таблицы delete_rows, рассмотренная в предыдущем разделе, написана в виде пакетной функции и что это функция возвращает количество удаленных строк. Для примера допустим далее, что значение второй входной параметр является также и выходным параметром этой функции (пусть, например, там передается начальное количество строк таблицы, из которой производится удаление). В приведенном ниже фрагменте кода показан вызов этой функции и выборка выходных параметров:

int min=10, max=20;

String querySql="{?= call delete_rows (?,?)}";// текст запроса

CallableStatement cstmt = conn.prepareCall(query,Sql); // создание запроса

cstmt.registerOutParameter(1,java.sql.Types.INTEGER);

// регистрация типа возвращаемого функцией значения

cstmt.setInt(2,min); // установка значения первого аргумента

cstmt.setInt(3,max); // установка значения второго аргумента

cstmt.registerOutParameter(3,java.sql.Types.INTEGER);

// регистрация типа значения, которое возвращается через второй аргумент функции

cstmt.executeUpdate(); // выполнение запроса

int del=cstmt.getInt(1); // получение возвращаемого функцией значения

int rows=cstmt.getInt(3); // получение значения, возвращаемого во втором аргументе функции

conn.commit(); // фиксация изменений

cstmt.close(); // освобождение ресурсов запроса

Что же касается интерфейса JDBC, то функция Oracle является процедурой, имеющей, по меньшей мере, один выходной параметр. Не существует специальной обработки возвращаемого функцией значения. Аргументами метода registerOutParameter() являются индекс параметра с отсчетом от единицы и тип данных SQL этого параметра. Значения выходных параметров выбираются после выполнения с помощью соответствующего метода get() (getStringQ, getF1oat() и др.). Используемый метод get() должен быть совместим с типом данных, передаваемым методу registerOutParameterO. Методы get() класса CallableStatement аналогичны методам get() класса ResultSet, которые воспринимают индекс столбца в качестве своего аргумента. Кроме того, подобно соответствующему методу класса ResultSet, метод wasNulI() позволяет определить, был ли пустым последний считанный выходной параметр.

Входные и выходные параметры INOUT должны быть заданы и зарегистрированы. Тип данных SQL, передаваемый методу registerOutParameter(), должен соответствовать используемому методу set(). Параметр INOUT может быть задан и зарегистрирован так, как, например, в следующем примере:

cstmt.setInt(3,max);

cstmt.registerOutParameter(3,java.sql.Types.INTEGER);