Korzystanie ze składników ColdFusion w programie Dreamweaver

Pliki składników ColdFusion (CFC) pozwalają na zapakowanie logiki biznesowej i aplikacyjnej w samodzielne jednostki wielokrotnego użytku. CFC pozwalają także na szybkie i łatwe tworzenie usług internetowych.

CFC jest modułem programowym wielokrotnego użytku, napisanym w języku poleceń ColdFusion (CFML), co pozwala na łatwe utrzymanie i ponowne wykorzystywanie kodu.

Program Dreamweaver może pracować z modułami CFC. Więcej informacji na temat znaczników i składni CFC można znaleźć w dokumentacji ColdFusion, dostępnej w programie Dreamweaver (Pomoc > Używanie składników ColdFusion).

Składniki CFC zostały pomyślane jako sposób na udostępnienie programistom prostej, ale bardzo efektywnej metody enkapsulacji elementów serwisów internetowych. Zasadniczo składników należy używać do tworzenia logiki biznesowej lub aplikacyjnej. Można skorzystać z niestandardowych znaczników, obsługujących elementy prezentacji takie jak dostosowane powitania, dynamiczne menu itp.

Tak jak w przypadku wielu innych typów konstrukcji, serwisy dynamiczne często korzystają z wymiennych elementów. Dynamiczny serwis może na przykład wielokrotnie używać tego samego zapytania do bazy lub obliczać całkowitą cenę koszyka zakupowego, przeliczając go za każdym razem, gdy zostanie dodana nowa pozycja. Te zadania mogą być obsługiwane przez składniki. Składnik można naprawić, ulepszyć, rozszerzyć lub nawet wymienić, a wpływ tych działań na resztę aplikacji będzie minimalny.

Wyobraźmy sobie, że sklep internetowy oblicza koszty wysyłki na podstawie wartości zamówień. Dla zamówień poniżej 20 USD koszty wysyłki wynoszą 4 USD, dla zakupów pomiędzy 20 a 40 USD koszty wysyłki wynoszą 6 USD i tak dalej. Można oczywiście wstawić logikę obliczającą koszty wysyłki zarówno na stronę z koszykiem, jak i na stronę płatności, ale takie podejście wymagałoby użycia kombinacji kodu prezentacji HTML i logiki CFML. Takie połączenie na ogół sprawia, że kod jest trudny w utrzymaniu i nie nadaje się do ponownego użycia.

Załóżmy, że postanowisz utworzyć składnik CFC o nazwie Wycena, który będzie zawierać między innymi funkcję ShippingCharge (opłata za dostawę). Funkcja ta przyjmuje cenę jako argument i zwraca koszt wysyłki. Jeśli wartość argumentu wynosi 32,80, funkcja zwróci np. wartość 6.

Zarówno na stronie koszyka jak i stronie płatności należy wstawić specjalny znacznik, który wywołuje funkcję ShippingCharge. Gdy serwer otrzyma żądanie wyświetlenia strony, wywoła tę funkcję, która zwróci wartość kosztu dostawy do pokazania na stronie.

Załóżmy, że sklep ogłosi potem specjalną promocję: darmowa wysyłka dla wszystkich zamówień powyżej 100 USD. Zmiany w sposobie naliczania ceny trzeba będzie wprowadzić tylko w jednym miejscu — w funkcji ShippingCharge składnika Wycena. Wszystkie strony korzystające z tej funkcji będą automatycznie naliczać prawidłowe koszty wysyłki.

Przegląd panelu Składniki (ColdFusion)

Panel Składniki (Okno > Składniki) służy do przeglądania i edycji składników ColdFusion oraz do dodawania kodu do stron, które wywołują funkcje podczas wykonywania strony CFM.

Tworzenie lub usuwanie składnika CFC w programie Dreamweaver

Za pomocą programu Dreamweaver można metodą graficzną definiować składniki CFC i ich funkcje. Program Dreamweaver tworzy plik .cfc i wstawia do niego niezbędne znaczniki CFML.

Wyświetlanie składników CFC w programie Dreamweaver

