ORM PostgreSQL baharu untuk Golang: Perusahaan

Mengapa kita memerlukan ORM baharu?

Sebenarnya terdapat beberapa ORM yang bagus, tetapi ia tidak memenuhi keperluan saya. Jadi apa yang saya mahukan?

• Prestasi tinggi
• Skema sebagai kod
• Kod api ditaip dan dijana secara statik
• Fail yang kurang dijana
• Mudah dan Berfungsi
• Penggunaan RawSQL yang mudah
• Penapis tekan db tunggal apabila menyertai hubungan

Pada masa ini saya tidak boleh mengatakan perusahaan melakukan dengan baik semua perkara yang saya nyatakan. Tetapi ia bertujuan untuk berbuat demikian.

Jadi mari kita lihat apa yang perusahaan lakukan.

Prestasi Tinggi

Anda boleh melihat kod sumber penanda aras di sini.
https://github.com/MrSametBurgazoglu/go-orm-benchmarks/tree/enterprise

Seperti yang anda lihat perusahaan sangat baik dalam prestasi.

Skema sebagai kod

Seperti kebanyakan perusahaan lain menjana model db daripada kod anda.
Berikut adalah contoh kecil

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

Apabila anda melaksanakan skrip di atas ia akan mencipta pakej bernama model dan meletakkan dua fail untuk setiap jadual bernama model.go dan model_predicates.go . Dan akan ada client.go untuk menggunakan db.

Kod api yang ditaip dan dijana secara statik

Selepas model jana automatik, anda boleh membuat dan mendapatkan model.

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)
    }
}

Fail yang kurang dijana

Seperti yang saya katakan sebelum perusahaan menjana 2 fail untuk setiap jadual dan satu fail klien yang menggunakan kesemuanya. Ia mengendalikan kebanyakan kes dalam pakej sendiri dengan cara ini anda akan mempunyai struktur yang lebih bersih.

Mudah dan Berfungsi

Enterprise menyasarkan interaksi mudah dan berfungsi dengan medan db. Untuk ini, medan mempunyai fungsi pembantu.

Katakan anda mempunyai uuid boleh nill bernama face_id di atas meja dan anda mewakilinya dengan *uuid. Perusahaan akan menjana fungsi pembantu untuk menetapkannya dengan rentetan. Dengan cara itu anda tidak perlu mendapatkan penunjuk pembolehubah itu.

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

Jika anda mempunyai medan uuid ia akan mencipta pembantu penghurai.

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

Untuk sesetengah jenis nilai ia akan mempunyai klausa IN.

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

Untuk masa. Masa ia akan mewujudkan fungsi pembantu ini.

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

Penggunaan RawSQL yang Mudah

Enterprise boleh mencipta pertanyaan yang kompleks tetapi keperluan untuk RawSQL sentiasa ada. Kerana itu anda boleh menggunakan models.IDatabase untuk berinteraksi dengan pgx. Kami mempunyai rancangan untuk mengimbas hasil sql mentah kepada model db anda atau struct tersuai yang anda buat dengan perkaitan jika perlu.

Penapis tekan db tunggal apabila menyertai hubungan

Salah satu ciri terpenting yang memisahkan Perusahaan daripada yang lain ialah boleh menyertai perhubungan dan menapisnya dengan pertanyaan tunggal.

Salah satu contoh adalah seperti ini. Mari dapatkan soalan ujian pelajar yang salah menjawab dengan markah ujian lebih tinggi daripada 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
}

Untuk repositori: https://github.com/MrSametBurgazoglu/enterprise
Untuk dokumentasi: https://mrsametburgazoglu.github.io/enterprise_docs/

Atas ialah kandungan terperinci ORM PostgreSQL baharu untuk Golang: Perusahaan. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!