mORMot2

Synopse Mormot 2 프레임 워크

현대 객체 Pascal의 오픈 소스 클라이언트 서버 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 블로그;
• 소스 코드 src 서브 폴더;
• 여전히 새 버전, 특히 디자인/개념 부분에 여전히 적용되는 Old Mormot 1 문서.

Mormot 에 대해 논의하려면 공식 포럼 외에도 참여할 수 있습니다.

• Mormot Telegram 그룹;
• Mormot discord 서버.

이러한 토론 그룹은 시누프스가 관리하지 않고 일부 Mormot 2 사용자에 의해 관리됩니다. 감사합니다!

사용할 가치가 있다면, 할 수 있다면 Mormot 2 Dev를 후원하는 것을 고려하십시오. :-)

프레젠테이션

Mormot 뭐?

Synopse Mormot 2는 Delphi 7을위한 오픈 소스 클라이언트 서버 ORM SOA MVC 프레임 워크입니다. Delphi 12 Athenes 및 FPC 3.2/Trunk, 서버의 Windows/Linux/BSD/MACOS를 대상으로하고 클라이언트 (모바일 또는 AJAX 포함)를 대상으로합니다.

따라서 Mormot 의 주요 특징은 다음과 같습니다.

• 최적화 된 크로스 컴파일러 및 크로스 플랫폼 JSON/UTF-8 및 RTTI 커널;
• 직접 SQL 및 NOSQL 데이터베이스 액세스 (예 : SQLITE3, PostgreSQL, Oracle, MSSQL, OLEDB, ODBC, MongoDB);
• ORM/ODM : 거의 모든 데이터베이스 (SQL 또는 NOSQL)의 개체 지속성;
• SOA : 비즈니스 로직을 interface 로 정의한 REST 서비스로 구성하십시오.
• 컨벤션-대조 휴식 REST/JSON 라우터, 로컬 또는 HTTP/HTTPS/WebSockets 이상;
• 클라이언트 : ORM/SOA API를 통해 모든 플랫폼에서 데이터 또는 서비스를 소비합니다.
• Web MVC : 반응 형 웹 응용 프로그램으로 ORM/SOA 프로세스를 게시하십시오.
• 다른 재사용 가능한 많은 벽돌 (예 : 유니 코드, 암호화, 네트워크, 스레드, 사전, 사전, 로깅, 이진 직렬화, 변형, 제네릭, 크로스 플랫폼 ...).

속도와 다양성을 강조하는 Mormot은 현대적인 물체 Pascal Native Code 및 Depholdible Solutions의 장점을 활용하여 배치 비용을 줄이고 ROI를 증가시킵니다. 사용할 수 있습니다.

• 기본 ORM 또는 클라이언트-서버 기능을 애호가를위한 간단한 응용 프로그램에 추가하려면
• 또는 숙련 된 사용자가 고객을위한 확장 가능한 서비스 기반 (DDD) 프로젝트를 개발할 수 있습니다.
• 또는 기존 델파이 코드베이스와 함께 FPC 크로스 플랫폼 기능을 활용하여 향후 수십 년 동안 수용하십시오.
• 즐거운 시간을 보내고 현대의 대상 Pascal이 최신 언어 나 프레임 워크에 도전하는 것을보십시오.

하위 폴더

Mormot 2 리포지토리 컨텐츠는 다음과 같은 하위 폴더로 구성됩니다.

• src 는 주요 소스 코드 폴더로 실제 프레임 워크를 찾아야합니다.
• packages 에는 DEV 환경을 설정하기위한 IDE 패키지 및 도구가 포함되어 있습니다.
• static FPC 및 Delphi STATIC Linking에 필요한 원시 라이브러리 .o / .obj 파일이 포함되어 있습니다.
• test 모든 프레임 워크 기능의 회귀 테스트를 정의합니다.
• src 내에서 사용되는 일부 리소스 - 예 res 들어 static 타사 바이너리를 수집합니다.
• doc 프레임 워크의 문서를 보유합니다.
• ex 다양한 샘플이 포함되어 있습니다.

출처와 상감 문서를 자유롭게 탐색하십시오.

MPL/GPL/LGPL 3- 라이센스

이 프레임 워크는 분리 된 3- 라이센스에 따라 라이센스가 부여되어 다음 세 세트의 무료 소프트웨어/오픈 소스 라이센스 용어 중 하나를 선택할 수 있습니다.

• Mozilla Public License, 버전 1.1 이상;
• GNU 일반 공개 라이센스, 버전 2.0 이상;
• GNU가 적은 일반 공개 라이센스, 버전 2.1 이상.

이를 통해 가능한 한 다양한 소프트웨어 프로젝트에서 코드를 사용할 수 있으며, 우리가 쓴 코드에 대한 사본 왼쪽을 유지합니다. 전체 라이센스 조건을 참조하십시오.

빠른 시작

컴파일러 대상

프레임 워크 소스 코드 :

