Italian community of Lazarus and Free Pascal

UIB (acronimo di Unified Interbase) è una suit di componenti gratuiti ed opensource per l'accesso a basi di dati Firebird, Interbase e Yaffil.
Questi componenti sono "Thread-Safe" con qualsiasi versione di Firebird, Interbase e Yaffil  e girano sotto Delphi, BCB, Kylix, Lazarus e FPC (Win32, Linux, FreeBsd).

UIB include 11 componenti:
            TJvUIBDatabase.
            TJvUIBTransaction.
            TJvUIBQuery.
            TJvUIBBackup.
            TJvUIBRestore.
            TJvUIBScript.
            TJvUIBDataSet (solo lettura)
            TJvUIBSecurity
            TJvUIBEvents
            TJvUIBRepair
            TJvUIBConfig

Vantaggi:
            Open source (se volete modificare il codice fatelo)
            Multi compilatore (lo compilate su Delphi, BC++, Lazarus)
            Multi piattaforma (gira praticamente ovunque)
            Indipendente (non serve che il data base sia istallato in modalità server o client, ma funziona anche su versioni embedded basta puntare alla dll o libreria giusta, non bisogna dirgli a priori che tipo di motore di data base usare)

Svantaggi:
            Personalmente non ne ho trovati

Primo passo, istallazione:

            Nota: i componenti synedit devono essere istallati

            Dephi:
                        1. Aggiungere la path dei sorgenti alle librerie
                        2. Aprire e compilare il package runtime JvUIBDXR.dpk
                        3. Aprire ed istallare il package design JvUIBDXD.dpk

            BC++:
                        1. Aprire e compilare il package runtime JvUIBCXR.bpk
                        2. Modificare (se necessario) il path nel package design (JvUIBCXD.bpk) che punta alla directory dei sorgenti di synedit "$(BCB)\Source\synedit\Source"
                        3. Aprire ed istallare il package design JvUIBCXD.bpk

            Kylix:
                        1. Aprire ed istallare il package JvUIBPack_K3.dpk

            Lazarus:
                        1. Istallare il package uiblaz.lpk nella directory dei sorgenti di UIB
                        2. Eseguire un rebuild di Lazarus

Collegarsi ad un data base

            Prendiamo il nostro componente TjvUIBDataBase
            impostiamo l'utente e la password (rispettivamente nei campi UserName e Password)
            impostiamo la libreria che utilizzaremo nel campo LibraryName (per esempio se si usa firebird embedder la libreria è fbembed.dll) – nota che la libreria contiene il path completo (esempio c:\Firebird\fbembed.dll).
            Impostiamo il nome del data base nel campo DatabaseName e siamo a posto.

            Riepiloghiamo:
              DataBase.DatabaseName := Path+nome file data base
              DataBase.UserName         := nome utente
              DataBase.PassWord         := password
              DataBase.LibraryName     := Path+nome file libreria

            Bene ora diamo un bel DBase.Connected := True; e siamo a posto.

            Ora per accedere al data base inseriamo nel nostro data module il componente TjvUIBTransaction e settiamo la proprietà DataBase in maniera che punti al componente  TjvUIBDataBase
            Inseriamo anche un componente  TjvUIBQuery, lo facciamo puntare al nostro  TjvUIBDataBase e al componente atto alle transazioni  TjvUIBTransation
            Volendo possiamo inserire anche un bel componente TjvUIBDataSet (che faremo puntare agli oggetti primari esattamente come  il TjvUIBQuery).
            Perchè due componenti di accesso invece di uno? Perchè è più semplice a seconda di quello che bisogna farci.
            Il componente Query lo utilizzeremo per le operazioni, diciamo, di basso livello (Creazione tabelle, trigger, select vari), mentre il DataSet per le ricerche e manipolazioni di dati (è più semplice)

