wechat-api/ent/tx.go

// Code generated by ent, DO NOT EDIT.

package ent

import (
	"context"
	stdsql "database/sql"
	"fmt"
	"sync"

	"entgo.io/ent/dialect"
)

// Tx is a transactional client that is created by calling Client.Tx().
type Tx struct {
	config
	// Agent is the client for interacting with the Agent builders.
	Agent *AgentClient
	// AgentBase is the client for interacting with the AgentBase builders.
	AgentBase *AgentBaseClient
	// AliyunAvatar is the client for interacting with the AliyunAvatar builders.
	AliyunAvatar *AliyunAvatarClient
	// AllocAgent is the client for interacting with the AllocAgent builders.
	AllocAgent *AllocAgentClient
	// BatchMsg is the client for interacting with the BatchMsg builders.
	BatchMsg *BatchMsgClient
	// Category is the client for interacting with the Category builders.
	Category *CategoryClient
	// ChatRecords is the client for interacting with the ChatRecords builders.
	ChatRecords *ChatRecordsClient
	// ChatSession is the client for interacting with the ChatSession builders.
	ChatSession *ChatSessionClient
	// Contact is the client for interacting with the Contact builders.
	Contact *ContactClient
	// CreditBalance is the client for interacting with the CreditBalance builders.
	CreditBalance *CreditBalanceClient
	// CreditUsage is the client for interacting with the CreditUsage builders.
	CreditUsage *CreditUsageClient
	// Employee is the client for interacting with the Employee builders.
	Employee *EmployeeClient
	// EmployeeConfig is the client for interacting with the EmployeeConfig builders.
	EmployeeConfig *EmployeeConfigClient
	// Label is the client for interacting with the Label builders.
	Label *LabelClient
	// LabelRelationship is the client for interacting with the LabelRelationship builders.
	LabelRelationship *LabelRelationshipClient
	// LabelTagging is the client for interacting with the LabelTagging builders.
	LabelTagging *LabelTaggingClient
	// Message is the client for interacting with the Message builders.
	Message *MessageClient
	// MessageRecords is the client for interacting with the MessageRecords builders.
	MessageRecords *MessageRecordsClient
	// Msg is the client for interacting with the Msg builders.
	Msg *MsgClient
	// PayRecharge is the client for interacting with the PayRecharge builders.
	PayRecharge *PayRechargeClient
	// Server is the client for interacting with the Server builders.
	Server *ServerClient
	// SopNode is the client for interacting with the SopNode builders.
	SopNode *SopNodeClient
	// SopStage is the client for interacting with the SopStage builders.
	SopStage *SopStageClient
	// SopTask is the client for interacting with the SopTask builders.
	SopTask *SopTaskClient
	// Token is the client for interacting with the Token builders.
	Token *TokenClient
	// Tutorial is the client for interacting with the Tutorial builders.
	Tutorial *TutorialClient
	// UsageDetail is the client for interacting with the UsageDetail builders.
	UsageDetail *UsageDetailClient
	// UsageStatisticDay is the client for interacting with the UsageStatisticDay builders.
	UsageStatisticDay *UsageStatisticDayClient
	// UsageStatisticHour is the client for interacting with the UsageStatisticHour builders.
	UsageStatisticHour *UsageStatisticHourClient
	// UsageStatisticMonth is the client for interacting with the UsageStatisticMonth builders.
	UsageStatisticMonth *UsageStatisticMonthClient
	// UsageTotal is the client for interacting with the UsageTotal builders.
	UsageTotal *UsageTotalClient
	// WorkExperience is the client for interacting with the WorkExperience builders.
	WorkExperience *WorkExperienceClient
	// WpChatroom is the client for interacting with the WpChatroom builders.
	WpChatroom *WpChatroomClient
	// WpChatroomMember is the client for interacting with the WpChatroomMember builders.
	WpChatroomMember *WpChatroomMemberClient
	// Wx is the client for interacting with the Wx builders.
	Wx *WxClient
	// WxCard is the client for interacting with the WxCard builders.
	WxCard *WxCardClient
	// WxCardUser is the client for interacting with the WxCardUser builders.
	WxCardUser *WxCardUserClient
	// WxCardVisit is the client for interacting with the WxCardVisit builders.
	WxCardVisit *WxCardVisitClient

	// lazily loaded.
	client     *Client
	clientOnce sync.Once
	// ctx lives for the life of the transaction. It is
	// the same context used by the underlying connection.
	ctx context.Context
}