• FPC Stable 및 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에서는 Mormot General Units에서는 Windows 대상 만 사용할 수 있지만 모든 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 으로 다운로드하여 추출하십시오.
• 또는 주어진 릴리스의 직접 다운로드 (예 : 빌드 스크립트) :
  • https://github.com/synopse/mormot2/releases에서 소스 코드 (zip) 릴리스를 다운로드하고 예를 들어 d:mormot2 로 추출하십시오.
  • 관련 mormot2static.tgz 또는 mormot2static.7z 파일 내용을 d:mormot2static 으로 다운로드하여 추출하십시오.

2. 좋아하는 IDE 설정 :

• 나사로에서 :
  • /packages/lazarus/mormot2.lpk 패키지를 열고 컴파일합니다.
  • 필요한 경우 mormot2ui.lpk .
• 델파이 :
  • mormot2 2 src 서브 폴더 ( 도구 - 옵션 - IDE- 환경 변수 ), 예를 들어 c:githubmORMot2src 또는 d:mormot2src ;
  • 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. 발견하고 즐기십시오 :

• IDE에서 test/mormot2tests.dpr 열고 컴파일하고 컴퓨터에서 회귀 테스트를 실행하십시오.
• 예제 폴더를 찾아보십시오 (진행중인 작업), 특히 현실적이고 교육적인 Thomas 튜토리얼.
• 예에서 시작하여 문서를 따르십시오.
• 이 빠르게 진화하는 프로젝트에 향상 및 패치를 게시하여 자유롭게 기여하십시오.

안전을 위해 https://synopse.info/files 서버에 게시 된 현재 다운로드 된 바이너리 파일의 SHA-256 체크섬은이 저장소 static/dev.sha256 파일에서 사용할 수 있습니다.

버전 1.18에서 나옵니다

작업 솔루션을 다시 작성하는 이유는 무엇입니까?

Mormot 프레임 워크는 수년간 개정 1.18에 머물 렀으며 완전한 리팩토링의 시간이었습니다.

주요 리팩토링 포인트는 탄탄한 원칙을 더 잘 따르려고 노력했습니다.

• 정기적 인 릴리스와 함께보다 엄격한 버전 관리 정책으로 전환하십시오.
• 메인 큰 단위 ( SynCommons.pas , mORMot.pas ) 분할 더 작은 범위 정제 단위로 분할;
• 진화를 용이하게하기 위해 분리 된 OS- 또는 컴파일러 특정 코드;
• 혼란스러운 유형의 이름을 바꾸고, 예를 들어 TSQLRecord TOrm , TSQLRest 로 트레 TRest ...;
• 상속에 대한 구성을 선호하고, 예를 들어 TRest 클래스는 적절한 휴식/soa 클래스와 폴더로 나뉩니다.
• 델파이의 내부 오류가 우회적 인 내부 오류로, 예를 들어, 비 유형의 const/var를 포인터로 변경하거나 단위 크기를 줄였습니다.
• 더 나은 효율성과 유지 보수 가능성을 위해 전체 RTTI, JSON 및 REST CORES의 전체 재 작성;
• 사용 가능한 경우 AVX2를 사용하여 프레임 워크 asm 커널의 최적화;
• OpenSSL , Libdeflate 또는 QuickJS 지원과 같은 새로운 기능;
• Let 's Encrypt를 통한 옵션 HTTPS/TLS 지원이 포함 된 새로운 비동기 HTTP 및 WebSockets 서버;
• 제네릭이나 열거 자와 같은 현대적인 구문을 소개하지만 호환성을위한 선택 사항.

따라서 우리는 버전 2로 전환하면 후진 호환되지 않는 변경 사항을 유도했기 때문에 완전히 새로운 프로젝트와 저장소를 만들었습니다. 마이그레이션 중 예기치 않은 충돌 문제를 피하기 위해 새로운 단위 이름이 사용되었거나 1.18이 호환성 프로젝트를 위해 설치되어야하는 경우에 사용되었습니다.

실제로 업그레이드

이전 1.18 개정판에서 업그레이드 할 때 빠른 단계 :

1. 분할 및 이름이 바뀌고 향상된 기능을 위해 일부 중단 변경이있는 모든 장치에 참고하여 직접 업데이트가 불가능합니다.

2. # lib 대신 새 폴더, 예를 들어 # lib2로 전환하십시오.

3. 최신 2.# 개정 파일을 다운로드하십시오

4. 참고 문헌을 Mormot 단위로 변경하십시오.

• 버전 간의 충돌을 피하기 위해 모든 단위 이름이 변경되었습니다.
• 주요 유용한 단위를 보려면 샘플을보십시오.

5. 주로 1.18의 변경 사항 중단에 대한 문서를 참조하십시오.

• 단위 리팩토링 (위 4 점 참조);
• PUREMORMOT2 모드로 이름이 바뀌는 유형;
• Delphi 5-6 및 Kylix 호환성이 제거되었습니다.
• bigtable, lvcl, rtti-ui는 더 이상 사용되지 않습니다.