Använda ColdFusion-komponenter i Dreamweaver

Om ColdFusion-komponenter

ColdFusion-komponentfiler (CFC) låter dig kapsla in applikations- och affärslogik i fristående, återanvändbara enheter.CFC:er tillhandahåller också ett snabbt, enkelt sätt att skapa webbtjänster.

En CFC är en återanvändbar mjukvaruenhet skriven i ColdFusion-märkspråket (CFML), vilket gör det enkelt att återanvända och underhålla din kod.

Du kan arbeta med CFC:er i Dreamweaver. För information om CFC-taggar och syntax, se ColdFusion-dokumentationen inifrån Dreamweaver (Hjälp > Använda ColdFusion).

CFC:er är avsedda att tillhandahålla ett enkelt men kraftfullt sätt för utvecklare att kapsla in delar av sina webbsidor.Generellt bör du använda komponenter för applikations- eller affärslogik.Använd anpassade taggar för presentationselement såsom anpassade hälsningar, dynamiska menyer och så vidare.

Som med många andra typer av konstruktion kan dynamiska webbsidor ofta dra nytta av utbytbara delar.Till exempel kan en dynamisk webbplats köra samma fråga upprepade gånger, eller beräkna det totala priset för kundvagnssidor och omberäkna det varje gång en artikel läggs till.Sådana åtgärder kan hanteras av komponenter. Du kan åtgärda, förbättra, utöka och till och med ersätta en komponent med minimal påverkan på resten av din applikation.

Anta att en online-butik beräknar fraktkostnader baserat på priset för beställningar.För beställningar under 20 $ är fraktkostnaden 4 $; för beställningar mellan 20 $ och 40 $ är fraktkostnaden 6 $, och så vidare.Du skulle kunna infoga logiken för att beräkna fraktkostnaden i både kundvagnssidan och kassasidan, men det skulle blanda HTML-presentationskod och CFML-logikkod och göra koden svår att underhålla och återanvända.

Du bestämmer dig för att skapa en CFC som heter Pricing som har, bland annat, en funktion som heter ShippingCharge.Funktionen tar ett pris som argument och returnerar en fraktkostnad.Till exempel, om värdet för argumentet är 32,80, returnerar funktionen 6.

I både kundvagn-sidan och kassan infogar du en speciell tagg för att anropa ShippingCharge-funktionen.När sidan begärs anropas funktionen och en fraktkostnad returneras till sidan.

Senare tillkännager butiken en speciell kampanj: kostnadsfri frakt för alla order över 100 $.Du gör ändringen av fraktkostnaderna på ett ställe—ShippingCharge-funktionen i Pricing-komponenten—och alla sidor som använder funktionen får automatiskt korrekta fraktkostnader.

Översikt över panelen Komponenter (ColdFusion)

Använd Components-panelen (Fönster > Components) för att visa och redigera ColdFusion-komponenter, och lägg till kod i sidan som anropar funktionen när CFM-sidan begärs.

Skapa eller ta bort en CFC i Dreamweaver

Du kan använda Dreamweaver när du vill definiera en CFC och dess funktioner visuellt. Dreamweaver skapar en .cfc-fil och infogar nödvändiga CFML-taggar åt dig.

Visa CFC:er i Dreamweaver

Med hjälp av Dreamweaver kan du visuellt undersöka de ColdFusion-komponenter (CFC:er) som finns i webbplatsmappen eller på servern. Dreamweaver läser CFC-filerna och visar information om dem i en lättnavigerad trädvy i panelen Komponenter.

Dreamweaver söker efter komponenterna på din testserver (se Ansluta till databasen i Dreamweaver). Om du skapar CFC:er eller förändrar befintliga CFC:er, måste du överföra CFC-filerna till testservern för att de ska återges korrekt på panelen Komponenter.

Om du vill visa komponenter på en annan server, ändrar du inställningarna för testservern.

Du kan visa följande information om dina CF-komponenter:

• En lista över alla ColdFusion-komponenter som definierats på servern.

• Om du använder ColdFusion MX 7 eller senare filtrerar du listan så att bara CFC:er i din webbplatsmapp visas.

• Utforska de olika komponenternas funktioner och argument.

• Granska egenskaperna för funktioner som fungerar som webbtjänster.

Så här visar du CFC:er i Dreamweaver:

Redigera CFC:er i Dreamweaver

Dreamweaver tillhandahåller ett strömlinjeformat sätt att redigera koden för ColdFusion-komponenterna som definieras för din plats.Du kan till exempel lägga till, ändra eller ta bort vilken komponentfunktion som helst utan att lämna Dreamweaver.

För att använda den här funktionen måste din utvecklingsmiljö vara inställd enligt följande:

• ColdFusion måste köras lokalt.

• I den avancerade dialogrutan för platsdefinition i Dreamweaver måste åtkomsttypen som anges i kategorin Testserver vara Lokal/nätverk.

