Přidání uživatelského chování serveru v aplikaci Dreamweaver

O vlastních serverových chováních

Dreamweaver je dodáván se sadou vestavěných chování serveru, která vám umožňují snadno přidat dynamické funkce na web.Funkčnost aplikace Dreamweaver můžete rozšířit vytvořením chování serveru tak, aby vyhovovalo vašim vývojářským potřebám, nebo získáním chování serveru z webu Dreamweaver Exchange.

Před vytvořením vlastního chování serveru byste měli zkontrolovat web Dreamweaver Exchange, zda již jiná strana nevytvořila chování serveru, které poskytuje funkcionalitu, kterou byste chtěli přidat na svůj web produktu. Často vývojář od třetí strany vytvořil a otestoval chování serveru, které splní vaše potřeby.

Přístup na web Dreamweaver Exchange

Instalace chování serveru nebo jiného rozšíření v aplikaci Dreamweaver

Pracovní postup s použitím vlastních serverových chování

Pokud jste webový vývojář zdatný v ColdFusion, JavaScript, VBScript nebo PHP, můžete napsat vlastní chování serveru. Kroky pro vytvoření chování serveru zahrnují následující úkoly:

• Napište jeden nebo více bloků kódu, které provedou požadovanou akci.

• Určete, kam vložit blok kódu v rámci HTML kódu stránky.

• Pokud chování serveru vyžaduje zadání hodnoty pro parametr, vytvořte dialogové okno, které vyzve webového vývojáře aplikujícího chování k zadání vhodné hodnoty.

• Otestujte serverové chování před tím, než ho dáte k dispozici ostatním.

Používání okna Vytvoření serverového chování

Pomocí nástroje Server Behavior Builder přidáte blok nebo bloky kódu, které chování vkládá do stránky.

Rozšířené volby

Poté, co zadáte zdrojový kód a umístění pro vložení každého bloku kódu, je chování serveru plně definováno. Ve většině případů nemusíte zadávat žádné další informace.

Pokud jste pokročilí uživatelé, můžete nastavit některou z následujících možností:

Určuje, zda má být blok kódu považován za identifikátor.

Standardně je každý blok kódu identifikátor. Pokud Dreamweaver najde identifikátor bloku kódu kdekoliv v dokumentu, zobrazí chování v panelu Chování serveru. Pomocí možnosti Identifikátor určete, zda má být blok kódu považován za identifikátor.

Alespoň jeden z bloků kódu chování serveru musí být identifikátor. Blok kódu by neměl být identifikátorem, pokud platí jedna z následujících podmínek: stejný blok kódu používá nějaké jiné chování serveru; nebo je blok kódu natolik jednoduchý, že se může na stránce vyskytovat přirozeně.

Určuje titul chování v panelu Serverová chování.

Když navrhář stránek klikne na tlačítko Plus (+) v panelu Chování serveru, název nového chování serveru se zobrazí v rozbalovací nabídce. Když návrhář aplikuje instanci chování serveru na dokument, chování se zobrazí v seznamu aplikovaných chování v panelu Chování serveru. Pomocí pole Název chování serveru zadejte obsah rozbalovací nabídky Plus (+) a seznamu aplikovaných chování.

Počáteční hodnota v poli je název, který jste zadali v dialogovém okně Nové chování serveru. Jak se definují parametry, název se automaticky aktualizuje tak, aby se parametry objevily v závorkách za názvem chování serveru.

Nastavit proměnnou relace (@@Name@@, @@Value@@)

Pokud uživatel přijme výchozí hodnotu, vše před závorkami se zobrazí v rozbalovací nabídce Plus (+) (například Nastavit proměnnou relace). Název plus parametry se zobrazí v seznamu aplikovaných chování—například Nastavit proměnnou relace ("abcd", "5").

Určuje, který blok kódu se vybere, když uživatel vybere chování na panelu Chování serveru.

Když použijete serverové chování, jeden z blokų kódu v daném chování je označen jako „blok kódu k výběru". Pokud serverové chování použijete a pak ho vyberete v panelu Serverová chování, označený blok se vybere v okně Dokument.Ve výchozím nastavení Dreamweaver vybere první blok kódu, který se nenachází nad značkou html.Pokud se všechny bloky kódu nacházejí nad značkou HTML, pak je vybrán první z nich. Pokročilí uživatelé mohou určit, který blok kódu je vybraný.

Vytváření bloků kódu

