Korzystanie ze składników ColdFusion w programie Dreamweaver

O składnikach ColdFusion

Pliki składników ColdFusion (CFC) umożliwiają hermetyzację logiki aplikacji i biznesowej w samowystarczalnych jednostkach wielokrotnego użytku. Składniki CFC zapewniają również szybki i łatwy sposób tworzenia usług internetowych.

CFC to jednostka oprogramowania wielokrotnego użytku napisana w języku znaczników ColdFusion (CFML), co ułatwia ponowne użycie i konserwację kodu.

Program Dreamweaver może pracować z modułami CFC. Informacje o znacznikach i składni CFC można znaleźć w dokumentacji ColdFusion w programie Dreamweaver (Pomoc > Using ColdFusion).

Składniki CFC mają zapewnić prosty, ale zarazem wydajny sposób hermetyzacji przez programistów elementów ich witryn internetowych. Na ogół składniki powinny być używane do logiki aplikacji lub biznesowej. Niestandardowe znaczniki należy stosować do elementów prezentacji, takich jak spersonalizowane powitania, dynamiczne menu itp.

Podobnie jak w przypadku wielu innych rodzajów konstrukcji, witryny dynamiczne często mogą skorzystać z wymienialnych części. Na przykład witryna dynamiczna może wielokrotnie uruchamiać to samo zapytanie lub obliczać łączną cenę stron koszyka zakupów i ponownie obliczać ją za każdym razem, gdy zostanie dodany element. Te zadania mogą być obsługiwane przez składniki. Można naprawić, ulepszyć, rozszerzyć, a nawet zastąpić składnik przy minimalnym wpływie na resztę aplikacji.

Załóżmy, że sklep internetowy oblicza opłaty za wysyłkę na podstawie ceny zamówień. W przypadku zamówień poniżej 20 $ opłata za wysyłkę wynosi 4 $; w przypadku zamówień między 20 $ a 40 $ opłata za wysyłkę wynosi 6 $ itd. Można wstawić logikę obliczania opłaty za wysyłkę zarówno na stronie koszyka zakupów, jak i na stronie realizacji transakcji, ale spowoduje to mieszanie kodu prezentacji HTML i kodu logiki CFML i generalnie utrudni konserwację i ponowne użycie kodu.

Decydujesz się utworzyć składnik CFC o nazwie Pricing, który ma między innymi funkcję o nazwie ShippingCharge.Funkcja przyjmuje cenę jako argument i zwraca opłatę za wysyłkę. Na przykład jeśli wartość argumentu wynosi 32,80, funkcja zwraca 6.

Zarówno na stronie koszyka zakupów, jak i na stronie realizacji transakcji należy wstawić specjalny znacznik wywołujący funkcję ShippingCharge. Gdy strona jest żądana, funkcja zostaje wywołana i opłata za wysyłkę zostaje zwrócona do strony.

Później sklep ogłasza specjalną promocję: bezpłatna wysyłka wszystkich zamówień powyżej 100 $. Zmiana stawek za wysyłkę zostaje wprowadzona w jednym miejscu — funkcji ShippingCharge składnika Pricing — a wszystkie strony korzystające z funkcji automatycznie otrzymują dokładne opłaty za wysyłkę.

Przegląd panelu Składniki (ColdFusion)

Użyj panel Składniki (Okno > Składniki), aby wyświetlić i edytować składniki ColdFusion oraz dodać kod na stronie, który wywołuje funkcję po zażądaniu 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. Dreamweaver tworzy plik .cfc i wstawia 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 odczytuje pliki CFC i wyświetla informacje o nich w łatwym do nawigowania widoku drzewa w panelu Components.

Dreamweaver szuka komponentów na serwerze testowym (zobacz Łączenie z bazą danych w programie Dreamweaver). Jeżeli utworzysz nowy CFC lub coś zmienisz w już istniejącym, wyślij nowa wersję do serwera testowe, tak, aby zmiany były widoczne w panelu Komponenty.

Aby obejrzeć Komponenty umieszczone na innym serwerze, zmień ustawienia serwera testowego.

