Utilizzo di componenti ColdFusion in Dreamweaver

Informazioni sui componenti ColdFusion

I file componente ColdFusion (CFC) ti permettono di incapsulare la logica di business e dell'applicazione in unità autonome e riutilizzabili.I CFC offrono anche un modo veloce e semplice per creare servizi web.

Un CFC è un'unità software riutilizzabile scritta nel linguaggio di markup ColdFusion (CFML), che facilita il riutilizzo e la manutenzione del codice.

Dreamweaver supporta l'uso dei componenti CFC. Per informazioni sui tag e la sintassi CFC, consulta la documentazione ColdFusion da Dreamweaver (Aiuto > Uso di ColdFusion).

I CFC sono progettati per offrire agli sviluppatori un modo semplice ma potente di incapsulare elementi dei loro siti web.In generale, dovresti utilizzare i componenti per la logica applicativa o di business.Usa i tag personalizzati per elementi di presentazione come saluti personalizzati, menu dinamici e così via.

Come per molti altri tipi di costruzione, i siti dinamici possono spesso trarre vantaggio da parti intercambiabili.Ad esempio, un sito dinamico può eseguire la stessa query ripetutamente, o calcolare il prezzo totale delle pagine del carrello della spesa e ricalcolarlo ogni volta che viene aggiunto un articolo.Queste operazioni possono essere gestite dai componenti. Puoi correggere, migliorare, estendere e persino sostituire un componente con un impatto minimo sul resto dell'applicazione.

Supponiamo che un web store calcoli le spese di spedizione in base al prezzo degli ordini.Per ordini sotto i 20$, la spesa di spedizione è di 4$; per ordini tra 20$ e 40$, la spesa di spedizione è di 6$, e così via.Potresti inserire la logica per calcolare la spesa di spedizione sia nella pagina del carrello che in quella di checkout, ma ciò mescolarebbe il codice di presentazione HTML e il codice logico CFML rendendo generalmente il codice difficile da mantenere e riutilizzare.

Decidi di creare un CFC chiamato Pricing che ha, tra le altre cose, una funzione chiamata ShippingCharge.La funzione prende un prezzo come argomento e restituisce una spesa di spedizione.Ad esempio, se il valore dell'argomento è 32.80, la funzione restituisce 6.

Sia nella pagina del carrello che in quella di checkout, inserisci un tag speciale per richiamare la funzione ShippingCharge.Quando la pagina viene richiesta, la funzione viene richiamata e una spesa di spedizione viene restituita alla pagina.

Successivamente, il negozio annuncia una promozione speciale: spedizione gratuita per tutti gli ordini superiori a $ 100.Apporti la modifica alle tariffe di spedizione in un solo posto—la funzione ShippingCharge del componente Pricing—e tutte le pagine che utilizzano la funzione ottengono automaticamente spese di spedizione accurate.

Panoramica sul pannello Componenti (ColdFusion)

Utilizza il pannello Componenti (Finestra > Componenti) per visualizzare e modificare i componenti ColdFusion, quindi aggiungi il codice nella pagina che richiama la funzione quando viene richiesta la pagina CFM.

Creare o eliminare un CFC in Dreamweaver

Dreamweaver consente di definire visivamente un CFC e le relative funzioni. Dreamweaver crea un file .cfc e inserisce i tag CFML necessari.

Visualizzare i CFC in Dreamweaver

Dreamweaver consente di esaminare visivamente i componenti ColdFusion (CFC) che si trovano nella cartella del sito o sul server. Dreamweaver legge i file CFC e visualizza le relative informazioni in una struttura ad albero di facile consultazione nel pannello Componenti.

Dreamweaver cerca i componenti sul server di test (vedi Connessione al database in Dreamweaver). Se create nuovi CFC o modificate CFC esistenti, ricordatevi di caricare i file CFC corrispondenti sul server di prova, in modo che siano correttamente visualizzati nel pannello Componenti.

Per visualizzare componenti presenti su un altro server, modificate le impostazioni del server di prova.

Potete visualizzare le informazioni seguenti sui componenti CF:

• Elencate tutti i componenti ColdFusion definiti sul server.

• Se utilizzate ColdFusion MX 7 o successivo, filtrate l'elenco in modo da visualizzare solo i CFC che si trovano nella cartella del sito.

• Esplorate le funzioni e gli argomenti di ciascun componente.

• Analizzate le proprietà delle funzioni che fungono da servizi Web.

Per visualizzare i CFC in Dreamweaver, procedete nel modo seguente:

Modificare i CFC in Dreamweaver

Dreamweaver fornisce un modo semplificato per modificare il codice dei componenti ColdFusion definiti per il sito.Ad esempio, puoi aggiungere, cambiare o eliminare qualsiasi funzione del componente senza uscire da Dreamweaver.

Per utilizzare questa funzionalità, l'ambiente di sviluppo deve essere configurato come segue:

• ColdFusion deve essere eseguito localmente.

• Nella finestra di dialogo Definizione sito avanzata in Dreamweaver, il tipo di accesso specificato nella categoria Server di test deve essere Locale/Rete.