Bloky kódu, které vytváříte v nástroji Server Behavior Builder, jsou zapouzdřeny v chování serveru, které se zobrazí na panelu Chování serveru. Kód může být jakýkoli platný běhový kód pro specifikovaný model serveru. Například pokud vyberete ColdFusion jako typ dokumentu pro vlastní chování serveru, kód, který napíšete, musí být platný kód ColdFusion, který běží na aplikačním serveru ColdFusion.

Bloky kódu můžete vytvořit buď přímo v nástroji Server Behavior Builder, nebo můžete kód zkopírovat a vložit z jiných zdrojů. Každý blok kódu, který vytvoříte v nástroji Server Behavior Builder, musí být jediný tag nebo blok skriptu. Pokud musíte vložit více bloků tagů, rozdělte je do samostatných bloků kódu.

Podmínky v blocích kódu

Dreamweaver vám umožňuje vyvíjet bloky kódu, které zahrnují řídicí příkazy vykonávané podmíněně. Modul Server Behavior Builder používá příkazy if, elseif a else a může také obsahovat parametry chování serveru. To vám umožňuje vkládat alternativní textové bloky na základě hodnot vztahů NEBO mezi parametry chování serveru.

Následující příklad ukazuje příkazy if, elseif a else. Hranaté závorky ([ ]) označují volitelný kód a hvězdička (*) označuje nulu nebo více instancí. Chcete-li spustit část bloku kódu nebo celý blok kódu pouze v případě, že platí určitá podmínka nebo podmínky, použijte následující syntaxi:

<@ if (expression1) @> podmíněný

text1[<@ elseif (expression2) @> podmíněný text2]*[<@ else @>

podmíněný text3]<@ endif @>

Výrazy pro podmínky mohou být jakékoliv JavaScript výrazy, které lze vyhodnotit pomocí JavaScript funkce eval(), a mohou obsahovat parametr chování serveru označený znaky @@. (Znaky @@ rozlišují parametr od JavaScript proměnných a klíčových slov.)

Efektivní používání podmíněných výrazů

Při používání direktiv if, else a elseif uvnitř XML tagu insertText je text účastníka předem zpracován za účelem vyřešení direktiv if a určení, který text zahrnout do výsledku. Direktivy if a elseif berou výraz jako argument. Výraz pro podmínku je stejný jako u JavaScript výrazů pro podmínky a může také obsahovat parametry chování serveru. Direktivy jako tato vám umožňují vybrat si mezi alternativními bloky kódu na základě hodnot nebo vztahů mezi parametry chování serveru.

Například následující JSP kód pochází z chování serveru aplikace Dreamweaver, které používá podmíněný blok kódu:

@@rsName@@.close();

<@ if (@@callableName@@ != '') @>

@@callableName@@.execute();

@@rsName@@ = @@callableName@@.getResultSet();<@ else @>

@@rsName@@ = Statement@@rsName@@.executeQuery();

<@ endif @>

@@rsName@@_hasData = @@rsName@@.next();

Podmíněný blok kódu začíná <@ if (@@callableName@@ != '') @> a končí <@ endif @>.Podle kódu, pokud uživatel zadá hodnotu pro parametr @@callableName@@ v dialogovém okně Parametry chování serveru—jinými slovy, pokud hodnota parametru @@callableName@@ není null, nebo (@@callableName@@ != '')—pak je podmíněný blok kódu nahrazen následujícími příkazy:

@@callableName@@.execute();

@@rsName@@ = @@callableName@@.getResultSet();

Jinak je blok kódu nahrazen následujícím příkazem:

@@rsName@@ = Statement@@rsName@@.executeQuery();

Umístění bloku kódu

Když vytváříte bloky kódu pomocí Server Behavior Builder, musíte specifikovat, kam je vložit do HTML kódu stránky.

Například pokud vložíte blok kódu nad otevírací značku <html>, musíte pak specifikovat pozici bloku kódu relativně k ostatním značkám, skriptům a chování serveru v této části HTML kódu stránky. Typické příklady zahrnují umístění chování buď před nebo po všech dotazech sady záznamů, které mohou také existovat v kódu stránky nad otevírací značkou <html>.

Když vyberete možnost umístění z rozbalovací nabídky Vložit kód, možnosti dostupné v rozbalovací nabídce Relativní pozice se změní tak, aby poskytovaly relevantní možnosti pro danou část stránky.Například pokud vyberete Nad značku <html> v rozbalovací nabídce Vložit kód, možnosti umístění dostupné v rozbalovací nabídce Relativní pozice odrážejí volby relevantní pro danou část stránky.