Program Dreamweaver umożliwia wizualną inspekcję składników CFC znajdujących się w folderze serwisu lub w dowolnym miejscu na serwerze. Dreamweaver wczytuje pliki CFC i wyświetla informacje na ich temat w łatwym do przeglądania drzewie w panelu Składniki.

Program Dreamweaver szuka składników na serwerze testowym (zobacz Łączenie się z bazą danych w programie Dreamweaver). Jeżeli utworzysz nowy składnik CFC lub wprowadzisz zmiany w już istniejącym składniku, wyślij nową wersję na serwer testowy, tak aby zmiany były widoczne w panelu Składniki.

Aby obejrzeć składniki umieszczone na innym serwerze, zmień ustawienia serwera testowego.

Możesz wyświetlić następujące informacje na temat składników CF:

• Lista wszystkich składników ColdFusion zdefiniowanych na serwerze.

• Jeśli korzystasz z wersji ColdFusion MX 7 lub nowszej, przefiltruj listę tak, aby pokazywała tylko składniki CFC znajdujące się w folderze serwisu.

• Eksploruj funkcje i argumenty każdego składnika.

• Przejrzyj właściwości funkcji, które służą jako usługi internetowe (Web Service).

Aby obejrzeć składniki CFC w programie Dreamweaver, wykonaj następujące kroki:

Edytowanie składników CFC w programie Dreamweaver

Program Dreamweaver umożliwia zoptymalizowaną edycję kodu składników ColdFusion zdefiniowanych dla serwisu. Można na przykład dodawać, zmieniać i usuwać dowolną funkcję składnika bez opuszczania programu Dreamweaver.

Aby skorzystać z tej możliwości, należy skonfigurować środowisko programistyczne w następujący sposób:

• Struktura ColdFusion musi być uruchomiona na komputerze lokalnym.

• W oknie dialogowym Definicja serwisu > Zaawansowane w programie Dreamweaver jako typ dostępu w kategorii Serwer testowy należy wybrać opcję Lokalnie/sieć.

• Ścieżka do lokalnego folderu głównego podana w zaawansowanym widoku okna Definicja serwisu musi być taka sama, jak ścieżka do jak do folderu serwera testowego (na przykład c:\Inetpub\wwwroot\cf_projects\myNewApp\). Możesz sprawdzić i zmodyfikować te ścieżki, wybierając polecenie Serwis > Edytuj serwisy.

• Składnik musi być zapisany w folderze serwisu lokalnego lub w dowolnym jego podfolderze na lokalnym dysku twardym.

Otwórz dowolną stronę ColdFusion w programie Dreamweaver i wyświetl składniki w panelu Składniki. Aby wyświetlić składniki, otwórz panel Składniki (Okno >Składniki), wybierz opcję Składniki CF z wyskakującego menu i kliknij przycisk Odśwież w panelu.

Ponieważ program ColdFusion jest uruchomiony na komputerze lokalnym, program Dreamweaver wyświetla pakiety składników znajdujące się na twardym dysku.

Skorzystaj z poniższej procedury, aby edytować składnik.

Budowanie stron internetowych, które korzystają ze składników CFC

Jednym ze sposobów wykorzystania funkcji składnika na stronie internetowej jest zaprogramowanie kodu strony, który wywoła tę funkcję w chwili, gdy pojawi się żądanie wyświetlenia strony. Program Dreamweaver ułatwia utworzenie takiego kodu.

Definiowanie zestawu rekordów w składniku CFC

Program Dreamweaver może ułatwić zdefiniowanie zestawu rekordów (zwanego także zapytaniem ColdFusion) w składniku CF (ColdFusion Component — CFC). Jeśli zdefiniujesz zestaw rekordów w składniku CFC, unikniesz konieczności definiowania tego zestawu na każdej stronie, która go używa. Swój zestaw rekordów definiujesz tylko raz, w składniku CFC, a następnie możesz z niego korzystać na różnych stronach.

Używanie zestawu rekordów CFC jako źródła dynamicznej treści

