mORMot2

Synopse Mormot 2 Framework

Un cadre Open Source Client-Server ORM / SOA / MVC dans l'objet moderne Pascal

(c) 2008-2024 Synopse informatique - Arnaud Bouchez

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

Merci à tous les contributeurs!

Remarque: Cette version 2 remplace Mormot 1.18 qui est maintenant en mode de maintenance uniquement. Envisagez d'utiliser Mormot 2 pour tout projet nouveau ou maintenable.

Ressources

Vous pouvez en savoir plus sur Mormot 2 in:

• sa documentation officielle (travail en cours);
• le dossier des échantillons;
• Les tutoriels Thomas;
• le forum Synopse;
• Le blog Synopse;
• le sous-dossier src code source;
• L'ancienne documentation Mormot 1 qui s'applique encore principalement à la nouvelle version - en particulier les parties de conception / conceptuelles.

Pour discuter de Mormot , en plus de notre forum officiel, vous pouvez vous joindre:

• le groupe de télégrammes Mormot;
• le serveur Mormot Discord.

Ces groupes de discussion ne sont pas gérés par Synopse, mais par certains utilisateurs de Mormot 2 : merci beaucoup à eux!

Si vous trouvez qu'il vaut la peine d'être utilisé, veuillez envisager de parrainer Mormot 2 Dev si vous le pouvez - et encore mieux en partageant vos propres engagements. :-)

Présentation

Mormot quoi?

Synopse Mormot 2 est un cadre Open Source Client-Server ORM SOA MVC pour Delphi 7 jusqu'à Delphi 12 Athenes et FPC 3.2 / Trunk, ciblant Windows / Linux / BSD / MacOS pour les serveurs, et toute plate-forme pour les clients (y compris mobile ou ajax).

Les principales caractéristiques de Mormot sont donc:

• Un compilateur transversal optimisé et le noyau JSON / UTF-8 et RTTI et RTTI;
• Accès de la base de données SQL et NOSQL direct (par exemple, SQLite3, PostgreSQL, Oracle, MSSQL, OLEDB, ODBC, MongoDB);
• ORM / ODM: Persistance des objets sur presque toutes les bases de données (SQL ou NOSQL);
• SOA: Organisez votre logique commerciale en services de repos définis comme interface ;
• Routeur REST / JSON de Convention-Over-Configuration, localement ou sur HTTP / HTTPS / WebSockets;
• CLIENTS: Consommez vos données ou services à partir de n'importe quelle plate-forme, via les API ORM / SOA;
• Web MVC: publiez votre processus ORM / SOA en tant qu'applications Web réactives;
• Beaucoup d'autres briques réutilisables (par exemple Unicode, cryptographie, réseau, threads, dictionnaires, journalisation, sérialisation binaire, variantes, génériques, plate-forme multipliée ...).

Soulignant la vitesse et la polyvalence, Mormot tire parti des avantages du code natif de l'objet moderne Pascal et des solutions faciles à déposer, de la réduction du coût de déploiement et de l'augmentation du retour sur investissement. Il peut être utilisé:

• Pour ajouter des fonctionnalités de base ORM ou Client-Server à des applications simples pour les amateurs,
• Ou permettez aux utilisateurs expérimentés de développer des projets basés sur les services (DDD) pour leurs clients,
• ou tirer parti des capacités de plate-forme multipliée FPC avec une base de code Delphi existante, pour adopter les prochaines décennies,
• Amusez-vous et voyez l'objet moderne Pascal défier les dernières langues ou cadres.

Sous-dossiers

Le contenu du référentiel MormOT 2 est organisé dans les sous-repliants suivants:

• src est le dossier principal du code source, où vous devriez trouver le cadre réel;
• packages contient des packages et des outils IDE pour configurer votre environnement de développement;
• static contient la bibliothèque RAW Fichiers .o / .obj nécessaires pour FPC et Delphi STATIC LINKING;
• test définit les tests de régression de toutes les caractéristiques du cadre;
• res pour compiler certaines ressources utilisées dans src - par exemple les binaires tiers static ;
• doc détient la documentation du cadre;
• ex contient divers échantillons.

N'hésitez pas à explorer la source et la documentation inclinée.

MPL / GPL / LGPL trois licences

Le cadre est autorisé sous une licence disjonctive à trois licences, ce qui vous donne le choix de l'un des trois ensembles suivants de termes de licence de logiciel libre / open source:

• Licence publique de Mozilla, version 1.1 ou version ultérieure;
• Licence publique générale GNU, version 2.0 ou version ultérieure;
• Licence publique GNU moins générale, version 2.1 ou version ultérieure.

Cela permet l'utilisation de notre code dans une plus grande variété de projets logiciels que possible, tout en conservant la copie-gauche sur le code que nous avons écrit. Voir les termes complets de licence.

Démarrage rapide

Cibles du compilateur

Le code source du framework:

• Essaie de rester compatible avec FPC Stable et Delphi 7 et plus;
• Est actuellement validé contre FPC 3.2.3 (Fixes-3_2) et Lazarus 2.2.5 (FIXES_2_2), Delphi 7, 2007, 2009, 2010, XE4, XE7, XE8, 10.4 et 11.1.

Notez que FPC 3.2.2 a une régression avec la variante de liaison tardive - Utilisez FPC 3.2.2 Firige la branche à la place.

