Delphi & Firebase Database Entegrasyonu Nasıl Sağlanır ?

Merhabalar,

Bu yazıda , Delphi Projenize Google Firebase Database Entegrasyonunu nasıl yapacağınızdan bahsedeceğim.

Firebase Google Amcanın bize sunduğu çok güzel kısmi ücretsiz, harika özellikler barındıran bir proje, biz bu yazımızda Realtime Database özelliğini kullanacağız.

Realtime Database aylık 10GB veriye kadar ücretsizdir , bu sebebten basit projelerinizde ücretsiz olarak bu canlı veritabanından neden yararlanmayalım.

İşimize Google Firebase Database oluşturmakla başlayacağız , öncelikle aşağıdaki linkten yeni bir proje oluşturalım.

https://console.firebase.google.com

Resimler ile nasıl yapabileceğinizi adım adım gösterelim..

İlk adım yeni proje oluşturma

Projemiz oluşturuldu ve kullanma hazır.

Şimdi veritabanı oluşturuyoruz.

Resimler ile devam…

İlk olarak public şekilde ayarlayabiliriz , sonradan kilitli moda alabiliriz.

Public şekilde olsa da Database Key olmadan kimse verilerini okuyamaz değiştiremez.  Test modunda olması verilerinizi herkesin görebileceği anlamına gelmiyor yani bu konuya daha sonra detaylı değinirim.

Bildiğiniz üzere Google amcanın bir çok ülkede Server’leri var , burada sizden bir bölge seçmenizi istiyor, size en yakın bölgeyi seçmeniz hız bakımından avantaj sağlayacaktır.

Sizin bu seçeneği değiştirmenize gerek yok google amca size en uygun bölgeyi kendisi otomatik seçiyor zaten.

Yukarıda Bitti dedikten sonra, size database ekranını açacak.

Bizim şimdi database’in secret keyine ve databaseurl’sine ihtiyacımız var.

Google her proje için bir domain verir bizlere, buna databaseurl denir.

Yukarıdaki gibi Ayarlar simgesine, daha sonra Kullanıcı  ve İzinler butonuna tıklıyoruz.

Açılan pencerede, Hizmet Hesapları sekmesine gelerek , Veritabanı Gizli Anahtarı Sekmesine tıklayın, Aşağıdaki gizli anahtarı alarak bir kenara kaydedin.

Sırada ihtiyacımız olan, Database Url’i almak için yukarıdaki gibi Uygulama ekliyoruz ,

Uygulamanıza isim verin ve devam edin.

Google SDK’mızı ayarlayıp bize Database Url’imizi verdi , şimdi bunu da bir kenara kaydediyoruz.

Şimdi yeni bir Koleksiyon başlatmamız gerekiyor, bir tablo adı gibi düşünebilirsiniz.

Buraya Doğrudan Otomatik Kimlik butotuna tıklayarak kaydedin.

Database’imiz hazır diyebiliriz, buradan sonra tablo fieldleri ayarlamanıza gerek yok , buraya nasıl bir json post ederseniz otomatik o şekilce bir tablo oluşacaktır.

Database’imizde şu işlemleri yapabiliriz.

• Post (Insert Data – Veri Kaydetme)
• Put (Update Data – Veri Güncelleme)
• Delete (Delete Data – Veri Silme) 
• Get (Get Data – Veri Listeleme / Gösterme) 

Sırasıyla bu işlemleri yapacağız.

Örneğin delphi versiyonlarını saklayacağımız bir veritabanı olsun bu.

Minik bir Delphi uygulaması ile gösterelim , bu uygulamanın kodlarını ve Kaynak Dosyasını yazının en sonunda sizlerle paylaşacağım.

Request Body’de gördüğünüz json verisini, Yukarıda açtığımız DelphiDb.json database’mizie post ettiğimizde canlı olarak verimizin kaydolduğunu Realtime database menüsünden gözlemleyebiliyoruz.

Ve Realtime Database sekmesinden izlediğimizde post eder etmez  , verimizi benzersiz uniqe bir ıd ile kaydolduğunu gözlüyoruz ve response olarak bize bu benzersiz id’yi dönüyor veritabanımız.

Sırasıyla 4 versiyonu database’imize bu şekilde kaydettik.

Buradan sonrasını video ile göstermem daha iyi olur sanırım.

aşağıdaki video’dan yukarıdaki 4 işlemi canlı olarak nasıl gerçekleştirdiğimi görebilirsiniz.

