패키지, 저장소 및 앱 카테고리 검색

패키지 상세v10.1.0

angel3_orm

Angel3 ORM의 런타임 지원. 쿼리용 기본 클래스를 포함합니다.

AndroidiOSWebmacOSWindowsLinux
30일 다운로드
2천
좋아요
13
Pub 점수
160

패키지 설치

flutter pub add angel3_orm

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

Angel3 ORM은 Dart 애플리케이션에서 객체-관계 매핑을 위한 런타임 지원을 제공하여 Dart 객체와 데이터베이스 간의 원활한 상호작용을 가능하게 합니다. 데이터베이스 쿼리를 생성하고 실행하기 위한 기초 클래스를 포함하며, 백엔드 서비스에서의 데이터 접근 패턴을 단순화합니다. Angel3 프레임워크와 함께 사용하도록 설계되었으며, Android, iOS, Web, macOS, Windows, Linux 등 다양한 플랫폼을 지원합니다. 타입 안전한 쿼리 작업을 갖춘 확장 가능한 데이터베이스 기반 웹 서버를 개발하는 개발자에게 이상적입니다.

사용 사례

  • 데이터베이스 기반 웹 서버 구축
  • 타입 안전성을 활용한 CRUD 작업 구현
  • 확장 가능한 백엔드 API 만들기
  • 데이터 모델 간의 관계 관리
  • Angel3 프레임워크와의 통합

주요 기능

  • 런타임 ORM 지원
  • 쿼리 생성을 위한 기본 클래스
  • 형 안전한 데이터베이스 상호작용
  • 크로스 플랫폼 호환성
  • Angel3과의 원활한 통합
  • 여러 데이터베이스 지원

적합한 대상

  • Angel3를 사용하는 백엔드 개발자
  • 다트 기반 웹 서버 프로젝트
  • 데이터베이스 추상화가 필요한 애플리케이션
  • 타입 안전성을 우선시하는 팀
  • 다중 플랫폼을 대상으로 하는 프로젝트

고려 사항

  • Angel3 프레임워크가 필요합니다
  • 사용 가능한 문서가 제한적입니다
  • 서버 측 Dart에 가장 적합
  • 모바일 UI 개발을 위한 것이 아님
  • 기반 데이터베이스 드라이버에 의존

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

Angel3 Framework

Angel3 Framework

Pub Version (including pre-releases) Null Safety Discord License melos

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:

  1. 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).
  2. 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).
  3. 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.
  4. 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.
  5. 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.
    • file_service & static: For serving static assets (images, CSS, JS) efficiently.

Important Notes

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
  1. Download and install Dart. Minimum 3.11.0.

  2. Clone one of the following starter projects:

  3. Run the project in development mode (hot-reloaded is enabled on file changes).

    dart --observe bin/dev.dart
    
  4. Run the project in production mode (hot-reloaded is disabled).

    dart bin/prod.dart
    
  5. Run as docker. Edit and build the image with the provided Dockerfile file.

  6. Next, refer to the developer guide to learn more about Angel3 framework.

(Option 2) Create a new project with Angel3 CLI
  1. Download and install Dart

  2. Install the Angel3 CLI:

    dart pub global activate angel3_cli
    
  3. On terminal, create a new project:

    angel3 init hello
    
  4. Run the project in development mode (hot-reloaded is enabled on file changes).

    dart --observe bin/dev.dart
    
  5. Run the project in production mode (hot-reloaded is disabled).

    dart bin/prod.dart
    
  6. Run as docker. Edit and build the image with the provided Dockerfile file.

  7. 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.

Performance Benchmark

An offical performance benchmark can be found at TechEmpower Framework Benchmarks

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.

  1. Cache with Redis
  2. 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.

Community

Join us on Discord.

Contributing

If you are interested in contributing to Angel3 framework please check out the Contribution Guide.

Development Setup
  1. Fork angel repository

  2. Clone the project to local and create a new branch

    git clone https://github.com/<your_repo_name>/angel.git
    git checkout -b feature/<your_branch_name>
    
  3. Download and install Dart 3

  4. Install melos:7.3

    dart pub global activate melos
    
  5. Run melos exec "dart pub upgrade" to update all the packages

  6. Contribute changes to the desired packages

Donation & Support

If you like this project and interested in supporting its development work, you are welcome to make a donation via the following links.

Paid Support

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.

카테고리

의존성

의존성 목록 6 개

소스 저장소

이 패키지를 사용하는 프로젝트

아직 데이터가 없습니다.