Dodawanie własnych zachowań serwerowych w programie Dreamweaver

Informacje o własnych zachowaniach serwerowych

Program Dreamweaver zawiera zestaw wbudowanych zachowań serwera, które umożliwiają łatwe dodawanie dynamicznych funkcji do witryny. Funkcjonalność programu Dreamweaver można rozszerzyć, tworząc zachowania serwera dostosowane do potrzeb programistycznych lub pobierając zachowania serwera z witryny Dreamweaver Exchange.

Przed utworzeniem własnych zachowań serwera sprawdź witrynę Dreamweaver Exchange, aby zobaczyć, czy inna strona już ucrzała zachowanie serwera zapewniające funkcjonalność, którą chcesz dodać do swojej witryny. Często programista zewnętrzny utworzył i przetestował zachowanie serwera, które zaspokoi Twoje potrzeby.

Dostęp do serwisu Dreamweaver Exchange

Zainstaluj zachowanie serwera lub inne rozszerzenie w programie Dreamweaver

Obieg pracy przy tworzeniu własnych zachowań serwerowych

Jeśli jesteś programistą internetowym biegłym w ColdFusion, JavaScript, VBScript lub PHP, możesz napisać własne zachowania serwera. Kroki tworzenia zachowania serwera obejmują następujące zadania:

• Napisz jeden lub więcej bloków kodu, które wykonują wymagane działanie.

• Określ, gdzie blok kodu powinien zostać wstawiony w kodzie HTML strony.

• Jeśli zachowanie serwera wymaga określenia wartości parametru, utwórz okno dialogowe, które poprosi programistę internetowego stosującego zachowanie o podanie odpowiedniej wartości.

• Przetestuj zachowanie serwerowe zanim udostępnisz je innym.

Korzystanie z Konstruktora zachowań serwerowych

Użyj narzędzia Server Behavior Builder, aby dodać blok lub bloki kodu, które zachowanie wstawia do strony.

Opcje zaawansowane

Po określeniu kodu źródłowego i lokalizacji wstawiania dla każdego bloku kodu zachowanie serwera jest całkowicie zdefiniowane. W większości przypadków nie trzeba określać żadnych dodatkowych informacji.

Jeśli jesteś zaawansowanym użytkownikiem, możesz ustawić dowolną z następujących opcji:

Określa, czy blok kodu powinien być traktowany jako identyfikator.

Domyślnie każdy blok kodu jest identyfikatorem. Jeśli program Dreamweaver znajdzie blok kodu identyfikatora gdziekolwiek w dokumencie, wyświetli zachowanie w panelu Zachowania serwera.Użyj opcji Identyfikator, aby określić, czy blok kodu powinien być traktowany jako identyfikator.

Co najmniej jeden z bloków kodu zachowania serwera musi być identyfikatorem. Blok kodu nie powinien być identyfikatorem, jeśli spełniony jest jeden z następujących warunków: ten sam blok kodu jest używany przez inne zachowanie serwera lub blok kodu jest tak prosty, że może wystąpić naturalnie na stronie.

Określa tytuł zachowania w panelu Zachowania serwerowe.

Gdy projektant strony kliknie przycisk Plus (+) na panelu Zachowania serwera, tytuł nowego zachowania serwera pojawi się w menu podręcznym. Gdy projektant zastosuje instancję zachowania serwera do dokumentu, zachowanie pojawi się na liście zastosowanych zachowań w panelu Zachowania serwera.Użyj pola Tytuł zachowania serwera, aby określić zawartość menu podręcznego Plus (+) i listy zastosowanych zachowań.

Wartość początkowa w polu to nazwa podana w oknie dialogowym Nowe zachowanie serwera. W miarę definiowania parametrów nazwa jest automatycznie aktualizowana, tak aby parametry pojawiały się w nawiasach po nazwie zachowania serwera.

Ustaw zmienną sesji (@@Name@@, @@Value@@)

Jeśli użytkownik zaakceptuje wartość domyślną, wszystko przed nawiasami pojawi się w menu podręcznym Plus (+) (na przykład Ustaw zmienną sesji). Nazwa wraz z parametrami pojawi się na liście zastosowanych zachowań — na przykład Ustaw zmienną sesji ("abcd", "5").

Określa, który blok kodu zostanie wybrany, gdy użytkownik wybierze zachowanie w panelu Zachowania serwera.