Możesz obejrzeć następujące informacje na temat komponentów CF:

• Lista wszystkich komponentów ColdFusion zdefiniowanych na serwerze.

• Jeżeli korzystasz z ColdFusion MX 7 lub nowszego, odfiltruj listę tak, aby pokazywała tylko CFC znajdujące się w folderze twojego serwisu.

• Eksploruj funkcje i argumenty każdego komponentu.

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

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

Edytowanie składników CFC w programie Dreamweaver

Dreamweaver zapewnia uproszczony sposób edycji kodu komponentów ColdFusion zdefiniowanych dla witryny. Na przykład można dodawać, zmieniać lub usuwać każdą funkcję komponentu bez opuszczania programu Dreamweaver.

Aby korzystać z tej funkcji, środowisko programistyczne musi być skonfigurowane w następujący sposób:

• ColdFusion musi działać lokalnie.

• W zaawansowanym oknie dialogowym Definicja witryny w programie Dreamweaver typ dostępu określony w kategorii Serwer testowy musi być ustawiony na Lokalny/Sieciowy.

• W zaawansowanym oknie dialogowym Definicja witryny ścieżka lokalnego folderu głównego musi być taka sama jak ścieżka folderu serwera testowego (na przykład c:\Inetpub\wwwroot\cf_projects\myNewApp\).Można sprawdzić i zmienić te ścieżki, wybierając Witryna > Edytuj witryny.

• Komponent musi być przechowywany w folderze witryny lokalnej lub w którymkolwiek z jej podfolderów na dysku twardym.

Otwórz dowolną stronę ColdFusion w programie Dreamweaver i wyświetl komponenty w panelu Komponenty. Aby wyświetlić komponenty, otwórz panel Komponenty (Okno > Komponenty), wybierz Komponenty CF z menu podręcznego panelu i kliknij przycisk Odśwież na panelu.

Ponieważ program ColdFusion działa lokalnie, Dreamweaver wyświetla pakiety komponentów na dysku twardym.

Użyj poniższej procedury do edycji komponentu.

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. Można użyć programu Dreamweaver jako pomocy przy pisaniu tego 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. Definiujesz zestaw rekordów tylko raz w komponencie CFC, a następnie korzystasz z niego na różnych stronach.

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

Możesz użyć komponentu ColdFusion (CFC) jako źródła dynamicznej treści dla twoich stron, jeżeli tylko komponent zawiera funkcję definiującą zestaw rekordów.

Definiowanie zawartości dynamicznej przy użyciu komponentu CFC

Można zdefiniować zestaw rekordów jako źródło zawartości dynamicznej w programie Dreamweaver przy użyciu komponentu CFC zawierającego definicję zestawu rekordów.

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

Powszechną praktyką jest dodawanie przedrostka rs do nazw zestawów rekordów, aby odróżnić je od innych nazw 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 z tych 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ż poniżej wyskakującego menu.

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

3. Wybierz komponent z tych zdefiniowanych w aktualnie wybranym pakiecie.

Jeżeli wyskakujące menu Komponent nie zawiera żadnych komponentów lub kiedy żaden z uprzednio zdefiniowanych komponentów nie pojawia się w menu, należy wysłać pliki CFC na serwer testowy.

4. (Opcjonalnie) Aby utworzyć komponent, kliknij przycisk Utwórz nowy komponent.

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 komponentów wprowadź lokalizację komponentu CFC lub przeglądaj, aby znaleźć folder.

5.Z menu podręcznego Funkcja wybierz funkcję zawierającą definicję zestawu rekordów.

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

6.Edytuj każdy parametr (typ, wartość i wartość domyślną), który musi zostać przekazany jako argument funkcji, klikając przycisk Edytuj.

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 wartość wykonawcza nie jest zwracana, zostanie użyta domyślna wartość parametru.

c.Kliknij 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 Test, aby połączyć się z bazą danych i utworzyć instancję zestawu rekordów.

Jeżeli wyrażenie SQL zawiera parametry strony, przed kliknięciem Test upewnij się, że kolumna Domyślna wartość pola 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 OK.