Následující tabulka zobrazuje možnosti vlož bloky kódu a мožnosti relativního umístění dostupné pro každou:

Chcete-li specifikovat vlastní pozici, musíte přiřadit bloku kódu váhu.Použijte možnost Vlastní pozice, když potřebujete vložit více než jeden blok kódu v určitém pořadí. Například, chcete-li vložit uspořádanou řadu tří bloků kódu za bloky kódu, které otevírají sady záznamů, zadali byste váhu 60 pro první blok, 65 pro druhý a 70 pro třetí.

Ve výchozím nastavení Dreamweaver přiřazuje váhu 50 všem blokům kódu pro otevírání sad záznamů vloženým nad značku <html>.Pokud se tloušťka dvou nebo více bloků sladí, Dreamweaver náhodně nastaví pořadí mezi bloky.

Umístění bloku kódu (obecné pokyny)

Umístění bloku kódu vzhledem k jiné značce na stránce

Umístění bloku kódu vzhledem ke značce vybrané návrhářem stránky

Opakování bloků kódu s instrukcí cyklu

Chcete-li opakovat část bloku kódu nebo celý blok kódu několikrát, použijte následující syntaxi:

<@ loop (@@param1@@,@@param2@@) @> kód

blok<@ endloop @>

Při vytváření chování serveru můžete použít konstrukce smyček pro opakování bloku kódu určitý počet krát.<@ loop (@@param1@@,@@param2@@,@@param3@@,@@param_n@@) @> code block <@ endloop @>Směrnice loop přijímá jako argumenty seznam polí parametrů oddělených čárkami.V tomto případě argumenty pole parametrů umožňují uživateli zadat více hodnot pro jeden parametr. Opakující se text je duplikován nkrát, kde n je délka pole argumentů parametrů.Je-li zadán více než jeden argument pole parametrů, všechna pole musí mít stejnou délku. Při itém vyhodnocení smyčky nahradí ité prvky polí parametrů přidružené instance parametrů v bloku kódu.

Při vytváření dialogového okna pro chování serveru můžete přidat do dialogového okna ovládací prvek, který umožní návrháři stránky vytvořit pole parametrů. Dreamweaver obsahuje jednoduchý ovládací prvek pole, který můžete použít k vytváření dialogových oken.Tento ovládací prvek se nazývá Text Field Comma Separated List a je dostupný prostřednictvím Server Behavior Builder. Pro vytvoření prvků uživatelského rozhraní větší složitosti si prohlédněte dokumentaci rozhraní API pro vytvoření dialogového okna s ovládáním pro vytváření polí (například ovládání mřížky).

Můžete vnořit libovolný počet podmínek nebo direktivu smyčky uvnitř podmíněné direktivy.Můžete například zadat, že pokud je výraz pravdivý, provede se smyčka.

Následující příklad ukazuje, jak lze tyto opakující se bloky kódu použít k vytvoření chování serveru (příkladem je chování ColdFusion použité pro přístup k uložené proceduře):

<@ loop (@@param1@@,@@param2@@,@@param3@@,@@param_n@@) @> code block

<@ endloop @>

<CFSTOREDPROC procedure="AddNewBook"

datasource=#MM_connection_DSN#

username=#MM_connection_USERNAME#

password=#MM_connection_PASSWORD#>

<CFPROCPARAM type="IN" dbvarname="@CategoryId" value="#Form.CategoryID#"

cfsqltype="CF_SQL_INTEGER">

<CFPROCPARAM type="IN" dbvarname="@ISBN" value="#Form.ISBN#"

cfsqltype="CF_SQL_VARCHAR">

</CFSTOREDPROC>

V tomto příkladu může značka CFSTOREDPROC obsahovat nula nebo více značek CFPROCPARAM. Bez podpory smyčkové direktivy však neexistuje způsob, jak zahrnout značky CFPROCPARAM do vložené značky CFSTOREDPROC. Kdyby se toto vytvořilo jako chování serveru bez použití smyčkové direktivy, museli byste tento příklad rozdělit na dva účastníky: hlavní značku CFSTOREDPROC a značku CFPROCPARAM, jejíž typ účastníka je vícenásobný.

Pomocí smyčkové direktivy můžete napsat stejný postup takto:

<CFSTOREDPROC procedure="@@procedure@@"

datasource=#MM_@@conn@@_DSN#

username=#MM_@@conn@@_USERNAME#

