|
Обработка форм
В данном примере к ATLserverApp.h добавляется класс обработчика запросов, называемый C_process_post_AppHandler. В этом классе имеется метод ProcessPost, который получает доступ к переменной, переданной из формы с помощью объекта HTTP-запроса. Коллекцию CHttpRequestParams можно получить из метода CHttpRequest: :GetFormVars. Затем для получения из формы значения с определенным именем используется метод CHttpRequestParams :: Exchange В нашем примере таким именем значения является "txtName". Значение, содержащееся в szName, мы будем передавать назад клиенту — всего лишь для доказательства того, что этот метод работает.
// Обработчик (handler), который обрабатывает POST
[request_handler("process_post")]
class C_process_post_AppHandler
{
protected: // защищенный
[ tag_name(name="ProcessPost") ]
HTTP_CODE ProcessPost(void)
{
// использовать переменную формы
const CHttpRequestParams &request = // константа
m_HttpRequest.GetFormVars();
CValidateContext valCtx;
LPCSTR szName;
request.Exchange("txtName", SszName, fivalCtx); // запрос.
// Обмен
m_HttpResponse
<< "Welcome to ATL Server, " << szName
<< "<p>";
// «"Добро пожаловать в ATL Server,
" return HTTP_SUCCESS;
}
};
Вот файл process_post. srf, который предоставляет доступ к только что описанному методу ProcessPost:
{{handler ATLServerApp.dll/process_post}}
{{ProcessPost}}
На этот раз непосредственного доступа к process_post .srf через броузер не
будет. Доступ теперь возможен через другой, HTML-файл, содержащий форму. Второй
файл [При создании решения в среде Visual Studio html-файл автоматически копируется
в виртуальный каталог размещения вместе с srf-файлами.] называется SimpleForm.html
и содержит следующий HTML-код. Обратите внимание, что этот HTML-код регистрирует
запрос, содержащий значение с именем "txtName".
<HTML>
<HEAD>
</HEAD>
<BODY> <!-- ТЕЛО -->
<form method="post" <!-- метод -->
action= <!-- действие -->
"http://localhost/ATLServerApp/process_post.srf">
Enter your name:
<!-- Введите ваше имя -->
<input name="txtName" type="text"
size="30">
<!-- имя = "txtName" тип = "текстовый"
размер = "30" -->
<input name="cmdEcho" type="submit"
value="Echo">
<!-- входное имя = "cmdEcho" тип = "представить"
значение =
// "Echo" -->
</form>
</BODY> <!-- тело -->
</HTML>
И опять же, будет полезно, используя отладчик, понаблюдать, что происходит внутри динамически подключаемой библиотеки (DLL) расширения интерфейса прикладного программирования Internet-сервера (ISAPI). Вы увидите, что функция HttpExtension-Proc из ATLServerAppIsapi . dll принимает параметр EXTENSION_CONTROL_BLOCK, который содержит данные, перечисленные в табл. 12.2. Содержимое этих элементов берется из формы, определяемой впоказанном выше файле SimpleForm.html.
В этом примере SimpleForm.html использует метод POST (ЗАПИСАТЬ), и данные
переносятся в тело запроса. В классе обработчика доступ к этим данным выполняется
с помощью массива FormVars (Переменные формы). Если файл SimpleForm.html был
изменен для использования метода GET (ПОЛУЧИТЬ), тогда в строке запроса должны
находиться данные [В элементе FORM (ФОРМА) атрибут метода может указывать один
из двух методов отправки данных формы на Web-сервер, а именно GET (ПОЛУЧИТЬ)
или POST (ЗАПИСАТЬ). Первый из них в конце универсального идентификатора ресурса
(URI), указанного атрибутом действия элемента FORM (ФОРМА), вставляет знак вопроса,
а затем — данные формы. Метод POST (ЗАПИСАТЬ) помещает эти данные в тело HTTP-запроса
]. Впрочем, массив FormVars также можно использовать для доступа к данным формы.
В табл. 12.3 показаны значения параметра EXTENSION_ CONTROL_BLOCK в том случае,
если бы элемент FORM (ФОРМА) был изменен для использования метода GET (ПОЛУЧИТЬ).
На рис. 12.18. показан файл SimpleForm.html с заполненной формой. Когда вы
щелкнете на кнопке Echo (Эхо), то с помощью переменной формы осуществляется
доступ к process_post. srf. Эта переменная содержит значение Bob (Боб). Результат
показан на рис. 12.19.
Таблица 12.2. Структура EXTENSION_CONTROL BLOCK с указанием метода POST (ЗАПИСАТЬ)
|
Элемент структуры
|
Значение
|
|
IpszMethod
|
"POST" ("ЗАПИСАТЬ")
|
|
IpszQuerystring
|
till
|
|
IpszPathlnfo
|
"ATLServerApp/process_post.srf"
|
|
pbData
|
"txtName=Bob&cmdEcho=Echo"
|
Таблица 12.3. Структура EXTENSION_CONTROL_BLOCK с указанием
метода GЕТ (ПОЛУЧИТЬ)
|
Элемент структуры
|
Значение
|
|
IpszMethod
|
"GET" ("ПОЛУЧИТЬ")
|
|
IpszQuerystring
|
"txtName=Bob&cmdEcho=Echo"
|
|
IpszPathlnfo
|
"ATLServerApp/process_post.srf"
|
|
pbData
|
0
|
Рис. 12.18. Просмотр формы, которая находится в SimpleForm.htm
Рис. 12.19. Результат представления формы, которая находится
в SimpleForm htm
|