Creazione di un data base:

            1) Collegarsi ad un data base (non eseguire il Connect := True)
            2) Creiamo fisicamente il data base con Dbase.CreateDatabase
            3) Con il componente Query creiamo tutte le tabelle, trigger, procedure, che ci occorrrono (qui bisogna sapere l'SQL)
            4) Con il componente Transaction esequiamo un bel commit (Transaction.CommitRetaining)
            5) Ora possiamo aprire il nostro data base con la solita  DBase.Connected := True

            ovviamente possiamo automatizzare il tutto con una bella procedura tipo

            Procedure Apertura_Data_Base;
            Begin
              // ------------------------------------------
              // Controllo Data-Base già presente
              // ------------------------------------------
              If FileExists(DBase.DatabaseName) Then
                 Begin
                   // ------------------------------------------
                   // Connessione al Data-Base
                   // ------------------------------------------
                   DBase.Connected := True;
           
                   // ------------------------------------------
                   // Uscita
                   // ------------------------------------------
                   Exit;
                 End;

              // ------------------------------------------
              // Creazione fisica del data base
              // ------------------------------------------
              Dbase.CreateDatabase;

              .........................................
                  qui' con il componente Query bisognerà creare
                  tutte le tabelle, trigger ed altro che ci
                  occorre
              .........................................

              // ------------------------------------------------------
              // Scrive fisicamente i dati e termina la creazione del
              // Data-base
              // ------------------------------------------------------
              Transaction.CommitRetaining;

              // ------------------------------------------------------
              // Apertura Data-Base
              // ------------------------------------------------------
              DBase.Connected := True;  
            End;

TjvUIBQuery:

            E' il componente primario di accesso al data base e necessita di una precisazione: si può utilizzare in tre maniere differenti

            Metodo Open
                        Tipicamente usata nei SELECT

                          Query.SQL.Text := 'SELECT FIRST_NAME, LAST_NAME, SALARY FROM EMPLOYEE WHERE DEPT_NO = :Num';
                          Query.Params.ByNameAsInteger['Num'] := 623;
                          Query.Open;
                          while not Query.EOF do
                            with Query, Fields do
                            begin
                              memo.Lines.Add(format('%s %s, Salary: %f'
                                 ,
                                [ByNameAsString['FIRST_NAME'],
                                 ByNameAsString['LAST_NAME'],
                                 ByNameAsCurrency['SALARY']]));
                              Next;
                            end;
                          Query.Close(etmCommit);    
                         
            Metodo Execute
                        Tipicamente usata per Data Pump

                        const
                          Datas : array[1..10] of TARecord = (
                            (COUNTRY: 'blabla0'; CURRENCY: 'blabla'),
                            (COUNTRY: 'blabla1'; CURRENCY: 'blabla'),
                            (COUNTRY: 'blabla2'; CURRENCY: 'blabla'),
                            (COUNTRY: 'blabla3'; CURRENCY: 'blabla'),
                            (COUNTRY: 'blabla4'; CURRENCY: 'blabla'),
                            (COUNTRY: 'blabla5'; CURRENCY: 'blabla'),
                            (COUNTRY: 'blabla6'; CURRENCY: 'blabla'),
                            (COUNTRY: 'blabla7'; CURRENCY: 'blabla'),
                            (COUNTRY: 'blabla8'; CURRENCY: 'blabla'),
                            (COUNTRY: 'blabla9'; CURRENCY: 'blabla'));
                        begin
                          for i := 1 to 10 do
                          begin
                            Query.Params.AsString[0] := Datas[i].COUNTRY;
                            Query.Params.AsString[1] := Datas[i].CURRENCY;
                            Query.Execute;
                            // Per performance migliori eseguire un commit ogni circa 1000 record
                          end;
                          Query.Close(etmRollback); // Cambiare in etmCommit per applicarlo
                        end;

            ExecSQL
                        E' la via più semplice per eseguire varie query simultaneamente. Se QuickScript è settata a True viene eseguita una query differente per ogni singola linea

                       Query.QuickScript := True;
                        Query.SQL.Add('INSERT INTO COUNTRY (COUNTRY,CURRENCY) VALUES (''Test0'',''FFranc'')');
                        Query.SQL.Add('DELETE FROM COUNTRY WHERE COUNTRY = ''Test0''');
                        .../...
                        Query.ExecSQL;
                        Query.Close(etmCommit);

Regole di transazione

            1. Una transazione parte automaticamente quando una query è aperta
            2. La transazione rimane attiva finchè una query non è chiusa
            3. Il rollback è automatico in caso di errore
            4. Il commit è automatico se il componente della query è distrutto