password=#MM_@@conn@@_PASSWORD#>

<@ loop (@@paramName@@,@@value@@,@@type@@) @>

<CFPROCPARAM type="IN"

dbvarname="@@paramName@@"

value="@@value@@"

cfsqltype="@@type@@">

<@ endloop @>

</CFSTOREDPROC>

Pokud uživatel zadal následující hodnoty parametrů v dialogovém okně Server Behavior Builder:

procedure = "proc1"

conn = "connection1"

paramName = ["@CategoryId", "@Year", "@ISBN"]

value = ["#Form.CategoryId#", "#Form.Year#", "#Form.ISBN#"]

type = ["CF_SQL_INTEGER", "CF_SQL_INTEGER", "CF_SQL_VARCHAR"]

Chování serveru by vložilo následující běhový kód do stránky:

<CFSTOREDPROC procedure="proc1"

datasource=#MM_connection1_DSN#

username=#MM_connection1_USERNAME#

password=#MM_connection1_PASSWORD#>

<CFPROCPARAM type="IN" dbvarname="@CategoryId" value="#Form.CategoryId#"

cfsqltype="CF_SQL_INTEGER">

<CFPROCPARAM type="IN" dbvarname="@Year" value="#Form.Year#"

cfsqltype="CF_SQL_INTEGER">

<CFPROCPARAM type="IN" dbvarname="@ISBN" value="#Form.ISBN#"

cfsqltype="CF_SQL_VARCHAR">

</CFSTOREDPROC>

Používání proměnných _length a _index instrukce cyklu

Direktiva smyčky zahrnuje dvě vestavěné proměnné, které můžete použít pro vnořené podmínky if.Tyto proměnné jsou: _length a _index. Proměnná _length se vyhodnocuje na délku polí zpracovávaných direktivou smyčky, zatímco proměnná _index se vyhodnocuje na aktuální Rejstřík direktivy smyčky.Abyste zajistili, že proměnné jsou rozpoznány pouze jako direktivy a nikoli jako skutečné parametry, které mají být předány do smyčky, neuzavírejte žádnou proměnnou do @@.

Příkladem použití vestavěných proměnných je jejich použití u atributu import direktivy stránky.Atribut import vyžaduje oddělení balíčků čárkami.Pokud se direktiva loop rozšiřuje kolem celého atributu import, výstupem by byl pouze název atributu import= při první iteraci smyčky—to zahrnuje uzavírací dvojité uvozovky (&quot;)—a při poslední iteraci smyčky se nevypíše čárka.Pomocí vestavěné proměnné to můžete vyjádřit následovně:

<@loop (@@Import@@)@>

<@ if(_index == 0)@>import="

<@endif@>@@Import@@<@if (_index == _length-1)@>"<@else@>,

<@ endif @>

<@endloop@>

Vyžádat parametr pro chování serveru

Chování serveru často vyžaduje, aby návrhář stránky poskytl hodnotu parametru.Tato hodnota musí být vložena před vložením kódu chování serveru do stránky.

Dialogové okno vytvoříte definováním parametrů dodaných návrhářem v kódu.Poté vygenerujete dialogové okno pro chování serveru, které vyzve návrháře stránky k zadání hodnoty parametru.

Definujte parametr v kódu chování serveru

Také můžete řetězec zvýraznit a klepnout na tlačítko Vložit parametr do bloku kódu. Zadejte název parametru a klikněte na tlačítko OK. Aplikace Dreamweaver nahradí každý výskyt zvýrazněného řetězce určeným názvem parametru uzavřeným mezi značkami parametru.

Aplikace Dreamweaver používá řetězce, které uzavřete mezi značky parametru, aby označil ovladače v dialogovém okně, které generuje (viz následující postup). V předcházejícím příkladu aplikace Dreamweaver vytvoří dialogové okno s následujícím popisem:

Vytvořte dialogové okno pro chování serveru, aby vyžadovalo hodnotu parametru

Zobrazení dialogového okna

Upravit dialogové okno, které jste vytvořili pro chování serveru

Úpravy a změny serverových chování

Můžete upravit jakékoli chování serveru vytvořené pomocí Tvůrce chování serveru, včetně chování serveru, které si stáhnete z webu produktu Dreamweaver Exchange, a od jiných vývojářů třetích stran.

Pokud použijete chování serveru na stránku a poté upravíte chování v aplikaci Dreamweaver, instance starého chování se již nezobrazují v panelu Chování serveru. Panel Chování serveru prohledává stránku a hledá kód, který odpovídá kódu známých chování serveru. Pokud se kód chování serveru změní, panel nerozpozná starší verze chování na dané stránce.

