Angel3 ORM은 Dart 애플리케이션에서 객체-관계 매핑을 위한 런타임 지원을 제공하여 Dart 객체와 데이터베이스 간의 원활한 상호작용을 가능하게 합니다. 데이터베이스 쿼리를 생성하고 실행하기 위한 기초 클래스를 포함하며, 백엔드 서비스에서의 데이터 접근 패턴을 단순화합니다. Angel3 프레임워크와 함께 사용하도록 설계되었으며, Android, iOS, Web, macOS, Windows, Linux 등 다양한 플랫폼을 지원합니다. 타입 안전한 쿼리 작업을 갖춘 확장 가능한 데이터베이스 기반 웹 서버를 개발하는 개발자에게 이상적입니다.
사용 사례
데이터베이스 기반 웹 서버 구축
타입 안전성을 활용한 CRUD 작업 구현
확장 가능한 백엔드 API 만들기
데이터 모델 간의 관계 관리
Angel3 프레임워크와의 통합
주요 기능
런타임 ORM 지원
쿼리 생성을 위한 기본 클래스
형 안전한 데이터베이스 상호작용
크로스 플랫폼 호환성
Angel3과의 원활한 통합
여러 데이터베이스 지원
적합한 대상
Angel3를 사용하는 백엔드 개발자
다트 기반 웹 서버 프로젝트
데이터베이스 추상화가 필요한 애플리케이션
타입 안전성을 우선시하는 팀
다중 플랫폼을 대상으로 하는 프로젝트
고려 사항
Angel3 프레임워크가 필요합니다
사용 가능한 문서가 제한적입니다
서버 측 Dart에 가장 적합
모바일 UI 개발을 위한 것이 아님
기반 데이터베이스 드라이버에 의존
원본 README
연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.
Angel3 Framework
A production-ready dart backend framework.
About
Angel3 originated from a fork of the archived Angel framework in support of Dart SDK 2.12.x or later. It is a full-stack backend framework in Dart that aims to streamline development by providing many common features out-of-the-box in a consistent manner. The codebase has been completely migrated and refactored to support null safety. One of the main goal is to enable developers to build both frontend and backend in dart language. Angel3 is designed as a collection of plugins that enable developers to pick and choose the parts needed for their projects. A series of starter templates are also provided for quick start and trial run with Angel3. Visit our website to learn more.
The available features in Angel3 includes:
OAuth2 Authentication
WebSocket
HTTP/2
HTTP Streaming
GraphQL
Markdown, Mustache, Jinja and JAEL as Server-Side HTML Rendering
ORM support for PostgreSQL and MySQL
MongoDB, Sembast and RethinkDB as storage
Redis as cache
The Core Framework
The packages directory contains specialized sub-packages that act as individual plugins or modules. Depending on the needs of a project, a developer can plug in specific packages.
They can broadly be categorized as follows:
Core Framework & Request Handling
framework: The foundational package (angel3_framework). It provides the base HTTP server, request/response contexts, dependency injection container, and middleware pipelines.
route: The routing engine handling URL matching and route parameters.
container: Dependency Injection (DI) system for resolving services.
configuration: Utilities for loading configuration files (YAML, JSON, .env).
Data Modeling & Persistence (ORM)
The framework provides an extensive ORM (angel3_orm) ecosystem with generators and database drivers:
orm: Houses the main ORM library, code generator (angel_orm_generator), and SQL dialects for MySQL and PostgreSQL.
model: Base model abstractions for data entities.
serialize: Libraries to serialize/deserialize data to and from JSON using code generation (angel_serialize_generator).
mongo, rethinkdb, sembast: Specialized drivers for interacting with MongoDB, RethinkDB, and Sembast (a NoSQL local database).
Authentication & Security
auth: Core authentication abstractions and strategies (local, token-based).
auth_oauth2 & oauth2: Out-of-the-box support for OAuth2 authentication flows.
security: Security middleware (rate limiting, standard headers, etc.).
cors: Middleware to handle Cross-Origin Resource Sharing effortlessly.
Frontend & Template Rendering
Support for processing and returning HTML views to the client:
jael: The Jael template engine specifically built for Angel, capable of HTML manipulation. It is split into language servers, preprocessors, and web renderers.
mustache, jinja, markdown: Wrappers/integrations for rendering Mustache templates, Jinja templates, or parsing Markdown into HTML.
html & seo: Utilities for building out HTML responses and optimizing for search engines.
Additional Utilities and APIs
websocket: Integration for real-time bidirectional communication.
client: A client-side library designed to interface seamlessly with Angel3 backends directly from Dart/Flutter.
cache & redis: Caching interfaces with Redis integration to improve response times.
hot & production: Tooling for hot-reloading the server during development, and managing clustering/multi-threading under production loads.
test & mock_request: Testing utilities for mocking HTTP requests without spinning up a real server.
Angel3 packages are published under angel3_ prefix on pub.dev. These packages have passed all of their respective test suites before going live. The development work are currently focused on:
Keeping the packages with angel3_ prefix in sync with Dart SDK releases
Remove and replace deprecated classes and methods while keeping it backward compatible
Refactor the code to use new language features
Fix and resolve reported issues
Performance optimization
Improve on existing features, unit test, user guide and examples
Add new features
Status
Release Notes (version: 9.1.0)
Updated angel3_ packages to Require Dart >= 3.13.0
Updated code geneator to use analyzer 14.x.x
Branch: master
Dart version : 3.13.0 or later.
Publish : Refer to all packages withangel3_ prefix on pub.dev.
Status : Production
Notes : Use this branch for all PR submission
What is in the pipeline?
Remove the use of Mirror
Performance optimization
Out of the box OIDC and SAML2 support
Integrated Open API 3 support
Expand ORM to support
SQL Server
Oracle DB
SQLite
Installation and Setup
(Option 1) Create a new project by cloning from boilerplate templates
Run the project in development mode (hot-reloaded is enabled on file changes).
dart --observe bin/dev.dart
Run the project in production mode (hot-reloaded is disabled).
dart bin/prod.dart
Run as docker. Edit and build the image with the provided Dockerfile file.
Next, refer to the User Guide to learn more about Angel3 framework.
Performance Testing
Refer to Angel3 Performance Test Suite for more information. It is still in early stage, but eventually will contain test cases for running load testing with Locust on various key features of Angel3 framework. These test cases can serve as a foundation for building performance tests for any applications developed with Angel3 framework.
The test cases are build using standard Angel3 ORM template for PostgreSQL and MySQL databases. The result are used for improving Angel3 framework with respect to other frameworks. The following test cases will be added in the subsequent update to this benchmark.
Cache with Redis
Angel3 with MongoDB
Documentation
Refer to User Guide for more detailed information on the available features of Angel3 framework.
Examples
Take various applications at Examples for a spin to get a feel of what Angel3 framework can do.
We offer professional paid support for teams and developers using Angel3 framework. Our support services are designed to help you build faster, deploy with confidence, and scale reliably, whether you’re just getting started or running the framework in production. The fund collected will go into continued improvements of the framework.
What we can help with
Architecture and best-practice guidance
Framework setup, configuration, and upgrades
Debugging runtime, performance, or build issues
Production readiness (scaling, monitoring, deployment)
Code reviews and design feedback
Custom feature guidance and extensions
Who this is for
Teams using or planning to use Angel3 in production
Developers who want expert guidance from people who maintain the framework
Migration from other dart or none dart framework
Support options
We offer flexible plans depending on your needs:
Hourly support for one-off issues
Monthly retainers for ongoing help
Consulting sessions for architecture and planning
Support is available via email, chat, and scheduled calls.
Why paid support?
Paid support ensures you get reliable, professional assistance when it matters most.
Get in touch
If you’re interested in paid support, contact us at [dukefirehawk.apps@gmail.com] with your contact and use cases. We will get back within 24 hours.