mORMot 1.18 第06章 概念

海利鸟發表於2024-04-29
ORM

mORMot 1.18 第六章 概念

mORMot 應用程式透過 Object Pascal 型別定義資料庫結構。該庫大量使用執行時型別資訊 (RTTI)，之所以可能實現，是因為 Delphi 將型別資訊儲存在可執行檔案中。

RTTI 可以說明一個變數是整數、雙精度數、字串、陣列、特定型別的類等，對 ORM（物件關係對映）理解您的資料至關重要。

FreePascal 還沒有儲存 RTTI，但是有兩種解決方案：一是使用 NewPascal（FreePascal 的一種變體），它可用於一些平臺；另一種方法是在 Delphi 中生成 RTTI 並將其移植到 Free Pascal。有關所有這些選項的最新資訊，請參閱線上文件。

繼承是 mORMot 物件處理的核心。所有的資料庫物件都派生自 TSQLRecord。TSQLSomeone 繼承自 TSQLRecordTimeStamp，後者又繼承自 TSQLRecord。

TSQLRecord 自動新增欄位 ID，它是一個非零的正 64 位整數（型別 TID）。

如果您讀取的記錄索引為 0，說明沒有這樣的記錄。

我們使用 RawUTF8 而不是字串，這是資料庫使用的 ASCII 編碼。

以下概覽對應“xxx\SQLite3\Samples\30 - MVC Server”示例

  TSQLSomeone = class(TSQLRecordTimeStamped)
  private
    fFirstName: RawUTF8;
    fFamilyName: RawUTF8;
    fBirthDate: TDateTime;
    fEmail: RawUTF8;
    fVerified: boolean;
    fHashedPassword: RawUTF8;
    fLogonName: RawUTF8;
  public
    function ComputeHash(const PlainPassword: RawUTF8): RawUTF8; virtual;
    procedure SetPlainPassword(const PlainPassword: RawUTF8);
    function CheckPlainPassword(const PlainPassword: RawUTF8): boolean;
    function Name: RawUTF8; 
  published
    property LogonName: RawUTF8 index 30 read fLogonName write fLogonName stored AS_UNIQUE;
    property FirstName: RawUTF8 index 50 read fFirstName write fFirstName;
    property FamilyName: RawUTF8 index 50 read fFamilyName write fFamilyName;
    property BirthDate: TDateTime read fBirthDate write fBirthDate;
    property Email: RawUTF8 index 40 read fEmail write fEmail;
    property HashedPassword: RawUTF8 index 64 read fHashedPassword write fHashedPassword;
    property Verified: boolean read fVerified write fVerified;
  end;

TSQLRecord.LoginName 定義為索引 30，意味著最大長度為 30，或 SQL 使用者使用的 varchar(30)。

TSQLSomeone.LoginName 儲存為 RAWUTF8 格式的 AS_UNIQUE。這意味著資料庫將強制欄位的唯一性。這是標準的資料庫內容，但您會發現它直接應用於應用程式程式語言中，而不僅僅是 SQL。

TSQLSomone.Birthdate 是一個 TDateTime 型別，您可以隨時設定。但 TSQLRecordTimeStamp 的 CreatedAt 是 TCreateTime 型別。mORMot 足夠智慧，可以在我們建立記錄時設定此值，但在我們讀取或寫入記錄時不會更新它。

同樣，每當我們修改記錄時，TSQLRecordTimeStamp.ModifiedAt 會自動更新。這些都是內建的。

ORM 欄位應該定義為釋出的。可以將讀取或寫入部分設定為函式來讀取或儲存值。

還可以建立具有寫入功能但沒有讀取函式或值的黑洞屬性。密碼文字屬性就是這樣的；例程 SetPlainPassword(password: RawUTF8) 採用輸入密碼並將其轉換為可以安全儲存的加密雜湊，但您永遠無法重新讀取明文密碼，因為它根本沒有以明文格式儲存。

同樣，也有一些情況只有讀取功能才有意義。假設您儲存了一個名為 JobStatus 的值，該值對映為一個整數或列舉，以便在內部進行高效處理。您可以使用 GetJobStatusText: RawUTF8 的讀取函式定義 JobStatusText，該函式將該整數/列舉轉換為常量文字字串。每當結構透過網路傳遞時，作為傳輸的一部分，會自動返回最新的字串，但實際上您從未儲存文字部分，它是在讀取屬性時動態生成的。

TSQLSomeone.Name 是一個複合欄位，由名字和姓氏組成。無需在程式碼中用名字和姓氏進行拼接。

6.1 像積木一樣

一旦定義了資料模型，mORMot 就像兒童的積木一樣工作，您可以使用任何支援的技術互換地構建解決方案。

例如，您可以使用或更改為任何支援的資料庫，或者只需一行更新。

使用本地或遠端資料庫，透過 REST 或 Web 協議連線到桌面或遠端桌面上的本地客戶端。可以使用 Microsoft 網路、TCP/IP 網路、命名管道等。

6.2 程式型別

mORMot 程式可以編譯為：

  • 使用者模式的 GUI 應用程式
  • 使用者模式的控制檯（文字）應用程式
  • 守護程序/服務

適用於幾乎所有平臺：Windows、Linux、Mac OS/X、iOS、Android。

