mORMot2 Download - mORMot2 Quellcode Download

mORMot2

Delphi-Quellcode

mORMot 2.3 stable

Herunterladen

Synopse Mormot 2 Framework

Ein Open-Source-Client-Server ORM/SOA/MVC-Framework im modernen Objekt Pascal

Happy Mormot

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

Vielen Dank an alle Mitwirkenden!

Hinweis: Diese Version 2 ersetzt Mormot 1.18, die sich jetzt im nur Wartungsmodus befindet. Erwägen Sie, Mormot 2 für ein neues oder wartbares Projekt zu verwenden.

Ressourcen

Sie können mehr über Mormot 2 in:

seine offizielle Dokumentation (in Arbeit);
der Probenordner;
die Thomas -Tutorials;
das Synopse -Forum;
der Synopse -Blog;
der Quellcode src -Unterordner;
Die alte Mormot 1 -Dokumentation, die immer noch hauptsächlich für die neue Version gilt - insbesondere für die Design-/konzeptionellen Teile.

Um über Mormot zu besprechen, können Sie neben unserem offiziellen Forum teilnehmen:

die Mormot -Telegrammgruppe;
Der Mormot Discord Server.

Diese Diskussionsgruppen werden nicht von Synopse verwaltet, sondern von einigen Mormot 2 -Benutzern: Vielen Dank an sie!

Wenn Sie es wert sind, es wert zu verwenden, sollten Sie Mormot 2 Dev sponsern, wenn Sie können - und noch besser durch das Teilen Ihrer eigenen Commits. :-)

Präsentation

Mormot was?

Synopse Mormot 2 ist ein Open-Source-Client-Server-ORM-SOA-MVC-Framework für Delphi 7 bis zu Delphi 12 Athenes und FPC 3.2/Trunk, das Windows/Linux/BSD/MacOS für Server sowie eine Plattform für Clients (einschließlich Mobilfunk oder AJAX) abzielt.

Mormot -Karte

Die Hauptmerkmale von Mormot sind daher:

Ein optimierter Cross-Compiler- und plattformübergreifender JSON/UTF-8 und RTTI-Kernel;
Direkter SQL- und NoSQL -Datenbankzugriff (EG SQLite3, PostgreSQL, Oracle, MSSQL, OLEDB, ODBC, MongoDB);
ORM/ODM: Objekte Persistenz in fast jeder Datenbank (SQL oder NoSQL);
SOA: Organisieren Sie Ihre Geschäftslogik in REST -Diensten, die als interface definiert sind.
Convention-Over-Configuration REST/JSON-Router, lokal oder über http/https/webockets;
Kunden: Konsumieren Sie Ihre Daten oder Dienste von einer Plattform über Orm/SOA -APIs.
Web MVC: Veröffentlichen Sie Ihren ORM/SOA -Prozess als reaktionsschnelle Webanwendungen.
Viele andere wiederverwendbare Steine (z. B. Unicode, Kryptographie, Netzwerk, Fäden, Wörterbücher, Protokollierung, binäre Serialisierung, Varianten, Generika, plattformübergreifende ...).

Mormot betont Geschwindigkeit und Vielseitigkeit und nutzt die Vorteile des modernen Objekts Pascal Native Code und einfach zu deplozierende Lösungen, senkt die Bereitstellungskosten und steigern den ROI. Es kann verwendet werden:

Fügen Sie einfache Anwendungen für Hobbyisten einfache ORM- oder Client-Server-Funktionen hinzu.
Oder lassen Sie erfahrene Benutzer skalierbare Service-basierte (DDD) -Projekte für ihre Kunden entwickeln.
oder nutzen Sie FPC-plattformübergreifende Fähigkeiten mit einer vorhandenen Delphi-Codebasis, um die nächsten Jahrzehnte zu nutzen,
Viel Spaß und sehen Sie die moderne Objekte Pascal herausfordern die neuesten Sprachen oder Frameworks.

Unterordner