Po zastosowaniu zachowania serwera jeden z bloków kodu w ramach tego zachowania zostaje wyznaczony jako „blok kodu do wybrania". Jeśli zastosujesz zachowanie serwera, a następnie wybierzesz zachowanie w panelu Zachowania serwera, wyznaczony blok zostanie wybrany w oknie Dokument.Domyślnie program Dreamweaver wybiera pierwszy blok kodu, który nie znajduje się powyżej znacznika html.Jeśli wszystkie bloki kodu znajdują się nad znacznikiem html, wybierany jest pierwszy z nich. Zaawansowani użytkownicy mogą określić, który blok kodu jest wybrany.

Tworzenie bloków kodu

Bloki kodu utworzone w narzędziu Server Behavior Builder są hermetyzowane w zachowaniu serwera, które pojawia się w panelu Server Behaviors. Kod może być dowolnym prawidłowym kodem środowiska uruchomieniowego dla określonego modelu serwera. Na przykład, jeśli wybierzesz ColdFusion jako typ dokumentu dla niestandardowego zachowania serwera, napisany kod musi być prawidłowym kodem ColdFusion działającym na serwerze aplikacji ColdFusion.

Bloki kodu można utworzyć bezpośrednio w konstruktorze zachowań serwera lub skopiować i wkleić kod z innych źródeł. Każdy blok kodu utworzony w konstruktorze zachowań serwera musi być pojedynczym znacznikiem lub blokiem skryptu. W przypadku konieczności wstawienia wielu bloków znaczników należy je podzielić na osobne bloki kodu.

Warunki w blokach kodu

Dreamweaver pozwala tworzyć bloki kodu zawierające instrukcje kontrolne wykonywane warunkowo. Kreator zachowań serwera używa instrukcji if, elseif i else i może również zawierać parametry zachowania serwera. Umożliwia to wstawianie alternatywnych bloków tekstu na podstawie wartości relacji LUB pomiędzy parametrami zachowania serwera.

Poniższy przykład pokazuje instrukcje if, elseif i else. Nawiasy kwadratowe ([ ]) oznaczają kod opcjonalny, a gwiazdka (*) oznacza zero lub więcej wystąpień. Aby wykonać część bloku kodu lub cały blok kodu tylko wtedy, gdy spełniony jest określony warunek lub warunki, użyj następującej składni:

<@ if (wyrażenie1) @> tekst

warunkowy1[<@ elseif (wyrażenie2) @> tekst warunkowy2]*[<@ else @>

tekst warunkowy3]<@ endif @>

Wyrażenia warunkowe mogą być dowolnymi wyrażeniami JavaScript, które można ocenić za pomocą funkcji JavaScript eval() i mogą zawierać parametr zachowania serwera oznaczony przez @@. (Znaki @@ odróżniają parametr od zmiennych i słów kluczowych JavaScript.)

Efektywne stosowanie wyrażeń warunkowych

Podczas używania dyrektyw if, else i elseif w tagu XML insertText, tekst uczestnika jest przetwarzany wstępnie w celu rozpoznania dyrektyw if i określenia, który tekst uwzględnić w wyniku.Dyrektywy if i elseif przyjmują wyrażenie jako argument. Wyrażenie warunkowe jest takie samo jak w przypadku wyrażeń warunkowych JavaScript i może również zawierać parametry zachowania serwera. Dyrektywy takie jak ta pozwalają wybrać między alternatywnymi blokami kodu na podstawie wartości lub relacji między parametrami zachowania serwera.

Na przykład następujący kod JSP pochodzi z zachowania serwera Dreamweaver, które używa warunkowego bloku kodu:

@@rsName@@.close();

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

@@callableName@@.execute();

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

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

<@ endif @>

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

Warunkowy blok kodu rozpoczyna się od <@ if (@@callableName@@ != '') @> i kończy się <@ endif @>. Zgodnie z kodem, jeśli użytkownik wprowadzi wartość parametru @@callableName@@ w oknie dialogowym Parametr zachowania serwera — innymi słowy, jeśli wartość parametru @@callableName@@ nie jest pusta, lub (@@callableName@@ != '') — wtedy warunkowy blok kodu jest zastępowany następującymi instrukcjami:

@@callableName@@.execute();

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

W przeciwnym razie blok kodu jest zastępowany następującą instrukcją:

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

Określanie położenia bloku kodu

Podczas tworzenia bloków kodu za pomocą Konstruktora zachowań serwera musisz określić, gdzie wstawić je w kodzie HTML strony.