type (
	// Committer is the interface that wraps the Commit method.
	Committer interface {
		Commit(context.Context, *Tx) error
	}

	// The CommitFunc type is an adapter to allow the use of ordinary
	// function as a Committer. If f is a function with the appropriate
	// signature, CommitFunc(f) is a Committer that calls f.
	CommitFunc func(context.Context, *Tx) error

	// CommitHook defines the "commit middleware". A function that gets a Committer
	// and returns a Committer. For example:
	//
	//	hook := func(next ent.Committer) ent.Committer {
	//		return ent.CommitFunc(func(ctx context.Context, tx *ent.Tx) error {
	//			// Do some stuff before.
	//			if err := next.Commit(ctx, tx); err != nil {
	//				return err
	//			}
	//			// Do some stuff after.
	//			return nil
	//		})
	//	}
	//
	CommitHook func(Committer) Committer
)

// Commit calls f(ctx, m).
func (f CommitFunc) Commit(ctx context.Context, tx *Tx) error {
	return f(ctx, tx)
}

// Commit commits the transaction.
func (tx *Tx) Commit() error {
	txDriver := tx.config.driver.(*txDriver)
	var fn Committer = CommitFunc(func(context.Context, *Tx) error {
		return txDriver.tx.Commit()
	})
	txDriver.mu.Lock()
	hooks := append([]CommitHook(nil), txDriver.onCommit...)
	txDriver.mu.Unlock()
	for i := len(hooks) - 1; i >= 0; i-- {
		fn = hooks[i](fn)
	}
	return fn.Commit(tx.ctx, tx)
}

// OnCommit adds a hook to call on commit.
func (tx *Tx) OnCommit(f CommitHook) {
	txDriver := tx.config.driver.(*txDriver)
	txDriver.mu.Lock()
	txDriver.onCommit = append(txDriver.onCommit, f)
	txDriver.mu.Unlock()
}

type (
	// Rollbacker is the interface that wraps the Rollback method.
	Rollbacker interface {
		Rollback(context.Context, *Tx) error
	}

	// The RollbackFunc type is an adapter to allow the use of ordinary
	// function as a Rollbacker. If f is a function with the appropriate
	// signature, RollbackFunc(f) is a Rollbacker that calls f.
	RollbackFunc func(context.Context, *Tx) error

	// RollbackHook defines the "rollback middleware". A function that gets a Rollbacker
	// and returns a Rollbacker. For example:
	//
	//	hook := func(next ent.Rollbacker) ent.Rollbacker {
	//		return ent.RollbackFunc(func(ctx context.Context, tx *ent.Tx) error {
	//			// Do some stuff before.
	//			if err := next.Rollback(ctx, tx); err != nil {
	//				return err
	//			}
	//			// Do some stuff after.
	//			return nil
	//		})
	//	}
	//
	RollbackHook func(Rollbacker) Rollbacker
)

// Rollback calls f(ctx, m).
func (f RollbackFunc) Rollback(ctx context.Context, tx *Tx) error {
	return f(ctx, tx)
}

// Rollback rollbacks the transaction.
func (tx *Tx) Rollback() error {
	txDriver := tx.config.driver.(*txDriver)
	var fn Rollbacker = RollbackFunc(func(context.Context, *Tx) error {
		return txDriver.tx.Rollback()
	})
	txDriver.mu.Lock()
	hooks := append([]RollbackHook(nil), txDriver.onRollback...)
	txDriver.mu.Unlock()
	for i := len(hooks) - 1; i >= 0; i-- {
		fn = hooks[i](fn)
	}
	return fn.Rollback(tx.ctx, tx)
}

// OnRollback adds a hook to call on rollback.
func (tx *Tx) OnRollback(f RollbackHook) {
	txDriver := tx.config.driver.(*txDriver)
	txDriver.mu.Lock()
	txDriver.onRollback = append(txDriver.onRollback, f)
	txDriver.mu.Unlock()
}

// Client returns a Client that binds to current transaction.
func (tx *Tx) Client() *Client {
	tx.clientOnce.Do(func() {
		tx.client = &Client{config: tx.config}
		tx.client.init()
	})
	return tx.client
}

