适用于 Golang 的新 PostgreSQL ORM：企业版

为什么我们需要一个新的 ORM？

实际上有一些不错的 ORM 可用，但它们只是不能满足我的需求。那我想要什么？

• 高性能
• 架构即代码
• 静态输入和生成的 API 代码
• 生成的文件较少
• 简单实用
• 简单的 RawSQL 使用
• 连接关系时单个数据库命中过滤器

目前我还不能说企业在我提到的所有事情上都做得很好。但它的目的就是这样做。

那么让我们看看企业是做什么的。

高性能

您可以在此处查看基准测试源代码。
https://github.com/MrSametBurgazoglu/go-orm-b​​enchmarks/tree/enterprise

如您所见，企业的性能非常出色。

架构即代码

像许多其他企业一样，企业从您的代码生成数据库模型。
这是一个小例子

// db_models/account.go
package db_models

import (
    "github.com/MrSametBurgazoglu/enterprise/models"
    "github.com/google/uuid"
)

func Account() *models.Table {
    idField := models.UUIDField("ID").DefaultFunc(uuid.New)

    tb := &models.Table{
        Fields: []models.FieldI{
            idField,
            models.StringField("Name"),
            models.StringField("Surname"),
            models.UUIDField("TestID").SetNillable(),
        },
        Relations: []*models.Relation{
            models.ManyToOne(TestName, idField.DBName, "test_id"),
            models.ManyToMany(GroupName, "account_id", "group_id", "id", AccountGroupName),
        },
    }

    tb.SetTableName(AccountName)
    tb.SetIDField(idField)

    return tb
}

// generate/generate.go
package main

import (
    "example/db_models"
    "github.com/MrSametBurgazoglu/enterprise/generate"
)

func main() {
    generate.Models(
        db_models.Test(),
        db_models.Account(),
        db_models.Group(),
    )
}

当您执行上面的脚本时，它将创建一个名为 models 的包，并为每个名为 model.go 和 model_predicates.go 的表放置两个文件。并且会有一个client.go用于使用db。

静态输入和生成的 API 代码

自动生成模型后，您可以创建并获取模型。

import "/your/project/models" // your auto-generated models package

func main() {
    db, err := models.NewDB(dbUrl)
    if err != nil {
        panic(err)
    }

    ctx := context.Background()
    account := models.NewAccount(ctx, db)
    account.SetName("name")
    account.SetSurname("surname")
    err = account.Create()//row added to table
    if err != nil {
        log.Fatal(err)
    }
}

import "/your/project/models" // your auto-generated models package

func main() {
    db, err := models.NewDB(dbUrl)
    if err != nil {
        panic(err)
    }

    ctx := context.Background()
    account := models.NewAccount(ctx, db)
    account.Where(account.IsIDEqual(uuid.New()))
    err = account.Get()//row variables set to account struct
    if err != nil {
        log.Fatal(err)
    }
}

生成的文件较少

就像我之前说过的，企业为每个表生成 2 个文件，以及一个使用所有这些表的客户端文件。它在自己的包中处理大多数情况，这样您将拥有更干净的结构。

简单实用

Enterprise 的目标是与数据库字段进行简单且功能性的交互。为此，字段具有辅助函数。

假设表上有一个名为face_id 的可为空的uuid，并且用*uuid 表示它。 Enterprise 将生成一个辅助函数来用字符串设置它。这样你就不需要获取该变量的指针。

func (t *Account) SetFaceIDValue(v uuid.UUID)

如果你有一个 uuid 字段，它将创建一个解析器助手。

func (t *Account) ParseFaceID(v string) error

对于某些值类型，它将有 IN 子句。

func (t *Account) FaceIDIN(v ...uuid.UUID) bool
func (t *Account) FaceIDNotIN(v ...uuid.UUID) bool

对于 time.Time 它将创建这些辅助函数。

func (t *Account) FormatCreatedAt(v string) string
func (t *Account) ParseCreatedAt(layout, value string) error

简单的 RawSQL 用法

企业可以创建复杂的查询，但始终需要 RawSQL。因此，您可以使用 models.IDatabase 与 pgx 交互。如果需要，我们计划将原始 sql 结果扫描到您的数据库模型或您使用关系创建的自定义结构。

连接关系时单个数据库命中过滤器

Enterprise 与其他产品的区别最重要的功能之一是可以通过单个查询连接关系并过滤它们。

一个例子是这样的。让我们来看看学生答错的测试题，并且测试分数高于 80。

// db_models/account.go
package db_models

import (
    "github.com/MrSametBurgazoglu/enterprise/models"
    "github.com/google/uuid"
)

func Account() *models.Table {
    idField := models.UUIDField("ID").DefaultFunc(uuid.New)

    tb := &models.Table{
        Fields: []models.FieldI{
            idField,
            models.StringField("Name"),
            models.StringField("Surname"),
            models.UUIDField("TestID").SetNillable(),
        },
        Relations: []*models.Relation{
            models.ManyToOne(TestName, idField.DBName, "test_id"),
            models.ManyToMany(GroupName, "account_id", "group_id", "id", AccountGroupName),
        },
    }

    tb.SetTableName(AccountName)
    tb.SetIDField(idField)

    return tb
}

存储库：https://github.com/MrSametBurgazoglu/enterprise
文档：https://mrsametburgazoglu.github.io/enterprise_docs/

以上是适用于 Golang 的新 PostgreSQL ORM：企业版的详细内容。更多信息请关注PHP中文网其他相关文章！