cFos Personal Net дакументацыя - Стандартныя сцэнарыі

Стандартныя сцэнары cFos PNet

Сцэнарыі, пастаўленыя з cFos PNet, могуць паказаць, як рэалізаваць функцыі сервера з дапамогай JavaScript. Яны прызначаны для выкарыстання з сцэнарыямі браўзэра на баку кліента, як jQuery. Па сцэнары сервера канвенцый выкарыстоўваецца пашырэнне .jss, а кліенцкія сцэнарыі - пашырэнне .js. Гэта значыць, cFos PNet *выконвае* .jss файлы, у той час як ён адпраўляе .js файлы ў браўзэр.

Вы можаце выкарыстоўваць адладку сцэнарыя з Visual studio або Visual Web Developer. Для адладкі сцэнарыяў вам патрэбна версія Visual Studio або Visual Web Developer з падтрымкай аддаленай адладкі, г.зн. Візуальная студыя Professional Edition. Каб уключыць адладку сцэнарыя, усталюйце ключ enable_script_debugging=1 у раздзеле [param] файла GLOBAL.INI у GLOBAL.INI c:\programdata\cFos\cFosPNet.

Калі ў вас не ўстаноўлены адладчык сцэнарыяў, усталюйце яго на 0. У адваротным выпадку сцэнарыі могуць завісаць на некаторых машынах. Вы таксама можаце загрузіць cfospnet.exe з -enable_script_debugging або -esd пераключальніка каманднага радка, каб уключыць адладку сцэнарыя для запуску гэтай праграмы.

Сцэнарнае кіраванне і аўтэнтыфікацыя карыстальнікаў

У папцы pub ёсць users падпапкі з падпапкамі для кожнага карыстальніка, які мае ўліковы запіс на вашым серверы cFos PNet. Пароль карыстальніка ці іншыя неабавязковыя дадзеныя профілю захоўваюцца ў спісе хэшаў пад назвай PROFILE.TXT. Гэта дазваляе хутка і кэшаваць доступ для cFos PNet убудаванай аўтэнтыфікацыяй HTTP. У публічнай тэчцы таксама знаходзіцца падпапка www з падпапкамі для кожнага карыстальніка. Гэтая тэчка можа змяшчаць загружаныя файлы гэтага карыстальніка. Скрыпт file_op.jss таксама дазваляе карыстачу загружаць файлы ў гэтую тэчку.

Сцэнарыі выконваюць праверку сапраўднасці ў адпаведнасці з адпаведнымі наладамі .htaccess. Такім чынам, вам патрэбныя адпаведныя ўліковыя дадзеныя для карыстальніка, якому належаць каталог.