• Nella finestra di dialogo Definizione sede avanzata, il percorso della cartella principale locale deve essere uguale al percorso della cartella del server di test (ad esempio, c:\Inetpub\wwwroot\cf_projects\myNewApp\). Puoi esaminare e cambiare questi percorsi selezionando Sede > Modifica sedi.

• Il componente deve essere archiviato nella cartella del sito locale o in una delle sue sottocartelle sul disco rigido.

Apri qualsiasi pagina ColdFusion in Dreamweaver e visualizza i componenti nel pannello Componenti.Per visualizzare i componenti, apri il pannello Componenti (Finestra > Componenti), seleziona Componenti CF dal menu a comparsa del pannello e fai clic sul pulsante Aggiorna sul pannello.

Poiché ColdFusion è in esecuzione localmente, Dreamweaver visualizza i pacchetti dei componenti sul disco rigido.

Utilizzate la procedura seguente per modificare un componente.

Creare pagine Web che utilizzano i CFC

Un metodo per utilizzare una funzione di un componente in una pagina Web consiste nello scrivere del codice che richiami la funzione quando la pagina viene richiesta. Puoi usare Dreamweaver per aiutarti a scrivere questo codice.

Definire un recordset in un CFC

Dreamweaver può essere utilizzato per definire un recordset (noto anche come “query ColdFusion”) in un componente ColdFusion (CFC). Se definite un recordset in un CFC, non dovete definirlo su ogni pagina che lo utilizza, bensì è sufficiente definirlo una volta nel CFC e utilizzare il CFC su più pagine.

Usa un recordset CFC come origine di contenuto dinamico

Potete utilizzare un componente ColdFusion (CFC) come origine di contenuto dinamico per le pagine, se il componente contiene una funzione che definisce un recordset.

Definire contenuto dinamico usando un CFC

Puoi definire un recordset come origine di contenuto dinamico in Dreamweaver usando un CFC che contiene una definizione di recordset.

1.Nella casella Nome, inserisci un nome per il recordset CFC.

Una pratica comune è aggiungere il prefisso rs ai nomi dei recordset per distinguerli dagli altri nomi di oggetti nel codice, ad esempio: rsPressRelease.

I nomi di recordset possono contenere solo caratteri alfanumerici e trattini di sottolineatura (_). I nomi non possono contenere caratteri speciali o spazi.

2.Seleziona un pacchetto tra quelli già definiti sul server.

Se il pacchetto non compare nel menu a comparsa, potete aggiornare l'elenco dei pacchetti facendo clic sul pulsante Aggiorna accanto al menu.

Accertatevi di aver dapprima caricato i CFC sul server di prova. Solo i CFC che si trovano sul server di prova vengono visualizzati.

3.Seleziona un componente tra quelli definiti nel pacchetto attualmente selezionato.

Se il menu a comparsa Componente non contiene alcun componente, oppure se nessuno dei componenti creati in precedenza compare nel menu, caricate i file CFC sul server di prova.

4.(Facoltativo) Per creare un componente, fai clic sul pulsante Crea nuovo componente.

a. Nella casella Nome, inserite il nome del nuovo CFC. Il nome può contenere solo caratteri alfanumerici e trattini di sottolineatura (_).

b.Nella casella directory Componente, inserisci il percorso per il tuo CFC, oppure sfoglia per individuare la cartella.

5.Dal menu a comparsa Funzione, selezionare la funzione che contiene la definizione del recordset.

Il menu a comparsa Funzione contiene solo le funzioni definite nel componente attualmente selezionato. Se nel menu non compare alcuna funzione, oppure se le ultime modifiche non risultano applicate nelle funzioni elencate, controllate che le ultime modifiche siano state correttamente salvate e caricate sul server.

6. Modifica ogni parametro (tipo, valore e valore predefinito) che deve essere passato come argomento della funzione facendo clic sul pulsante Modifica.

a. Inserite un valore per il parametro corrente selezionando il tipo di valore dal menu a comparsa Valore e digitando il valore nella casella a destra. Il tipo di valore può essere un parametro URL, una variabile di modulo, un cookie, una variabile di sessione, una variabile di applicazione o un valore inserito.

b. Inserite un valore predefinito per il parametro nella casella Valore predefinito. Se non viene restituito un valore runtime, viene utilizzato il parametro predefinito.

c.Fare clic su OK. 

Non è possibile modificare la connessione di database e la query SQL per il recordset. Questi campi sono sempre disabilitati; il loro contenuto è visualizzato a solo scopo informativo.

7.Fare clic su Test per connettersi al database e creare un'istanza del recordset.

Se l'istruzione SQL contiene parametri di pagina, verificate che la colonna Valore predefinito della casella Parametri contenga valori di prova validi prima di fare clic su Prova.

Se la query è stata eseguita correttamente, viene visualizzata una tabella con il recordset. Ciascuna riga contiene un record, mentre ciascuna colonna rappresenta un campo del record.

Fate clic su OK per cancellare la query CFC.

8. Fai clic su OK.