Składnika ColdFusion (CFC) można użyć jako źródła dynamicznej zawartości dla stron, pod warunkiem, że składnik zawiera funkcję definiującą zestaw rekordów.

Definiowanie zawartości dynamicznej za pomocą składnika CFC

Program Dreamweaver umożliwia zdefiniowanie zestawu rekordów jako źródła dynamicznej treści na podstawie składnika CFC, który zawiera definicję zestawu rekordów.

1. W polu Nazwa wpisz nazwę zestawu rekordów CFC.

Zwyczajową praktyką jest dodawanie przedrostka rs (ang. „recordset”) do nazwy zestawu rekordów, aby odróżnić go od nazw innych obiektów w kodzie; na przykład: rsPressRelease.

Nazwa może zawierać wyłącznie znaki alfanumeryczne i podkreślenia (_). Nie można używać znaków specjalnych ani spacji.

2. Wybierz pakiet spośród już zdefiniowanych na serwerze.

Jeżeli pakiet nie pojawia się w wyskakującym menu, możesz odświeżyć listę pakietów, klikając przycisk Odśwież obok wyskakującego menu.

Upewnij się, że składniki CFC zostały uprzednio wysłane na serwer testowy. Wyświetlane są tylko składniki CFC znajdujące się na serwerze testowym.

3. Wybierz jeden ze składników zdefiniowanych w aktualnie wybranym pakiecie.

Jeśli wyskakujące menu Składnik nie zawiera żadnych składników lub jeśli żaden z uprzednio zdefiniowanych składników nie pojawia się w menu, należy wysłać pliki CFC na serwer testowy.

4. (Opcjonalnie) Aby utworzyć składnik, kliknij przycisk Utwórz nowy składnik.

a. W polu tekstowym Nazwa wprowadź nazwę zestawu rekordów CFC. Nazwa może zawierać wyłącznie znaki alfanumeryczne i podkreślenia (_).

b. W polu Katalog składnika wpisz położenie składnika CFC lub przejdź do odpowiedniego folderu.

5. Z wyskakującego menu Funkcja wybierz funkcję, która zawiera definicję zestawu rekordów.

Menu Funkcja zawiera tylko funkcje zdefiniowane w aktualnie wybranym składniku. Jeśli w menu nie pojawia się żadna funkcja lub jeśli ostatnie zmiany nie zostały odzwierciedlone na liście funkcji, sprawdź, czy zmiany te zostały zapisane i wysłane na serwer.

6. Klikając przycisk Edycja, ustaw poszczególne parametry (podając typ, wartość oraz wartość domyślną), które muszą być przekazywane jako argumenty funkcji.

a. Wprowadź wartość bieżącego parametru, wybierając typ wartości z wyskakującego menu Wartość i wprowadzając odpowiednią wartość w polu tekstowym po prawej stronie. Typ wartości może być parametrem URL, zmienną formularza, zmienną cookie, zmienną sesji, zmienną aplikacji lub wprowadzoną wartością.

b. Wpisz domyślną wartość parametru w polu Domyślna wartość. Jeżeli w czasie wykonywania nie zostanie zwrócona żadna wartość, to użyta będzie wartość domyślna parametru.

c. Kliknij przycisk OK.

Nie można zmienić połączenia z bazą danych ani zapytania SQL zestawu rekordów. Te pola są zawsze nieaktywne — połączenie i zapytanie SQL są wyświetlane w celach informacyjnych.

7. Kliknij przycisk Testuj, aby połączyć się z bazą danych i utworzyć instancję zestawu rekordów.

Jeżeli wyrażenie SQL zawiera parametry strony, przed kliknięciem przycisku Testuj upewnij się, że kolumna „Domyślna wartość” w polu Parametry zawiera prawidłowe wartości testowe.

Jeżeli zapytanie zostało pomyślnie wykonane, tabela wyświetli zestaw rekordów. Każdy wiersz zawiera rekord, a każda kolumna odpowiada jednemu polu w tym rekordzie.

Kliknij przycisk OK, aby wyczyścić zapytanie CFC.

8. Kliknij przycisk OK.