mORMot 1.18 第06章 概念

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，但您有責任確保資料庫反映數據模型。