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弃用。