Использование технологий WWW для доступа к базам данных

       

Примеры cgi-модулей


В качестве примера рассмотрим работу тестовых программ поставляющихся

вместе с программным обеспечением сервера НТТРD стандарта NCSA.

Для тестирования работы форм поставляются программы :

post-query - для тестирования работы форм с методом запроса

POST

query - для тестирования работы форм с методом запроса

GET

util.c - описание функций для обработки входного потока

(используется query и post-query).

Рассмотрим простой пример формы на языке HTML использующую программу

query.

<HTML>

<HEAD>

<TITLE>Пример использования CGI</TITLE>

</HEAD>

<BODY>



<FORM ACTION="http://iceman.cnit.nsu.ru/cgi-bin/post-query"

METHOD="POST">

<B>Введите свое имя<I>(Фамилию Имя Отчество)</I>:</B>

<INPUT name=RealName type=text size=40 maxlength=60 value="Петров

Иван Сидорович"><P>

Пол: <INPUT name=Sex type=Radio value="Мужской" CHECKED>-

мужской <INPUT name=Sex type=Radio value="Женский">-женский<P>

<INPUT name=Submit type=submit value="Послать запрос"><BR>

<INPUT name=Reset type=reset value="Сброс">

</FORM>

</BODY>

</HTML>

После инициации формы путем нажатия кнопки "Послать запрос"

WWW сервер обрабатывает поток

данных от формы (заменяет все пробелы в именах и значениях на

символ "+", заменяет все символы с десятичным кодом

большим 128 на символ "%" и следующим за ним шестнадцатеричным

кодом символа (например "И" в %С8)).

Выходной поток примет следующий вид:

RealName=%CF%E5%F2%F0%EE%E2+%C8%E2%E0%ED+%D1%E8%E4%EE%F0
%EE%E2%E8%F7&Sex=%CC%F3%E6%F1%EA%EE%E9&Submit=%CF%EE%F1
%EB%E0%F2%FC+%E7%E0%EF%F0%EE%F1

В момент передачи управления модулю post-query сервер присваивает

значения переменным окружения и аргументам командной строки:

argc = 0. argv =

SERVER_SOFTWARE = NCSA/1.5.1

SERVER_NAME = iceman.cnit.nsu.ru



GATEWAY_INTERFACE = CGI/1.1

SERVER_PROTOCOL = HTTP/1.0

SERVER_PORT = 80

REQUEST_METHOD = POST

HTTP_ACCEPT = image/gif, image/x-xbitmap, image/jpeg, image/pjpeg,*/*

PATH_INFO =

PATH_TRANSLATED =

SCRIPT_NAME = /cgi-bin/test-cgi

QUERY_STRING =

REMOTE_HOST = fwa.cnit.nsu.ru

REMOTE_ADDR = 193.124.209.74

REMOTE_USER =

AUTH_TYPE =

CONTENT_TYPE = application/x-www-form-urlencoded

CONTENT_LENGTH = 142
Результат работы post-query:

<H1>Query Results</H1>You submitted the following
name/value pairs:<p>

<ul>

<li> <code>RealName = Петров Иван Сидорович</code>

<li> <code>Sex = Мужской</code>

<li> <code>Submit = Послать запрос </code>

</ul>
И на экране браузера

Query Results

You submitted the following name/value pairs:

RealName = Петров Иван Сидорович

Sex = Мужской

Submit = Послать запрос

Ниже приведен исходный текст программы post-query.
#include <stdio.h>
#ifndef NO_STDLIB_H
#include <stdlib.h>
#elsechar *getenv();
#endif
#define MAX_ENTRIES 10000

typedef struct {
char *name;
char *val;
} entry;

char *makeword(char *line, char
stop);
char *fmakeword(FILE *f, char
stop, int *len);
char x2c(char *what);
void unescape_url(char *url);
void plustospace(char *str);
main(int argc, char *argv[])
{
entry entries[MAX_ENTRIES];
register int x,m=0;
int cl;
printf("Content-type:
text/html%c%c",10,10);
if(strcmp(getenv("REQUEST_METHOD"),"POST"))
{ printf("This
script should be referenced with a METHOD of POST.\n");
printf("If you don't
understand this, see this "); printf("<A HREF=\"http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/Docs/fill-out-forms/overview.html\">
forms overview</A>.%c",10);
exit(1);
} if(strcmp(getenv("CONTENT_TYPE"),"application/x-www-form-urlencoded"))
{printf("This script
can only be used to decode form results. \n");


exit(1);
}
cl = atoi(getenv("CONTENT_LENGTH"));
for(x=0;cl && (!feof(stdin));x++)
{m=x;entries[x].val
= fmakeword(stdin,'&',&cl); plustospace(entries[x].val);
unescape_url(entries[x].val);
entries[x].name = makeword(entries[x].val,'=');
}
printf("<H1>Query
Results</H1>");
printf("You submitted
the following name/value pairs:<p>%c",10);
printf("<ul>%c",10);
for(x=0; x <= m; x++)
printf("<li>
<code>%s = %s</code>%c",entries[x].name,
entries[x].val,10);
printf("</ul>%c",10);
}

Надо отметить, что post- query не обрабатывает имена, поэтому в
примере они даны на английском языке. Если Вы используете русские
названия имен, то вы должны обработать имена также как и значения,
т.е. заменить все символы "+" на пробелы и преобразовать
шестнадцатеричные коды кириллических символов в сам символ.
Приведем также исходный текст функций используемых post-query
char *makeword(char *line,
char stop) {
/*
Предназначена для выделения
части строки, ограниченной "стоп-символами"*/
int x = 0,y;
char *word = (char *) malloc(sizeof(char)
* (strlen(line) + 1));
for(x=0;((line[x]) &&
(line[x] != stop));x++)
word[x] = line[x];
word[x] = '\0';
if(line[x]) ++x;
y=0;