Sur Delphi, seule la cible Windows est disponible pour les unités générales de Mormot , mais vous pouvez utiliser les unités de clients multiplateformes sur toutes les cibles Delphi. FPC est un compilateur multiplateforme bien meilleur et cohérent, nous soutenons volontiers.

Veuillez soumettre des demandes de traction pour les versions non validées.

Installation

1. Obtenez la source, Luke!

• En clonage le référentiel (préféré):
  • git clone https://github.com/synopse/mORMot2.git dans eg c:githubmORMot2 ,
  • et télécharger et extraire les derniers https://synopse.info/files/mormot2static.tgz ou https://synopse.info/files/mormot2static.7z dans c:githubmORMot2static .
• ou comme téléchargement direct d'une version donnée (par exemple pour un script de construction):
  • Téléchargez une version de code source (ZIP) depuis https://github.com/synopse/mormot2/releases et extraire, par exemple dans d:mormot2 ,
  • et télécharger et extraire son contenu de fichier mormot2static.tgz ou mormot2static.7z dans d:mormot2static .

2. Configurez votre IDE préféré:

• Sur Lazarus:
  • Ouvrez et compilez simplement le package /packages/lazarus/mormot2.lpk ;
  • et mormot2ui.lpk si nécessaire.
• Sur Delphi:
  • Créez une nouvelle variable d'environnement mormot2 avec un chemin complet vers votre sous-dossier src MormOT 2 ( Options - Options - IDE - Variables d'environnement ), par exemple c:githubmORMot2src ou d:mormot2src en fonction de l'étape 1;
  • Ajoutez la chaîne suivante à vos chemins de bibliothèque IDE (pour toutes les plates-formes cibles, IE Win32 et 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
  • Aucun package IDE ou UI n'est nécessaire (encore).

3. Découvrez et profitez:

• Ouvrez et compilez test/mormot2tests.dpr dans l'IDE et exécutez les tests de régression sur votre machine.
• Parcourez le dossier Exemples (travail en cours) - en particulier les tutoriels Thomas qui sont réalistes et pédagogiques.
• Commencez à partir d'un exemple et suivez la documentation.
• N'hésitez pas à contribuer en publiant des améliorations et des correctifs à ce projet en évolution rapide.

Pour la sécurité, les sommes de contrôle SHA-256 de la version actuelle des fichiers binaires téléchargés, tels que publiés dans notre serveur https://synopse.info/files, sont disponibles dans ce fichier de référentiel static/dev.sha256 .

Provenant de la version 1.18

Pourquoi réécrire une solution de travail?

Le cadre Mormot est resté dans la révision 1.18 pendant des années et était le temps de refactoriser.

Les principaux points de refactorisation ont essayé de mieux suivre les principes solides:

• Passez à une politique de version plus rigoureuse, avec des versions régulières;
• Diviser les grandes unités principales ( SynCommons.pas , mORMot.pas ) en unités raffinées plus petites;
• Code spécifique à l'OS ou au compilateur séparé pour faciliter l'évolution;
• Renommer les types confus, par exemple TSQLRecord dans TOrm , TSQLRest dans TRest ...;
• Favoriser la composition sur l'héritage, par exemple la classe TRest divisée en classes REST / ORM / SOA appropriées - et les dossiers;
• COUPER Les erreurs internes du compilateur sur Delphi, par exemple, le const / var non typé a changé en pointeurs ou a réduit la taille des unités;
• Réécriture complète de l'ensemble des noyaux RTTI, JSON et REST, pour une meilleure efficacité et maintenabilité;
• Optimisation du noyau asm Framework, en utilisant AVX2 si disponible;
• De nouvelles fonctionnalités comme OpenSSL , LibDeflate ou QuickJS Support;
• Nouveaux serveurs HTTP et WebSockets asynchrones, avec support HTTPS / TLS en option via Let's Encrypt;
• Introduire la syntaxe moderne comme les génériques ou les énumérateurs - mais facultatif pour la compatibilité.

Nous avons donc créé un tout nouveau projet et référentiel, car le passage à la version 2 a induit des changements non compatibles en arrière. De nouveaux noms d'unité ont été utilisés, pour éviter les problèmes de collision inattendus pendant la migration, ou si 1.18 doit rester installé pour un projet de compatibilité.

Mettre à niveau dans la pratique

Étapes rapides lors de la mise à niveau d'une révision de 1.18 précédente:

1. Remarquez toutes les unités lorsqu'elles sont partagées et renommées, et quelques modifications de rupture introduites pour les fonctionnalités améliorées, donc une mise à jour directe n'est pas possible - ni recherché

2. Passez à un nouveau dossier, par exemple # lib2 au lieu de # lib

3. Télécharger les derniers fichiers 2. # Revision comme indiqué juste ci-dessus

4. Changez vos références en unités de Mormot :

• Tous les noms d'unité ont changé, pour éviter la collision entre les versions;
• Regardez les échantillons pour voir les principales unités utiles.

5. Consultez la documentation sur la rupture des changements de 1,18, principalement:

• Unités refactoring (voir point 4 ci-dessus);
• Types renommés en mode PUREMORMOT2 ;
• Delphi 5-6 et la compatibilité Kylix ont été supprimées;
• BigTable, LVCL, RTTI-UI déprécié.