[Содержание] [Предыдущая] [Следующая] [Индекс]

Stproc

Представляет запрос к сохраненой в базе данных процедуре.

Объект server-side
Реализовано в Netscape Server 3.0

Создание

Методом storedProc объекта database или объекта Connection. Вы не вызываете конструктор Stproc.

Описание

Когда работа с объектом Stproc закончена, используйте метод close, чтобы закрыть его и освободить память, которую он использует. Если Вы выпускаете подключение, которое имеет открытую сохраненную процедуру, двигатель времени выполнения ждет, пока сохраненная процедура не будет закрыта перед фактическим освобождением подключения.

Если Вы явно не закрываете сохраненную процедуру методом close, двигатель времени выполнения JavaScript на сервере автоматически пробует закрыть все открытые сохраненные процедуры, когда связанный объект database или Connection выходит из области видимости. Это может излишне связывать ресурсы системы. Это может также привести к непредсказуемым результатам.

Вы можете использовать свойство prototype класса Stproc, чтобы добавить свойство ко всем образцам Stproc. Если Вы делаете так, то добавление применяется ко всем объектам Stproc, выполняющимся во всех приложениях на Вашем сервере, не только в отдельном приложении, которое сделало изменение. Это позволяет Вам разворачивать возможности этого объекта для всего Вашего сервера.

Резюме Свойств

prototype
Позволяет добавление свойств к объекту Stproc.

Резюме Методов

close
Закрывает объект сохрненной процедуры.
outParamCount
Возвращает число выходных параметров, возвращенных сохраненной процедурой.
outParameters
Возвращает значение определенного выходного параметра.
resultSet
Возвращает новый объект набора результатов.
returnValue
Возвращает возвращаемое сохраненной процедурой значение.

Свойства

prototype

Представляет прототип для этого класса. Вы можете использовать прототип, чтобы добавлять свойства или методы ко всем образцам класса. Для информации о прототипах, смотрите Function.prototype.

Свойство объекта Stproc
Реализовано в LiveWire 1.0

Методы

close

Закрывает сохраненную процедуру и освобождает распределенную память.

Метод объекта Stproc
Реализовано в Netscape Server 3.0

Синтаксис

close()

Параметры

Нет.

Возвращает

0, если запрос был успешен; иначе, ненулевой код состояния, основанный на любом сообщении об ошибках, переданном базой данных. Если метод возвращает ненулевой код состояния, используйте связанные методы majorErrorCode и majorErrorMessage, чтобы интерпретировать причину ошибки.

Описание

Метод close закрывает сохраненную процедуру и освобождает память, которую она использует. Если Вы явно не закрываете сохраненную процедуру методом close, двигатель времени выполнения JavaScript на сервере автоматически закрывает ее, когда соответствующий объект client выходит из области видимости.

outParamCount

Возвращает число выходных параметров, возвращенных сохраненной процедурой.

Метод объекта Stproc
Реализовано в Netscape Server 3.0

Синтаксис

outParamCount()

Параметры

Нет.

Возвращает

Число выходных параметров сохраненной процедуры. Informix сохраненные процедуры не имеют выходных параметров. Следовательно для Informix, этот метод всегда возвращает 0. Вы должны всегда вызывать этот метод перед вызовом outParameters, чтобы знать, имеет ли сохраненная процедура выходные параметры.

outParameters

Возвращает значение определенного выходного параметра.

Метод объекта Stproc
Реализовано в Netscape Server 3.0

Синтаксис

outParameters (n)

Параметры

n
Нуль-основанный порядковый номер выходного параметра для возврата.

Возвращает

Значение определенного выходного параметра. Это может быть строка, число, двойное число или объект.

Описание

Не используйте этот метод для Informix сохраненных процедур, потому что они не имеют выходных параметров.

Вы должны всегда вызывать метод outParamCount прежде, чем Вы вызовите этот метод. Если outParamCount возвращает 0, сохраненная процедура не имеет выходных параметров. В этой ситуации, не вызывайте этот метод.

Вы должны получить объекты набора результатов прежде, чем Вы вызовите этот метод. Если только Вы вызвали этот метод, Вы больше не можете получить данные из набора результатов, и Вы не можете получить любые дополнительные наборы результатов.

resultSet

Возвращает новый объект набора результатов.

Метод объекта Stproc
Реализовано в Netscape Server 3.0

Синтаксис

resultSet ()

Параметры

Нет.

Описание

Выполнение сохраненной процедуры может создавать 0 или большее количество наборов результатов. Вы обращаетесь к наборам результатов по очереди повторными вызовами метода resultSet. Смотрите описание Resultset для ограничений на то, когда Вы можете использовать этот метод, обращаясь к наборам результатов для сохраненной процедуры.

spobj = connobj.storedProc("getcusts");
// Создаем новый объект набора результатов
resobj = spobj.resultSet();

returnValue

Возвращает возвращаемое сохраненной процедурой значение.

Метод объекта Stproc
Реализовано в Netscape Server 3.0

Синтаксис

returnValue()

Параметры

Нет.

Возвращает

Для Sybase, этот метод всегда возвращает возвращаемое сохраненной процедурой значение.

Для Oracle, этот метод возвращает null, если сохраненная процедура не возвратила значение, или возвращаемое значение сохраненной процедуры.

Для Informix, DB2 и ODBC этот метод всегда возвращает null.

Описание

Вы должны получить объекты набора результатов прежде, чем Вы вызовите этот метод. Если только Вы вызвали этот метод, Вы больше не можете получить данные из набора результатов, и Вы не можете получить любые дополнительные наборы результатов.


[Содержание] [Предыдущая] [Следующая] [Индекс]

Последняя Модификация: 10/31/97 16:36:13


Права © 1997 Netscape Communications Corporation



Все мессаги сюда:yanich@inbox.ru
Hosted by uCoz