Am sa va prezint in acest articol, un tag de ColdFusion care mi s-a parut foarte util. L-am descoperit in timp ce lucram la un mic demo care implica interogarea unei baze de date cu <cfquery>.
Pentru ca nu voiam sa ma complic, m-am gandit sa folosesc una din bazele de date care vine preinstalata cu ColdFusion. Problema este ca acestea sunt de tip Apache Derby si nu aveam nicio metoda sa le inspectez ca se le aflu structura.
Din fericire, cei de la Adobe s-au gandit si la asta cand au dezvoltat acest limbaj si ne-au pus la dispozitie un tag pe cat de util, pe atat de descriptiv. Se numeste <cfdbinfo> si a fost gandit pentru inspectarea atat a structurii unei baze de date cat si a tabelelor acesteia.
Tag-ul ia ca parametru un datasource (despre care vom vorbi intr-un articol viitor), plus alte cateva dupa cum urmeaza:
<cfdbinfo
datasource='data_source_name' // Datasource-ul
name='result_name' // Variabila in care va fi stocat rezultatul
type='dbnames|tables|columns|version|procedures|foreignkeys|index' // Ce vrem sa inspectam din baza de date
dbname='database_name' // Numele bazei de date
password='password' // Parola de la baza de date
pattern='filter pattern' // Eventuale filtre pe care dorim sa le aplicam
table='table_name' // Numele tabelei (daca am ales type=columns)
username='username'> // Username-ul pentru baza de date
Cel mai simplu mod de a inspecta o baza de date cu ajutorul lui <cfdbinfo> este acesta:
<cfdbinfo datasource='cfartgallery' name='cfart' type='Tables' /> <cfdump var='#cfart#' />
Unde cfartgallery este unul din datasource-urile care vin preinstalate cu ColdFusion. Tag-ul <cfdump> este folosit pentru a tirmite la ecran rezultatul lui <cfdbinfo>. Rezultatul arata asa:
Daca vreti o metoda mai eleganta de a afisa aceasta informatie, puteti folosi un alt tag din ColdFusion, care stie sa ia ca parametru o structura ca cea pe care o intoarce <cfdump>. Este vorba de <cfgrid>.
<cfdbinfo datasource='cfartgallery' name='cfart' type='Tables' /> <cfform> <cfgrid name='gInfo' query='cfart' format='html' /> </cfform>
Veti observa ca <cfgrid> este inauntru unui alt tag, numit <cfform> care este obligatoriu. Asta pentru ca <cfgrid> vine si cu optiuni CRUD via AJAX, iar pentru ca ele sa mearga, <cfform> este neaparat necesar. Rezultatul va arata asa:
Cam atat pentru acest articol. Sper ca este un inceput bun pentru o serie de articole care au ca scop sa demonstreze de ce ColdFusion este un limbaj atat de versatil si util.