Быстрый поиск

Лабораторная работа: Технологія WebSnap

Лабораторна робота

Технологія Web Snap

 Мета: отримання практичних навиків обміну даними між прикладенням C++ Builder і базою даних інформаційної системи в комп'ютерній мережі Internet з використанням технології WebSnap.

 Завдання:

· засобами C++ Builder із використанням технології WebSnap створити оригінальне (!) прикладення, яке складається з декількох html-сторінок;

· використати панель навігації, адаптери і парольний доступ до сторінок, реалізовані засобами технології WebSnap;

· забезпечити зв'язок прикладення з БД типу InterBase (або н.): забезпечити можливість перегляду і редагування записів перетину таблиц БД за допомогою html-сторінок.

Вказівки по встановленню і налагодженню Web-сервера IIS

· Якщо Web-сервер не встановлений, то необхідно його встановити таким чином: виконати команду Пуск | Панель управления, обрати піктограму Установка и удаление программ, потім обрати пункт Установка компонентов Windows, відзначити галочкою Internet Information Services (IIS) і виконати подальші інструкції операційної системи.

· Після успішного встановлення необхідно запустити IIS, для чого виконати команду Пуск | Панель управления, обрати піктограму Администрирование, обрати ярлик Internet Information Services, а в списку, що з'явився, - Веб-узел по-умолчанию (мал.1) натиснути кнопку запуску.

Малюнок 1

· Для налагодження Веб-узла по умолчанию треба в контекстному меню обрати команду Свойства і встановити параметри згідно мал. 2.

Малюнок 2

Нижче описана методика створення WebSnap-сервера, що підтримує повний інтерфейс редагування і перегляду для набору даних з графічними полями. Такий WebSnap-сервер не вимага написання коду. Проте, він підтримує повний набір функціональних можливостей з модифікації таблиці БД за допомогою браузера.

Приклад 1. Простий WebSnap-сервер

Для створення WebSnap-сервера у середовищі Borland C++ Builder 6 скористаємося майстром, який викликається командою File | New | Other | WebSnap | WebSnap Application (мал. 3).

На екрані відобразиться діалог (мал. 4).

Малюнок 3

Група параметрів Server type дозволя обрати тип прикладення.

Група Application Module Components (модуль компонентів прикладення) призначена для вибору компонентів, які будуть розташован в основному модулі прикладення і вид модуля. Модуль компонентів Web-прикладення використовується для централізації керування діловими правилами і не візуальними компонентами.

Малюнок 4

Можна вибрати один з двох видів модулів:

· Модуль Web-сторінки (Page Module) включає компоненти: PageProducer, WebAppServices, ApplicationAdapter, LogicalPageDispatcher, і AdapterDispatcher. З використанням модуля Web-сторінки в редакторі коду можна переглянути unit Web-сторінки, html-код і виконати попередній перегляд Web-сторінки після компіляції і виконання модуля.

· Модуль даних (Data Module) включає компоненти: PageProducer, WebAppServices, ApplicationAdapter, LogicalPageDispatcher, і AdapterDispatcher.

Слово Application у назві модуля вказує на те, що модуль буде головним у прикладенні. Натиснувши кнопку Components, можна побачити діалог вибору компонентів (мал. 5), які будуть розташовані в модул прикладення.

Група Application Module Options дозволя набудувати параметри основного модуля прикладення. Параметр Page Name дозволя вказати ім'я сторінки модуля (доступний лише для типу модуля Page Module). Параметр Caching дозволя задати режим кешування прикладення. За умовчанням параметр має значення Cache Instance (дозволити кешування). Друге можливе значення - Destroy Instance відключа кешування. Залишимо даний параметр без зміни. Кнопка Page Options виклика діалог налагодження параметрів модуля прикладення (мал. 6). Група параметрів Producer дозволя обрати тип продюсера сторінки (рядок введення Type) і скриптову мову (JScript або VBasic). Група HTML дозволя вказати шаблон для генерації HTML-сторінки. Група Page дозволя набудувати параметри сторінки: ім'я, заголовок, видимість (параметр published) необхідність аутентифікації користувача для перегляду даної сторінки (параметр Login Required). Ім'я дублює параметр Page Name попереднього діалогу.

Малюнок 5

Малюнок 6

