Používání komponent ColdFusion v aplikaci Dreamweaver

Soubory komponent ColdFusion (CFC) umožňují zapouzdření aplikační a obchodní logiky do samostatných opakovatelně použitelných jednotek. Komponenty CFC jsou zároveň možností, jak rychle a snadno vytvářet webové služby.

CFC je opakovatelně použitelná softwarová jednotka napsaná v jazyce CFML (ColdFusion markup language), která usnadňuje opětovné používání a údržbu kódu.

Aplikace Dreamweaver umožňuje práci s komponentami CFC. Informace o tazích a syntaxi komponent CFC najdete v dokumentaci aplikace ColdFusion v aplikaci Dreamweaver (Nápověda > Použití ColdFusion).

CFC mají být jednoduchou a přitom výkonnou možností, jak vývojářům umožnit zapouzdření elementů ve webových místech. Obecně platí, že komponenty by měly být používány pro aplikační nebo obchodní logiku. Elementy vzhledu, například přizpůsobené pozdravy, dynamická menu a podobně, vytvářejte pomocí tagů.

Výměnné součásti mohou být přínosem i pro mnoho dalších typů konstrukcí, jako jsou dynamická webová místa. Například dynamické webové místo může opakovaně spouštět stejný dotaz nebo počítat celkovou cenu na všech stránkách nákupního košíku a přepočítávat ji vždy po přidání položky. Tyto úkoly mohou být prováděny komponentami. Komponentu můžete upravit, zlepšit, rozšířit nebo i nahradit, a má to jen minimální dopad na zbytek aplikace.

Předpokládejme, že online obchod vypočítává cenu poštovného podle hodnoty objednávky. U objednávek s cenou do 20 $ je poštovné 4 $; u objednávek s cenou 20 až 40 $ je poštovné 6 $ a tak dále. Logiku výpočtu můžete vložit na stránku nákupního košíku i na stránku pokladny, ale tím dojde ke zvýšení složitosti prezentačního kódu HTML a logického kódu CFML a obecně se ztíží opakovatelná použitelnost a údržba kódu.

Rozhodnete se vytvořit CFC s názvem Stanovení ceny, která kromě jiného obsahuje funkci Poštovné. Funkce na základě vstupního parametru ceny vrátí poštovné. Například při vstupní hodnotě 32,80 funkce vrátí hodnotu 6.

Na stránku nákupního košíku i na stránku pokladny vložíte tag, který vyvolá funkci Poštovné. Při vyžádání stránky je zavolána funkce a stránce je vrácena hodnota poštovného.

Obchod později vyhlásí zvláštní reklamní akci: poštovné zdarma u všech objednávek nad 100 $. Změnu sazeb poštovného můžete provést na jednom místě – ve funkci Poštovné komponenty Stanovení ceny – a všechny stránky, které ji používají, budou automaticky účtovat správné poštovné.

Panel Komponenty – přehled (ColdFusion)

Pomocí panelu Komponenty (Okna > Komponenty) můžete zobrazit a upravovat komponenty ColdFusion a přidávat na stránky kód, který při vyžádání stránky CFM zavolá požadovanou funkci.

Vytvoření nebo odstranění komponenty CFC v aplikaci Dreamweaver

Pomocí aplikace Dreamweaver můžete vizuálně definovat komponenty CFC a související funkce. Aplikace Dreamweaver vytvoří soubor .cfc a vloží do něj potřebné tagy CFML.

Zobrazení komponent CFC v aplikaci Dreamweaver

Aplikace Dreamweaver nabízí možnost, jak vizuálně prohlížet komponenty ColdFusion (CFC) umístěné ve složce webového místa nebo na serveru jako celku. Aplikace Dreamweaver načte soubory CFC a zobrazí o nich informace ve snadno ovladatelném stromovém zobrazení v panelu Komponenty.

Aplikace Dreamweaver vyhledává komponenty na testovacím serveru (viz článek Připojení k databázi v aplikaci Dreamweaver). Pokud vytvoříte komponentu CFC nebo měníte stávající komponentu CFC, nezapomeňte nahrát soubory CFC na testovací server, aby se správně zobrazily v panelu Komponenty.

Komponenty umístěné na jiném serveru zobrazíte změnou nastavení testovacího serveru.

Můžete zobrazit následující informace o komponentách CF:

• Seznam všech komponent ColdFusion definovaných na serveru.

• Pokud používáte aplikaci ColdFusion MX 7 nebo novější, filtrujte seznam tak, aby zobrazoval jen komponenty CFC umístěné ve složce webového místa.

• Zobrazte si funkce a argumenty jednotlivých komponent.

• Prohlédněte si vlastnosti funkcí, které slouží jako webové služby.

Pokud chcete komponentu CFC zobrazit v aplikaci Dreamweaver, postupujte takto:

Úpravy komponent CFC v aplikaci Dreamweaver

Aplikace Dreamweaver nabízí zjednodušenou možnost úprav kódu komponent ColdFusion definovaných pro webové místo. Můžete například přidat, upravit nebo odstranit funkci libovolné komponenty a neopustit přitom aplikaci Dreamweaver.

Tato funkce je k dispozici jen při níže popsaném nastavení vývojového prostředí:

• Aplikace ColdFusion musí běžet lokálně.

• V rozšířeném dialogovém okně Definice webového místa aplikace Dreamweaver musí být jako Typ přístupu v kategorii Testovací server nastavena možnost Lokální/síťový.