https://www.youtube.com/watch?v=9WUl6R_bYGw

Delphi Proje Dosyasını indirmek için tıklayın

Proje Dosyası Kodları

FirebaseDatabase.pas

Delphi/Pascal
<br /> unit FirebaseDatabase;<br /> interface<br /> uses<br /> System.Classes, clHttp, clHttpRequest, System.SysUtils;<br /> type<br /> TFirebase = class(TObject)<br /> public<br /> SecretKey: String;<br /> ProjectUrl: String;<br /> procedure Delete(Database: string);<br /> procedure Put(Database, Data: string);<br /> function Post(Database, Data: string): String;<br /> function Get(Database: string): String;<br /> end;<br /> implementation<br /> { TFirebase }<br /> procedure TFirebase.Delete(Database: string);<br /> var<br /> FireBase: TclHttp;<br /> begin<br /> FireBase := TclHttp.Create(nil);<br /> try<br /> // Post Url : https://delphifirebase-demo.firebaseio.com/DelphiDb/-Lmnhs0f6jE22p2H_Jz4.json?auth=guPhITQseHczlGqZgG6CnNTV2nqY1n7gfccX2NlO<br /> FireBase.Delete(ProjectUrl + Database + ‘?auth=’ + SecretKey);<br /> finally<br /> if Assigned(FireBase) then<br /> FreeAndNil(FireBase);<br /> end;<br /> end;<br /> function TFirebase.Get(Database: string): String;<br /> var<br /> Response: TMemoryStream;<br /> FireBase: TclHttp;<br /> Ts: TStringList;<br /> begin<br /> Response := TMemoryStream.Create;<br /> FireBase := TclHttp.Create(nil);<br /> Ts := TStringList.Create;<br /> try<br /> // Post Url : https://delphifirebase-demo.firebaseio.com/DelphiDb.json?auth=guPhITQseHczlGqZgG6CnNTV2nqY1n7gfccX2NlO<br /> FireBase.Get(ProjectUrl + Database + ‘?auth=’ + SecretKey, Response);<br /> Response.Position := 0;<br /> Ts.LoadFromStream(Response, TEncoding.UTF8);<br /> Result := Ts.Text;<br /> finally<br /> if Assigned(Ts) then<br /> FreeAndNil(Ts);<br /> if Assigned(Response) then<br /> FreeAndNil(Response);<br /> if Assigned(FireBase) then<br /> FreeAndNil(FireBase);<br /> end;<br /> end;<br /> function TFirebase.Post(Database, Data: string): String;<br /> var<br /> Response: TMemoryStream;<br /> FireBase: TclHttp;<br /> Ts: TStringList;<br /> Request: TclHttpRequest;<br /> SStream: TStringStream;<br /> begin<br /> Response := TMemoryStream.Create;<br /> FireBase := TclHttp.Create(nil);<br /> Ts := TStringList.Create;<br /> Request := TclHttpRequest.Create(nil);<br /> SStream := TStringStream.Create(Data);<br /> try<br /> Request.RequestStream := SStream;<br /> Request.Header.ContentType := ‘application/json’;<br /> Request.Header.ContentLength := IntToStr(SStream.Size);<br /> // Post Url : https://delphifirebase-demo.firebaseio.com/DelphiDb.json?auth=guPhITQseHczlGqZgG6CnNTV2nqY1n7gfccX2NlO<br /> // Post Data : {“Product”: “Delphi 10.3 Rio”,”ProductVersion”: 26,”PackageVersion”: 260,”CompilerVersion”: 33}<br /> FireBase.Post(ProjectUrl + Database + ‘?auth=’ + SecretKey, Request, Response);<br /> Response.Position := 0;<br /> Ts.LoadFromStream(Response, TEncoding.UTF8);<br /> Result := Ts.Text;<br /> finally<br /> if Assigned(Ts) then<br /> FreeAndNil(Ts);<br /> if Assigned(Response) then<br /> FreeAndNil(Response);<br /> if Assigned(FireBase) then<br /> FreeAndNil(FireBase);<br /> if Assigned(Request) then<br /> FreeAndNil(Request);<br /> if Assigned(SStream) then<br /> FreeAndNil(SStream);<br /> end;<br /> end;<br /> procedure TFirebase.Put(Database, Data: string);<br /> var<br /> Response: TMemoryStream;<br /> FireBase: TclHttp;<br /> Request: TclHttpRequest;<br /> SStream: TStringStream;<br /> begin<br /> Response := TMemoryStream.Create;<br /> FireBase := TclHttp.Create(nil);<br /> Request := TclHttpRequest.Create(nil);<br /> SStream := TStringStream.Create(Data);<br /> try<br /> Request.RequestStream := SStream;<br /> Request.Header.ContentType := ‘application/json’;<br /> Request.Header.ContentLength := IntToStr(SStream.Size);<br /> // Post Url : https://delphifirebase-demo.firebaseio.com/DelphiDb/-Lmnhs0f6jE22p2H_Jz4.json?auth=guPhITQseHczlGqZgG6CnNTV2nqY1n7gfccX2NlO<br /> // Post Data : {“Product”: “Delphi 10.3 Rio”,”ProductVersion”: 26,”PackageVersion”: 260,”CompilerVersion”: 33}<br /> FireBase.Put(ProjectUrl + Database + ‘?auth=’ + SecretKey, ‘application/json’, Request.RequestStream);<br /> finally<br /> if Assigned(Response) then<br /> FreeAndNil(Response);<br /> if Assigned(FireBase) then<br /> FreeAndNil(FireBase);<br /> if Assigned(Request) then<br /> FreeAndNil(Request);<br /> if Assigned(SStream) then<br /> FreeAndNil(SStream);<br /> end;<br /> end;<br /> end.<br />