• I den avancerade dialogrutan för platsdefinition måste vägen till din lokala rotmapp vara samma som vägen till testserverns mapp (till exempel c:\Inetpub\wwwroot\cf_projects\myNewApp\). Du kan granska och ändra dessa vägar genom att välja Plats > Redigera platser.

• Komponenten måste lagras i den lokala platsmappen eller någon av dess undermappar på hårddisken.

Öppna vilken ColdFusion-sida som helst i Dreamweaver och visa komponenterna i Components-panelen.För att visa komponenterna öppnar du panel Components (Fönster > Components), väljer CF Components från panelens popup-meny och klickar på knappen Uppdatera på panelen.

Eftersom ColdFusion körs lokalt visar Dreamweaver komponentpaket på din hårddisk.

Du redigerar en komponent med hjälp av följande procedur.

Bygga webbsidor som använder CFC:er

Ett sätt att använda en komponentfunktion på dina webbsidor är att skriva kod på en sida, som anropar funktionen när sidan begärs. Du kan använda Dreamweaver för att hjälpa dig skriva den här koden.

Definiera en postmängd i en CFC

Dreamweaver kan hjälpa dig att definiera en postmängd (kallas även för en ColdFusion-fråga) i en ColdFusion-komponent (CFC). Om du definierar en postmängd i CFC:n slipper du definiera den på alla sidor som använder den. Du definierar postmängden en gång i CFC:n och använder sedan CFC:n på olika sidor.

Använd en CFC-recordset som källa för dynamiskt innehåll

Om en ColdFusion-komponent (CFC) innehåller en funktion som definierar en postmängd, kan du använda komponenten som källa för dynamiskt innehåll på dina sidor.

Definiera dynamiskt innehåll med hjälp av en CFC

Du kan definiera en recordset som källa till dynamiskt innehåll i Dreamweaver genom att använda en CFC som innehåller en recordset-definition.

1. I rutan Namn anger du ett namn för CFC-postmängden.

En vanlig praxis är att lägga till prefixet rs till recordsetnamn för att skilja dem från andra objektnamn i koden, till exempel: rsPressRelease.

Namn på postmängder får bara bestå av alfanumeriska tecken och understreck (_). Du får inte använda specialtecken eller mellanslag.

2. Välj ett paket från de som redan är definierade på servern.

Om paketet inte visas på snabbmenyn, kan du uppdatera paketlistan genom att klicka på Uppdatera nära snabbmenyn.

Glöm inte att överföra dina CFC:er till testservern först. Endast CFC:er på testservern visas.

3.Välja en komponent från de som är definierade i det för närvarande valda paketet.

Om snabbmenyn Komponent inte innehåller några komponenter, eller om ingen av dina tidigare komponenter visas på menyn, överför du CFC-filerna till testservern.

4. (Valfritt) För att skapa en komponent klickar du på knappen Skapa ny komponent.

a. Ange namnet på den nya CFC:en i rutan Namn. Namnet får bara bestå av alfanumeriska tecken och understreck (_).

b.I rutan Komponentkatalog anger du platsen för din CFC, eller så bläddrar du för att hitta mappen.

5. I popup-menyn Funktion väljer du den funktion som innehåller postuppsättningens definition.

Snabbmenyn Funktion innehåller bara de funktioner som är definierade i den för närvarande markerade komponenten. Om ingen funktion visas på snabbmenyn, eller om dina senaste ändringar inte visas i de för närvarande visade funktionerna, kontrollerar du att dina senaste ändringar har sparats och överförts till servern.

6.Redigera varje parameter (typ, värde och standardvärde) som måste skickas som funktionsargument genom att klicka på knappen Redigera.

a. Ange ett värde för den aktuella parametern genom att markera värdetypen på snabbmenyn Värde och ange värdet i rutan till höger. Värdetypen kan vara en URL-parameter, en formulärvariabel, en cookie-fil, en sessionsvariabel, en programvariabel eller ett angivet värde.

b. Ange ett standardvärde för parametern i rutan Standardvärde. Om inget körtidsvärde returneras, används parameterns standardvärde.

c.Klicka på OK. 

Du kan inte förändra postmängdens databasanslutning eller SQL-fråga. De här fälten är alltid inaktiverade. Anslutningen och SQL-frågan visas bara i informationssyfte.

7.Klicka på Test för att ansluta till databasen och skapa en instans av postuppsättningen.

Om SQL-satsen innehåller sidparametrar, kontrollerar du att kolumnen Standardvärde i rutan Parametrar innehåller giltiga testvärden innan du klickar på Test.

Om frågan kördes utan fel visas postmängden i en tabell. Varje rad innehåller en post och varje kolumn motsvarar ett fält i posten.

Rensa CFC-frågan genom att klicka på OK.

8. Klicka på OK.