Справочник функций

Ваш аккаунт

Войти через: 
Забыли пароль?
Регистрация
Информацию о новых материалах можно получать и без регистрации:

Почтовая рассылка

Подписчиков: -1
Последний выпуск: 19.06.2015

Использование Java классов и объектов в Oracle8i

Автор: Стивен Ферстайн
(Oracle Magazine, no.3, 2000)

Эта статья является второй из серии, рассматривающей методику, связанную с использованием Java из окружения, написанного на PL/SQL. В предыдущей статье я описывал, как конструировать простые Java-классы для доступа к основным функциональным возможностям Java, загружать Java-классы в программы базы данных Oracle, управлять этими новыми объектами базы данных, и публиковать их для использования в PL/SQL. В этой статье я продолжу этот вводный курс, подробно исследуя "поддерживаемые черты" - пространство Java-имен в Oracle8i, проверка и экспорт элементов кода Java, хранимых в базе данных, возможность вывода на экран из Java-методов, и обработка исключений для Java-методов из PL/SQL.

Что в имени?

Oracle8i с виртуальной машиной Java (VM) хранит каждый Java-класс как объект схемы. Имя объекта выводится из полного квалифицированного имени класса (но не идентично ему), и включает имена всех содержащих пакетов. Например, полным квалифицированным именем класса OracleSimpleChecker является Oracle.sqlj.checker.OracleSimpleChecker

Однако, в базе данных Oracle полным квалифицированным именем Java-объекта схемы будет следующее: oracle/sqlj/checker/OracleSimpleChecker

Другими словами, при сохранении Java-класса в базе данных Oracle, точки заменяются слешами.

Имя объекта в базе данных Oracle, вне зависимости от того, является ли этот объект таблицей или классом, не может быть длиннее 30 символов. Java не имеет таких ограничений. Вы можете загрузить Java-класс с именем более 4000 символов в базу данных Oracle. Если имя элемента Java содержит более 30 символов, то программное обеспечение Oracle автоматически генерирует корректный (менее 31 символа) псевдоним, или "короткое имя" для элемента.

Но не беспокойтесь! Вам не придется даже ссылаться на псевдонимы, вместо этого вы можете продолжать использовать реальное имя элемента в вашем коде. Oracle автоматически устанавливает соответствие между этим длинным именем и псевдонимом (именем в схеме), когда это нужно. Для получения полного или длинного имени для заданного короткого имени можно использовать функцию DBMS_JAVA.LONGNAME. Следующий запрос (хранимый в скрипте longname.sql) выводит длинные имена для всех Java- классов, описанных в текущей (той, к которой присоединены) схеме базы данных, у которых не совпадают краткое и полное имена:

SELECT object_name shortname,
DBMS_JAVA.LONGNAME (object_name) longname
FROM USER_OBJECTS
WHERE object_type = 'JAVA CLASS'
AND object_name != DBMS_JAVA.LONGNAME (object_name);

(Этот запрос также содержится в файле myJava.pkg, в пакете myJava, использование которого показано ниже.) Предположим, вы объявили класс, с очень длинным именем, например:

public class
DropAnyObjectIdentifiedByTypeAndName {

Вы можете удостовериться в том, что Oracle создал собственное короткое имя, следующим образом:

SQL> exec myjava.showlongnames
Short Name | Long Name
___________________________ 
Short: /247421b0_DropAnyObjectIdentif
Long: DropAnyObjectIdentifiedByTypeAndName

Просмотр Java-элементов

После загрузки исходных кодов Java, классов и элементов ресурсов в базу данных, можно получить информацию об этих элементах из нескольких представлений словаря данных (см. таблицу).

Представления словаря данных, содержащие информацию о Java-объектах

Представления словаря данныхИнформация, содержащаяся в словаре
USER_OBJECTSОсновная информация об объектах, для типа JAVA SOURCE
ALL_OBJECTSJAVA CLASS и JAVA RESOURCE
DBA_OBJECTS 
USER_ERRORSЛюбые ошибки компиляции ваших объектов
ALL_ERRORS 
DBA_ERRORS 
USER_SOURCEИсходный код ваших источников Java, только в случае использования команды CREATE JAVA SOURCE для создания Java-объектов схемы

Вы можете писать запросы к этим представлениям, либо создавать программы, которые используют эту информацию различными способами. Листинг 1 содержит скрипт с запросом, показывающим все Java-связанные объекты в вашей схеме и результат выполнения этого запроса. Предложение WHERE отсекает те объекты, которые Oracle создал для управления Java-объектами. Файл myjava.pkg содержит пакетный вариант запроса, представленный в Листинге 1, который позволяет просматривать Java-объекты, используя следующий процедурный вызов:

SQL> exec myjava.showobjects

Следующая команда выводит список всех Java-элементов, имена которых начинаются на OE:

SQL> exec myjava.showobjects ('OE%')

Столбец object_name в представлении словаря данных user_objects содержит полные имена Java-объектов схемы, за исключением имен, которые длиннее 30 символов или содержат непереводимые символы из набора символов UNICODE. В этом случае в столбце object_name хранится короткое имя. Для преобразования коротких имен в полные можно использовать функцию longname из пакета утилит DBMS_JAVA (см следующий раздел).

Помните следующие характеристики Java-элементов схемы в базе данных:

  • При использовании команды loadjava для загрузки Java-элементов в базу данных, исходный код ваших Java-элементов не переносится, - в базу данных помещаются только такие файлы, как class, jar, zip, и java,.
  • При использовании команды CREATE JAVA , исходный код Java-элементов хранится в базе данных. Объекты типа JAVA SOURCE можно увидеть в представлении словаря данных USER_OBJECTS, а также в представлениях ALL_OBJECTS, DBA_OBJECTS для этого элемента. Для извлечения исходного кода, размещения его в структурах данных PL/SQL и отображения или изменения текста этого кода можно использовать процедуру DBMS_JAVA.EXPORT_SOURCE, как об этом сказано в следующем разделе.

Экспорт Java-ресурсов

Пакет Oracle DBMS_JAVA содержит процедуры для экспорта исходного кода, классов и ресурсов. Вообще говоря, эти процедуры можно использовать для экспорта Java-ресурсов в типы данных Oracle8i BLOB или CLOB.

Пример процедуры в Листинге 2 дает представление о том, каким образом можно экспортировать исходный код Java-объектов схемы. Можно использовать команду CREATE JAVA для создания исходных Java-объектов, как показано ниже:

CREATE OR REPLACE JAVA SOURCE NAMED "Hello"
AS
public class Hello {
public static String hello() {
return "Hello Oracle World";}
};
/
Если для функции пакета DBMS_OUTPUT установлена возможность вывода в текстовый буфер, то можно просмотреть исходный код, как показано ниже:
SQL> exec show_java_source ('Hello')
public class Hello {
public static String hello() {
return "Hello Oracle World";}
};

Класс нельзя экспортировать в CLOB, только в BLOB. Кроме того, внутреннее представление исходного кода использует формат UTF8, поэтому этот формат применяется также для хранения исходного кода в BLOB.

Предоставление возможности вывода данных для Java

Когда классы System.out и System.err выполняются внутри базы данных, они посылают свои выходные данные в текущий файл трассировки. Этот файл не слишком удобное хранилище, особенно если вам просто нужно проверить правильно ли работает ваш код. Пакет DBMS_JAVA содержит процедуру, которую можно вызывать, чтобы перенаправить выходные данные в текстовый буфер DBMS_OUTPUT, из которого данные автоматически выводятся на экран SQL*Plus. Вот синтаксис вызова этой процедуры:

PROCEDURE DBMS_JAVA.set_output (buffersize NUMBER);

А вот пример ее использования:

SET SERVEROUTPUT ON SIZE 1000000
CALL DBMS_JAVA.SET_OUTPUT (1000000);

Документация по взаимодействию между DBMS_JAVA и DBMS_OUTPUT очень скудная. С помощью тестирования я выявил следующие правила:

  • Минимальный (и заданный по умолчанию) размер буфера составляет всего лишь 2000 байт; максимальный - 1000000 байт. Можно указывать число, выходящее за эти пределы, при этом не будет возникать ошибка (за исключением действительно больших чисел); SQL*Plus будет просто игнорировать его.
  • Размер буфера, заданный командой SET SERVEROUTPUT, замещает размер, указанный в DBMS_JAVA.SET_OUTPUT. Другими словами, если вы укажете меньшее значение при вызове DBMS_JAVA, то оно будет проигнорировано SQL*Plus, и будет использоваться большее значение.
  • Если выходные данные в Java превышают размер буфера, вы не получите сообщение, которое появляется при использовании DBMS_OUTPUT, а именно:
ORU-10027: buffer overflow, limit of [] bytes

Но вместо этого выходные данные будут усечены до размера буфера, указанного в SQL*Plus по умолчанию, и выполнение кода продолжится.

Как и в случае с DBMS_OUTPUT, выходные данные, выводимые Java-вызовами, не будут отображены до тех пор, пока не закончится выполнение хранимой процедуры, через которую они вызываются.

Обработка исключений в Java

С одной стороны, архитектура обработки исключений в Java-очень похожа на обработку исключений в PL/SQL. В языке Java, вы возбуждаете (throw) исключение и затем перехватываете (catch) его. В языке PL/SQL, вы возбуждаете (raise) исключение и затем обрабатываете (handle) его.

С другой стороны, обработка исключений в Java гораздо более трудоемка. Java предлагает базовый класс, называемый Exception. Все исключения являются объектами, основанными на этом классе, или на классах, происходящих от (расширяющих) Exception. Вы можете передавать исключения как параметры и манипулировать ими точно также как объектами любого другого класса.

Когда при выполнении SQL-оператора из хранимого Java-метода возбуждается исключение, это исключение является объектом подкласса java.sql.SQLException. Этот класс содержит два метода, которые возвращают код сообщения об ошибке Oracle, - getErrorCode(), и само сообщение об ошибке - getMessage() .

Если хранимая процедура Java, вызываемая из SQL или PL/SQL, возбуждает исключение, которое не перехватывается виртуальной Java-машиной, то вызывающая программа получает исключение, возбужденное сообщением об ошибке Java. Таким образом, виртуальная Java-машина на сервере базы данных Oracle сообщает обо всех не перехваченных исключениях (включая исключения, не связанные с SQL).

Рассмотрим теперь различные способы обработки ошибок и результирующие выходные данные. Допустим, что вы создали класс, использующий JDBC, для удаления объектов базы данных (смотри Листинг 3; этот пример скопирован из документации Oracle). Эта строка перехватит и отобразит на экране любое SQL-исключение:

catch (SQLException e)
{System.err.println(e.getMessage());}

Вы можете встроить этот класс в процедуру PL/SQL следующим образом:

CREATE OR REPLACE PROCEDURE dropany (
tp IN VARCHAR2,
nm IN VARCHAR2
)
AS LANGUAGE JAVA NAME 'DropAny.object (
java.lang.String,
java.lang.String)';
/