Оберімо як Script Engine значення JScript, а як параметр Template – значення Standard. Натиснемо кнопки Ok для виходу з діалогів. Borland C++ Builder 6 згенерує заготівку проекту (мал. 7 –8).

Малюнок 7

Малюнок 8

Тепер треба модифікувати створений модуль так, щоб надалі не довелося упроваджувати в нього пакети реального часу (у тому числі і динамічні бібліотеки RTL). Хоча у результаті об'єм виконуємого модуля збільшиться, він зможе працювати на будь-якій платформі, включаючи і такі, де відсутній C++ Builder. Для цього у головному меню C++ Builder оберіть команду Project | Options. У діалоговому вікні Project Options, яке з'явиться після цього на екрані, відкрийте сторінку Linker і скиньте прапорець Use Dynamic RTL (використовувати динамічну бібліотеку RTL). Відкрийте сторінку Packages і скиньте прапорець Builder with Runtime Packages (Компілювати з пакетами реального часу).

Тепер залишилося зберегти і скомпілювати проект. Одержаний виконуваний файл і шаблон сторінки Unit1.html треба розташувати на Web-сервері у каталозі скриптів (для IIS це каталог c:\Inetpub\Scripts). Запустимо Web-браузер Internet Explorer і в рядку адреси наберемо http://localhost/Scripts/Project1.dll (у раз використання Apache та для нших Web-серверів адреса буде іншою). У вікні браузера ми побачимо напис PageProducerPage1 (мал. 9).

Малюнок 9

Приклад 2. Використання панелі навігації у WebSnap-сервері

Для доопрацювання сторінки встановимо властивість ApplicationTitle компоненту ApplicationAdapter у значення «WebSnap-приложение 2». А зараз сюрприз: HTML-сторінка, що згенерована, може бути переглянута без перенесення прикладення на Web-сервер (візуалізація сторінок може значно прискорити розробку Web-прикладень). Для цього необхідно обрати закладку Preview у нижній частині вікна редагування (мал. 10).

Малюнок 10

Друга закладка Unit1.html – містить текст шаблона html-сторінки, а закладка HTML Result – результуючий HTML-код.

Текст шаблону html-сторінки

<html>

<head>

</head>

<body>

<% if (EndUser.Logout != null) { %>

<% if (EndUser.DisplayName != '') { %>

<h1>Welcome <%=EndUser.DisplayName %></h1>

<% } %>

<% if (EndUser.Logout.Enabled) { %>

<a href="<%=EndUser.Logout.AsHREF%>">Logout</a>

<% } %>

<% if (EndUser.LoginForm.Enabled) { %>

<a href=<%=EndUser.LoginForm.AsHREF%>>Login</a>

<% } %>

<td>

<% e = new Enumerator(Pages)

s = ''

c = 0

for (; !e.atEnd(); e.moveNext())

{

if (e.item().Published)

}

if (c>1) Response.Write(s)

</td>

</table>

</body>

</html>

Результирующий html-код

<html>

<head>

<title>

PageProducerPage1

</title>

</head>

<body>

<h1>WebSnap-приложение 2</h1>

<h2>PageProducerPage1</h2>

<td>

</td>

</table>

</body>

</html>

WebSnap-прикладення в реальних проектах містить декілька модулів сторінок. Додамо новий модуль сторінки у прикладення командою File | New | Other | Web Snap | WebSnap Page Module. У діалозі вибору параметрів модуля (мал. 3.11) натиснемо кнопку ОК, - одержимо модуль сторінки з ім'ям PageProducerPage2 (мал. 3.12).

Малюнок 11

Малюнок 12

Тепер, побудуємо прикладення і розташуємо його на Web-сервері (для цього необхідно скопіювати файли Unit1.html, Unit2.html, Project1.dll у теку для скриптів на сервері). Запустимо Web-браузер Internet Explorer і у рядку адреси наберемо http://localhost/scripts/project1.dll (у раз використання Apache і для нших Web-серверів адреса буде іншою). У вікні браузера побачимо, що нижче за заголовка з'явилася панель навігації по сторінках прикладення (мал. 3.13).

Малюнок 13

Відразу виникає питання, а як вона з'явилася, адже ми нічого не робили для генерації? Відповідь криється у файлі Unit1.html. Крім HTML-тегів Web-сторінка містить теги <% %>, усередині яких розташовані оператори скриптової мови. Дані оператори виконуються на боці сервера, результат їх роботи вставляється в сторінку, що надсилається клієнту. Зі скриптів можна звертатися до більшості компонентів, розташованих в модулях. Це вносить чудову гнучкість і відкриває велик можливості для створення складних динамічних сторінок.

Текст скрипта необхідно укладати в тег <% %>. В якості скриптової мови можуть застосовуватися JScript і VBScript. Ми використовуватимемо JScript. Тепер стає ясно, що функція:

<% e = new Enumerator(Pages)

s = ''

c = 0

for (; !e.atEnd(); e.moveNext())

{

if (e.item().Published)

e.item().Name)

}