Вось кароткае апісанне сцэнарыяў. Вы павінны зірнуць у зыходны код, каб убачыць, як яны працуюць.
makedir2.jss	Калі ў запытаным каталогу няма файла index.htm або index.html cFos PNet запускае гэты сцэнар для стварэння спісу каталогаў. Скрыпт выкарыстоўвае FileSystemObject для збору інфармацыі пра змесціва бягучага каталога. Затым ён загружае файл шаблону XML, аналізуе яго і стварае HTML-старонку са змесціва каталога і фрагментаў, якія прадстаўляюцца XML. Каб змяніць знешні выгляд або функцыянальнасць спісу каталогаў, змяніце шаблон XML. Атрыманы файл HTML мае асноўныя спасылкі на абслугоўванне файлаў. Як адміністратар вы можаце ўвайсці з дапамогай HTTP аўтэнтыфікацыі і перайменаваць, выдаляць файл ці папкі, загружаць файлы, а таксама ствараць новыя тэчкі. Гэта падтрымліваецца jQuery на базе кліента, які ў асноўным выкарыстоўваецца для зручнага адпраўкі запытаў Ajax на cFos PNet. Серверны скрыпт file_op.jss выконвае неабходную аўтэнтыфікацыю HTTP і апрацоўвае файлавыя аперацыі.
file_op.jss	Выконвае аперацыі з файламі ў адпаведнасці з аўтэнтыфікацыяй вышэй. Аперацыі з файламі rename, delete, mkdir для стварэння тэчкі і загрузкі. Загрузка звычайна патрабуе праверкі сапраўднасці. Паколькі браўзэр заўсёды спачатку адпраўляе ўвесь загружаны файл на сервер, а потым атрымлівае інфармацыю пра аўтэнтыфікацыю, ён адправіць файл двойчы. Каб прадаставіць file_op.jss інфармацыю пра file_op.jss сцэнар file_op.jss падтрымлівае file_op.jss па загрузцы перад палётам. Аглядальнік, выкарыстоўваючы запыт Ajax, пытаецца ў сервера адказ HTTP (401), а затым аўтаматычна выкарыстоўвае яго для фактычнай загрузкі. Загрузка ажыццяўляецца функцыяй upload.jss, якая выкарыстоўвае аб'ект файла cFos PNet, каб дазволіць загрузку файлаў адвольнага памеру.
user_op.jss	Выконвае асноўныя функцыі адміністравання карыстальніка: create, delete, reset password і list. Карыстальнік адміністратара патрабуецца для праверкі сапраўднасці.
list_op.jss	Паколькі хэш-спіс гуляе важную ролю для cFos PNet, list_op.jss забяспечвае асноўныя аперацыі са спісам, даступныя для запытаў Ajax. Праводзіцца тая ж схема праверкі сапраўднасці, як апісана вышэй. Гэта значыць: у залежнасці ад месцазнаходжання сцэнарыя выбіраецца карыстальнік, для якога патрабуецца аўтэнтыфікацыя. Аўтэнтыфікацыя праводзіцца ў адпаведнасці з дырэктывамі ў адпаведных файлах .htaccess. list_op.jss прапануе наступныя аперацыі: get Атрымаць спіс значэнняў у хэш-спісе. set Устанавіць спіс клавіш у спіс значэнняў. save Захаваць здымак на дыск. erase Сцірае спіс клавіш. clear сцірае ўсе клавішы. remove Выдаліць спіс з памяці / дыска. size Вяртанне памеру спісу. list Спіс усіх элементаў у хэш-спісе. Ajax у dyndns.htm выкарыстоўвае гэтыя аперацыі для ўстаноўкі інфармацыі аб канфігурацыі DynDNS.
dyndns.jss	Выконвае рэгістрацыю DynDNS альбо dyndns.txt, выкарыстоўваючы дадзеныя канфігурацыі ў хэш-спісе dyndns.txt у прыватнай тэчцы. Можна выкарыстоўваць пры запуску і адключэнні сервера (гл. Раздзел 1).
get_connections.jss	Выкарыстоўваецца для адлюстравання бягучых злучэнняў HTTP. HTTP ажыццяўляецца праз TCP. Каб паскорыць HTTP-запыты, браўзары спрабуюць паўторна выкарыстоўваць TCP-злучэнні для HTTP-запытаў. Фактычны запыт HTTP - гэта толькі кароткае паведамленне і адказ. Пасля гэтага браўзэр спыняе злучэнне TCP праз некалькі секунд. Такім чынам, вы можаце ўбачыць карыстальніка толькі на кароткі час. Калі аўтэнтыфікацыя прайшла паспяхова, імя карыстальніка таксама вяртаецца з IP-адрасамі карыстальнікаў.
stretch.jss	Паколькі вэб-майстру заўсёды з'яўляецца цяжарам змяняць памеры малюнкаў у фармаце, які выкарыстоўваецца на вэб-старонцы, мы рэалізавалі невялікі сцэнар, у якім выкарыстоўваецца аб'ект выявы cFos PNet (GDI +). У радку запыту URL выкарыстоўваецца імя файла і параметр w (шырыня) і h (вышыня). Калі вашы выявы адвольнага памеру, вам варта выкарыстоўваць толькі адзін параметр, каб захаваць прапорцыі малюнка. makedir2.jss выкарыстоўвае спасылкі на гэты сцэнар для адлюстравання мініяцюрных малюнкаў для малюнкаў, якія захоўваюцца ў бягучай тэчцы.
utils.jss	Збор функцый ўтыліты для спрашчэння сцэнарыяў на баку сервера. Прапануе наступную функцыянальнасць: - абгарнуць аб'ект вэб-сервера і яго функцыі. - пашырыць аб'ект JavaScript String з некалькімі карыснымі функцыямі. - выканаць ацэнку параметраў сцэнарыя альбо з радка запыту, альбо з формай, якая выкарыстоўваецца з POST. - загрузка, захаванне і адпраўка (праз пошту) невялікіх файлаў. - 1123 даты, як выкарыстоўваецца ў кукі. - печыва. - простая функцыя пераўтварэння XML. Калі вы выкарыстоўваеце cFos PNet для вялікіх праектаў, вы, магчыма, захочаце спакаваць функцыянальныя блокі ў модулі, а не ў просты файл з сцэнарыем. cFos PNet прапануе падтрымку спецыфікацыі модуля ініцыятывы common.js.