mORMot2

إطار Synopse Mormot 2

إطار عمل عميل ORM/SOA/MVC مفتوح المصدر

(ج) 2008-2024 Synopse Informatique - Arnaud Bouchez

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

شكرا لجميع المساهمين!

إشعار: يحل هذا الإصدار 2 محل Mormot 1.18 الذي هو الآن في وضع الصيانة فقط. فكر في استخدام Mormot 2 لأي مشروع جديد أو قابل للصيانة.

موارد

يمكنك العثور على المزيد حول Mormot 2 في:

• وثائقها الرسمية (العمل قيد التقدم) ؛
• مجلد العينات.
• دروس توماس.
• منتدى Synopse ؛
• مدونة Synopse ؛
• رمز المصدر src الفرعي.
• وثائق Mormot 1 القديمة التي لا تزال تنطبق في الغالب على الإصدار الجديد - وخاصة الأجزاء التصميم/المفاهيمية.

للمناقشة حول Mormot ، بالإضافة إلى المنتدى الرسمي ، يمكنك الانضمام:

• مجموعة Mormot Telegram ؛
• خادم Discord Mormot.

لا تتم إدارة مجموعات المناقشة هذه بواسطة Synopse ، ولكن من قبل بعض مستخدمي Mormot 2 : شكرًا جزيلاً لهم!

إذا وجدت أنه يستحق الاستخدام ، فيرجى التفكير في رعاية Mormot 2 Dev إذا كنت تستطيع - وحتى من الأفضل من خلال مشاركة الاهتمامات الخاصة بك. :-)

عرض تقديمي

Mormot ماذا؟

Synopse Mormot 2 هو إطار عمل ORM SOA MVC لخادم العميل مفتوح المصدر لـ Delphi 7 Up to Delphi 12 Athenes و FPC 3.2/trunk ، ويستهدف Windows/Linux/BSD/MacOS للخوادم ، وأي منصة للعملاء (بما في ذلك الهاتف المحمول أو AJAX).

لذلك فإن الميزات الرئيسية للمورمون هي:

• محسّن عبر mompiler و json/utf-8 و rtti kernel ؛
• الوصول المباشر SQL و NOSQL (EG SQLITE3 ، Postgresql ، Oracle ، MSSQL ، OLEDB ، ODBC ، MongoDB) ؛
• ORM/ODM: استمرار الكائنات على أي قاعدة بيانات تقريبًا (SQL أو NOSQL) ؛
• SOA: تنظيم منطق عملك إلى خدمات REST المعرّفة على أنها interface ؛
• REST-Over-Over-Configuration REST/JSON ROUTER ، محليًا أو أكثر من http/https/websockets ؛
• العملاء: استهلك بياناتك أو خدماتك من أي منصة ، عبر واجهات برمجة تطبيقات ORM/SOA ؛
• Web MVC: نشر عملية ORM/SOA كتطبيقات ويب مستجيبة ؛
• الكثير من الطوب الآخر القابل لإعادة الاستخدام (مثل Unicode ، تشفير ، شبكة ، مؤشرات الترابط ، القواميس ، تسجيل التسجيل ، التسلسل الثنائي ، المتغيرات ، الأدوية الجيرية ، المنصات المتقاطعة ...).

مع التأكيد على السرعة والتنوع ، يقوم Mormot بتعزيز مزايا الكود الأصلي للكائنات الحديثة وحلول سهلة النشر ، مما يقلل من تكلفة النشر وزيادة العائد على الاستثمار. يمكن استخدامه:

• لإضافة ميزات ORM أو خادم العميل الأساسية إلى تطبيقات بسيطة للهواة ،
• أو السماح للمستخدمين ذوي الخبرة بتطوير مشاريع قابلة للتطوير (DDD) لعملائهم ،
• أو الاستفادة من قدرات FPC عبر المنصات مع قاعدة كود دلفي الحالية ، لتبني العقود المقبلة ،
• استمتع وشاهد Modern Object Pascal تحدي أحدث اللغات أو الأطر.

المرحلين الفرعيين