• V rozšířeném dialogovém okně Definice webového místa musí být nastavena stejná lokální kořenová složka jako je cesta složky testovacího serveru (například c:\Inetpub\wwwroot\cf_projects\myNewApp\). Tyto cesty můžete zkontrolovat a změnit výběrem volby Webové místo > Upravit webová místa.

• Komponenta musí být uložena ve složce lokálního webového místa nebo v jejích podsložkách na pevném disku.

Otevřete stránku ColdFusion v aplikaci Dreamweaver a zobrazte komponenty v panelu Komponenty. Pokud chcete zobrazit komponenty, otevřete panel Komponenty (Okna > Komponenty), vyberte z rozbalovací nabídky panelu Komponenty CF a klikněte na tlačítko Obnovit v panelu.

Vzhledem k tomu, že aplikace ColdFusion běží lokálně, aplikace Dreamweaver zobrazuje balíky komponent na vašem pevném disku.

Pokud chcete upravit komponentu, použijte následující postup.

Vytváření webových stránek, které používají komponenty CFC

Jednou z možností, jak na webových stránkách použít funkci komponenty, je napsat na stránku kód, který vyvolá funkci v okamžiku, kdy je stránka vyžádána. S psaním tohoto kódu vám může pomoci aplikace Dreamweaver.

Definice sady záznamů v CFC

Aplikace Dreamweaver vám může pomoci definovat sadu záznamů (také označovanou jako dotaz ColdFusion) v komponentě ColdFusion (CFC). Pokud definujete sadu záznamů v CFC, nemusíte definovat sadu záznamů na každé stránce, která ji používá. Sadu záznamů definujete jednou v CFC a CFC použijete na více stránkách.

Používání sady záznamů CFC jako zdroje dynamického obsahu

Komponentu ColdFusion (CFC) můžete použít jako zdroj dynamického obsahu pro vaše stránky, pokud komponenta obsahuje funkci, která definuje sadu záznamů.

Definice dynamického obsahu pomocí komponenty CFC

Sadu záznamů můžete v aplikaci Dreamweaver definovat jako zdroj dynamického obsahu pomocí komponenty CFC, která obsahuje definici sady záznamů.

1. V poli Název zadejte název sady záznamů CFC.

Běžnou praxí je přidávat k názvům sad záznamů prefix rs, aby je bylo v kódu možné odlišit od názvů jiných objektů, například: rsPressRelease.

Názvy sad záznamů smí obsahovat jen písmena, číslice a znaky podtržítka (_). Nemůžete použít speciální znaky ani mezery.

2. Vyberte jeden z balíků definovaných na serveru.

Pokud se balík nezobrazuje v rozbalovací nabídce, můžete seznam balíků obnovit kliknutím na tlačítko Obnovit u rozbalovací nabídky.

Nejdříve vždy nahrajte CFC na testovací server. Zobrazí se jen CFC na testovacím serveru.

3. Vyberte komponentu z komponent definovaných v právě vybraném balíku.

Pokud rozbalovací nabídka Komponenta neobsahuje žádné komponenty nebo pokud se v nabídce nezobrazí žádné z komponent, které jste vytvořili, je nutné soubory CFC nahrát na testovací server.

4. (Volitelně) Pokud chcete vytvořit komponentu, klikněte na tlačítko Vytvořit novou komponentu.

a. V rámečku Název zadejte název nové komponenty CFC. Název smí obsahovat jen písmena, číslice a znaky podtržítka (_).

b. V rámečku Složka komponenty zadejte umístění komponenty CFC nebo procházením vyhledejte požadovanou složku.

5. Z rozbalovací nabídky Funkce vyberte funkci, která obsahuje definici sady záznamů.

Rozbalovací nabídka Funkce obsahuje jen funkce definované v právě vybrané komponentě. Pokud tato rozbalovací nabídka nezobrazuje žádnou funkci nebo pokud právě zobrazené funkce neodpovídají změnám, které jste provedli, zkontrolujte, zda jste uložili poslední změny a nahráli soubory na server.

6. Jednotlivé parametry (typ, hodnota a standardní hodnota), které je funkci nutno předat jako argumenty, upravte kliknutím na tlačítko Upravit.

a. Hodnotu aktuálního parametru zadejte výběrem typu hodnoty z rozbalovací nabídky Hodnota a zadáním hodnoty do rámečku vpravo. Typ hodnoty může být parametr URL, proměnná formuláře, soubory cookie, proměnná relace, proměnná aplikace nebo zadaná hodnota.

b. V poli Výchozí hodnota zadejte výchozí hodnotu pro parametr. Pokud není vrácena hodnota za běhu, použije se standardní hodnota.

c. Klepněte na tlačítko OK.

Nemůžete měnit připojení k databázi a dotaz SQL u sadu záznamů. Tato pole jsou vždy nepřístupná – připojení a dotaz SQL se zobrazují jen pro informaci.

7. Klepnutím na tlačítko Testovat se připojíte k databázi a vytvoříte instanci sady záznamů.

Pokud výraz SQL obsahuje parametry stránky, zkontrolujte před kliknutím na tlačítko Test, zda sloupec Standardní hodnota v poli Parametry obsahuje platné testovací hodnoty.

Pokud dotaz proběhl úspěšně, tabulka zobrazí sadu záznamů. Každý řádek obsahuje jeden záznam a každý sloupec odpovídá jednomu poli v tomto záznamu.

Klepnutím na tlačítko OK vymažte dotaz CFC.

8. Klepněte na tlačítko OK.