milus.it

Sto scrivendo una serie di articoli per il framework CFWheels sulla falsariga di quelli scritti da Dan Wilson per Model Glue:Unity. Questo articolo corrisponde a questo suo post. Creeremo un’applicazione per la gestione di contatti partendo da zero. Se non hai ancora installato CFWheels leggi questo post.

La nostra applicazione risiederà nella root e sarà raggiungibile all’indirizzo http://localhost. Per prima cosa analizzeremo i file installati da CFWheels, poi parleremo di Request Handling (gestione delle richieste) e di URL Rewriting (riscrittura delle URL).

CFWheels è un framework basato su Ruby on Rails che porta anche in ColdFusion la possibilità di utilizzare Convenzioni e non configurazioni.

Struttura delle directory

Guardiamo le directory principali (o quelle che io considero tali…). Queste cartelle sono direttamente nella root. Qui puoi trovare una lista completa dei file e delle cartelle installate da CFWheels.

wheels – è la cartella più importante e quella che probabilmente non dovrai mai toccare. E’ il cuore del framework. In caso di aggiornamento dovrai semplicemente copiare la nuova versione di questa cartella nella webroot sovrascrivendo quella già presente.

controllers – è il cervello della nostra applicazione. Decide quali modelli (models) verranno utilizzati per richiamare i dati dal database e quali viste (view) verranno utilizzate per presentarli all’utente. Si tratta di file cfc.

models – definiscono come i dati verranno letti e scritti sul database. CFWheels crea degli oggetti che rappresentano i dati del nostro database. Anche questi sono file cfc.

views – sono le pagine web che gli utenti visualizzeranno sul loro browser. Questi sono file cfm.

config – è la cartella contenente i file di configurazione. Puoi sovrascrivere qualche convenzione qui. Sovrascrivere le convenzioni? Sì sì, CFWheels prova a semplificarci la vita, così ci possiamo concentrare sulle cose importanti, ma ci lascia comunque molta flessibilità se lo vogliamo. Imposteremo qui alcune cose come routes (URL personalizzate), il tipo di ambiente in cui ci troviamo (sviluppo, produzione, ecc.) e probabilmente la connessione ad un database.

images – le immagini andranno qui e solo qui. Ricordi? Nessuna decisione da prendere, concentrati sulle cose importanti.

javascripts – i file javascript andranno qui. Stessa cosa, nessun pensiero, semplice no?

stylesheets – i file css devono essere inseriti in questa cartella. Rilassati e goditi le convenzioni al posto delle configurazioni.

Request Handling – la gestione delle richieste

CFWheels collega le richieste al tuo codice. Pensa a qualcosa simil-REST. CFWheels utilizzerà una specie di “riscrittura parziale delle URL” per accedere alla tua applicazione. Nel caso dell’applicazione per la gestione dei contatti, l’URL potrebbe essere qualcosa come: http://localhost/index.cfm/contact/list. Questo visualizzerà una lista di contatti. Tieni presente che, se il tuo server non supporta la direttiva cgi.path_info, potresti invece vedere una URL come questa: http://localhost/index.cfm?controller=contact&action=list.

URL Rewriting – la riscrittura delle URL

La riscrittura parziale delle URL non è male, ma non sarebbe meglio avere un indirizzo così: http://localhost/contact/list ? Riscrivere le URL in questo modo è possibile su Apache o IIS ma non su web services basati su JRUN o Tomcat. Mi dispiace, ma non abbatterti, potrai comunque continuare ad utilizzare le convenzioni al posto delle configurazioni!

Per capire come impostare la riscrittura delle URL, leggi questo articolo.

Per aggiungere un filtro ISAPI in IIS 7, leggi invece questo articolo. Controlla di passare al filtro ISAPI nella finestra “impostazioni e personalizzazioni (settings and customization)”.

Nel prossimo articolo aggiungeremo qualche funzionalità alla nostra applicazione.

Per aiutare CFWheels a crescere, puoi pubblicare i tuoi progressi nel CFWheels Google Group. In questo modo potrai chiedere aiuto in caso di difficoltà o aiutare gli altri con la tua esperienza. Inserisci sempre sistema operativo, web server e versione di CFWheels nel titolo del post. Controlla anche se qualcuno prima di te ha fatto una richiesta simile o ha avuto gli stessi problemi.

Questa è una traduzione dall’inglese dell’articolo So you want to install CFWheels? di Mike Henke.
La traduzione è stata autorizzata dall’autore. Il copyright rimane dell’autore e di Dan Wilson da cui è partita l’idea della serie “So you want…”.