Na przykład, jeśli wstawisz blok kodu powyżej otwierającego tagu <html>, musisz następnie określić pozycję bloku kodu względem innych tagów, skryptów i zachowań serwera w tej sekcji kodu HTML strony. Typowe przykłady obejmują pozycjonowanie zachowania przed lub po wszelkich zapytaniach zestawu rekordów, które mogą również istnieć w kodzie strony powyżej otwierającego tagu <html>.

Gdy wybierzesz opcję pozycjonowania z menu podręcznego Wstaw kod, opcje dostępne w menu podręcznym Pozycja względna zmieniają się, aby dostarczyć odpowiednie opcje dla tej części strony. Na przykład, jeśli wybierzesz Powyżej tagu <html> w menu podręcznym Wstaw kod, opcje pozycjonowania dostępne w menu podręcznym Pozycja względna odzwierciedlają wybory odpowiednie dla tej części strony.

Poniższa tabela pokazuje opcje wstawiania bloków kodu oraz opcje pozycjonowania względnego dostępne dla każdej z nich:

Aby określić niestandardową pozycję, musisz przypisać wagę do bloku kodu.Użyj opcji Pozycja niestandardowa, gdy musisz wstawić więcej niż jeden blok kodu w określonej kolejności. Na przykład, aby wstawić uporządkowaną serię trzech bloków kodu po blokach kodu, które otwierają zestawy rekordów, wprowadź wagę 60 dla pierwszego bloku, 65 dla drugiego i 70 dla trzeciego.

Domyślnie Dreamweaver przypisuje grubość 50 wszystkim blokom kodu otwierającym zestaw rekordów wstawionym nad znacznikiem <html>. Jeśli grubość dwóch lub więcej bloków jest taka sama, Dreamweaver losowo ustawia kolejność między blokami.

Pozycjonowanie bloku kodu (ogólne instrukcje)

Pozycjonowanie bloku kodu względem innego znacznika na stronie

Pozycjonowanie bloku kodu względem znacznika wybranego przez projektanta strony

Powtarzanie bloków kodu za pomocą dyrektywy loop

Aby powtórzyć część bloku kodu lub cały blok kodu określoną liczbę razy, użyj następującej składni:

<@ loop (@@param1@@,@@param2@@) @> kod

blok<@ endloop @>

Podczas tworzenia zachowań serwera można użyć konstrukcji pętli do powtarzania bloku kodu określoną liczbę razy. <@ loop (@@param1@@,@@param2@@,@@param3@@,@@param_n@@) @> blok kodu <@ endloop @>Dyrektywa loop przyjmuje rozdzieloną przecinkami listę tablic parametrów jako argumenty. W tym przypadku argumenty tablicy parametrów pozwalają użytkownikowi podać wiele wartości dla jednego parametru. Powtarzający się tekst jest duplikowany n razy, gdzie n to długość argumentów tablicy parametrów. Jeśli określono więcej niż jeden argument tablicy parametrów, wszystkie tablice muszą mieć tę samą długość. Podczas i-tej iteracji pętli i-ty element tablic parametrów zastępuje powiązane wystąpienia parametrów w bloku kodu.

Podczas tworzenia okna dialogowego dla zachowania serwera można dodać kontrolkę do okna dialogowego, która pozwala projektantowi strony tworzyć tablice parametrów. Dreamweaver zawiera prostą kontrolkę tablicy, której można użyć do tworzenia okien dialogowych. Ta kontrolka, nazywana Text Field Comma Separated List, jest dostępna za pośrednictwem Server Behavior Builder.Aby utworzyć elementy interfejsu użytkownika o większej złożoności, zobacz dokumentację API, aby utworzyć okno dialogowe z kontrolką do tworzenia tablic (na przykład kontrolkę siatki).

Można zagnieżdżać dowolną liczbę warunków lub dyrektywę pętli w dyrektywie warunkowej. Na przykład można określić, że jeśli wyrażenie jest prawdziwe, należy wykonać pętlę.

Poniższy przykład pokazuje, jak takie powtarzające się bloki kodu mogą być używane do tworzenia zachowań serwera (przykład to zachowanie ColdFusion używane do dostępu do procedury składowanej):

<@ loop (@@param1@@,@@param2@@,@@param3@@,@@param_n@@) @> blok kodu

<@ 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>

