* * * *
12 Visitatori, 0 Utenti
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.

cursor.Fields[indice].as[xxxx]
cursor.FieldByName(nome).as[xxxx]

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;


Share on Twitter! Digg this story! Del.icio.us Share on Facebook! Technorati Reddit StumbleUpon

Articles in « How to »

Related

Comments *

Commenting option has been turned off for this article.

Recenti

How To

Trascinare un file nel programma da xinyiman
DB concetti fondamentali e ZeosLib da xinyiman
Recuperare codice HTML da pagina web da xinyiman
Mandare mail con Lazarus da xinyiman
Stabilire il sistema operativo da xinyiman
Esempio lista in pascal da xinyiman
File INI da xinyiman
Codice di attivazione da xinyiman
Realizzare programmi multilingua da xinyiman
Lavorare con le directory da xinyiman
Utilizzare Unità esterne da Loryea
TTreeView da xinyiman
TTreeview e Menu da xinyiman
Generare controlli RUN-TIME da xinyiman
LazReport, PDF ed immagini da xinyiman
Intercettare tasti premuti da xinyiman
Ampliare Lazarus da xinyiman
Lazarus e la crittografia da xinyiman
System Tray con Lazarus da xinyiman
UIB: Unified Interbase da Microges2000
Il file: questo sconosciuto da Microges2000
Conferma di chiusura di un applicazione da xinyiman
Liste e puntatori da Microges2000
Overload di funzioni da Microges2000
Funzioni a parametri variabili da Microges2000
Proprietà da Microges2000
Conversione numerica da Microges2000
TImage su Form e Panel da Maverich
Indy gestiore server FTP lato Client da Maverich
PopUpMenu sotto Pulsante (TSpeedButton) da Maverich
Direttiva $macro da Microges2000
Toolbar da xinyiman
Evidenziare voci TreeView da Maverich
Visualizzare un file Html esterno da Maverich
StatusBar - aggirare l'errore variabile duplicata da Maverich
Da DataSource a Excel da xinyiman
Le permutazioni da xinyiman
Brute force da xinyiman
Indy 10 - Invio email con allegati da Maverich
La gestione degli errori in Lazarus da xinyiman
Pascal Script da xinyiman
Linux + Zeos + Firebird da xinyiman
Dataset virtuale da xinyiman
Overload di operatori da Microges2000
Lavorare con file in formato JSON con Lazarus da nomorelogic
Zeos ... dietro le quinte (prima parte) da Stilgar
Disporre le finestre in un blocco unico (come Delphi) da Maverich
Aspetto retrò (Cmd Line) da xinyiman
Come interfacciare periferica twain da Narciso
Ubuntu - aggiornare free pascal e lazarus da xinyiman
fpcup: installazioni parallele di lazarus e fpc da nomorelogic
Free Pascal e Lazarus sul Raspberry Pi da nomorelogic
Cifratura: breve guida all'uso dell'algoritmo BlowFish con lazarus e free pascal. da nomorelogic
Creare un server multithread da xinyiman
guida all'installazione di fpc trunk da subversion in linux gentoo da nomorelogic
Indice da nomorelogic
DB concetti fondamentali e connessioni standard da xinyiman
Advanced Record Syntax da nomorelogic
DB concetti fondamentali e DBGrid da xinyiman
DB concetti fondamentali e TDBEdit, TDBMemo e TDBText da xinyiman
Advanced Record Syntax: un esempio pratico da nomorelogic
Superclasse form base per programmi gestionali (e non) da nomorelogic
Superclasse form base per programmi gestionali (e non) #2 - log, exception call stack, application toolbox da nomorelogic
Superclasse form base per programmi gestionali (e non) #3 - traduzione delle form da nomorelogic
Superclasse form base per programmi gestionali (e non) #4 - wait animation da nomorelogic
Un dialog per la connessione al database:TfmSimpleDbConnectionDialog da nomorelogic
Installare lazarus su mac osx sierra da xinyiman
Utenti
Stats
  • Post in totale: 10493
  • Topic in totale: 1336
  • Online Today: 11
  • Online Ever: 74
  • (Luglio 09, 2012, 11:05:53 am)
Utenti Online
Users: 0
Guests: 12
Total: 12

Disclaimer:

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.