mORMot2

Synopse Mormot 2 Framework

เฟรมเวิร์กโอเพนซอร์สไคลเอนต์เซิร์ฟเวอร์ ORM/SOA/MVC

(c) 2008-2024 Synopse Informatique - Arnaud Bouchez

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

ขอบคุณผู้มีส่วนร่วมทุกคน!

ข้อสังเกต: เวอร์ชัน 2 นี้แทนที่ Mormot 1.18 ซึ่งขณะนี้อยู่ในโหมดบำรุงรักษาเท่านั้น พิจารณาใช้ Mormot 2 สำหรับโครงการใหม่หรือบำรุงรักษาใด ๆ

ทรัพยากร

คุณสามารถค้นหาเพิ่มเติมเกี่ยวกับ Mormot 2 ใน:

• เอกสารอย่างเป็นทางการ (ทำงานอยู่ระหว่างดำเนินการ);
• โฟลเดอร์ตัวอย่าง
• บทเรียนโทมัส;
• ฟอรัม Synopse;
• บล็อก Synopse;
• ซอร์สโค้ด src Sub-Folder;
• เอกสาร Mormot 1 เก่าซึ่งส่วนใหญ่ยังคงใช้กับเวอร์ชันใหม่โดยเฉพาะอย่างยิ่งการออกแบบ/ส่วนแนวคิด

เพื่อหารือเกี่ยวกับ Mormot นอกเหนือจากฟอรัมอย่างเป็นทางการของเราคุณสามารถเข้าร่วม:

• กลุ่ม Mormot Telegram;
• เซิร์ฟเวอร์ Mormot Discord

กลุ่มการสนทนาเหล่านั้นไม่ได้รับการจัดการโดย Synopse แต่โดยผู้ใช้ Mormot 2 บางคน: ขอบคุณมากสำหรับพวกเขา!

หากคุณพบว่ามันคุ้มค่าที่จะใช้โปรดพิจารณาสปอนเซอร์ Mormot 2 Dev หากคุณทำได้ - และดียิ่งขึ้นผ่านการแบ่งปันความมุ่งมั่นของคุณเอง -

การนำเสนอ

Mormot อะไร?

Synopse Mormot 2 เป็นเฟรมเวิร์กโอเพนซอร์ซ-เซิร์ฟเวอร์ Orm SOA MVC สำหรับ Delphi 7 ถึง Delphi 12 Athenes และ FPC 3.2/trunk โดยกำหนดเป้าหมายไปที่ Windows/Linux/BSD/MacOS สำหรับเซิร์ฟเวอร์และแพลตฟอร์มใด ๆ สำหรับลูกค้า (รวมถึงมือถือหรือ AJAX)

คุณสมบัติหลักของ Mormot คือ:

• เคอร์เนล cross-compiler และเคอร์เนลข้ามแพลตฟอร์ม JSON/UTF-8 และ RTTI;
• การเข้าถึงฐานข้อมูล SQL และ NOSQL โดยตรง (เช่น SQLITE3, PostgreSQL, Oracle, MSSQL, OLEDB, ODBC, MongoDB);
• ORM/ODM: การคงอยู่ของวัตถุในเกือบทุกฐานข้อมูล (SQL หรือ NOSQL);
• SOA: จัดระเบียบตรรกะทางธุรกิจของคุณเป็นบริการ REST ที่กำหนดเป็น interface
• การประชุม-การกำหนดค่าการกำหนดค่า/เราเตอร์ JSON, ท้องถิ่นหรือมากกว่า http/https/websockets;
• ลูกค้า: ใช้ข้อมูลหรือบริการของคุณจากแพลตฟอร์มใด ๆ ผ่าน API ORM/SOA;
• Web MVC: เผยแพร่กระบวนการ ORM/SOA ของคุณเป็นเว็บแอปพลิเคชันที่ตอบสนองได้
• อิฐที่สามารถนำกลับมาใช้ใหม่ได้อีกมากมาย (เช่น Unicode, Cryptography, เครือข่าย, เธรด, พจนานุกรม, การบันทึก, การทำให้เป็นอนุกรมไบนารี, ตัวแปร, ยาชื่อสามัญ, ข้ามแพลตฟอร์ม ... )

การเน้นความเร็วและความเก่งกาจ Mormot ใช้ประโยชน์จากข้อดีของรหัสพื้นเมือง Pascal ที่ทันสมัยและโซลูชันที่ใช้งานง่ายลดต้นทุนการปรับใช้และเพิ่ม ROI สามารถใช้:

• เพื่อเพิ่มคุณสมบัติ ORM หรือเซิร์ฟเวอร์ไคลเอนต์พื้นฐานให้กับแอพพลิเคชั่นง่าย ๆ สำหรับนักสมัครเล่น
• หรือให้ผู้ใช้ที่มีประสบการณ์พัฒนาโครงการตามบริการ (DDD) ที่ปรับขนาดได้สำหรับลูกค้า
• หรือใช้ประโยชน์จากความสามารถข้ามแพลตฟอร์ม FPC ด้วย Delphi Codebase ที่มีอยู่เพื่อโอบกอดทศวรรษหน้า
• ขอให้สนุกและดูวัตถุที่ทันสมัย Pascal Challenge ภาษาหรือเฟรมเวิร์กล่าสุด

โฟลเดอร์ย่อย

เนื้อหาที่เก็บ Mormot 2 ถูกจัดระเบียบเป็นโฟลเดอร์ย่อยต่อไปนี้:

• src เป็นโฟลเดอร์ซอร์สโค้ดหลักที่คุณควรค้นหากรอบจริง
• packages มีแพ็คเกจและเครื่องมือ IDE ในการตั้งค่าสภาพแวดล้อม dev ของคุณ
• static มีไลบรารีดิบ .o / .obj ไฟล์ที่จำเป็นสำหรับการเชื่อมโยง FPC และ Delphi Static;
• test กำหนดการทดสอบการถดถอยของคุณสมบัติทั้งหมด
• res เพื่อรวบรวมทรัพยากรบางอย่างที่ใช้ภายใน src - เช่นไบนารีบุคคลที่สามแบบ static
• doc ถือเอกสารของกรอบ;
• ex มีตัวอย่างต่าง ๆ

อย่าลังเลที่จะสำรวจแหล่งที่มาและเอกสารประกอบ

MPL/GPL/LGPL สามใบอนุญาต

เฟรมเวิร์กได้รับใบอนุญาตภายใต้ใบอนุญาตสามใบที่แยกออกมาให้คุณเลือกหนึ่งในสามชุดของชุดซอฟต์แวร์/โอเพนซอร์สฟรีต่อไปนี้:

• ใบอนุญาตสาธารณะ Mozilla เวอร์ชัน 1.1 หรือใหม่กว่า;
• ใบอนุญาตสาธารณะ GNU ทั่วไปเวอร์ชัน 2.0 หรือใหม่กว่า;
• GNU Lesser Lesser Public Public License, เวอร์ชัน 2.1 หรือใหม่กว่า

สิ่งนี้ช่วยให้การใช้รหัสของเราในโครงการซอฟต์แวร์ที่หลากหลายที่สุดเท่าที่จะเป็นไปได้ ดูเงื่อนไขการออกใบอนุญาตเต็มรูปแบบ

เริ่มต้นอย่างรวดเร็ว

เป้าหมายคอมไพเลอร์

ซอร์สโค้ดเฟรมเวิร์ก:

• พยายามที่จะอยู่ร่วมกับ FPC เสถียรและ Delphi 7 ขึ้นไป
• ขณะนี้ได้รับการตรวจสอบกับ FPC 3.2.3 (FIXES-3_2) และ 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 เป็นเช่น 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 ที่คุณชื่นชอบ:

• บน Lazarus:
  • เพียงเปิดและรวบรวม /packages/lazarus/mormot2.lpk แพ็คเกจ;
  • และ mormot2ui.lpk ถ้าจำเป็น
• บน Delphi:
  • สร้างตัวแปรสภาพแวดล้อมใหม่ mormot2 ด้วยเส้นทางเต็มไปยัง MORMOT 2 src Sub -Folder ( เครื่องมือ - ตัวเลือก - 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. ค้นพบและเพลิดเพลิน:

• เปิดและรวบรวม test/mormot2tests.dpr ใน IDE และเรียกใช้การทดสอบการถดถอยบนเครื่องของคุณ
• เรียกดูโฟลเดอร์ตัวอย่าง (ทำงานอยู่ระหว่างดำเนินการ) - โดยเฉพาะอย่างยิ่งการสอนโทมัสซึ่งเป็นจริงและการสอน
• เริ่มต้นจากตัวอย่างและทำตามเอกสาร
• อย่าลังเลที่จะมีส่วนร่วมโดยการโพสต์การปรับปรุงและแพตช์ไปยังโครงการที่พัฒนาอย่างรวดเร็วนี้

เพื่อความปลอดภัย SHA-256 ตรวจสอบเวอร์ชันปัจจุบันของไฟล์ไบนารีที่ดาวน์โหลดมาซึ่งเผยแพร่ในเซิร์ฟเวอร์ https://synopse.info/files ของเรามีอยู่ในไฟล์ static/dev.sha256

มาจากเวอร์ชัน 1.18

ทำไมต้องเขียนโซลูชันการทำงานใหม่

Mormot Framework อยู่ในการแก้ไข 1.18 เป็นเวลาหลายปีและเป็นเวลาสำหรับการปรับโครงสร้างใหม่อย่างเต็มรูปแบบ

จุด refactoring หลักพยายามที่จะปฏิบัติตามหลักการที่เป็นของแข็งได้ดีขึ้น:

• เปลี่ยนไปใช้นโยบายการกำหนดเวอร์ชันที่เข้มงวดยิ่งขึ้นด้วยการเปิดตัวปกติ
• แยกหน่วยใหญ่หลัก ( SynCommons.pas , mORMot.pas ) เป็นหน่วยที่มีขอบเขตขนาดเล็กกว่า
• รหัสเฉพาะของ OS- หรือคอมไพเลอร์คั่นเพื่อความสะดวกในการวิวัฒนาการ
• เปลี่ยนชื่อประเภทที่สับสนเช่น TSQLRecord เป็น TOrm , TSQLRest เป็น TRest ... ;
• ความโปรดปรานองค์ประกอบเหนือมรดกเช่นคลาส TRest แบ่งออกเป็นคลาสที่เหมาะสม/orm/soa - และโฟลเดอร์;
• ข้อผิดพลาดภายในคอมไพเลอร์ของคอมไพเลอร์บน Delphi เช่นเปลี่ยน const/var ที่ไม่ได้เปลี่ยนเป็นพอยน์เตอร์หรือลดขนาดของหน่วย
• การเขียนเต็มรูปแบบทั้งหมดของ RTTI, JSON และ REST CORES ทั้งหมดเพื่อประสิทธิภาพและการบำรุงรักษาที่ดีขึ้น
• การเพิ่มประสิทธิภาพของเคอร์เนล 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 ส่วนใหญ่:

• หน่วย refactoring (ดูจุดที่ 4 ด้านบน);
• ประเภทที่เปลี่ยนชื่อในโหมด PUREMORMOT2 ;
• ลบความเข้ากันได้ของ Delphi 5-6 และ Kylix;
• BigTable, LVCL, RTTI-UI เลิกใช้แล้ว