W tym przykładzie znacznik CFSTOREDPROC może zawierać zero lub więcej znaczników CFPROCPARAM. Jednakże bez wsparcia dla dyrektywy loop nie ma możliwości dołączenia znaczników CFPROCPARAM w ramach wstawianego znacznika CFSTOREDPROC.Gdyby miało to zostać utworzone jako zachowanie serwera bez użycia dyrektywy loop, trzeba by podzielić ten przykład na dwóch uczestników: główny znacznik CFSTOREDPROC oraz znacznik CFPROCPARAM, którego typem uczestnika jest multiple.

Używając dyrektywy loop, można zapisać tę samą procedurę w następujący sposób:

<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>

Jeśli użytkownik wprowadzi następujące wartości parametrów w oknie dialogowym 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"]

Zachowanie serwera wstawi następujący kod czasu wykonania na stronie:

<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>

Korzystanie ze zmiennych _length oraz _index w dyrektywie LOOP

Dyrektywa pętli obejmuje dwie zmienne wbudowane, których można używać w osadzonych warunkach if. Są to następujące zmienne: _length oraz _index. Zmienna _length określa długość tablic przetwarzanych przez dyrektywę pętli, a zmienna _index określa bieżący indeks dyrektywy pętli.Aby upewnić się, że zmienne są rozpoznawane tylko jako dyrektywy, a nie jako rzeczywiste parametry do przekazania do pętli, nie umieszczaj żadnej zmiennej w @@.