func (tx *Tx) init() {
	tx.Agent = NewAgentClient(tx.config)
	tx.AgentBase = NewAgentBaseClient(tx.config)
	tx.AliyunAvatar = NewAliyunAvatarClient(tx.config)
	tx.AllocAgent = NewAllocAgentClient(tx.config)
	tx.BatchMsg = NewBatchMsgClient(tx.config)
	tx.Category = NewCategoryClient(tx.config)
	tx.ChatRecords = NewChatRecordsClient(tx.config)
	tx.ChatSession = NewChatSessionClient(tx.config)
	tx.Contact = NewContactClient(tx.config)
	tx.CreditBalance = NewCreditBalanceClient(tx.config)
	tx.CreditUsage = NewCreditUsageClient(tx.config)
	tx.Employee = NewEmployeeClient(tx.config)
	tx.EmployeeConfig = NewEmployeeConfigClient(tx.config)
	tx.Label = NewLabelClient(tx.config)
	tx.LabelRelationship = NewLabelRelationshipClient(tx.config)
	tx.LabelTagging = NewLabelTaggingClient(tx.config)
	tx.Message = NewMessageClient(tx.config)
	tx.MessageRecords = NewMessageRecordsClient(tx.config)
	tx.Msg = NewMsgClient(tx.config)
	tx.PayRecharge = NewPayRechargeClient(tx.config)
	tx.Server = NewServerClient(tx.config)
	tx.SopNode = NewSopNodeClient(tx.config)
	tx.SopStage = NewSopStageClient(tx.config)
	tx.SopTask = NewSopTaskClient(tx.config)
	tx.Token = NewTokenClient(tx.config)
	tx.Tutorial = NewTutorialClient(tx.config)
	tx.UsageDetail = NewUsageDetailClient(tx.config)
	tx.UsageStatisticDay = NewUsageStatisticDayClient(tx.config)
	tx.UsageStatisticHour = NewUsageStatisticHourClient(tx.config)
	tx.UsageStatisticMonth = NewUsageStatisticMonthClient(tx.config)
	tx.UsageTotal = NewUsageTotalClient(tx.config)
	tx.WorkExperience = NewWorkExperienceClient(tx.config)
	tx.WpChatroom = NewWpChatroomClient(tx.config)
	tx.WpChatroomMember = NewWpChatroomMemberClient(tx.config)
	tx.Wx = NewWxClient(tx.config)
	tx.WxCard = NewWxCardClient(tx.config)
	tx.WxCardUser = NewWxCardUserClient(tx.config)
	tx.WxCardVisit = NewWxCardVisitClient(tx.config)
}

// txDriver wraps the given dialect.Tx with a nop dialect.Driver implementation.
// The idea is to support transactions without adding any extra code to the builders.
// When a builder calls to driver.Tx(), it gets the same dialect.Tx instance.
// Commit and Rollback are nop for the internal builders and the user must call one
// of them in order to commit or rollback the transaction.
//
// If a closed transaction is embedded in one of the generated entities, and the entity
// applies a query, for example: Agent.QueryXXX(), the query will be executed
// through the driver which created this transaction.
//
// Note that txDriver is not goroutine safe.
type txDriver struct {
	// the driver we started the transaction from.
	drv dialect.Driver
	// tx is the underlying transaction.
	tx dialect.Tx
	// completion hooks.
	mu         sync.Mutex
	onCommit   []CommitHook
	onRollback []RollbackHook
}

// newTx creates a new transactional driver.
func newTx(ctx context.Context, drv dialect.Driver) (*txDriver, error) {
	tx, err := drv.Tx(ctx)
	if err != nil {
		return nil, err
	}
	return &txDriver{tx: tx, drv: drv}, nil
}

// Tx returns the transaction wrapper (txDriver) to avoid Commit or Rollback calls
// from the internal builders. Should be called only by the internal builders.
func (tx *txDriver) Tx(context.Context) (dialect.Tx, error) { return tx, nil }

// Dialect returns the dialect of the driver we started the transaction from.
func (tx *txDriver) Dialect() string { return tx.drv.Dialect() }

// Close is a nop close.
func (*txDriver) Close() error { return nil }

// Commit is a nop commit for the internal builders.
// User must call `Tx.Commit` in order to commit the transaction.
func (*txDriver) Commit() error { return nil }

// Rollback is a nop rollback for the internal builders.
// User must call `Tx.Rollback` in order to rollback the transaction.
func (*txDriver) Rollback() error { return nil }

// Exec calls tx.Exec.
func (tx *txDriver) Exec(ctx context.Context, query string, args, v any) error {
	return tx.tx.Exec(ctx, query, args, v)
}

// Query calls tx.Query.
func (tx *txDriver) Query(ctx context.Context, query string, args, v any) error {
	return tx.tx.Query(ctx, query, args, v)
}

var _ dialect.Driver = (*txDriver)(nil)

// ExecContext allows calling the underlying ExecContext method of the transaction if it is supported by it.
// See, database/sql#Tx.ExecContext for more information.
func (tx *txDriver) ExecContext(ctx context.Context, query string, args ...any) (stdsql.Result, error) {
	ex, ok := tx.tx.(interface {
		ExecContext(context.Context, string, ...any) (stdsql.Result, error)
	})
	if !ok {
		return nil, fmt.Errorf("Tx.ExecContext is not supported")
	}
	return ex.ExecContext(ctx, query, args...)
}

// QueryContext allows calling the underlying QueryContext method of the transaction if it is supported by it.
// See, database/sql#Tx.QueryContext for more information.
func (tx *txDriver) QueryContext(ctx context.Context, query string, args ...any) (*stdsql.Rows, error) {
	q, ok := tx.tx.(interface {
		QueryContext(context.Context, string, ...any) (*stdsql.Rows, error)
	})
	if !ok {
		return nil, fmt.Errorf("Tx.QueryContext is not supported")
	}
	return q.QueryContext(ctx, query, args...)
}