Der Mormot 2- Repository-Inhalt ist in die folgenden Unterordner organisiert:

src ist der Hauptquellcodeordner, in dem Sie das eigentliche Framework finden sollten.
packages enthält IDE -Pakete und -Tools, um Ihre Entwicklerumgebung einzurichten.
static enthält Rohbibliothek .o / .obj -Dateien, die für FPC und Delphi Static Links benötigt werden;
test definiert die Regressionstests aller Rahmenfunktionen.
res , um einige Ressourcen zu kompilieren, die in src verwendet wurden - z. B. die static Binärdateien von Drittanbietern;
doc hält die Dokumentation des Rahmens;
ex enthält verschiedene Proben.

Fühlen Sie sich frei, die Quelle und die eingebrachte Dokumentation zu erkunden.

MPL/GPL/LGPL Drei-Lizenz

Der Rahmen ist unter einem disjunktiven Drei-Lizenz-Drei-Lizenz lizenziert, wobei Sie die Wahl eines der drei folgenden Sätze kostenloser Software-/Open-Source-Lizenzbegriffe haben:

Mozilla Public Lizenz, Version 1.1 oder höher;
GNU General Public Lizenz, Version 2.0 oder höher;
GNU Lesser allgemeine öffentliche Lizenz, Version 2.1 oder höher.

Dies ermöglicht die Verwendung unseres Codes in so weit wie möglich eine Vielzahl von Softwareprojekten und führt dennoch die Kopie-Links für den von uns geschriebenen Code bei. Siehe die vollständigen Lizenzbegriffe.

Schneller Start

Compiler -Ziele

Der Framework -Quellcode:

Versucht, mit FPC -Stall und Delphi 7 und Up kompatibel zu bleiben;
Wird derzeit gegen FPC 3.2.3 (Fixes-3_2) und Lazarus 2.2.5 (Fixes_2_2), Delphi 7, 2007, 2009, 2010, XE4, XE7, XE8, 10.4 und 11.1 validiert.

Beachten Sie, dass FPC 3.2.2 eine Regression mit Variantenspätbindung aufweist. Verwenden Sie stattdessen FPC 3.2.2 Fixes.

Auf Delphi ist nur das Windows-Ziel für Mormot General Units verfügbar. Sie können jedoch die plattformübergreifenden Client-Einheiten für alle Delphi-Ziele verwenden. FPC ist ein viel besserer und konsistenter plattformübergreifender Compiler, den wir gerne unterstützen.

Bitte senden Sie Pull-Anfragen für nicht validierte Versionen.

Installation

Holen Sie sich die Quelle, Luke!

