Соединение с источником данных для последующего выполнения SQL-запросов (<query …/>), показа данных в табличном виде (<view …/>) или работы с сетевыми протоколами (http).
—-
| Название | Тип | Описание |
|---|---|---|
| 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. |
| Название | Тип | Описание |
|---|---|---|
| is-file | boolean | Если в value содержится имя файла |
| Название | Тип | Описание |
|---|---|---|
| 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"
/>