يتم تنظيم محتوى مستودع Mormot 2 في المقاتلين الفرعيين التاليين:

• src هو مجلد الكود المصدر الرئيسي ، حيث يجب أن تجد الإطار الفعلي ؛
• تحتوي packages على حزم وأدوات IDE لإعداد بيئة DEV الخاصة بك ؛
• يحتوي static على ملفات RAW Library .o / .obj اللازمة لربط FPC و Delphi Static ؛
• يحدد test اختبارات الانحدار لجميع ميزات الإطار ؛
• res لتجميع بعض الموارد المستخدمة في src - على سبيل المثال ثنائيات الطرف الثالث static ؛
• doc يحمل توثيق الإطار ؛
• ex يحتوي على عينات مختلفة.

لا تتردد في استكشاف المصدر ، والوثائق المحصورة.

MPL/GPL/LGPL Three-Cense

تم ترخيص الإطار بموجب ترخيص ثلاثي الترخيص غير المرغوب فيه مما يتيح لك اختيار إحدى المجموعات الثلاثة التالية لشروط ترخيص البرامج/المصدر المفتوح المجانية:

• رخصة موزيلا العامة ، الإصدار 1.1 أو أحدث ؛
• رخصة عامة عامة GNU ، الإصدار 2.0 أو الأحدث ؛
• GNU أقل رخصة عامة عامة ، الإصدار 2.1 أو أحدث.

هذا يسمح باستخدام الكود لدينا في مجموعة واسعة من مشاريع البرمجيات قدر الإمكان ، مع الحفاظ على نسخ اليسار على الكود الذي كتبناه. انظر شروط الترخيص الكاملة.

بداية سريعة

أهداف المترجم

رمز مصدر الإطار:

• يحاول البقاء متوافقًا مع FPC مستقر و Delphi 7 وما فوق ؛
• تم التحقق من صحة حاليًا مقابل FPC 3.2.3 (إصلاحات -3_) و Lazarus 2.2.5 (Fixes_2_2) ، Delphi 7 ، 2007 ، 2009 ، 2010 ، XE4 ، XE7 ، XE8 ، 10.4 و 11.1.

لاحظ أن FPC 3.2.2 لديه انحدار مع ربط المتأخر المتأخر - استخدم فرع FPC 3.2.2 بدلاً من ذلك.

في Delphi ، يتوفر هدف Windows فقط لوحدات Mormot General ، ولكن يمكنك استخدام وحدات عملاء المنصات عبر المنصات على جميع أهداف Delphi. FPC هو مترجم أفضل بكثير ومتسق عبر المنصات ، ونحن ندعم بكل سرور.

يرجى تقديم طلبات سحب الإصدارات غير المقيدة.

تثبيت

1. الحصول على المصدر ، لوقا!

• عن طريق استنساخ المستودع (المفضل):
  • git clone https://github.com/synopse/mORMot2.git in eg c:githubmORMot2 ،
  • وقم بتنزيل واستخراج أحدث https://synopse.info/files/mormot2static.tgz أو https://synopse.info/files/mormot2static.7z في c:githubmORMot2static .
• أو كتنزيل مباشر لإصدار معين (على سبيل المثال لبرنامج نصي بناء):
  • قم بتنزيل إصدار رمز مصدر (ZIP) من https://github.com/synopse/mormot2/releases واستخرجه على سبيل المثال في d:mormot2 ،
  • وقم بتنزيل واستخراج محتوى ملف mormot2static.tgz أو mormot2static.7z في d:mormot2static .

2. قم بإعداد IDE المفضل لديك:

• على لازاروس:
  • فقط فتح وتجميع /packages/lazarus/mormot2.lpk lazarus/mormot2.lpk حزمة ؛
  • و mormot2ui.lpk إذا لزم الأمر.
• على دلفي:
  • قم بإنشاء متغير بيئة جديد 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 أو واجهة المستخدم (حتى الآن).

3. اكتشف واستمتع:

• فتح وتجميع test/mormot2tests.dpr في IDE ، وقم بتشغيل اختبارات الانحدار على جهازك.
• تصفح مجلد الأمثلة (العمل قيد التقدم) - وخاصة البرامج التعليمية توماس التي هي واقعية وتربوية.
• ابدأ من مثال ، واتبع الوثائق.
• لا تتردد في المساهمة من خلال نشر التحسينات والبقع في هذا المشروع المتطور بسرعة.

من أجل السلامة ، تتوفر اختبارات SHA-256 من الإصدار الحالي من الملفات الثنائية التي تم تنزيلها ، كما تم نشرها في خادم https://synopse.info/files ، في ملف مستودع static/dev.sha256 .

قادم من الإصدار 1.18

لماذا إعادة كتابة حل العمل؟

بقي إطار Mormot في المراجعة 1.18 لسنوات ، وكان الوقت قد حان لإعادة إنشاء كامل.

حاولت نقاط إعادة الطرد الرئيسية اتباع مبادئ صلبة بشكل أفضل:

• التحول إلى سياسة إصدار أكثر صرامة ، مع إصدارات منتظمة ؛
• تقسيم الوحدات الكبيرة الرئيسية ( SynCommons.pas ، mORMot.pas ) إلى وحدات أصغر نطاقًا ؛
• رمز OS- أو المترجم مفصولة لتخفيف التطور ؛
• إعادة تسمية الأنواع المربكة ، مثل TSQLRecord في TOrm ، TSQLRest في TRest ... ؛
• تفضيل التكوين على الميراث ، على سبيل المثال ، تقسيم فئة TRest إلى فئات راحة/ORM/SOA المناسبة - والمجلدات ؛
• التحايل على الأخطاء الداخلية للمترجم على Delphi ، على سبيل المثال ، تم تغيير const/var غير النوع إلى مؤشرات ، أو خفض حجم الوحدات ؛
• إعادة كتابة كاملة من RTTI كلها ، JSON و REST CORES ، لتحسين الكفاءة والقدرة على الصيانة ؛
• تحسين kernel الإطار asm ، باستخدام AVX2 إذا كان ذلك متاحًا ؛
• ميزات جديدة مثل OpenSSL أو Libdeflate أو QuickJS دعم ؛
• خوادم HTTP و WebSockets غير المتزامنة الجديدة ، مع دعم HTTPS/TLS اختياري عبر Let's Encrypt ؛
• إدخال بناء الجملة الحديثة مثل الأدوية أو العدادات - ولكن اختياري للتوافق.

لذلك ، أنشأنا مشروعًا ومستودعًا جديدًا بالكامل ، نظرًا لأن التحول إلى الإصدار 2 تسبب في بعض التغييرات غير المتوافقة مع الإصدارات. تم استخدام أسماء الوحدات الجديدة ، لتجنب مشكلات التصادم غير المتوقعة أثناء الترحيل ، أو إذا كان 1.18 سيظل مثبتًا لمشروع التوافق.

ترقية في الممارسة العملية

خطوات سريعة عند الترقية من مراجعة سابقة 1.18:

1. لاحظ جميع الوحدات التي تقسمها وإعادة تسميتها ، وبعض التغييرات التي تم تقديمها للميزات المحسّنة ، وبالتالي التحديث المباشر غير ممكن - ولا مطلوب

2. التبديل إلى مجلد جديد ، على سبيل المثال # lib2 بدلاً من # lib

3. قم بتنزيل أحدث 2. ملفات المراجعة كما هو مذكور أعلاه مباشرة

4. قم بتغيير مراجعك إلى وحدات Mormot :

• تغيرت جميع أسماء الوحدات ، لتجنب الاصطدام بين الإصدارات ؛
• انظر إلى العينات لرؤية الوحدات المفيدة الرئيسية.

5. راجع الوثائق حول كسر التغييرات من 1.18 ، بشكل رئيسي:

• وحدات إعادة إنشاء (انظر النقطة 4 أعلاه) ؛
• الأنواع التي تم تسميتها في وضع PUREMORMOT2 ؛
• تمت إزالة توافق Delphi 5-6 و Kylix ؛
• Bigtable ، LVCL ، RTTI-UI تم إهمالها.