Zachování starých i nových verzí chování v panelu

Úprava kódu chování serveru vytvořeného pomocí Tvůrce chování serveru

Pravidla programování

Obecně by měl být kód vašeho chování serveru kompaktní a robustní. Vývojáři webových aplikací jsou velmi citliví na kód přidaný do jejich stránek. Dodržujte obecně přijímané postupy kódování pro jazyk typu dokumentu (ColdFusion, JavaScript, VBScript nebo PHP). Při psaní poznámek zvažte různé technické skupiny, které mohou potřebovat kódu porozumět, například webové designéry a designéry interaktivity nebo jiné vývojáře webových aplikací. Zahrňte poznámky, které přesně popisují účel kódu a všechny speciální pokyny pro jeho zahrnutí na stránku.

Při vytváření chování serveru mějte na paměti následující pokyny pro kódování:

To je důležitý požadavek. Kód chování serveru by měl elegantně zvládnout chybové případy. Snažte se předvídat každou možnost. Co se například stane, když požadavek na parametr selže?Co když dotaz nevrátí žádné záznamy?

Pomáhají zajistit, aby byl váš kód jasně identifikovatelný a vyhýbal se kolizím názvů se stávajícím kódem. Například pokud stránka obsahuje funkci nazvanou hideLayer() a globální proměnnou nazvanou ERROR_STRING a vaše chování serveru vloží kód, který tyto názvy také používá, chování serveru může být v konfliktu se stávajícím kódem.

Umožňují identifikovat běhové funkce a globální proměnné na stránce.Jednou konvencí je používat vaše iniciály. Nikdy nepoužívejte předponu MM_, protože je vyhrazena pouze pro použití v aplikaci Dreamweaver. Dreamweaver uvádí všechny funkce a globální proměnné předponou MM_, aby nedošlo ke konfliktu s jakýmkoli kódem, který napíšete.

var MM_ERROR_STRING = "...";

function MM_hideLayer() {

tak, aby kód, který píšete, příliš nepřipomínal kód v jiných blocích. Pokud nějaký blok kódu příliš připomíná jiný blok kódu na stránce, panel Chování serveru může omylem identifikovat první blok kódu jako instanci druhého bloku kódu (nebo naopak). Jednoduchým řešením je přidat do bloku kódu komentář, aby byl jedinečnější.

Testování chování serveru

Dreamweaver Exchange doporučuje provést následující testy u každého chování serveru, které vytvoříte:

• Aplikujte chování z panelu Serverová chování. Pokud má dialogové okno, zadejte platná data do každého pole a klikněte na tlačítko OK. Zkontrolujte, že se při aplikování chování nevyskytla žádná chyba. Ověřte, že se v Inspektoru kódu zobrazí běhový kód pro chování serveru.

• Použijte chování serveru znovu a zadejte neplatná data do každého pole dialogového okna. Zkuste ponechat pole prázdné, použít velká nebo záporná čísla, použít neplatné znaky (například /, ?, :, * atd.) a použít písmena v numerických polích. Můžete napsat ověřovací rutiny formuláře pro zpracování neplatných dat (ověřovací rutiny vyžadují ruční kódování, což překračuje rozsah této knihy).

  Po úspěšném použití chování serveru na stránku ověřte následující:

• Zkontrolujte panel Chování serveru a ujistěte se, že se název chování serveru zobrazuje v seznamu chování přidaných na stránku.

• Je-li to relevantní, ověřte, že se na stránce zobrazují ikony skriptů na straně serveru.Obecné ikony skriptu na straně serveru jsou zlaté štíty. Chcete-li vidět ikony, povolte Neviditelné prvky (Zobrazit > Vizuální pomůcky > Neviditelné prvky).

• V zobrazení Kód (Zobrazit > Kód) ověřte, že není generován žádný neplatný kód.

  Navíc, pokud vaše chování serveru vkládá kód do dokumentu navazujícího připojení k databázi, vytvořte testovací databázi pro testování kódu vloženého do dokumentu. Ověřte připojení definováním dotazů, které vytvářejí různé sady dat a různé velikosti datových sad.

  Nakonec nahrajte stránku na server a otevřete ji v prohlížeči. Zobrazte zdrojový kód HTML stránky a ověřte, že skripty na straně serveru nevygenerovaly žádný neplatný HTML kód.