Home page
Рус. Eng.  
Просто линия

Скрипт язык сервера

RC$form-variable - переменные FORM
RC@scalar Встроенные функции сервера.
RCCcgi Выполнение сервером CGI приложения
RCDcache.col# Возвращает содержимое столбца
RCEenvironment-variable Переменные окружения сервера
RCexit Выход из сценария.
RCFcache Возвращает содержимое курсора
RCif condition RCelse RCelseif another-condition RCendif Тэги условий
RCinclude /url Включает указанный файл/ISAPI/шаблон
RCJservlet Включение java скрипта
RCOobservation-string Запись сообщения-события в лог файл
RCQcache.query Выполнение SQL запроса
RCredirect location Редирект
RCterminate Остановка выполнения всех скриптов.
RCVvariable Переменные сервера
RCWwincgi Выполнение сервером WinCGI приложения
RCXmethod Процедуры сервера RPC
RCZmacro Макрос сервера

Скрипты сервера *.STM.

Обычно страница HTML это статичный документ сети. SambarServer помимо возможности работы с обычными статичными документами файлами имеет возможность регенерации динамических страниц двух типов. Это *.STM шаблоны  и  server-side includes. Оба типа требуют установки параметра "Prohibit Script #exec" в файле config.ini в  false для выполнения включенных в страницу скриптов.  

Шаблоны *.STM позволяют создавать динамические HTML документы. Скрипт язык похож на PHP и ASP скрипт языки. Дополнительно к статичным HTML тегам, STM файты могут содержать собственные управляющие команды. Эти команды интерпретируются сервером во время выполнения запроса броузером клиента, и клиент получает страницу с результатом выполнения данных инструкций и вставкой нового текста вместо тегов скрипта.

Интерпритатор SambarServer выполняет несколько типов включаемых инструкций. Он интерпритирует SQL запросы для выполнения в базе данных, реализует условную логическую и текстовую замену и переменные сервера, чтобы расширить взаимодействия пользователя / сервера.

Для реального взаимодействия клиента "Пользователя сети" и сервера сети, сервер должен получить запрос клиента с заголовками или содержимым с переменными, сформировать и выслать ответ клиенту обработав данные переменные. 

Sambar Server поддерживает эти функции используя первично четыре метода:

  • встроенные процедуры
  • скалярные функции
  • текстовые макрокоманды замены
  • поддержка переменных сервера.

Вы можете включать макрокоманды скрипта в любое место HTML шаблона. После выполнения интерпритатором данные теги скрипта подменяется значениями сгенерированными сервером.

Значение макрокоманды от содержимого URL запроса (адреса и параметров запроса к серверу), когда к странице обращается программа интернет броузер.

Следующий пример показывает как работает текстовая  замена.

Пользователь заполняет HTML форму содержащую значение Имени и Фамилиии.

<html>
<body>
<FORM action=template.stm>
Имя <INPUT NAME=firstname VALUE="Jane">
Фамилия <INPUT NAME=lastname VALUE="Smith">
<INPUT TYPE=SUBMIT>
</FORM>
</body>
</html>

 

Когда форма отправляется на сервер то броузер клиента формирует запрос типа:

 

http://www/template.stm?firstname=Jane&lastname=Smith 

 

В HTML шаблоне, вместо тега <RC$firstname> будет вставлено Jane и вместо тега <RC$lastname>  Smith во время выполнения данного запроса. Для примера в страницу ответа template.stm можно включить:

 

<html><body>
Dear <RC$firstname> <RC$lastname> , 
Thank you for your registration.
Your registration number is 123-456.
</body></html> 

 

Тэг RC$ использует FORM параметры. То есть переменные, которые являются доступными для текстовой замены и-или использования в условной логической схеме.

Комментарии

Коментарии в станице скрипта необходимо помещать в теги 

<!--- and ---> 

Внимание три символа (-) и содержимое имеют пробел между собой, не конфликтует с функцией RCredirect в отличае от обычного написания комментариев.

 

Спецсимволы и ограничители тегов скрипта.

Для помещения символа (>) в тело скрипта, например

<RC$foo = where x \> 22> 

используется символ (\) перед любым спец.символом.

 

*.stm файлы

Приведенный язык SambarServer работает только в файлах с расширением (типом файлов) Server Scripts, по умолчанию значение 

 

Server Scripts = *.stm

 

Передавая данный файл по HTTP запросу  клиента, сервер включает интерпретатор для выполнения данных скрипт команд.

Просто линия
  E-mail support@sambar.ru © 2001  Sambar.Ru
Last modifed: 2004-05-04 14:00 Распечатать страницу