Main.pas

Delphi/Pascal
<br /> unit Main;<br /> interface<br /> uses<br /> Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,<br /> Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.ComCtrls, Vcl.StdCtrls,<br /> FirebaseDatabase, Vcl.ExtCtrls, Data.DB, Vcl.Grids, System.JSON, Vcl.DBGrids, dxmdaset, Vcl.DBCtrls;<br /> type<br /> TMainForm = class(TForm)<br /> GroupBox1: TGroupBox;<br /> PageControl1: TPageControl;<br /> Post: TTabSheet;<br /> Put: TTabSheet;<br /> Delete: TTabSheet;<br /> Get: TTabSheet;<br /> GroupBox2: TGroupBox;<br /> SecretKey: TLabeledEdit;<br /> ProjectUrl: TLabeledEdit;<br /> Post_Button: TButton;<br /> GroupBox3: TGroupBox;<br /> GroupBox4: TGroupBox;<br /> RequestBody: TMemo;<br /> ResponseBody: TMemo;<br /> Panel1: TPanel;<br /> CollectionName: TLabeledEdit;<br /> Get_Button: TButton;<br /> CollectionName2: TLabeledEdit;<br /> GroupBox5: TGroupBox;<br /> ResponseBody2: TMemo;<br /> DBGrid1: TDBGrid;<br /> DataSource1: TDataSource;<br /> dxMemData1: TdxMemData;<br /> Button1: TButton;<br /> dxMemData1Product: TStringField;<br /> dxMemData1ProductVersion: TIntegerField;<br /> dxMemData1PackageVersion: TIntegerField;<br /> dxMemData1CompilerVersion: TIntegerField;<br /> dxMemData1DatabaseId: TStringField;<br /> Delete_Btn: TButton;<br /> Update_Btn: TButton;<br /> GroupBox6: TGroupBox;<br /> RequestBody3: TMemo;<br /> CollectionName3: TLabeledEdit;<br /> Put_btn: TButton;<br /> DataKey: TLabeledEdit;<br /> CollectionName4: TLabeledEdit;<br /> dataKey2: TLabeledEdit;<br /> Delete_Button: TButton;<br /> procedure FormCreate(Sender: TObject);<br /> procedure Post_ButtonClick(Sender: TObject);<br /> procedure Get_ButtonClick(Sender: TObject);<br /> procedure Button1Click(Sender: TObject);<br /> procedure dxMemData1BeforeDelete(DataSet: TDataSet);<br /> procedure Update_BtnClick(Sender: TObject);<br /> procedure Put_btnClick(Sender: TObject);<br /> procedure Delete_ButtonClick(Sender: TObject);<br /> procedure Delete_BtnClick(Sender: TObject);<br /> private<br /> { Private declarations }<br /> public<br /> { Public declarations }<br /> end;<br /> var<br /> MainForm: TMainForm;<br /> Firebase: TFirebase;<br /> implementation<br /> {$R *.dfm}<br /> procedure TMainForm.Get_ButtonClick(Sender: TObject);<br /> begin<br /> Firebase.SecretKey := SecretKey.Text;<br /> Firebase.ProjectUrl := ProjectUrl.Text;<br /> ResponseBody2.Text := Firebase.Get(CollectionName.Text);<br /> end;<br /> procedure TMainForm.Post_ButtonClick(Sender: TObject);<br /> begin<br /> Firebase.SecretKey := SecretKey.Text;<br /> Firebase.ProjectUrl := ProjectUrl.Text;<br /> ResponseBody.Text := Firebase.Post(CollectionName.Text, RequestBody.Text);<br /> end;<br /> procedure TMainForm.Put_btnClick(Sender: TObject);<br /> begin<br /> Firebase.SecretKey := SecretKey.Text;<br /> Firebase.ProjectUrl := ProjectUrl.Text;<br /> Firebase.Put(CollectionName3.Text + ‘/’ + DataKey.Text, RequestBody3.Text);<br /> end;<br /> procedure TMainForm.Update_BtnClick(Sender: TObject);<br /> var<br /> JSON: String;<br /> begin<br /> JSON := Format(‘{“Product”: “%s”,”ProductVersion”:%s,”PackageVersion”: %s,”CompilerVersion”: %s}’,<br /> [dxMemData1Product.AsString, dxMemData1ProductVersion.AsString, dxMemData1PackageVersion.AsString, dxMemData1CompilerVersion.AsString]);<br /> RequestBody3.Text := JSON;<br /> DataKey.Text := dxMemData1DatabaseId.AsString + ‘.json’;<br /> PageControl1.ActivePageIndex := 2;<br /> end;<br /> procedure TMainForm.Button1Click(Sender: TObject);<br /> var<br /> ListObject: TJSONObject;<br /> item: TJSONObject;<br /> JsonValue, DatabaseId: String;<br /> i: integer;<br /> begin<br /> dxMemData1.DisableControls;<br /> ListObject := TJSONObject.ParseJSONValue(TEncoding.UTF8.GetBytes(ResponseBody2.Text), 0) as TJSONObject;<br /> try<br /> for I := 0 to ListObject.Count – 1 do<br /> begin<br /> JsonValue := ListObject.Pairs[i].JsonValue.ToString;<br /> DatabaseId := ListObject.Pairs[i].JsonString.Value;<br /> item := TJSONObject.ParseJSONValue(TEncoding.UTF8.GetBytes(JsonValue), 0) as TJSONObject;<br /> try<br /> if not dxMemData1.Active then<br /> dxMemData1.Open;<br /> dxMemData1.Edit;<br /> dxMemData1.Append;<br /> dxMemData1.FieldByName(‘DatabaseId’).Value := DatabaseId;<br /> dxMemData1.FieldByName(‘Product’).Value := item.GetValue(‘Product’).Value;<br /> dxMemData1.FieldByName(‘ProductVersion’).Value := item.GetValue(‘ProductVersion’).Value;<br /> dxMemData1.FieldByName(‘PackageVersion’).Value := item.GetValue(‘PackageVersion’).Value;<br /> dxMemData1.FieldByName(‘CompilerVersion’).Value := item.GetValue(‘CompilerVersion’).Value;<br /> dxMemData1.Post;<br /> finally<br /> FreeAndNil(item);<br /> end;<br /> end;<br /> finally<br /> if Assigned(ListObject) then<br /> FreeAndNil(ListObject);<br /> end;<br /> dxMemData1.EnableControls;<br /> end;<br /> procedure TMainForm.Delete_BtnClick(Sender: TObject);<br /> begin<br /> CollectionName4.Text := ‘DelphiDb’;<br /> dataKey2.Text := dxMemData1DatabaseId.AsString + ‘.json’;<br /> PageControl1.ActivePageIndex := 3;<br /> end;<br /> procedure TMainForm.Delete_ButtonClick(Sender: TObject);<br /> begin<br /> Firebase.SecretKey := SecretKey.Text;<br /> Firebase.ProjectUrl := ProjectUrl.Text;<br /> Firebase.Delete(CollectionName4.Text + ‘/’ + dataKey2.Text);<br /> end;<br /> procedure TMainForm.dxMemData1BeforeDelete(DataSet: TDataSet);<br /> begin<br /> ShowMessage(DataSet.FieldByName(‘DatabaseId’).AsString);<br /> end;<br /> procedure TMainForm.FormCreate(Sender: TObject);<br /> begin<br /> Firebase := TFirebase.Create;<br /> end;<br /> end.<br />