<connect ... />

Соединение с источником данных для последующего выполнения SQL-запросов (<query …/>), показа данных в табличном виде (<view …/>) или работы с сетевыми протоколами (http). —-

Атрибуты

Основные атрибуты (R/W):

Название Тип Описание
login string Имя пользователя.
password string Пароль пользователя.

Атрибуты ввода (R/W):

Название Тип Описание
value value write: данные передаваемые на вебсервер при query=post;
read: текст загруженной страницы или имя временного файла, если ответом был бинарный ресурс.
value-type string Тип загруженного содержимого (возвращается то, что было в http-заголовке «Content-type»).

Командные атрибуты (W/O):

Название Тип Описание
close boolean Команда на разрыв соединения с БД.
connect boolean Команда на создание соединения с БД.

Прочие атрибуты (R/W):

Название Тип Описание
alias string Алиас БД (схема, база и т.д., в разных СУБД по-разному).
cookie boolean Включить поддержку куков. Если поддержка включена, куки сохраняются в файле, указанном в cookie-file.
По умолчанию, cookie=«false».
cookie-file string Файл для хранения куков между запусками программы, eсли не указан - то в качестве имени подставляется значение в формате: «temp/{хост вебсервера}.dat».
Работа с куками отключается через атрибут cookie.
driver string @driver
error-code string Код HTTP ответа (при отсутствии ошибки - код 200)
error-text string Сообщение HTTP ответа
host string Имя хоста, на котором работает сервер БД. Для работы с вэб-сайтами используется атрибут url.
По умолчанию, host=«localhost».
proxy string HTTP proxy host.
По умолчанию прокси не используется. Можно задавать в формате host или host:port
proxy-port number HTTP proxy port.
По умолчанию, proxy-port=«3128»
query get | post Метод обращения к HTTP ресурсу
timeout number Время (сек.) на попытку соединения с БД.
type mysql | firebird | postgresql | oraclethin | oracle | odbc | h2 | http Тип источника данных: БД (mysql, postgresql, oraclethin, oracle, odbc и т.д.) или вэб-сервер (http).
По умолчанию, type=«mysql»
url string URL вэб-сайта. Указывается в формате: http://server.com/page.html
params jdbc-params Позволяет указывать драйверу дополнительные параметры подключения. Поддерживается только для MySQL.

Атрибуты только для чтения (R/O):

Название Тип Описание
is-file boolean Если в value содержится имя файла

Событийные атрибуты (R/W):

Название Тип Описание
onCreated code Описание действий для события, возникающего после создания объекта, но до установления соединения с источником данных.
Правила описания см. (Описание событий в ApplicationXML )
onConnected code Описание действий для события, возникающего после подключения к источнику данных.
Правила описания см. (Описание событий в ApplicationXML )
onDisconnected code Описание действий для события, возникающего после отключения от источника данных.
Правила описания см. (Описание событий в ApplicationXML )
onError code Описание действий для события, возникающего при ошибке подсоединения к источнику данных.
Правила описания см. (Описание событий в ApplicationXML )
onExecuted code Описание действий для события, возникающего после успешного скачивания страницы.
Правила описания см. (Описание событий в ApplicationXML )

Описание

<connect …/> - это объект для подключения к источнику данных. В дальнейшем этот объект используется для выполнения запросов <query …/> или просмотра данных в табличном виде <view …/>. В явном виде ссылки в <query ../> или <view …/> на <connect ../> нет. Поэтому, на текущий момент в AppXML-скрипте рекомендуется описывать только один объект типа <connect …/>. Он будет считаться основным и использоваться везде.

Описание объекта <connect …/> необходимо разместить в секции <system> AppXML-скрипта.

Для выполнения подключения к СУБД в момент создания объекта (т.е. сразу при запуске программы) необходимо в описании объекта атрибуту connect присвоить значение «true».

Для выполнения подключения позже, например, в момент первого обращения к СУБД из <query …/> или <view …/>, необходимо в описании объекта опустить атрибут connect.

Примеры

Пример подсоединения к СУБД H2:

<connect type="h2" login="sa" password="" alias="file:.data/my_base" connect="true"/>

Пример обращения к вэб-сайту:

<connect id="c1" type="http" query="get" 
            url="http://test-od.trais-od.com/phptest/tmp/2.php" content="" 
            onError="msg('Error: ' + this.http-message)" 
            onConnected="msg('Connected')" 
            onExecuted="msg('Executed:' + this.content-type + ' ' + this.value)" 
            cookie-enable=true 
            cookie-file=".data/test-cookie.dat" 
/> 
 
tags/datasource/connect.txt · Последние изменения: 15/12/2010 20:31 (внешнее изменение)
 
Recent changes RSS feed Valid XHTML 1.0 Valid CSS