mORMot2

Symotse Mormot 2框架

現代對像中的開源客戶服務器服務器/SOA/MVC框架Pascal

（c）2008-2024 Synopse Informatique -Arnaud Bouchez

https://synopse.info- http：//mormot.net

感謝所有貢獻者！

注意：此版本2替換了現在處於僅維護模式的Mormot 1.18 。考慮將Mormot 2用於任何新的或可維護的項目。

資源

您可以找到有關Mormot 2的更多信息：

• 它的官方文件（正在進行的工作）；
• 樣品文件夾；
• 托馬斯教程；
• 概要論壇；
• Synopse博客；
• 源代碼src子文件夾；
• 舊的Mormot 1文檔仍然主要適用於新版本，尤其是設計/概念部分。

為了討論Mormot ，除了我們的官方論壇外，您還可以加入：

• Mormot Telegram小組；
• Mormot Discord服務器。

這些討論小組不是由Synopse管理的，而是由一些Mormot 2用戶管理的：非常感謝他們！

如果您覺得值得使用，請考慮贊助Mormot 2 Dev，如果可以的話 - 甚至通過分享自己的提交也更好。 :-)

推介會

mormot什麼？

Synopse Mormot 2是Delphi 7到Delphi 12雅典和FPC 3.2/TRUNK的開源客戶端服務器ORM SOA MVC框架，針對服務器的Windows/Linux/BSD/MACOS，用於服務器，以及任何用於客戶端的平台（包括移動或AJAX）。

因此，摩爾特的主要特徵是：

• 優化的交叉補充器和跨平台JSON/UTF-8和RTTI內核；
• 直接SQL和NOSQL數據庫訪問（例如SQLITE3，Postgresql，Oracle，MSSQL，OLEDB，ODBC，MongoDB）;
• ORM/ODM：幾乎所有數據庫（SQL或NOSQL）上的對象持久；
• SOA：將您的業務邏輯組織到定義為interface的REST服務中；
• 當地或http/https/websockets的會議範圍內/json路由器的限制/json路由器；
• 客戶端：通過ORM/SOA API從任何平台上使用您的數據或服務；
• Web MVC：將您的ORM/SOA流程作為響應式Web應用程序發布；
• 許多其他可重複使用的磚（例如Unicode，加密網絡，線程，詞典，記錄，二進制序列化，變體，仿製藥，跨平台...）。

強調速度和多功能性， Mormot利用了現代物體Pascal本地代碼和易於動力的解決方案的優勢，降低了部署成本並增加了投資回報率。它可以使用：

• 要將基本ORM或客戶服務器功能添加到業餘愛好者的簡單應用程序中，
• 或讓經驗豐富的用戶為客戶開發可擴展服務的項目（DDD）項目，
• 或利用現有Delphi代碼庫的FPC跨平台能力，以接受接下來的幾十年
• 玩得開心，看到現代物體Pascal挑戰最新的語言或框架。

子食者

Mormot 2存儲庫含量被組織到以下子文件夾中：

• src是主要的源代碼文件夾，您應該在其中找到實際的框架；
• packages包含IDE軟件包和工具來設置開發環境；
• static包含FPC和Delphi靜態鏈接所需的原始庫.o / .obj文件；
• test定義了所有框架功能的回歸測試；
• res編譯src中使用的一些資源 - 例如static第三方二進製文件；
• doc保留了該框架的文檔；
• ex包含各種樣本。

請隨時探索源頭和嵌套的文檔。

MPL/GPL/LGPL三個許可

該框架是根據析取的三個許可許可的，使您可以選擇以下三組免費軟件/開源許可條款之一：

• Mozilla公共許可證，1.1版或更高版本；
• GNU通用公共許可證，版本2.0或更高版本；
• GNU較少的通用公共許可證，版本2.1或更高版本。

這允許在盡可能寬的軟件項目中使用我們的代碼，同時仍在我們編寫的代碼上維護副本。請參閱完整的許可條款。

快速開始

編譯器目標

框架源代碼：

• 試圖與FPC穩定和Delphi 7及以上保持兼容；
• 目前已針對FPC 3.2.3（FIXES-3_2）和LAZARUS 2.2.5（FIXES_2_2），DELPHI 7、2007、2009、2009、2010，XE4，XE7，XE7，XE8、10.4和11.1進行驗證。

請注意，FPC 3.2.2具有帶有變化的後期綁定的回歸 - 使用FPC 3.2.2修復分支。

在Delphi上，只有Windows目標可用於Mormot通用單元，但是您可以在所有Delphi目標上使用跨平台客戶端單元。 FPC是一個更好，一致的跨平台編譯器，我們很樂意支持。

