Module Environment

Implement environment class

Class Environment

Environment:new (env) Создает новый объект Environment .
Environment:destroy () Уничтожает объект Environment .
Environment:destroyed () Возвращает статус объекта.
Environment:handle () Возвращает плотформозависимый дескриптор.
Environment:connection (dbname [, login [, password [, autocommit=true]]]) Создает новый объект Connection.
Environment:connection (params [, autocommit=true]) Создает новый объект Connection.
Environment:connect () Создает новый объект Connection и открывает подключение.


Class Environment

Environment:new (env)
Создает новый объект Environment .

Parameters:

  • env

Returns:

    объект Environment
Environment:destroy ()
Уничтожает объект Environment .


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

Environment:destroyed ()
Возвращает статус объекта.
Environment:handle ()
Возвращает плотформозависимый дескриптор.

Returns:

    handle
Environment:connection (dbname [, login [, password [, autocommit=true]]])
Создает новый объект Connection.

Parameters:

  • dbname название БД. (для ODBC это DSN)
  • login string
  • password string
  • autocommit boolean

Returns:

    Connection

Usage:

  • local db = env:connection('demo','DBA','sql',false)
  • local db = env:connection('demo',false) --Логин и пароль опущены, но autocommit установлен
Environment:connection (params [, autocommit=true])
Создает новый объект Connection.

Parameters:

  • params table таблица для формирования строки подключения
  • autocommit boolean

Returns:

  1. Connection
  2. string строка подключения

Usage:

    local db = env:connection{DSN='demo',UID='DBA',PWD='sql'}
Environment:connect ()
Создает новый объект Connection и открывает подключение.
Эквивалентно cnn = env:connection(...) cnn:open().
Если не удалось подключится к БД, то объект Connection уничтожается.

see also:

generated by LDoc 1.3