{{/* Copyright 2019-present Facebook Inc. All rights reserved. This source code is licensed under the Apache 2.0 license found in the LICENSE file in the root directory of this source tree. */}} {{/* gotype: entgo.io/ent/entc/gen.Graph */}} {{ define "client/init" }} // Client is the client that holds all ent builders. type Client struct { config {{- if $.SupportMigrate }} // Schema is the client for creating, migrating and dropping schema. Schema *migrate.Schema {{- end }} {{- range $n := $.Nodes }} // {{ $n.Name }} is the client for interacting with the {{ $n.Name }} builders. {{ $n.Name }} *{{ $n.Name }}Client {{- end }} {{- template "client/fields/additional" $ }} {{- with $tmpls := matchTemplate "client/fields/additional/*" }} {{- range $tmpl := $tmpls }} {{- xtemplate $tmpl $ }} {{- end }} {{- end }} } // NewClient creates a new client configured with the given options. func NewClient(opts ...Option) *Client { cfg := config{log: log.Println, hooks: &hooks{}} cfg.options(opts...) client := &Client{config: cfg} client.init() return client } func (c *Client) init() { {{- if $.SupportMigrate }} c.Schema = migrate.NewSchema(c.driver) {{- end }} {{- range $n := $.Nodes }} c.{{ $n.Name }} = New{{ $n.Name }}Client(c.config) {{- end }} } {{ end }} {{ define "client" }} {{ $pkg := base $.Config.Package }} {{ template "header" $ }} import ( "log" "{{ $.Config.Package }}/migrate" {{ range $n := $.Nodes }} {{ $n.PackageAlias }} "{{ $n.Config.Package }}/{{ $n.PackageDir }}" {{- end }} "entgo.io/ent/dialect" {{ range $import := $.Storage.Imports -}} "{{ $import }}" {{ end -}} ) {{ template "client/init" $ }} // Open opens a database/sql.DB specified by the driver name and // the data source name, and returns a new client attached to it. // Optional parameters can be added for configuring the client. func Open(driverName, dataSourceName string, options ...Option) (*Client, error) { switch driverName { case {{ join $.Storage.Dialects ", " }}: {{- $tmpl := printf "dialect/%s/client/open" $.Storage -}} {{- xtemplate $tmpl . -}} default: return nil, fmt.Errorf("unsupported driver: %q", driverName) } } // Tx returns a new transactional client. The provided context // is used until the transaction is committed or rolled back. func (c *Client) Tx(ctx context.Context) (*Tx, error) { if _, ok := c.driver.(*txDriver); ok { return nil, errors.New("{{ $pkg }}: cannot start a transaction within a transaction") } tx, err := newTx(ctx, c.driver) if err != nil { return nil, fmt.Errorf("{{ $pkg }}: starting a transaction: %w", err) } cfg := c.config cfg.driver = tx return &Tx{ ctx: ctx, config: cfg, {{- range $n := $.Nodes }} {{ $n.Name }}: New{{ $n.Name }}Client(cfg), {{- end }} }, nil } {{- /* If the storage driver supports TxOptions (like SQL) */}} {{- $tmpl = printf "dialect/%s/txoptions" $.Storage }} {{- if hasTemplate $tmpl }} {{- xtemplate $tmpl . }} {{- end }} // Debug returns a new debug-client. It's used to get verbose logging on specific operations. // // client.Debug(). // {{ (index $.Nodes 0).Name }}. // Query(). // Count(ctx) // func (c *Client) Debug() *Client { if c.debug { return c } cfg := c.config cfg.driver = dialect.Debug(c.driver, c.log) client := &Client{config: cfg} client.init() return client } // Close closes the database connection and prevents new queries from starting. func (c *Client) Close() error { return c.driver.Close() } // Use adds the mutation hooks to all the entity clients. // In order to add hooks to a specific client, call: `client.Node.Use(...)`. func (c *Client) Use(hooks ...Hook) { {{- range $n := $.Nodes }} c.{{ $n.Name }}.Use(hooks...) {{- end }} } {{- with $tmpls := matchTemplate "client/additional/*" "client/additional/*/*" }} {{- range $tmpl := $tmpls }} {{- xtemplate $tmpl $ }} {{- end }} {{- end }} {{ range $n := $.Nodes }} {{ $client := print $n.Name "Client" }} // {{ $client }} is a client for the {{ $n.Name }} schema. type {{ $client }} struct { config } {{ $rec := $n.Receiver }}{{ if eq $rec "c" }}{{ $rec = printf "%.2s" $n.Name | lower }}{{ end }} // New{{ $client }} returns a client for the {{ $n.Name }} from the given config. func New{{ $client }}(c config) *{{ $client }} { return &{{ $client }}{config: c} } // Use adds a list of mutation hooks to the hooks stack. // A call to `Use(f, g, h)` equals to `{{ $n.Package }}.Hooks(f(g(h())))`. func (c *{{ $client }}) Use(hooks ...Hook) { c.hooks.{{ $n.Name }} = append(c.hooks.{{ $n.Name }}, hooks...) } // Create returns a builder for creating a {{ $n.Name }} entity. func (c *{{ $client }}) Create() *{{ $n.CreateName }} { mutation := new{{ $n.MutationName }}(c.config, OpCreate) return &{{ $n.CreateName }}{config: c.config, hooks: c.Hooks(), mutation: mutation} } // CreateBulk returns a builder for creating a bulk of {{ $n.Name }} entities. func (c *{{ $client }}) CreateBulk(builders ...*{{ $n.CreateName }}) *{{ $n.CreateBulkName }} { return &{{ $n.CreateBulkName }}{config: c.config, builders: builders} } // Update returns an update builder for {{ $n.Name }}. func (c *{{ $client }}) Update() *{{ $n.UpdateName }} { mutation := new{{ $n.MutationName }}(c.config, OpUpdate) return &{{ $n.UpdateName }}{config: c.config, hooks: c.Hooks(), mutation: mutation} } // UpdateOne returns an update builder for the given entity. func (c *{{ $client }}) UpdateOne({{ $rec }} *{{ $n.Name }}) *{{ $n.UpdateOneName }} { {{- if $n.HasOneFieldID }} mutation := new{{ $n.MutationName }}(c.config, OpUpdateOne, {{ print "with" $n.Name }}({{ $rec }})) {{- else }} mutation := new{{ $n.MutationName }}(c.config, OpUpdateOne) {{- range $id := $n.EdgeSchema.ID }} mutation.{{ $id.BuilderField }} = &{{ $rec }}.{{ $id.StructField }} {{- end }} {{- end }} return &{{ $n.UpdateOneName }}{config: c.config, hooks: c.Hooks(), mutation: mutation} } {{ with $n.HasOneFieldID }} // UpdateOneID returns an update builder for the given id. func (c *{{ $client }}) UpdateOneID(id {{ $n.ID.Type }}) *{{ $n.UpdateOneName }} { mutation := new{{ $n.MutationName }}(c.config, OpUpdateOne, {{ print "with" $n.Name "ID" }}(id)) return &{{ $n.UpdateOneName }}{config: c.config, hooks: c.Hooks(), mutation: mutation} } {{ end }} // Delete returns a delete builder for {{ $n.Name }}. func (c *{{ $client }}) Delete() *{{ $n.DeleteName }} { mutation := new{{ $n.MutationName }}(c.config, OpDelete) return &{{ $n.DeleteName }}{config: c.config, hooks: c.Hooks(), mutation: mutation} } {{ with $n.HasOneFieldID }} // DeleteOne returns a builder for deleting the given entity. func (c *{{ $client }}) DeleteOne({{ $rec }} *{{ $n.Name }}) *{{ $n.DeleteOneName }} { return c.DeleteOneID({{ $rec }}.ID) } // DeleteOne returns a builder for deleting the given entity by its id. func (c *{{ $client }}) DeleteOneID(id {{ $n.ID.Type }}) *{{ $n.DeleteOneName }} { builder := c.Delete().Where({{ $n.Package }}.ID(id)) builder.mutation.id = &id builder.mutation.op = OpDeleteOne return &{{ $n.DeleteOneName }}{builder} } {{ end }} // Query returns a query builder for {{ $n.Name }}. func (c *{{ $client }}) Query() *{{ $n.QueryName }} { return &{{ $n.QueryName }}{ config: c.config, {{- with $tmpls := matchTemplate (printf "dialect/%s/query/fields/init/*" $.Storage) }} {{- range $tmpl := $tmpls }} {{- xtemplate $tmpl $n }} {{- end }} {{- end }} } } {{ with $n.HasOneFieldID }} // Get returns a {{ $n.Name }} entity by its id. func (c *{{ $client }}) Get(ctx context.Context, id {{ $n.ID.Type }}) (*{{ $n.Name }}, error) { return c.Query().Where({{ $n.Package }}.ID(id)).Only(ctx) } // GetX is like Get, but panics if an error occurs. func (c *{{ $client }}) GetX(ctx context.Context, id {{ $n.ID.Type }}) *{{ $n.Name }} { obj, err := c.Get(ctx, id) if err != nil { panic(err) } return obj } {{ end }} {{ range $e := $n.Edges }} {{ $builder := $e.Type.QueryName }} {{ $arg := $rec }}{{ if eq $arg "id" }}{{ $arg = "node" }}{{ end }} {{ $func := print "Query" (pascal $e.Name) }} // Query{{ pascal $e.Name }} queries the {{ $e.Name }} edge of a {{ $n.Name }}. func (c *{{ $client }}) {{ $func }}({{ $arg }} *{{ $n.Name }}) *{{ $builder }} { {{- if $n.HasOneFieldID }} query := &{{ $builder }}{config: c.config} query.path = func(context.Context) (fromV {{ $.Storage.Builder }}, _ error) { {{- with extend $n "Receiver" $arg "Edge" $e "Ident" "fromV" }} {{ $tmpl := printf "dialect/%s/query/from" $.Storage }} {{- xtemplate $tmpl . -}} {{- end -}} return fromV, nil } return query {{- else }} {{- /* For edge schema, we use the predicate-based approach. */}} return c.Query(). Where({{ range $id := $n.EdgeSchema.ID }}{{ $n.Package }}.{{ $id.StructField }}({{ $arg }}.{{ $id.StructField }}),{{ end }}). {{ $func }}() {{- end }} } {{ end }} // Hooks returns the client hooks. func (c *{{ $client }}) Hooks() []Hook { {{- if or $n.NumHooks $n.NumPolicy }} hooks := c.hooks.{{ $n.Name }} return append(hooks[:len(hooks):len(hooks)], {{ $n.Package }}.Hooks[:]...) {{- else }} return c.hooks.{{ $n.Name }} {{- end }} } {{ end }} {{ end }} {{/* A template that can be overridden in order to add additional fields to the client.*/}} {{ define "client/fields/additional" }}{{ end }}