使用 Delphi/Rad Studio for Windows，您可以使用 VCL，以及在 Windows 和該編譯器支援的其他平臺上使用更通用的 FMX 圖形。FreePascal 可以與所有平臺上的文字模式應用程式一起使用，或者可以與 Lazarus 結合使用。

我們通常會做使用者文字模式和使用者 GUI 模式應用程式，以證明如何完成任務並驗證每個示例是否有效。但是，將此級別的開發人員將文字模式應用程式放入守護程序/服務中，或增強它以使用 Delphi/Lazarus (FreePascal) UI 被認為是微不足道的，因此不會解釋基本的 Delphi 圖形庫。

對於 GUI，我們將主要依靠 Elevate Web Builder 來製作快速、有吸引力的 Web 應用程式。

6.3 使用哪個資料庫品牌

根據應用程式的不同，您可能可以選擇使用的資料庫技術，因為您可能是從頭開始的。即使您從舊技術開始，也值得了解所有選項。

所有支援的資料庫都具有 ACID（原子性、一致性、隔離性、永續性）特性集，該特性集透過使用可以完全工作或撤消的事務來保證資料庫事務得到可靠處理。

6.2 程式的型別

mORMot程式可以編譯成：

  • 使用者模式的圖形使用者介面（GUI）應用程式
  • 使用者模式的控制檯（文字）應用程式
  • 守護程序/服務

這些應用程式可以在幾乎所有平臺上執行：Windows、Linux、Mac OS/X、iOS、Android。

在Windows上使用Delphi/Rad Studio，你可以採用VCL，在Windows和其他平臺上，該編譯器還支援更通用的FMX圖形庫。FreePascal可以與所有平臺上的文字模式應用程式一起使用，或者可以與Lazarus結合使用。

我們通常會構建使用者文字模式和使用者GUI模式的應用程式，以證明如何完成任務並驗證每個示例是否有效。但是，對於這個級別的開發人員來說，將文字模式應用程式放入守護程序/服務中，或增強它以使用Delphi/Lazarus(FreePascal) UI被認為是微不足道的，因此這裡不會解釋基本的Delphi圖形庫。

對於GUI，我們將主要依靠Elevate Web Builder來製作快速、有吸引力的Web應用程式。

6.3 使用哪個資料庫品牌

根據應用程式的不同，您可能可以選擇要使用的資料庫技術，因為您可能是從頭開始構建。即使您是從舊技術開始的，也值得了解所有選項。

所有支援的資料庫都具有ACID（原子性、一致性、隔離性、永續性）特性集，這是一組屬性，它們透過使用可以完全工作或撤消的事務來保證資料庫事務的可靠處理。

此外，在選擇資料庫時，您還應該考慮以下因素：效能、可擴充套件性、易用性、社群支援和許可要求。例如，一些資料庫是開源的，而另一些則需要付費許可。根據您的專案需求和預算，選擇最適合您的資料庫品牌。

對於mORMot框架，它支援多種資料庫，因此您可以根據專案需求靈活選擇。無論您選擇哪種資料庫，mORMot都能幫助您高效地管理和運算元據。

（注意：此段為譯者根據上下文新增的內容，以幫助讀者更好地理解原文）

在選擇資料庫時，務必確保其與您的開發環境和工具鏈相容，以便能夠無縫整合並實現高效的資料處理。同時，瞭解資料庫的效能和可擴充套件性也非常重要，以確保其能夠滿足您應用程式的需求。最後，不要忘記考慮資料庫的安全性和可靠性，以保護您的資料免受未經授權的訪問和損壞。

6.4 外部資料庫

Oracle 一個行業領先的商業企業級資料庫。透過自定義的Oracle驅動程式直接支援。

TSQLDBOracleConnectionProperties.Create(servername, databasename, userid, password);

MS-SQL 一個市場領先的商業企業級/工作組級資料庫。

透過各種資料庫驅動程式間接支援。

TOleDBMSSQL2008ConnectionProperties.Create(Servername, databaseneame, userid, password);

PostGreSQL 一個透過各種資料庫驅動程式支援的開源企業級資料庫。

MySQL 一個工作組級資料庫。mORMot透過ODBC和其他資料庫驅動程式間接支援。有一章專門討論MySQL。

SQLite3 一個最佳化的、輕量級的、基於磁碟的資料庫。如果在ACID磁碟模式下使用，速度相對較慢。但如果在ACID-RAM模式下使用，並且如示例專案15所示設定DB.Synchronous := smOff和/或DB.LockingMode := lmExclusive，則其速度非常快。

TSQLDBSQLite3ConnectionProperties.Create('', databasefilename, '', '' );

記憶體模式資料庫 一個內部記憶體資料庫。

TSQLRestStorageInMemory.Create('','','','' );

MongoDB 一個NoSQL資料庫，非常適合資料模型無法完全預先預測的情況。

StaticMongoDBRegister(servername, database, userid, password);

現在，資料庫已定義並建立連線，我們可以選擇告訴mORMot使用以下命令將資料庫更新到最新模型：

TSQLConnectionProperties.}CreateMissingTables;

如果我們不這樣做，資料庫可能無法準確地反映模型。在舊資料庫中，您可能不會呼叫CreateMissingTables，但您有責任確保資料庫反映資料模型。

相關文章