Durch Klonen des Repositorys (bevorzugt):
- git clone https://github.com/synopse/mORMot2.git in z c:githubmORMot2 ,
- und laden und extrahieren Sie die neuesten https://synopse.info/files/mormot2static.tgz oder https://synopse.info/files/mormot2static.7z in c:githubmORMot2static .
oder als direkter Download einer bestimmten Version (z. B. für ein Build -Skript):
- Laden Sie einen Quellcode (ZIP) -Rease (Https://github.com/synopse/mormot2/releases herunter und extrahieren Sie ihn in d:mormot2 , extrahieren Sie.
- und laden und extrahieren Sie den zugehörigen mormot2static.tgz oder mormot2static.7z -Dateiinhalt in d:mormot2static .

Richten Sie Ihre Lieblings -IDE ein:

Auf Lazarus:
- Öffnen Sie einfach das /packages/lazarus/mormot2.lpk -Paket;
- und mormot2ui.lpk bei Bedarf.
Auf Delphi:
- Erstellen d:mormot2src eine neue Umgebungsvariable mormot2 mit vollem Pfad zu Ihrem Mormot 2 src -Unterbeordner ( Tools - Optionen - IDE - Umgebungsvariablen ), z c:githubmORMot2src
- Fügen Sie Ihren IDE -Bibliothekspfaden den folgenden Zeichenfolge hinzu (für alle Zielplattformen, dh Win32 und 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
- (Noch) wird kein IDE- oder UI -Paket benötigt.

Entdecken und genießen:

Öffnen und kompilieren Sie test/mormot2tests.dpr in der IDE und führen Sie die Regressionstests auf Ihrer Maschine durch.
Durchsuchen Sie den Beispiel -Ordner (in Arbeit) - insbesondere in Thomas -Tutorials, die realistisch und pädagogisch sind.
Beginnen Sie von einem Beispiel und befolgen Sie die Dokumentation.
Fühlen Sie sich frei, einen Beitrag zu leisten, indem Sie Verbesserungen und Patches für dieses sich schnell entwickelnde Projekt veröffentlichen.

Für die Sicherheit sind die SHA-256-Überprüfungen der aktuellen Version der heruntergeladenen Binärdateien, wie in unserem Server https://synopse.info/files veröffentlicht, in dieser Datei Repository static/dev.sha256 verfügbar.

Aus Version 1.18 kommen

Warum eine funktionierende Lösung neu schreiben?

Der Mormot -Rahmen blieb jahrelang in Revision 1.18 und war Zeit für ein vollständiges Refactoring.

Die wichtigsten Refactoring -Punkte versuchten, den festen Prinzipien besser zu befolgen:

Wechseln Sie zu einer strengeren Versionsrichtlinie mit regelmäßigen Veröffentlichungen.
Splits Haupteinheiten ( SynCommons.pas , mORMot.pas ) in kleinere Einheiten mit senkmal refinierten Einheiten;
OS- oder Compiler-spezifischer Code getrennt, um die Entwicklung zu erleichtern;
Verwirrende Typen umbenennen, z. B. TSQLRecord in TOrm , TSQLRest in TRest ...;
Bevorzugung der Zusammensetzung der Erbschaft, der z. B. der TRest -Klasse in ordnungsgemäße Ruhe/ORM/SOA -Klassen - und Ordner;
Umgehende Compiler interne Fehler auf Delphi, z. B. änderte sich nicht typed const/var in Zeiger oder reduzierte die Größe der Einheiten.
Vollständige Umschreiben der gesamten RTTI-, JSON- und REST -Kerne, um eine bessere Effizienz und Wartbarkeit zu erzielen;
Optimierung des Framework asm -Kernels unter Verwendung von AVX2, falls verfügbar;
Neue Funktionen wie OpenSSL , Libdeflate oder QuickJS Support;
Neue asynchrone HTTP- und WebSockets -Server mit optionalem HTTPS/TLS -Support über Let's Encrypt;
Führen Sie moderne Syntax wie Generika oder Aufzähler ein - jedoch optional für die Kompatibilität.

Wir haben daher ein ganz neues Projekt und ein ganz neues Repository erstellt, da die Umstellung auf Version 2 einige rückwärts unkompatible Änderungen induzierte. Es wurden neue Einheitennamen verwendet, um unerwartete Kollisionsprobleme während der Migration zu vermeiden oder wenn 1.18 für ein Kompatibilitätsprojekt installiert bleiben.

Upgrade in der Praxis

Schnelle Schritte beim Upgrade von einer früheren Überarbeitung von 1.18:

Beachten Sie alle Einheiten, in denen geteilt und umbenannt wurde, sowie einige gegenwärtige Änderungen, die für erweiterte Funktionen eingeführt wurden, daher ist ein direktes Update nicht möglich - noch gesucht
Wechseln Sie in einen neuen Ordner, z. B. # lib2 anstelle von # lib
Laden Sie die neuesten 2.# Revisionsdateien herunter, wie oben angegeben
Ändern Sie Ihre Verweise auf Mormot -Einheiten:

Alle Einheitennamen geändert, um eine Kollision zwischen den Versionen zu vermeiden.
Schauen Sie sich die Proben an, um die wichtigsten nützlichen Einheiten zu sehen.