while(line[y++] = line[x++]);
return word;
}

char *fmakeword(FILE *f,
char stop, int *cl) {
/*
Предназначена для выделения
строки,
ограниченной "стоп-символом" stop,
из потока f
длиной cl.
*/
int wsize;
char *word;
int ll;

wsize = 102400;
ll=0;
word = (char *) malloc(sizeof(char)
* (wsize + 1));

while(1) {
word[ll] = (char)fgetc(f);
if(ll==wsize) {
word[ll+1] = '\0';
wsize+=102400;
word = (char *)realloc(word,sizeof(char)*(wsize+1));
}
--(*cl);
if((word[ll] == stop)
(feof(f)) (!(*cl))) {
if(word[ll] != stop)
ll++;
word[ll] = '\0';
return word;
}
++ll;


}
}

char x2c(char *what) {
/* Предназначена для преобразования
шестнадцатиричного кода символа в код символа
*/
register char digit;

digit = (what[0] >= 'A'
? ((what[0] & 0xdf) - 'A')+10 : (what[0] - '0'));
digit *= 16;
digit += (what[1] >= 'A'
? ((what[1] & 0xdf) - 'A')+10 : (what[1] - '0'));
return(digit);
}

void unescape_url(char
*url) {

register int x,y;

for(x=0,y=0;url[y];++x,++y)
{
if((url[x] = url[y])
== '%') {
url[x] = x2c(&url[y+1]);
y+=2;
}
}
url[x] = '\0';
}

void plustospace(char
*str) {
/*замена символов "+"
на символ "пробел"*/
register int x;

for(x=0;str[x];x++) if(str[x]
== '+') str[x] = ' ';
}

Для демонстрации реализации формы с методом запроса GET воспользуемся
той же самой формой, что и для метода POST и программой query.
Для этого изменим значение атрибутов ACTION и METHOD в теге FORM.
<FORM action="http://iceman.cnit.nsu.ru/cgi-bin/query"
METHOD=GET>
После инициации формы сервер установит следующие значения для
переменных окружения и аргументов командной строки:

argc = 0. argv is =
SERVER_SOFTWARE = NCSA/1.5.1
SERVER_NAME = iceman.cnit.nsu.ru
GATEWAY_INTERFACE = CGI/1.1
SERVER_PROTOCOL = HTTP/1.0
SERVER_PORT = 80
REQUEST_METHOD = GET
HTTP_ACCEPT = image/gif, image/x-xbitmap, image/jpeg, image/pjpeg,
*/*
PATH_INFO =
PATH_TRANSLATED =
SCRIPT_NAME = /cgi-bin/test-cgi
QUERY_STRING = RealName=%CF%E5%F2%F0%EE%E2+%C8%E2%E0%ED+%D1%E8
%E4%EE%F0%EE%E2%E8%F7&Sex=%CC%F3%E6%F1%EA%EE%E9&Submit=%CF%EE
%F1%EB%E0%F2%FC+%E7%E0%EF%F0%EE%F1
REMOTE_HOST = fwa.cnit.nsu.ru
REMOTE_ADDR = 193.124.209.74
REMOTE_USER =
AUTH_TYPE =
CONTENT_TYPE =
CONTENT_LENGTH =

Как мы видим, выходной поток от формы появился в значении переменной
QUERY_STRING.
Результат работы query полностью совпадает с результатом работы
post-query.

Содержание раздела