Unduh mORMot2 - Unduh Kode Sumber mORMot2

mORMot2

Kode sumber Delphi

mORMot 2.3 stable

Unduh

Sinopse Mormot 2 Framework

Kerangka kerja Open Source-Server ORM/SOA/MVC di Objek Modern Pascal

Selamat Mormot

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

Terima kasih untuk semua kontributor!

Perhatikan: Versi 2 ini menggantikan Mormot 1.18 yang sekarang dalam mode perawatan saja. Pertimbangkan untuk menggunakan Mormot 2 untuk proyek baru atau yang dapat dipelihara.

Sumber daya

Anda dapat menemukan lebih banyak tentang Mormot 2 di:

dokumentasi resminya (pekerjaan sedang berlangsung);
folder sampel;
tutorial Thomas;
Forum Sinopse;
Blog Sinopse;
Kode Sumber Sub-folder src ;
Dokumentasi Mormot 1 lama yang sebagian besar masih berlaku untuk versi baru - terutama bagian desain/konseptual.

Untuk membahas tentang Mormot , selain forum resmi kami, Anda dapat bergabung:

Grup Telegram Mormot;
Server Discord Mormot.

Kelompok -kelompok diskusi itu tidak dikelola dengan sinopse, tetapi oleh beberapa pengguna Mormot 2 : terima kasih banyak kepada mereka!

Jika Anda merasa perlu digunakan, silakan pertimbangkan untuk mensponsori Dev Mormot 2 jika Anda bisa - dan bahkan lebih baik dengan berbagi komitmen Anda sendiri. :-)

Presentasi

mormot apa?

Synopse Mormot 2 adalah kerangka kerja OPRen Source-Server-Server ORM SOA MVC untuk Delphi 7 hingga Delphi 12 Athenes dan FPC 3.2/trunk, menargetkan Windows/Linux/BSD/MacOS untuk server, dan platform apa pun untuk klien (termasuk seluler atau AJAX).

Peta Mormot

Fitur utama Mormot karenanya:

Kompiler lintas kompiler dan cross-platform JSON/UTF-8 dan kernel RTTI;
Akses database SQL dan NoSQL langsung (misalnya SQLITE3, PostgreSQL, Oracle, MSSQL, OLEDB, ODBC, MongoDB);
ORM/ODM: Kegigihan objek pada hampir semua database (SQL atau NoSQL);
SOA: Atur logika bisnis Anda ke dalam layanan REST yang didefinisikan sebagai interface ;
REST/JSON ROUTER CONVENSI-OVER-OVER-CONFIGASI/JSON, LOKAL ATAU OVER HTTP/HTTPS/WEBSOCKETS;
Klien: Konsumsi data atau layanan Anda dari platform apa pun, melalui ORM/SOA API;
Web MVC: Publikasikan proses ORM/SOA Anda sebagai aplikasi web yang responsif;
Banyak batu bata lain yang dapat digunakan kembali (misalnya unicode, kriptografi, jaringan, utas, kamus, penebangan, serialisasi biner, varian, obat generik, lintas platform ...).

Menekankan kecepatan dan keserbagunaan, Mormot memanfaatkan keunggulan kode asli objek modern Pascal dan solusi yang mudah digunakan, mengurangi biaya penyebaran dan meningkatkan ROI. Itu bisa digunakan:

Untuk menambahkan ORM dasar atau fitur server klien ke aplikasi sederhana untuk hobi,
Atau biarkan pengguna yang berpengalaman mengembangkan proyek berbasis layanan (DDD) yang dapat diskalakan untuk pelanggan mereka,
atau memanfaatkan kemampuan lintas platform FPC dengan basis kode Delphi yang ada, untuk merangkul dekade berikutnya,
Bersenang -senang dan lihat objek modern Pascal menantang bahasa atau kerangka kerja terbaru.

Sub-folder

Konten repositori Mormot 2 diatur ke dalam sub-folder berikut:

src adalah folder kode sumber utama, di mana Anda harus menemukan kerangka kerja yang sebenarnya;
packages berisi paket dan alat IDE untuk mengatur lingkungan dev Anda;
static berisi perpustakaan mentah .o / .obj file yang diperlukan untuk tautan statis FPC dan Delphi;
test mendefinisikan tes regresi dari semua fitur kerangka kerja;
res untuk mengkompilasi beberapa sumber daya yang digunakan dalam src - misalnya binari pihak ketiga static ;
doc memegang dokumentasi kerangka kerja;
ex berisi berbagai sampel.

Jangan ragu untuk mengeksplorasi sumbernya, dan dokumentasi yang dilarang.

MPL/GPL/LGPL Tiga lisensi

Kerangka kerja ini dilisensikan di bawah lisensi tiga disjunctive yang memberi Anda pilihan salah satu dari tiga set perangkat lunak gratis/istilah lisensi sumber terbuka:

Lisensi Publik Mozilla, versi 1.1 atau lebih baru;
Lisensi Publik Umum GNU, versi 2.0 atau lebih baru;
Lisensi Publik Umum GNU yang lebih rendah, versi 2.1 atau lebih baru.

Ini memungkinkan penggunaan kode kami dalam berbagai proyek perangkat lunak sebanyak mungkin, sambil tetap mempertahankan copy-left pada kode yang kami tulis. Lihat persyaratan lisensi lengkap.

Awal yang cepat

Target kompiler

Kode Sumber Kerangka:

Mencoba untuk tetap kompatibel dengan FPC Stabil dan Delphi 7 dan lebih tinggi;
Saat ini divalidasi terhadap FPC 3.2.3 (Fixes-3_2) dan Lazarus 2.2.5 (Fixes_2_2), Delphi 7, 2007, 2009, 2010, Xe4, Xe7, Xe8, 10.4 dan 11.1.

Perhatikan bahwa FPC 3.2.2 memiliki regresi dengan varian yang terlambat mengikat - Gunakan FPC 3.2.2 Perbaikan Cabang sebagai gantinya.

Di Delphi, hanya target Windows yang tersedia untuk unit umum Mormot , tetapi Anda dapat menggunakan unit klien lintas platform di semua target Delphi. FPC adalah kompiler lintas-platform yang jauh lebih baik dan konsisten, kami dengan senang hati mendukung.

Harap kirimkan permintaan tarik untuk versi yang tidak divalidasi.

Instalasi

Dapatkan sumbernya, Luke!

Dengan mengkloning repositori (lebih disukai):
- git clone https://github.com/synopse/mORMot2.git ke misalnya c:githubmORMot2 ,
- dan unduh dan ekstrak terbaru https://synopse.info/files/mormot2static.tgz atau https://synopse.info/files/mormot2static.7z ke dalam c:githubmORMot2static .
atau sebagai pengunduhan langsung rilis yang diberikan (misalnya untuk skrip build):
- Unduh rilis kode sumber (ZIP) dari https://github.com/synopse/mormot2/releases dan ekstrak misalnya ke d:mormot2 ,
- dan mengunduh dan mengekstrak konten file mormot2static.tgz atau mormot2static.7z yang terkait ke dalam d:mormot2static .

Siapkan IDE favorit Anda:

Di Lazarus:
- Cukup buka dan kompilasi paket /packages/lazarus/mormot2.lpk ;
- dan mormot2ui.lpk jika diperlukan.
Di Delphi:
- Buat variabel lingkungan baru mormot2 dengan jalur lengkap ke sub -folder Mormot 2 src Anda ( alat - opsi - IDE - variabel lingkungan ), misalnya c:githubmORMot2src atau d:mormot2src tergantung pada langkah 1;
- Tambahkan string berikut ke jalur perpustakaan IDE Anda (untuk semua platform target, IE Win32 dan 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
- Tidak ada paket IDE atau UI yang dibutuhkan (belum).

Temukan dan Nikmati:

Buka dan Kompilasi test/mormot2tests.dpr di IDE, dan jalankan tes regresi pada mesin Anda.
Jelajahi folder contoh (bekerja dalam proses) - terutama tutorial Thomas yang realistis dan pedagogis.
Mulailah dari contoh, dan ikuti dokumentasi.
Jangan ragu untuk berkontribusi dengan memposting peningkatan dan tambalan pada proyek yang berkembang dengan cepat ini.

Untuk keselamatan, checksum SHA-256 dari versi file biner yang diunduh saat ini, seperti yang diterbitkan dalam server https://synopse.info/files kami, tersedia dalam file static/dev.sha256 repositori ini.

Berasal dari versi 1.18

Mengapa menulis ulang solusi yang berfungsi?

Kerangka Mormot tetap di Revisi 1.18 selama bertahun -tahun, dan sudah waktunya untuk refactoring penuh.

Poin refactoring utama mencoba untuk mengikuti prinsip -prinsip yang lebih baik:

Beralih ke kebijakan versi yang lebih ketat, dengan rilis reguler;
Unit besar utama ( SynCommons.pas , mORMot.pas ) menjadi unit yang lebih kecil;
Kode spesifik OS- atau kompiler yang dipisahkan untuk memudahkan evolusi;
Ganti nama jenis yang membingungkan, misalnya TSQLRecord menjadi TOrm , TSQLRest menjadi TRest ...;
Mendukung komposisi daripada warisan, misalnya kelas TRest dibagi menjadi kelas istirahat/orm/soA yang tepat - dan folder;
Menghindari kesalahan internal kompiler pada delphi, misalnya mengubah const/var yang tidak diketik diubah menjadi pointer, atau mengurangi ukuran unit;
Penulisan ulang penuh dari seluruh rtti, json dan inti istirahat, untuk efisiensi dan pemeliharaan yang lebih baik;
Optimalisasi kerangka kerja asm kernel, menggunakan AVX2 jika tersedia;
Fitur -fitur baru seperti OpenSSL , LibDeflate atau dukungan QuickJS ;
Server HTTP dan Websockets asinkron baru, dengan dukungan HTTPS/TLS opsional melalui Enkripsi Let's;
Memperkenalkan sintaks modern seperti generik atau enumerator - tetapi opsional untuk kompatibilitas.

Oleh karena itu kami membuat proyek dan repositori yang sama sekali baru, karena beralih ke versi 2 menginduksi beberapa perubahan yang tidak kompatibel ke belakang. Nama unit baru digunakan, untuk menghindari masalah tabrakan yang tidak terduga selama migrasi, atau jika 1,18 ingin tetap diinstal untuk proyek kompatibilitas.

Tingkatkan dalam praktiknya

Langkah cepat saat meningkatkan dari revisi 1.18 sebelumnya:

Perhatikan semua unit di mana terpecah dan berganti nama, dan beberapa perubahan besar yang diperkenalkan untuk fitur yang ditingkatkan, oleh karena itu pembaruan langsung tidak dimungkinkan - atau diinginkan
Beralih ke folder baru, misalnya # lib2 bukan # lib
Unduh terbaru 2.# file revisi sebagaimana dinyatakan tepat di atas
Ubah referensi Anda ke unit Mormot :