請提交非驗證版本的拉請請求。

安裝

1. 獲取來源，盧克！

• 通過克隆存儲庫（首選）：
  • git clone https://github.com/synopse/mORMot2.git to eg c:githubmORMot2 ，
  • 並下載並提取最新的https://synopse.info/files/mormot2static.tgz或https://synopse.info/files/mormot2static.7z進入c:githubmORMot2static 。
• 或作為給定版本的直接下載（例如，構建腳本）：
  • 從https://github.com/synopse/mormot2/releases下載源代碼（ZIP）版本，然後將其提取到d:mormot2 ，
  • 並下載並提取其關聯的mormot2static.tgz或mormot2static.7z文件內容到d:mormot2static中。

2. 設置您喜歡的IDE：

• 關於拉撒路：
  • 只需打開並編譯/packages/lazarus/mormot2.lpk軟件包;
  • 如果需要， mormot2ui.lpk 。
• 在Delphi上：
  • 創建一個新的環境變量mormot2 ，並具有通往Mormot 2 src折路的完整路徑（工具 - 選項 - IDE-環境變量），例如c:githubmORMot2src或d:mormot2src取決於步驟1；
  • 將以下字符串添加到您的IDE庫路徑（對於所有目標平台，即Win32和Win64）： $(mormot2);$(mormot2)core;$(mormot2)lib;$(mormot2)crypt;$(mormot2)net;$(mormot2)db;$(mormot2)rest;$(mormot2)orm;$(mormot2)soa;$(mormot2)app;$(mormot2)script;$(mormot2)ui;$(mormot2)tools;$(mormot2)misc
  • 不需要IDE或UI軟件包。

3. 發現並享受：

• 在IDE中打開和編譯test/mormot2tests.dpr ，並在計算機上運行回歸測試。
• 瀏覽示例文件夾（正在進行的工作） - 尤其是托馬斯教程，這些教程是現實且教學的。
• 從示例開始，然後按照文檔進行操作。
• 通過向這個快速發展的項目發布增強和補丁來隨意做出貢獻。

為了安全起見，如我們的https://synopse.info/files服務器中發布的當前版本的SHA-256校驗和，在此存儲庫static/dev.sha256文件中可用。

來自版本1.18

為什麼要重寫工作解決方案？

Mormot框架在修訂1.18中保留了多年，是時候進行全面重構了。

主要的重構點試圖更好地遵循堅實的原則：

• 切換到更嚴格的版本管理策略，並具有常規版本；
• 將主要的大型單位（ SynCommons.pas ， mORMot.pas ）分為較小的示波器裝置；
• OS-或編譯器 - 特定代碼分開以簡化進化；
• 重命名為混亂的類型，例如TSQLRecord ，為TOrm ， TSQLRest變成TRest ...;
• 偏向於繼承，例如TRest類分為適當的REST/ORM/SOA類 - 和文件夾；
• 繞過Delphi的編譯器內部錯誤，例如，EG更改了未型的const/var更改為指針，或者減小了單位的大小；
• 完整重寫整個RTTI，JSON和REST內核，以提高效率和可維護性；
• 框架asm內核的優化，使用AVX2（如果有）；
• 諸如OpenSSL ， Libdeflate或QuickJS支持之類的新功能；
• 新的異步HTTP和WebSockets服務器，可通過Let's Encrypt提供可選的HTTPS/TLS支持；
• 引入仿製藥或枚舉者等現代語法 - 但可選的兼容性。

因此，我們創建了一個全新的項目和存儲庫，因為切換到版本2引起了一些向後的不相容更改。使用了新的單位名稱，以避免在遷移過程中出現意外的碰撞問題，或者是否要保持1.18的安裝以進行兼容項目。

實踐中升級

從以前的1.18修訂升級時的快速步驟：

1. 請注意所有分裂和重命名的單元，以及為增強功能引入的一些破壞更改，因此不可能進行直接更新 - 也不想要

2. 切換到新文件夾，例如＃ lib2，而不是＃ lib

3. 下載最新2.＃如上所述的修訂文件

4. 更改您對Mormot單位的引用：

• 所有單位名稱都更改了，以避免版本之間發生碰撞；
• 查看樣品以查看主要有用單元。

5. 諮詢有關打破1.18的變化的文檔，主要是：

• 單位重構（請參見上面的第4點）；
• 類型以PUREMORMOT2模式重命名；
• Delphi 5-6和Kylix兼容性消除了；
• Bortable，LVCL，RTTI-UI棄用。