Листинг 4 показывает два результата, один из которых получается при попытке удалить несуществующий объект. Результаты, представленные в файле, напоминают о том, что вывод из System.err.println не появится на экране до тех пор, пока это не будет разрешено явным образом, путем вызова DBMS_JAVA.SET_OUTPUT. В любом случае, однако, исключение не будет распространяться на вызывающий блок, поскольку оно перехватывается внутри Java. После второго вызова процедуры dropany, можно увидеть, что сообщение об ошибке, переданное из метода getMessage(), является ошибкой Oracle.

Если закомментировать строки try и catch в методе DropAny.obj, то результат выполнения будет совершенно другим, как показано в Листинге 5. Здесь требуется небольшое пояснение. Все что написано между

java.sql.SQLException: ORA-00942: table or view does not exist

и

-29532

представляет собой дамп стека ошибок, генерируемый Java, и направленный на стандартный вывод, вне зависимости от того, как обрабатываются ошибки в PL/SQL. Другими словами, даже если раздел исключений выглядит следующим образом:

EXCEPTION WHEN OTHERS THEN NULL;

все эти сообщения все равно будут выведены на экран. Обработка в другом блоке (если он есть) будет затем продолжена. Последние три строки отображаемого вывода генерируются вызовом DBMS_OUTPUT.PUT_LINE.

Заметим, что возникает не ошибка Oracle ORA-00942, а общая Java-ошибка ORA-29532. Это действительно проблема. Как обнаружить при перехвате ошибки, что именно является настоящей ошибкой? Похоже, настал черед Человека, Пишущего Утилиты (Write-a-Utility Man)!

Я обратил внимание, что сообщение об ошибке, возвращаемое функцией SQLERRM, имеет следующий вид:

ORA-29532: Java call ...:
java.sql.SQLException: ORA-NNNNN ...

Следовательно, можно проверять наличие слова java.sql.SQLException и затем использовать функцию SUBSTR. Листинг 6 содержит процедуру, созданную с целью компенсации неудобного формата сообщений об ошибках Java. Процедура возвращает код ошибки и сообщение для текущей ошибки. Блок кода в Листинге 7 демонстрирует, каким образом можно использовать эту процедуру (процедура использует пакет log81, созданный файлом log81.pkg, чтобы записать информацию об ошибке в журнал).

Хотя эта процедура хранит информацию об ошибках в журнальных таблицах базы данных, она по-прежнему возвращает клиентской сессии стек исключений Java. Например, при запуске скрипта в SQL*Plus, стек исключений Java будет отображаться на экране.

