Written by Stilgar Aprile 22, 2012, 02:57:00 pm21804 ViewsRating: 0 (0 Rates)Print
Ciao a tutti.
Mi cimento per la prima volta a scrivere un articolo, quindi abbiate pietà di me :D
Bando alle ciancie.
Con questa primo articolo mi prefiggo di rendervi autonomi nel lancio delle query per interrogare il DB.
Transazioni e modifiche dei dati saranno oggetto di un'altro articolo, per evitare di mettere troppa carne al fuoco sin da subito.
ZEOS è una libreria molto potente nel suo insieme, spesso la si usa come alternativa ai driver Express Borland/Codegear/Embarcadero.
La paragono a DBExpress visto che cambiando qualche parametro, si cambia il DB Engine target dell'applicazione. Le altre soluzioni prevedono il cambio di componenti di connettività (se va bene, solo quelli).
I componenti di connettivita e data aware di VCL/LCL coprono la maggior parte delle esigenze per le applicazioni classiche.
ZEOS permette di gestire agilmente anche le situazioni non proprio ortodosse.
In questo articolo, cercherò di fare una panoramica su come utilizzare ZEOS in modo ... low level programming, se mi passate l'espressione, in modo da poter gestire queste situazioni.
Chi lo ha installato su Lazarus ha notato che ci sono diversi pacchetti che vengono compilati, ma solo uno viene installato, per l'appunto zcomponent.lpk.
Questo pacchetto dipende da altri 4: zcore.lpk
Contiene classi e interfaccie utilizzate da tutti gli altri pacchetti. Una sorta di libreria base. zparsesql.lpk
Questo pacchetto contiene delle librerie di aiuto per i vari DB Engine.
Chi ha lavorato o smanettato con almeno due DBEngine, sa che sono molte le estensioni che ogni motore aggiunge. Per verificare, controllate le specifiche di liguaggio di due engine open source, Firebird e MySQL. zplain.lpk
Plan è il pacchetto che contiene tutti i Wrapper alle librerie (dll, so e così via) messe a disposizione dai vari DB per connettersi. E' qui che dovreste mettere il vostro "driver" il giorno che scriverete il vostro DB Engine.
Se non trovate il file ZPlanXXXX.pas vuol dire che ZEOS non supporta quel DB Engine. Esempio per tutti DB2. Zeos non supporta (per questioni di licenza) IBM DB2
Eventualmente una disamina sull'anatomia del driver può essere interessante, ma ai nostri fini è solo accademica. zdbc.lpk
Questo è il cuore pulsante di ZEOS.
Per poter accedre a questo pacchetto dal nostro codice, basta includere una unit :ZDBCIntfs.
Per "accendere" il motore di ZEOS Low Level, basta una semplice chiamata:
var Connection : IZConnection; .. Connection := DriverManager.GetConnection(connectionURL);
Per spegnerlo
Connection.Close; Connection := nil;
Connection URL è una stringa che deve contenere alcune informazioni semplici, faccio subito un esempio pratico: 'zdbc:sqlite-3:/path_e_file_sqlite'
Come potete notare sembra un indirizzo di rete, e in effetti si ispira proprio a quella sintassi. [Protocollo]:[Driver]:[Driver data].
Per gli indirizzi di rete, il formato è protocollo:host[:port]:[percorso della risorsa]. (Il formato string "URL" prevede anche altri parametri, tipo user name, per protocolli di rete diversi dall'HTTP e HTTPS)
Per chi usa altri linguaggi, ad esempio Java, si renderà contro immediatamente che è lo stesso modo per utilizzare i driver JDBC, ed in effetti ha moltissime funzionalità esportate come in JDBC. Quindi (anche se non dichiarato) è un framework compatibile con le specifiche ODBC per UNIX (un sotto insieme di ODBC per Microsoft).
Torniamo a ZEOS dopo questa piccola digressione.
Cerchiamo una corrispondenza tra il componente TZConnection e i pezzi della stringa di connessione (basta che trascinate un componente ZConnection su di una Form/DataModule).
Per la lista di Driver supportati dalla vostra installazione in Lazarus, consultate la proprietà protocol. (Qui il nome della property è forviante, ma hanno scelto questo nome).
Per la risorsa (parametro specifico per l'engine) è la property Database.
Per un SQLITE basterà mettere il nome del file da utilizzare come DB, per un Firebird, il file o l'alias configurato. Per un Oracle il SID, MySQL ...
Come vedete, fino a qui, al posto di utilizzare il componente TZConnection, ci sono due righe di codice. A questo non si è ancora visto nulla di nuovo, apparentemente solo un modo più "difficile" di fare le cose.
Lanciamo la nostra prima query, chiediamo a SQLITE quali sono le tabelle nel db: var statement:IZStatement; cursore :IZResultSet; begin [...] statement := FConnection.CreateStatement; cursore := stmt.ExecuteQuery('SELECT tbl_name FROM SQLITE_MASTER WHERE (type=''table'') AND (NOT tbl_name LIKE ''sqlite_%'') ORDER BY tbl_name'); E per chiudere il cursorse: cursore := nil; stmt := nil; Come si potrà notare non c'è bisogno di componenti (quindi il nostro programma avrà bisogno di meno Ram/Spazio su disco).
Il modo di fare la fatch del cursore è semplicissimo: while rs.next do
begin
[...]
end;
Quindi, rispetto ai componenti classici, non c'è bisogno di fare un : while not cursore.EOF do
begin
[...]
cursore.NEXT;
end;
Non so voi, ma dimentico spesso l'ultima riga :D
Come si accede alle colonne?
cursor.get[xxxxx](indice).
o
cursor.get[xxxxx]ByName(nome della colonna).
la sintassi è molto diversa da quella a cui siamo abituati con i componenti classici.
Altra differenza: con ZEOS le colonne iniziano da 1 e non da 0 come verrebbe da pensare.
Piccolo esempio completo di lettura dei dati di un DB SQLITE:
procedure TMainModel.loadDatabase(); var stmt :IZStatement; rs :IZResultSet; begin stmt := FConnection.CreateStatement; rs := stmt.ExecuteQuery('SELECT tbl_name FROM SQLITE_MASTER WHERE (type=''table'') AND (NOT tbl_name LIKE ''sqlite_%'') ORDER BY tbl_name');
while rs.Next do begin loadTable(rs.GetStringByName('tbl_name')); end; rs := nil; stmt := nil; End;
procedure TMainModel.loadTable(const nomeTabella : String); { Qui puoi caricare i dati in una qualche maniera, a te conveniente, in memoria, porto come esempio, lo scrivere a console tutte le colonne in modo che vengano interpreatate come stringa. (Non sapendo a priori il tipo). Eventualmente puo fare un'operazione analoga caricando i dati in un documento XML. }
var fieldIdx :Integer; stmt :IZStatement; rs :IZResultSet; rsMeta :IZResultSetMetadata; begin Writeln('Tabella',nomeTabella); try stmt := FConnection.CreateStatement; RS := stmt.ExecuteQuery(Format('SELECT * FROM %s',[nomeTabella])); rsMeta := rs.GetMetadata; while RS.Next do begin for fieldIdx := 1 to rsMeta.GetColumnCount do begin Writeln(rsMeta.GetColumnLabel(fieldIdx)),'=', rs.GetString(fieldIdx)); end; end; finally rsMeta := nil; rs := nil; stmt := nil; end; end;
About the author
Stilgar registered at Italian community of Lazarus and Free Pascal on Aprile 15, 2012, 07:06:32 pm and has posted 2389 posts in the boards since then. Last visit was Dicembre 02, 2024, 09:09:05 pm.
Questo blog non rappresenta una testata giornalistica poiché viene
aggiornato senza alcuna periodicità. Non può pertanto considerarsi un
prodotto editoriale ai sensi della legge n. 62/2001.
Questo sito utilizza cookie, anche di terze parti, per offriti servizi in linea con le tue preferenze. Chiudendo questo banner, scorrendo questa pagina, cliccando su un link o proseguendo la navigazione in altra maniera, acconsenti all’uso dei cookie.