Посещая в Internet различные Web-серверы, вы, наверно, заметили, что одни из них просто предоставляют некоторую информацию, а другие пытаются вступить с вами в диалог. Конечно, и статическая информация может быть очень интересна и полезна сама по себе. Однако ваш сервер будет намного привлекательнее для пользователей, если вы сделаете его активным. Активные серверы могут содержать счетчик посещений, книгу записей для гостей, в которой каждый желающий может оставить свои координаты, формы для обращения к базам данных, динамически изменяющиеся изображения, кнопки, списки и т. д.

Для централизованной обработки информации, которая поступает от клиентов, просматривающих содержимое страниц сервера с помощью Netscape Navigator и Microsoft Internet Explorer, можно воспользоваться расширениями серверов Web.

Мы предполагаем, что вы умеете создавать документы HTML. Неплохо, если в вашем распоряжении имеется Web-сервер, на котором вы можете экспериментировать.

Расширения CGI и ISAPI

Чаще всего активные серверы Web создаются с помощью программ CGI, использующих так называемый стандартный шлюзовой интерфейс, - Common Gateway Interface (CGI).

Что же представляет собой программа CGI? Вообще-то это обычное консольное приложение. Такая программа не ведет никакого диалога с пользователем, а работает со стандартными потоками ввода и вывода, а также с переменными среды (environment variables). Если вы когда-либо создавали консольные программы для операционных систем MS-DOS, OS/2 или Windows NT, то составление программ CGI вам вполне по плечу. Как правило, программа CGI анализирует содержимое некоторых переменных среды, получает данные от удаленного пользователя через стандартный поток ввода, а результат обработки этих данных записывает в стандартный поток вывода. Вот и все! Ну хорошо, почти все...

Каждый раз, когда удаленный пользователь обращается к расширению CGI, на сервере Web запускается программа, которая выполняется как отдельный процесс, причем в собственном адресном пространстве. На запуск процесса требуется время, и если ваш сервер пользуется популярностью, то программы CGI могут полностью его загрузить. В результате увеличится время реакции сервера, что может оттолкнуть от него пользователей.

Для повышения производительности в некоторых Web-серверах (в частности, Microsoft Internet Information Server) используется другой способ создания расширений. Расширение создается как библиотека динамической загрузки DLL с использованием программного интерфейса ISAPI (Internet Server API). Когда такое расширение активизируется в первый раз, оно загружается в адресное пространство процесса Web-сервера и начинает свою работу. В памяти всегда находится только одна копия соответствующей библиотеки DLL, поэтому при одновременном обращении к расширению ISAPI нескольких пользователей системные ресурсы расходуются более экономно, а кроме того, не тратится время на дополнительные загрузки расширения.

Программирование приложений ISAPI представляет собой более сложную задачу, нежели создание программ CGI. Поскольку такие приложения всегда работают в мультизадачном режиме, необходимо обеспечить синхронизацию доступа к критичным ресурсам. Ошибки в приложениях ISAPI могут привести к аварийной остановке сервера Web, а вот при использовании программ CGI это маловероятно. Поэтому, несмотря на то что расширения ISAPI в целом более эффективны по сравнению с программами CGI, первые эксперименты по созданию активных серверов следует начинать именно с программ CGI.

Пишем первую программу CGI

Наша первая программа CGI не принимает данные от пользователя. Она запускается, если пользователь щелкает левой кнопкой мыши по соответствующей ссылке в документе HTML, и возвращает ему новый документ HTML, созданный динамически.

Для ссылки на программу CGI мы использовали оператор , как это показано в листинге 1.

Параметр HREF оператора задается почти таким же образом, как и при организации обычной ссылки на другой документ HTML, файл графического изображения или произвольный двоичный файл. Отличие заключается лишь в том, что вслед за именем загрузочного файла программы CGI после разделительного символа "?" следует необязательная строка параметров. В нашем случае программа CGI называется cgi1.exe, а строка параметров равна "param1".

Сервер с адресом http://frolov начнет поиск программы cgi1.exe и в случае успеха запустит ее. Перед запуском будет сформирован набор переменных среды, с помощью которых программа CGI может получить различную информацию, включающую, в том числе, строку параметров, указанную в операторе .

Вернемся к нашей программе cgi1.c. Исходный текст этой программы вы найдете в листинге 2.

По своей сложности cgi1.c совсем недалеко ушла от знаменитой программы "Hello, World!". Ее задачей является динамическое формирование документа HTML и отправка его в стандартный поток вывода с помощью функции printf.

При первом вызове функции printf в стандартный поток вывода записывается заголовок протокола HTTP, из которого видно, что далее последует текстовый документ HTML:

printf ("Content-type: text/html

");

Заголовок протокола HTTP всегда отделяется от данных пустой строкой, поэтому в конце приведенной выше строки находятся два символа " ".

Вслед за заголовком программа cgi1 выводит строки документа HTML.

Необязательный оператор определяет тип документа и версию языка HTML. Далее в стандартный поток выводятся операторы , и Ссылка для вызова программы CGI

Листинг 2

#include 
#include 

void main(int argc, char *argv[])
{
  printf("Content-type: text/html

");
  printf("");
  printf("");

  printf("
Содержимое некоторых переменных среды
");
  printf("REQUEST_METHOD = %s
", getenv("REQUEST_METHOD"));
  printf("QUERY_STRING = %s
",   getenv("QUERY_STRING"));
  printf("CONTENT_LENGTH= %s
",  getenv("CONTENT_LENGTH"));
  printf("CONTENT_TYPE= %s
",    getenv("CONTENT_TYPE"));
  printf("");
}

Листинг 3

   


Благодарим за посещение
Пожалуйста, оставьте запись в нашей книге гостей


  

    
Укажите ваш адрес E-mail
    

    

      
Ваше настоящее имя
      

    
    

      
Где вы живете?
      

    
  
  


  Ваши комментарии:
  

  

   
  

Листинг 4

// --------------------------
// Программа CGI - книга гостей для сервера Web
// 
// (c) Александр Фролов, 1997
//
// E-mail: frolov@glas.apc.org
// Web:    http://www.glasnet.ru/~frolov
//         http://www.dials.ccas.ru/frolov
// --------------------------
#include 
#include 
#include 

void DecodeStr(char *szString);
char DecodeHex(char *str);

void main(int argc, char *argv[])
{
  int lSize;
  FILE * fileGuestBook;
  char * szMethod;
  char szBuf[1024];
  char szSrcBuf[1024];
  char szTemp[1024];
  char * szPtr;
  char * szPtrValue;
  char * szParam;

  printf("Content-type: text/html

");
  printf("");
  printf("");
  printf("
Наша книга гостей
");
    
  fileGuestBook = fopen("guestbk.dat", "r");
  if(fileGuestBook != NULL)
  {
    while(!feof(fileGuestBook))
    {
      fgets(szBuf, 1024, fileGuestBook);
      if(ferror(fileGuestBook))      
        break;
      fputs(szBuf, stdout);
    }
    fclose(fileGuestBook);
  }
 
  szMethod = getenv("REQUEST_METHOD");
  if(!strcmp(szMethod, "POST"))
  {
    lSize = atoi(getenv("CONTENT_LENGTH"));
    fread(szBuf, lSize, 1, stdin);

    fileGuestBook = fopen("guestbk.dat", "a+");
    printf("
");
    fwrite("
", 4, 1, fileGuestBook);
    szBuf[lSize] = ''; strcpy(szSrcBuf, szBuf);
    DecodeStr(szSrcBuf);
    szBuf[lSize] = '&'; szBuf[lSize + 1] = '';
    szParam = szBuf; szPtr = strchr(szParam, '&');
    if(szPtr != NULL)
    {
      *szPtr = ''; DecodeStr(szParam);
      szPtrValue = strchr(szParam, '="); szPtrValue++;
      printf("%s
", 
        szPtrValue, szPtrValue);
      sprintf(szTemp, "%s
", 
        szPtrValue, szPtrValue);
      fwrite(szTemp, strlen(szTemp), 1, fileGuestBook);
    }

    szParam = szPtr + 1; szPtr = strchr(szParam, '&');
    if(szPtr != NULL)
    {
      *szPtr = ''; DecodeStr(szParam);
      szPtrValue = strchr(szParam, '="); szPtrValue++;
      printf("
%s, ", szPtrValue);
      sprintf(szTemp, "
%s, ", szPtrValue);
      fwrite(szTemp, strlen(szTemp), 1, fileGuestBook);
    }

    szParam = szPtr + 1; szPtr = strchr(szParam, '&');
    if(szPtr != NULL)
    {
      *szPtr = ''; DecodeStr(szParam);
      szPtrValue = strchr(szParam, '="); szPtrValue++;
      printf("%s
", szPtrValue);
      sprintf(szTemp, "%s
", szPtrValue);
      fwrite(szTemp, strlen(szTemp), 1, fileGuestBook);
    }

    szParam = szPtr + 1; szPtr = strchr(szParam, '&');
    if(szPtr != NULL)
    {
      *szPtr = ''; DecodeStr(szParam);
      szPtrValue = strchr(szParam, '="); szPtrValue++;
      printf("
%s", szPtrValue);
      sprintf(szTemp, "
%s", szPtrValue);
      fwrite(szTemp, strlen(szTemp), 1, fileGuestBook);
    }
    printf("");
    fclose(fileGuestBook);
    return;
  }
}

void DecodeStr(char *szString)
{
  int src;
  int dst;
  char ch;
  for(src=0, dst=0; szString[src]; src++, dst++)
  {
    ch = szString[src];
    ch = (ch == '+') ? ' ' : ch;
    szString[dst] = ch;
    if(ch == '%')
    {
      szString[dst] = DecodeHex(&szString[src + 1]);
      src += 2;
    }
  }
  szString[dst] = '';
}

char DecodeHex(char *str)
{
  char ch;
  if(str[0] >= 'A')
    ch = ((str[0] & 0xdf) - 'A') + 10;
  else
    ch = str[0] - '0';
  ch <<= 4;
  if(str[1] >= 'A')
    ch += ((str[1] & 0xdf) - 'A') + 10;
  else
    ch += str[1] - '0';
  return ch;
}

Листинг 5

  
    
Количество посещений: 
    
  

Листинг 6

// ===============================================
// Расширение CGI: счетчик посещений страниц
//
// (C) Фролов А.В., 1997
//
// E-mail: frolov@glas.apc.org
// WWW:    http://www.glasnet.ru/~frolov
//         http://www.dials.ccas.ru/frolov
// ===============================================

#include 
#include 
#include 
#include 

#define char_width  8
#define char_height 10

static unsigned char char_bits[10][char_height] = 
{
  { // 0
    0x3C, 0x42, 0x42, 0x42, 0x42, 0x42, 0x42, 0x42, 0x42, 0x3C 
  },
  { // 1
    0x10, 0x18, 0x14, 0x10, 0x10, 0x10, 0x10, 0x10, 0x10, 0x7C 
  },
  { // 2
    0x3E, 0x22, 0x20, 0x20, 0x10, 0x08, 0x04, 0x02, 0x22, 0x3F 
  },
  { // 3
    0x3E, 0x22, 0x40, 0x40, 0x3C, 0x40, 0x40, 0x40, 0x22, 0x3E 
  },
  { // 4
    0x10, 0x18, 0x14, 0x12, 0x12, 0x3E, 0x10, 0x10, 0x10, 0x38 
  },
  { // 5
    0x3E, 0x02, 0x02, 0x02, 0x3E, 0x20, 0x20, 0x20, 0x22, 0x2C 
  },
  { // 6
    0x1C, 0x06, 0x02, 0x02, 0x1E, 0x22, 0x22, 0x22, 0x22, 0x1C 
  },
  { // 7
    0x3E, 0x22, 0x20, 0x20, 0x10, 0x08, 0x08, 0x08, 0x08, 0x08 
  },
  { // 8
    0x1C, 0x22, 0x22, 0x22, 0x1C, 0x22, 0x22, 0x22, 0x22, 0x1C 
  },
  { // 9
    0x1C, 0x22, 0x22, 0x22, 0x3C, 0x20, 0x20, 0x20, 0x20, 0x1C 
  },
};

void main(int argc, char *argv[])
{
  CHAR   szBuff[4096];
  HANDLE hCounterFile;
  DWORD  dwBytesRead;
  DWORD  dwBytesWritten;
  BOOL   bResult;
  CHAR   szBuf[20];
  INT    nCounter;
  int    nFinalWidth;
  int    nFinalHeight;
  int    nLine;
  unsigned int nChar;
  int    nDigitOffset;

  hCounterFile = CreateFile("COUNTER.DAT", 
    GENERIC_READ, FILE_SHARE_READ, NULL, OPEN_EXISTING,
    FILE_FLAG_SEQUENTIAL_SCAN, NULL);
  bResult = ReadFile(hCounterFile, szBuf, 7, 
    &dwBytesRead, NULL);
  CloseHandle(hCounterFile);
  
  sscanf(szBuf, "%d", &nCounter);
  nCounter++;
  sprintf(szBuf, "%05.5ld", nCounter);

  hCounterFile = CreateFile("COUNTER.DAT", 
    GENERIC_WRITE, 0, NULL, CREATE_ALWAYS,
    FILE_FLAG_SEQUENTIAL_SCAN, NULL);
  WriteFile(hCounterFile, szBuf, strlen(szBuf),
    &dwBytesWritten, NULL);
  CloseHandle(hCounterFile);
  
  printf("Content-type: image/x-xbitmap

");

  nFinalWidth  = char_width * strlen(szBuf);
  nFinalHeight = char_height;

  printf("#define counter_width %d
", nFinalWidth);
  printf("#define counter_height %d
", nFinalHeight);
  printf("static unsigned char counter_bits[] = {
");

  for(nLine=0; nLine < nFinalHeight; nLine++)
  {
    for(nChar=0; nChar < strlen(szBuf); nChar++)
    {
      nDigitOffset = szBuf[nChar] - '0';
      printf("0x%02X, ", char_bits[nDigitOffset][nLine]);
    }
  }
  printf("};
");
}