Легкость интеграции

Темы, охваченные в этой статье, рассматривают некоторые приемы и основные принципы, используемые при встраивании функциональных возможностей Java в существующее Oracle PL/SQL окружение. Хотя магазины, работающие с базами данных Oracle, вероятно, не будут в ближайшем будущем переводить оптовую торговлю на Java, многие из нас захотят использовать Java как можно скорее. Информация, приведенная в этой статье, должна помочь вам сделать это рационально и эффективно.

Листинг 1. Java-связанные объекты в схеме

Этот запрос показывает все Java-связанные объекты в вашей схеме :

COLUMN object_name FORMAT A30
SELECT object_name, object_type, status, timestamp
    FROM user_objects
    WHERE (object_name NOT LIKE 'SYS_%'
    AND object_name NOT LIKE 'CREATE$%'
    AND object_name NOT LIKE 'JAVA$%'
    AND object_name NOT LIKE 'LOADLOB%')
    AND object_type LIKE 'JAVA %'
ORDER BY object_type, object_name;

Вот результат выполнения этого запроса:

SQL> @showjava
OBJECT_NAME    OBJECT_TYPE    STATUS    TIMESTAMP
___________    ____________    _______    ____________
Hello        JAVA CLASS    VALID    1999-05-19:16:42:27
JFile2        JAVA CLASS    VALID    1999-05-26:17:07:11
JFile3        JAVA CLASS    VALID    1999-05-27:12:53:46
plsolutions/java/putLn    JAVA SOURCE    VALID    1999-05-19:16:30:29

Листинг 2. Процедура экспорта из пакета Oracle DBMS_JAVA

Процедура экспорта из пакета Oracle DBMS_JAVA позволяет извлекать

исходный код Java-объектов схемы.

/* showjava.sp */
CREATE OR REPLACE PROCEDURE show_java_source (
    name IN VARCHAR2,
    schema IN VARCHAR2 := NULL
    )
IS
    b CLOB;
    v VARCHAR2(2000) ;
    i INTEGER ;
BEGIN
      /* Поместить исходный код Java в CLOB. */
    DBMS_LOB.CREATETEMPORARY (b, FALSE);
    DBMS_JAVA.EXPORT_SOURCE (name, NVL (schema, USER), b);
    /* Прочитать CLOB в переменную типа VARCHAR2 и отобразить ее. */
     i := 1000;
    DBMS_LOB.READ (b, i, 1, v);
    pl (v); /* запустить pl.sp для создания этой процедуры */
END;
/

Листниг 3. Создание класса для удаления объектов из базы

Вы можете создать класс, использующий JDBC, для удаления объектов из базы данных Oracle.

/* dropany.java */
import java.sql.*;
import java.io.*;
import oracle.jdbc.driver.*;

public class DropAny {
    public static void object (String object_type, String object_name)
    throws SQLException {
    // Присоединение к базе данных Oracle с помощью драйвера JDBC 
    Connection conn = new OracleDriver().defaultConnection();
    // Построение SQL предложения 
    String sql = "DROP " + object_type + " " + object_name;
    try {
        Statement stmt = conn.createStatement();
        stmt.executeUpdate(sql);
        stmt.close();
    } catch (SQLException e) {System.err.println(e.getMessage());}
     }
}

Листинг 4. Попытка удаления несуществующего объекта

При попытке удаления несуществующего объекта, вы получите следующие результаты:

SQL> CONNECT scott/tiger
Connected.
SQL> SET SERVEROUTPUT ON
SQL> BEGIN dropany ('TABLE', 'blip'); END;
/
PL/SQL procedure successfully completed.

SQL> CALL DBMS_JAVA.SET_OUTPUT (1000000);

Call completed.
SQL> BEGIN dropany ('TABLE', 'blip'); END;
/
ORA-00942: table or view does not exist

Оставить комментарий

Комментарий:
можно использовать BB-коды
Максимальная длина комментария - 4000 символов.
 

Комментарии

1.
94K
28 сентября 2014 года
alex-nosov1980
0 / / 28.09.2014
Мне нравитсяМне не нравится
28 сентября 2014, 12:20:03
Добрый день!
Меня заинтересовало как вы реализуете выделение кода (в рамку и синем цветом)
Применяете какой то плагин или средствами CSS?
Хотел внедрить это на своем сайте.
Реклама на сайте | Обмен ссылками | Ссылки | Экспорт (RSS) | Контакты
Добавить статью | Добавить исходник | Добавить хостинг-провайдера | Добавить сайт в каталог