Przykładem użycia zmiennych wbudowanych jest ich zastosowanie do atrybutu import dyrektywy strony. Atrybut import wymaga oddzielenia pakietów przecinkami. Jeśli dyrektywa loop rozciąga się wokół całego atrybutu import, wyświetlisz tylko nazwę atrybutu import= podczas pierwszej iteracji pętli — obejmuje to zamykający cudzysłów podwójny (") — i nie wyświetlisz przecinka podczas ostatniej iteracji pętli. Używając zmiennej wbudowanej, można to wyrazić w następujący sposób:

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

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

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

<@ endif @>

<@endloop@>

Żądaj parametru dla zachowania serwera

Zachowania serwera często wymagają, aby projektant strony podał wartość parametru.Ta wartość musi zostać wstawiona przed wstawieniem kodu zachowania serwera na stronę.

Okno dialogowe można utworzyć, definiując parametry dostarczone przez projektanta w kodzie.Następnie generujesz okno dialogowe dla zachowania serwera, które pyta projektanta strony o wartość parametru.

Zdefiniuj parametr w kodzie zachowania serwera

Możesz również zaznaczyć ten ciąg znaków i kliknąć przycisk Wstaw parametr w bloku kodu. Wpisz nazwę parametru i kliknij przycisk OK. Program Dreamweaver zastąpi każde wystąpienie zaznaczonego ciągu podaną nazwą parametru, otoczoną symbolami.

Program Dreamweaver używa ciągu, który można otoczyć symbolami parametru, do opisania formantów w generowanym oknie dialogowym (zobacz poniższą procedurę). W poprzednim przykładzie program Dreamweaver tworzy okno dialogowe z następującą etykietą:

Utwórz okno dialogowe dla zachowania serwera w celu żądania wartości parametru

Wyświetlanie okna dialogowego

Edytuj okno dialogowe utworzone dla zachowania serwera

Edytowanie i modyfikowanie zachowań serwerowych

Możesz edytować każde zachowanie serwera utworzone za pomocą Kreatora zachowań serwera, w tym zachowania serwera pobrane z witryny Dreamweaver Exchange i od innych zewnętrznych programistów.

Jeśli zastosujesz zachowanie serwera do strony, a następnie edytujesz zachowanie w Dreamweaver, wystąpienia starego zachowania nie są już wyświetlane w panelu Zachowania serwera.Panel Zachowania serwera przeszukuje stronę w poszukiwaniu kodu, który odpowiada kodowi znanych zachowań serwera.Jeśli kod zachowania serwera ulegnie zmianie, panel nie rozpoznaje wcześniejszych wersji zachowania na tej stronie.

Zachowaj stare i nowe wersje zachowania w panelu

Edytuj kod zachowania serwera utworzonego za pomocą Kreatora zachowań serwera

Wytyczne dotyczące kodowania

Ogólnie rzecz biorąc, kod zachowania serwera powinien być zwięzły i niezawodny.Programiści aplikacji internetowych są bardzo wrażliwi na kod dodawany do ich stron.Stosuj ogólnie akceptowane praktyki kodowania w języku właściwym dla typu dokumentu (ColdFusion, JavaScript, VBScript lub PHP).Pisząc komentarze, weź pod uwagę różne grupy techniczne, które mogą potrzebować zrozumieć kod, takie jak projektanci stron internetowych i interakcji lub inni programiści aplikacji internetowych.Dołącz komentarze, które dokładnie opisują cel kodu i wszelkie specjalne instrukcje dotyczące dołączania go na stronie.

Pamiętaj o następujących wytycznych dotyczących kodowania podczas tworzenia zachowań serwera:

Wymagania importu. Kod zachowania serwera powinien w sposób elegancki obsługiwać przypadki błędów.Postaraj się przewidzieć wszystkie potencjalne problemy. Na przykład, co jeśli żądanie parametru nie powiedzie się?Co jeśli z zapytania nie zostaną zwrócone żadne rekordy?

Pomaga zapewnić, że kod jest jasno identyfikowalny i unika kolizji nazw z istniejącym kodem. Na przykład, jeśli strona zawiera funkcję o nazwie hideLayer() i zmienną globalną o nazwie ERROR_STRING, a zachowanie serwera wstawia kod, który również używa tych nazw, zachowanie serwera może być w konflikcie z istniejącym kodem.

Pozwalają identyfikować własne funkcje czasu wykonywania i zmienne globalne na stronie. Można np. użyć własnych inicjałów. Nigdy nie używaj prefiksu MM_, ponieważ jest zarezerwowany wyłącznie do użytku przez Dreamweaver. Dreamweaver poprzedza wszystkie funkcje i zmienne globalne prefiksem MM_, aby zapobiec ich konfliktowi z dowolnym kodem, który napiszesz.

var MM_ERROR_STRING = "...";

function MM_hideLayer() {

aby kod, który piszesz, nie przypominał zbyt mocno kodu w innych blokach. Jeśli blok kodu zbyt bardzo przypomina inny blok kodu na stronie, panel Zachowania serwera może błędnie zidentyfikować pierwszy blok kodu jako instancję drugiego bloku kodu (lub odwrotnie). Prostym rozwiązaniem jest dodanie komentarza do bloku kodu, aby uczynić go bardziej unikalnym.

Testowanie zachowań serwerowych

Dreamweaver Exchange zaleca wykonywanie następujących testów dla każdego tworzonego zachowania serwera:

• Zastosuj to zachowanie za pomocą panelu Zachowania serwerowe. Jeśli ma okno dialogowe, wprowadź prawidłowe dane w każdym polu i kliknij OK. Sprawdź, czy podczas stosowania zachowania nie występują błędy. Sprawdź, czy kod czasu wykonywania dla zachowania serwera pojawia się w Inspektorze kodu.

• Zastosuj zachowanie serwera ponownie i wprowadź nieprawidłowe dane w każdym polu okna dialogowego. Spróbuj zostawić pole puste, używając dużych lub ujemnych liczb, używając nieprawidłowych znaków (takich jak /, ?, :, *, itd.), i używając liter w polach numerycznych. Można pisać procedury walidacji formularzy do obsługi nieprawidłowych danych (procedury walidacji wymagają ręcznego kodowania, co wykracza poza zakres tej książki).

  Po pomyślnym zastosowaniu zachowania serwera na stronie, sprawdź następujące rzeczy:

• Sprawdź panel Zachowania serwera, aby upewnić się, że nazwa zachowania serwera pojawia się na liście zachowań dodanych do strony.

• Jeśli dotyczy, sprawdź, czy ikony skryptów po stronie serwera pojawiają się na stronie. Standardowe ikony skryptów serwerowych to złote tarcze. Aby zobaczyć ikony, włącz Elementy niewidoczne (Widok > Pomocniki wizualne > Elementy niewidoczne).

• W widoku Kod (Widok > Kod) upewnij się, że nie jest generowany nieprawidłowy kod.

  Dodatkowo, jeśli zachowanie serwera wstawia kod w dokumencie ustanawiający połączenie z bazą danych, utwórz testową bazę danych do testowania kodu wstawionego w dokumencie. Sprawdź połączenie, definiując zapytania, które zwracają różne zestawy danych i różne rozmiary zestawów danych.

  Na koniec prześlij stronę na serwer i otwórz ją w przeglądarce. Wyświetl kod źródłowy HTML strony i sprawdź, że żaden nieprawidłowy kod HTML nie został wygenerowany przez skrypty po stronie serwera.