if (c>1) Response.Write(s)

у файлі Unit1.html генерує панель навігації. Текст функції достатньо зрозумілий, деякі коментарі необхідні лише для останнього оператора Response.Write. Цей оператор виводить рядок з результатом роботи скрипта в HTML-файл сторінки. Ще один приклад можна побачити в тому ж Unit1.html:

<%= Application.Title %>

В результаті роботи цього скрипта на сторінку виводиться її заголовок.

Приклад 3. Використання адаптерів у WebSnap-сервері

Адаптери призначені для зберігання різних параметрів і процедур; вони надають можливість звертатися до них зі скрипта. Сторінка WebSnap палітри компонентів Borland C++ Builder 6 містить декілька видів адаптерів. Найбільш неспеціалізованим є адаптер класу TAdapter. Параметри адаптера зберігаються в так званих полях (AdapterFields), які надають програмісту можливість задати оброблювачі для отримання значення поля та інших його параметрів. Клас TAdapter має властивість Data для зберігання полів і керування ними. Процедури дозволяють викликати зі скрипта виконання яких-небудь дій; для керування ними клас TAdapter містить властивість Actions.

Розглянемо приклад створення сторінки для введення мені користувача. Розташуймо компонент Adapter в модулі PageProducerPage2. Визначимо поле, яке повертатиме ім'я користувача. Для цього з інспектора об'єктів викличемо редактора властивості Data адаптера Adapter1. У редакторі натиснемо кнопку New Item. Нам буде запропонований діалог вибору типу поля (мал. 13).

Малюнок 13

Оберімо тип AdapterField, оскільки він найбільш підходить для зберігання невеликих рядків. У діалозі при цьому з'явиться елемент AdapterField1, відповідний полю. Оберімо його. Тепер в інспекторі об'єктів перейдемо на закладку Events визначимо текст оброблювача події OnGetValue. Дана подія виникає кожного разу, коли потрібно дізнатися значення поля. Значення поля, що зажадалося, необхідно повертати через параметр Value, передаваний в оброблювач. Код оброблювача:

void __fastcall TPageProducerPage2::AdapterField1GetValue(TObject *Sender,

Variant &Value)

{

Value = FValue;

}

Тут FValue - змінна, в якій запам'ятовується значення поля AdapterField1; необхідно визначити цю змінну в секції public декларац TPageProducerPage2 (файл Unit2.h) як AnsiString FValue;. Для ніціалізації значення FValue в оброблювачі події OnCreate модуля введемо код: FValue = “Неизвестный человек”;.

Тепер можна отримати доступ до даного поля зі скрипта. Спершу спробуємо виводити значення поля користувачу. Для цього в код шаблону HTML-сторінки Unit2.html треба додати після тега </table> наступний код:

<BR><BR> Здравствуйте, уважаемый <%=Adapter1.AdapterField1.DisplayText%>.

Скомпілюємо проект і розташуємо на Web-сервері файли Unit1.html, Unit2.html, Project1. dll на сервері в тец для скриптів. Запустимо Web-браузер Internet Explorer і в рядку адреси наберемо http://localhost/scripts/project1.dll. В результаті на сторінці PageProducerPage2 побачимо напис Здравствуйте, уважаемый Неизвестный человек.

Далі створимо процедуру для зміни значення імен користувача. У інспекторі об'єктів для компоненту Adapter1 викличемо редактора властивості Actions, і натиснувши кнопку New Item з діалогу, що з'явився, оберімо тип процедури AdapterAction (мал. 15).

Буде створена нова процедура AdapterAction1. У інспектор об'єктів встановимо властивості для процедури (табл 3.1).