sea orm

海洋

？生锈的异步和动态ORM

海洋

SEAORM是一种关系ORM，可以帮助您熟悉动态语言的熟悉，以生锈的形式构建Web服务。

如果您喜欢我们的工作，请考虑主演，分享和贡献！

请通过完成2024年SEAQL社区调查来帮助我们维护海洋公司！

加入我们的Discord服务器，与Seaql社区的其他成员聊天！

入门

• 文档
• 教程
• 食谱

集成示例：

• Actix V4示例
• 斧头示例
• GraphQl示例
• JSONRPSEE示例
• Loco todo榜样 /机车休息起动器
• 诗例
• 火箭示例 /火箭openapi示例
• Salvo示例
• 补品示例
• Seaography示例

特征

1. 异步

   依靠SQLX，Seaorm是一个新图书馆，并从第1天开始提供异步支持。

2. 动态的

   Seaorm建立在海格（Seaquery）上，可让您构建复杂的动态查询。

3. 可测试

   使用模拟连接和/或SQLite为您的应用程序逻辑编写测试。

4. 面向服务

   快速构建连接，过滤，分类和分页的服务中REST，GraphQL和GRPC API的服务。

快速味道

实体

 use sea_orm :: entity :: prelude :: * ;

# [ derive ( Clone , Debug , PartialEq , DeriveEntityModel ) ]
# [ sea_orm ( table_name = "cake" ) ]
pub struct Model {
    # [ sea_orm ( primary_key ) ]
    pub id : i32 ,
    pub name : String ,
}

# [ derive ( Copy , Clone , Debug , EnumIter , DeriveRelation ) ]
pub enum Relation {
    # [ sea_orm ( has_many = "super::fruit::Entity" ) ]
    Fruit ,
}

impl Related < super :: fruit :: Entity > for Entity {
    fn to ( ) -> RelationDef {
        Relation :: Fruit . def ( )
    }
}

选择

 // find all models
let cakes : Vec < cake :: Model > = Cake :: find ( ) . all ( db ) . await ? ;

// find and filter
let chocolate : Vec < cake :: Model > = Cake :: find ( )
    . filter ( cake :: Column :: Name . contains ( "chocolate" ) )
    . all ( db )
    . await ? ;

// find one model
let cheese : Option < cake :: Model > = Cake :: find_by_id ( 1 ) . one ( db ) . await ? ;
let cheese : cake :: Model = cheese . unwrap ( ) ;

// find related models (lazy)
let fruits : Vec < fruit :: Model > = cheese . find_related ( Fruit ) . all ( db ) . await ? ;

// find related models (eager)
let cake_with_fruits : Vec < ( cake :: Model , Vec < fruit :: Model > ) > =
    Cake :: find ( ) . find_with_related ( Fruit ) . all ( db ) . await ? ;

插入

 let apple = fruit :: ActiveModel {
    name : Set ( "Apple" . to_owned ( ) ) ,
    .. Default :: default ( ) // no need to set primary key
} ;

let pear = fruit :: ActiveModel {
    name : Set ( "Pear" . to_owned ( ) ) ,
    .. Default :: default ( )
} ;

// insert one
let pear = pear . insert ( db ) . await ? ;

// insert many
Fruit :: insert_many ( [ apple , pear ] ) . exec ( db ) . await ? ;

更新

 use sea_orm :: sea_query :: { Expr , Value } ;

let pear : Option < fruit :: Model > = Fruit :: find_by_id ( 1 ) . one ( db ) . await ? ;
let mut pear : fruit :: ActiveModel = pear . unwrap ( ) . into ( ) ;

pear . name = Set ( "Sweet pear" . to_owned ( ) ) ;

// update one
let pear : fruit :: Model = pear . update ( db ) . await ? ;

// update many: UPDATE "fruit" SET "cake_id" = NULL WHERE "fruit"."name" LIKE '%Apple%'
Fruit :: update_many ( )
    . col_expr ( fruit :: Column :: CakeId , Expr :: value ( Value :: Int ( None ) ) )
    . filter ( fruit :: Column :: Name . contains ( "Apple" ) )
    . exec ( db )
    . await ? ;

节省

 let banana = fruit :: ActiveModel {
    id : NotSet ,
    name : Set ( "Banana" . to_owned ( ) ) ,
    .. Default :: default ( )
} ;

// create, because primary key `id` is `NotSet`
let mut banana = banana . save ( db ) . await ? ;

banana . name = Set ( "Banana Mongo" . to_owned ( ) ) ;

// update, because primary key `id` is `Set`
let banana = banana . save ( db ) . await ? ;

删除

 // delete one
let orange : Option < fruit :: Model > = Fruit :: find_by_id ( 1 ) . one ( db ) . await ? ;
let orange : fruit :: Model = orange . unwrap ( ) ;
fruit :: Entity :: delete ( orange . into_active_model ( ) )
    . exec ( db )
    . await ? ;

// or simply
let orange : Option < fruit :: Model > = Fruit :: find_by_id ( 1 ) . one ( db ) . await ? ;
let orange : fruit :: Model = orange . unwrap ( ) ;
orange . delete ( db ) . await ? ;

// delete many: DELETE FROM "fruit" WHERE "fruit"."name" LIKE 'Orange'
fruit :: Entity :: delete_many ( )
    . filter ( fruit :: Column :: Name . contains ( "Orange" ) )
    . exec ( db )
    . await ? ; 

？ Seaography：Instant GraphQl API

Seaography是建立在Seaorm之上的GraphQL框架。 Seaography使您可以快速构建GraphQL解析器。只需几个命令，您就可以从Seaorm实体启动GraphQl Server！

查看Seaography示例以了解更多信息。

管理仪表板

利用Seaographing，使用您喜欢的前端框架创建管理仪表板将很轻松。查看我们的示例和教程：

1. React Admin示例
2. 通过Seaographing向Loco添加GraphQl支持
3. 基于GraphQL的管理仪表板，带有机车和Seaography

了解更多

1. 设计
2. 建筑学
3. 工程
4. 更改日志

谁在使用Seaorm？

参见使用Seaorm建造的。随时提交您的！

执照

根据任何一个

• Apache许可证，版本2.0（许可证或http://www.apache.org/licenses/license-2.0）
• MIT许可证（许可证或http://opensource.org/licenses/mit）

可以选择。

贡献

除非您另有明确说明，否则任何有意提交的捐款（如Apache-2.0许可证中定义）应为双重许可，如上所述，没有任何其他条款或条件。

我们邀请您参加，贡献和共同帮助建立Rust的未来。

向我们的贡献者大声喊叫！

赞助

Seaql.org是由热情开发人员经营的独立开源组织。如果您喜欢使用我们的图书馆，请出演并分享我们的存储库。如果您感到慷慨，将对GitHub赞助商进行的少量捐款将不胜感激，并为维持组织带来很大的帮助。

黄金赞助商

银色赞助商

我们非常感谢我们的赞助商：Osmos，因为他们的金层赞助和对我们开发的工具的信任。数字海洋，用于赞助我们的服务器。和Jetbrains，用于赞助我们的IDE。

吉祥物

弗里斯（Ferris）的朋友，寄居蟹是海洋官方的官方吉祥物。他的爱好正在收集贝壳。