新しい ORM が必要な理由

実際には、利用可能な優(yōu)れた ORM がいくつかありますが、それらは私のニーズを満たしていませんでした。それで、私は何がしたかったのですか？

• 高性能
• コードとしてのスキーマ
• 靜的に型付けされ生成された API コード
• 生成されるファイルの量が少ない
• シンプルかつ機(jī)能的
• RawSQL の簡単な使用法
• 結(jié)合関係時のシングル データベース ヒット フィルター

現(xiàn)時點(diǎn)では、企業(yè)が私が述べたすべてのことをうまくやっているとは言えません。しかし、それはそうすることを目的としています。

それでは、企業(yè)が何をしているのか見てみましょう。

高性能

ベンチマークのソース コードはここでご覧いただけます。
https://github.com/MrSametBurgazoglu/go-orm-b??enchmarks/tree/enterprise

ご覧のとおり、エンタープライズは非常に優(yōu)れたパフォーマンスを発揮しています。

コードとしてのスキーマ

他の多くの企業(yè)と同様に、企業(yè)はコードから DB モデルを生成します。
ここに小さな例があります

// 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(),
    )
}

上記のスクリプトを?qū)g行すると、models という名前のパッケージが作成され、model.go と model_predicates.go という名前の各テーブルに 2 つのファイルが配置されます。そして、db を使用するための client.go があります。

靜的に型付けされ生成された 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)
    }
}

生成量の少ないファイル

前に述べたように、企業(yè)はテーブルごとに 2 つのファイルと、それらすべてを使用する 1 つのクライアント ファイルを生成します。ほとんどのケースを獨(dú)自のパッケージで処理するため、よりクリーンな構(gòu)造が得られます。

シンプルかつ機(jī)能的

Enterprise は、DB フィールドとのシンプルかつ機(jī)能的な対話を目指しています。このため、フィールドにはヘルパー関數(shù)があります。

テーブルに face_id という名前の nillable uuid があり、それを *uuid で表すとします。 Enterprise はヘルパー関數(shù)を生成して文字列で設(shè)定します。そうすれば、その変數(shù)のポインタを取得する必要がなくなります。

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 の場合、これらのヘルパー関數(shù)が作成されます。

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

RawSQL の簡単な使い方

企業(yè)は複雑なクエリを作成できますが、RawSQL は常に必要になります。そのため、models.IDatabase を使用して pgx と対話することができます。必要に応じて、生の SQL 結(jié)果をデータベース モデルまたはリレーションを使用して作成したカスタム構(gòu)造體にスキャンする計(jì)畫があります。

結(jié)合関係時のシングル データベース ヒット フィルター

Enterprise を他と區(qū)別する最も重要な機(jī)能の 1 つは、リレーションを結(jié)合し、単一のクエリでフィルタリングできることです。

一例としてはこんな感じです。テストのスコアが 80 點(diǎn)を超える、生徒の間違ったテスト問題を見つけてみましょう。

// 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: Enterpriseの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國語 Web サイトの他の関連記事を參照してください。