В данном примере к 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 |