Серверный JavaScript 1.4. Руководство по использованию

       

Индивидуальные Соединения с Базой Данных


Как только Вы создали пул соединений, клиентская страница может получить доступ к индивидуальному соединению из пула. Если Вы используете объект database, соединение в данном объекте является неявным; то есть Вы используете методы объекта database для доступа к соединению. Если, однако, Вы используете объекты DbPool, соединение инкапсулируется в объекте Connection, который Вы получаете через вызов метода объекта DbPool. Например, в следующем пуле:

project.eng = new DbPool ("ORACLE", "myserver", "ENG", "pwd1", "", 5);

Вы можете получить соединение из пула с помощью такого вызова метода:

myconn = project.eng.connection ("My Connection", 60);

Оба параметра метода являются необязательными. Первый это имя соединения (используется при отладке); второй это целое число, обозначающее таймаут в секундах. В этом примере, если пул имеет доступное соединение или если оно становится доступным в течение 60 секунд, это соединение присваивается переменной myconn. Если соединение не становится доступным в течение указанного периода, этот метод возвращается без соединения. Дополнительно об ожидании получения соединения из пула см. раздел . О том, что делать, если соединение не получено, см. .

Если Вы закончили использование соединения, возвратите его в пул путём вызова метода release объекта Connection. (Если Вы используете объект database, Вам не нужно самостоятельно освобождать соединение). Прежде чем вызвать метод release, закройте все открытые курсоры, хранимые процедуры и результирующие наборы. Если Вы вызываете метод release, система ожидает, когда всё закроется, и возвращает затем соединение в пул базы данных. После этого соединение доступно следующему пользователю. Об использовании курсоров см. . О хранимых процедурах и результирующих наборах см. .

После получения соединения (через объект database или объект Connection), Вы можете работать с БД. В таблице резюмированы методы объектов database и connection для работы с единственным соединением. Объект database имеет и другие методы для обслуживания пула соединений, рассмотренные в разделе


МетодОписание


cursor


Создаёт курсор БД для специфицированного оператора SQL SELECT.




SQLTable


Отображает результаты выполнения запроса. Создаёт таблицу HTML для результата выполнения оператора SQL SELECT.


execute


Выполняет специфицированный оператор SQL. Используется для операторов SQL, отличных от запросов/queries.


connected


Возвращает true, если пул БД (и, следовательно, данное соединение) соединён с БД.


release


(Только для Connection) Освобождает соединение обратно в пул.


beginTransaction


Начинает транзакцию SQL.


commitTransaction


Подтверждает текущую транзакцию SQL.


rollbackTransaction


Выполняет откат текущей транзакции SQL.


storedProc


Создаёт объект хранимой процедуры и запускает специфицированную хранимую процедуру БД.


majorErrorCode


Важнейший код ошибки, возвращаемый сервером БД или ODBC.


majorErrorMessage


Сообщение о важнейшей ошибке, возвращаемое сервером БД или ODBC.


minorErrorCode


Второй по значению код ошибки, возвращаемый библиотекой производителя.


minorErrorMessage


Второе по значению сообщение о важнейшей ошибке, возвращаемое библиотекой производителя.

Содержание раздела