// 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. // Code generated by ent, DO NOT EDIT. package entv2 import ( "context" "database/sql/driver" "fmt" "math" "entgo.io/ent/dialect/sql" "entgo.io/ent/dialect/sql/sqlgraph" "entgo.io/ent/entc/integration/migrate/entv2/car" "entgo.io/ent/entc/integration/migrate/entv2/pet" "entgo.io/ent/entc/integration/migrate/entv2/predicate" "entgo.io/ent/entc/integration/migrate/entv2/user" "entgo.io/ent/schema/field" ) // UserQuery is the builder for querying User entities. type UserQuery struct { config limit *int offset *int unique *bool order []OrderFunc fields []string inters []Interceptor predicates []predicate.User withCar *CarQuery withPets *PetQuery withFriends *UserQuery withFKs bool // intermediate query (i.e. traversal path). sql *sql.Selector path func(context.Context) (*sql.Selector, error) } // Where adds a new predicate for the UserQuery builder. func (uq *UserQuery) Where(ps ...predicate.User) *UserQuery { uq.predicates = append(uq.predicates, ps...) return uq } // Limit the number of records to be returned by this query. func (uq *UserQuery) Limit(limit int) *UserQuery { uq.limit = &limit return uq } // Offset to start from. func (uq *UserQuery) Offset(offset int) *UserQuery { uq.offset = &offset return uq } // Unique configures the query builder to filter duplicate records on query. // By default, unique is set to true, and can be disabled using this method. func (uq *UserQuery) Unique(unique bool) *UserQuery { uq.unique = &unique return uq } // Order specifies how the records should be ordered. func (uq *UserQuery) Order(o ...OrderFunc) *UserQuery { uq.order = append(uq.order, o...) return uq } // QueryCar chains the current query on the "car" edge. func (uq *UserQuery) QueryCar() *CarQuery { query := (&CarClient{config: uq.config}).Query() query.path = func(ctx context.Context) (fromU *sql.Selector, err error) { if err := uq.prepareQuery(ctx); err != nil { return nil, err } selector := uq.sqlQuery(ctx) if err := selector.Err(); err != nil { return nil, err } step := sqlgraph.NewStep( sqlgraph.From(user.Table, user.FieldID, selector), sqlgraph.To(car.Table, car.FieldID), sqlgraph.Edge(sqlgraph.O2M, false, user.CarTable, user.CarColumn), ) fromU = sqlgraph.SetNeighbors(uq.driver.Dialect(), step) return fromU, nil } return query } // QueryPets chains the current query on the "pets" edge. func (uq *UserQuery) QueryPets() *PetQuery { query := (&PetClient{config: uq.config}).Query() query.path = func(ctx context.Context) (fromU *sql.Selector, err error) { if err := uq.prepareQuery(ctx); err != nil { return nil, err } selector := uq.sqlQuery(ctx) if err := selector.Err(); err != nil { return nil, err } step := sqlgraph.NewStep( sqlgraph.From(user.Table, user.FieldID, selector), sqlgraph.To(pet.Table, pet.FieldID), sqlgraph.Edge(sqlgraph.O2O, false, user.PetsTable, user.PetsColumn), ) fromU = sqlgraph.SetNeighbors(uq.driver.Dialect(), step) return fromU, nil } return query } // QueryFriends chains the current query on the "friends" edge. func (uq *UserQuery) QueryFriends() *UserQuery { query := (&UserClient{config: uq.config}).Query() query.path = func(ctx context.Context) (fromU *sql.Selector, err error) { if err := uq.prepareQuery(ctx); err != nil { return nil, err } selector := uq.sqlQuery(ctx) if err := selector.Err(); err != nil { return nil, err } step := sqlgraph.NewStep( sqlgraph.From(user.Table, user.FieldID, selector), sqlgraph.To(user.Table, user.FieldID), sqlgraph.Edge(sqlgraph.M2M, false, user.FriendsTable, user.FriendsPrimaryKey...), ) fromU = sqlgraph.SetNeighbors(uq.driver.Dialect(), step) return fromU, nil } return query } // First returns the first User entity from the query. // Returns a *NotFoundError when no User was found. func (uq *UserQuery) First(ctx context.Context) (*User, error) { nodes, err := uq.Limit(1).All(newQueryContext(ctx, TypeUser, "First")) if err != nil { return nil, err } if len(nodes) == 0 { return nil, &NotFoundError{user.Label} } return nodes[0], nil } // FirstX is like First, but panics if an error occurs. func (uq *UserQuery) FirstX(ctx context.Context) *User { node, err := uq.First(ctx) if err != nil && !IsNotFound(err) { panic(err) } return node } // FirstID returns the first User ID from the query. // Returns a *NotFoundError when no User ID was found. func (uq *UserQuery) FirstID(ctx context.Context) (id int, err error) { var ids []int if ids, err = uq.Limit(1).IDs(newQueryContext(ctx, TypeUser, "FirstID")); err != nil { return } if len(ids) == 0 { err = &NotFoundError{user.Label} return } return ids[0], nil } // FirstIDX is like FirstID, but panics if an error occurs. func (uq *UserQuery) FirstIDX(ctx context.Context) int { id, err := uq.FirstID(ctx) if err != nil && !IsNotFound(err) { panic(err) } return id } // Only returns a single User entity found by the query, ensuring it only returns one. // Returns a *NotSingularError when more than one User entity is found. // Returns a *NotFoundError when no User entities are found. func (uq *UserQuery) Only(ctx context.Context) (*User, error) { nodes, err := uq.Limit(2).All(newQueryContext(ctx, TypeUser, "Only")) if err != nil { return nil, err } switch len(nodes) { case 1: return nodes[0], nil case 0: return nil, &NotFoundError{user.Label} default: return nil, &NotSingularError{user.Label} } } // OnlyX is like Only, but panics if an error occurs. func (uq *UserQuery) OnlyX(ctx context.Context) *User { node, err := uq.Only(ctx) if err != nil { panic(err) } return node } // OnlyID is like Only, but returns the only User ID in the query. // Returns a *NotSingularError when more than one User ID is found. // Returns a *NotFoundError when no entities are found. func (uq *UserQuery) OnlyID(ctx context.Context) (id int, err error) { var ids []int if ids, err = uq.Limit(2).IDs(newQueryContext(ctx, TypeUser, "OnlyID")); err != nil { return } switch len(ids) { case 1: id = ids[0] case 0: err = &NotFoundError{user.Label} default: err = &NotSingularError{user.Label} } return } // OnlyIDX is like OnlyID, but panics if an error occurs. func (uq *UserQuery) OnlyIDX(ctx context.Context) int { id, err := uq.OnlyID(ctx) if err != nil { panic(err) } return id } // All executes the query and returns a list of Users. func (uq *UserQuery) All(ctx context.Context) ([]*User, error) { ctx = newQueryContext(ctx, TypeUser, "All") if err := uq.prepareQuery(ctx); err != nil { return nil, err } qr := querierAll[[]*User, *UserQuery]() return withInterceptors[[]*User](ctx, uq, qr, uq.inters) } // AllX is like All, but panics if an error occurs. func (uq *UserQuery) AllX(ctx context.Context) []*User { nodes, err := uq.All(ctx) if err != nil { panic(err) } return nodes } // IDs executes the query and returns a list of User IDs. func (uq *UserQuery) IDs(ctx context.Context) ([]int, error) { var ids []int ctx = newQueryContext(ctx, TypeUser, "IDs") if err := uq.Select(user.FieldID).Scan(ctx, &ids); err != nil { return nil, err } return ids, nil } // IDsX is like IDs, but panics if an error occurs. func (uq *UserQuery) IDsX(ctx context.Context) []int { ids, err := uq.IDs(ctx) if err != nil { panic(err) } return ids } // Count returns the count of the given query. func (uq *UserQuery) Count(ctx context.Context) (int, error) { ctx = newQueryContext(ctx, TypeUser, "Count") if err := uq.prepareQuery(ctx); err != nil { return 0, err } return withInterceptors[int](ctx, uq, querierCount[*UserQuery](), uq.inters) } // CountX is like Count, but panics if an error occurs. func (uq *UserQuery) CountX(ctx context.Context) int { count, err := uq.Count(ctx) if err != nil { panic(err) } return count } // Exist returns true if the query has elements in the graph. func (uq *UserQuery) Exist(ctx context.Context) (bool, error) { ctx = newQueryContext(ctx, TypeUser, "Exist") switch _, err := uq.FirstID(ctx); { case IsNotFound(err): return false, nil case err != nil: return false, fmt.Errorf("entv2: check existence: %w", err) default: return true, nil } } // ExistX is like Exist, but panics if an error occurs. func (uq *UserQuery) ExistX(ctx context.Context) bool { exist, err := uq.Exist(ctx) if err != nil { panic(err) } return exist } // Clone returns a duplicate of the UserQuery builder, including all associated steps. It can be // used to prepare common query builders and use them differently after the clone is made. func (uq *UserQuery) Clone() *UserQuery { if uq == nil { return nil } return &UserQuery{ config: uq.config, limit: uq.limit, offset: uq.offset, order: append([]OrderFunc{}, uq.order...), inters: append([]Interceptor{}, uq.inters...), predicates: append([]predicate.User{}, uq.predicates...), withCar: uq.withCar.Clone(), withPets: uq.withPets.Clone(), withFriends: uq.withFriends.Clone(), // clone intermediate query. sql: uq.sql.Clone(), path: uq.path, unique: uq.unique, } } // WithCar tells the query-builder to eager-load the nodes that are connected to // the "car" edge. The optional arguments are used to configure the query builder of the edge. func (uq *UserQuery) WithCar(opts ...func(*CarQuery)) *UserQuery { query := (&CarClient{config: uq.config}).Query() for _, opt := range opts { opt(query) } uq.withCar = query return uq } // WithPets tells the query-builder to eager-load the nodes that are connected to // the "pets" edge. The optional arguments are used to configure the query builder of the edge. func (uq *UserQuery) WithPets(opts ...func(*PetQuery)) *UserQuery { query := (&PetClient{config: uq.config}).Query() for _, opt := range opts { opt(query) } uq.withPets = query return uq } // WithFriends tells the query-builder to eager-load the nodes that are connected to // the "friends" edge. The optional arguments are used to configure the query builder of the edge. func (uq *UserQuery) WithFriends(opts ...func(*UserQuery)) *UserQuery { query := (&UserClient{config: uq.config}).Query() for _, opt := range opts { opt(query) } uq.withFriends = query return uq } // GroupBy is used to group vertices by one or more fields/columns. // It is often used with aggregate functions, like: count, max, mean, min, sum. // // Example: // // var v []struct { // MixedString string `json:"mixed_string,omitempty"` // Count int `json:"count,omitempty"` // } // // client.User.Query(). // GroupBy(user.FieldMixedString). // Aggregate(entv2.Count()). // Scan(ctx, &v) func (uq *UserQuery) GroupBy(field string, fields ...string) *UserGroupBy { uq.fields = append([]string{field}, fields...) grbuild := &UserGroupBy{build: uq} grbuild.flds = &uq.fields grbuild.label = user.Label grbuild.scan = grbuild.Scan return grbuild } // Select allows the selection one or more fields/columns for the given query, // instead of selecting all fields in the entity. // // Example: // // var v []struct { // MixedString string `json:"mixed_string,omitempty"` // } // // client.User.Query(). // Select(user.FieldMixedString). // Scan(ctx, &v) func (uq *UserQuery) Select(fields ...string) *UserSelect { uq.fields = append(uq.fields, fields...) sbuild := &UserSelect{UserQuery: uq} sbuild.label = user.Label sbuild.flds, sbuild.scan = &uq.fields, sbuild.Scan return sbuild } // Aggregate returns a UserSelect configured with the given aggregations. func (uq *UserQuery) Aggregate(fns ...AggregateFunc) *UserSelect { return uq.Select().Aggregate(fns...) } func (uq *UserQuery) prepareQuery(ctx context.Context) error { for _, inter := range uq.inters { if inter == nil { return fmt.Errorf("entv2: uninitialized interceptor (forgotten import entv2/runtime?)") } if trv, ok := inter.(Traverser); ok { if err := trv.Traverse(ctx, uq); err != nil { return err } } } for _, f := range uq.fields { if !user.ValidColumn(f) { return &ValidationError{Name: f, err: fmt.Errorf("entv2: invalid field %q for query", f)} } } if uq.path != nil { prev, err := uq.path(ctx) if err != nil { return err } uq.sql = prev } return nil } func (uq *UserQuery) sqlAll(ctx context.Context, hooks ...queryHook) ([]*User, error) { var ( nodes = []*User{} withFKs = uq.withFKs _spec = uq.querySpec() loadedTypes = [3]bool{ uq.withCar != nil, uq.withPets != nil, uq.withFriends != nil, } ) if withFKs { _spec.Node.Columns = append(_spec.Node.Columns, user.ForeignKeys...) } _spec.ScanValues = func(columns []string) ([]any, error) { return (*User).scanValues(nil, columns) } _spec.Assign = func(columns []string, values []any) error { node := &User{config: uq.config} nodes = append(nodes, node) node.Edges.loadedTypes = loadedTypes return node.assignValues(columns, values) } for i := range hooks { hooks[i](ctx, _spec) } if err := sqlgraph.QueryNodes(ctx, uq.driver, _spec); err != nil { return nil, err } if len(nodes) == 0 { return nodes, nil } if query := uq.withCar; query != nil { if err := uq.loadCar(ctx, query, nodes, func(n *User) { n.Edges.Car = []*Car{} }, func(n *User, e *Car) { n.Edges.Car = append(n.Edges.Car, e) }); err != nil { return nil, err } } if query := uq.withPets; query != nil { if err := uq.loadPets(ctx, query, nodes, nil, func(n *User, e *Pet) { n.Edges.Pets = e }); err != nil { return nil, err } } if query := uq.withFriends; query != nil { if err := uq.loadFriends(ctx, query, nodes, func(n *User) { n.Edges.Friends = []*User{} }, func(n *User, e *User) { n.Edges.Friends = append(n.Edges.Friends, e) }); err != nil { return nil, err } } return nodes, nil } func (uq *UserQuery) loadCar(ctx context.Context, query *CarQuery, nodes []*User, init func(*User), assign func(*User, *Car)) error { fks := make([]driver.Value, 0, len(nodes)) nodeids := make(map[int]*User) for i := range nodes { fks = append(fks, nodes[i].ID) nodeids[nodes[i].ID] = nodes[i] if init != nil { init(nodes[i]) } } query.withFKs = true query.Where(predicate.Car(func(s *sql.Selector) { s.Where(sql.InValues(user.CarColumn, fks...)) })) neighbors, err := query.All(ctx) if err != nil { return err } for _, n := range neighbors { fk := n.user_car if fk == nil { return fmt.Errorf(`foreign-key "user_car" is nil for node %v`, n.ID) } node, ok := nodeids[*fk] if !ok { return fmt.Errorf(`unexpected foreign-key "user_car" returned %v for node %v`, *fk, n.ID) } assign(node, n) } return nil } func (uq *UserQuery) loadPets(ctx context.Context, query *PetQuery, nodes []*User, init func(*User), assign func(*User, *Pet)) error { fks := make([]driver.Value, 0, len(nodes)) nodeids := make(map[int]*User) for i := range nodes { fks = append(fks, nodes[i].ID) nodeids[nodes[i].ID] = nodes[i] } query.withFKs = true query.Where(predicate.Pet(func(s *sql.Selector) { s.Where(sql.InValues(user.PetsColumn, fks...)) })) neighbors, err := query.All(ctx) if err != nil { return err } for _, n := range neighbors { fk := n.owner_id if fk == nil { return fmt.Errorf(`foreign-key "owner_id" is nil for node %v`, n.ID) } node, ok := nodeids[*fk] if !ok { return fmt.Errorf(`unexpected foreign-key "owner_id" returned %v for node %v`, *fk, n.ID) } assign(node, n) } return nil } func (uq *UserQuery) loadFriends(ctx context.Context, query *UserQuery, nodes []*User, init func(*User), assign func(*User, *User)) error { edgeIDs := make([]driver.Value, len(nodes)) byID := make(map[int]*User) nids := make(map[int]map[*User]struct{}) for i, node := range nodes { edgeIDs[i] = node.ID byID[node.ID] = node if init != nil { init(node) } } query.Where(func(s *sql.Selector) { joinT := sql.Table(user.FriendsTable) s.Join(joinT).On(s.C(user.FieldID), joinT.C(user.FriendsPrimaryKey[1])) s.Where(sql.InValues(joinT.C(user.FriendsPrimaryKey[0]), edgeIDs...)) columns := s.SelectedColumns() s.Select(joinT.C(user.FriendsPrimaryKey[0])) s.AppendSelect(columns...) s.SetDistinct(false) }) if err := query.prepareQuery(ctx); err != nil { return err } neighbors, err := query.sqlAll(ctx, func(_ context.Context, spec *sqlgraph.QuerySpec) { assign := spec.Assign values := spec.ScanValues spec.ScanValues = func(columns []string) ([]any, error) { values, err := values(columns[1:]) if err != nil { return nil, err } return append([]any{new(sql.NullInt64)}, values...), nil } spec.Assign = func(columns []string, values []any) error { outValue := int(values[0].(*sql.NullInt64).Int64) inValue := int(values[1].(*sql.NullInt64).Int64) if nids[inValue] == nil { nids[inValue] = map[*User]struct{}{byID[outValue]: {}} return assign(columns[1:], values[1:]) } nids[inValue][byID[outValue]] = struct{}{} return nil } }) if err != nil { return err } for _, n := range neighbors { nodes, ok := nids[n.ID] if !ok { return fmt.Errorf(`unexpected "friends" node returned %v`, n.ID) } for kn := range nodes { assign(kn, n) } } return nil } func (uq *UserQuery) sqlCount(ctx context.Context) (int, error) { _spec := uq.querySpec() _spec.Node.Columns = uq.fields if len(uq.fields) > 0 { _spec.Unique = uq.unique != nil && *uq.unique } return sqlgraph.CountNodes(ctx, uq.driver, _spec) } func (uq *UserQuery) querySpec() *sqlgraph.QuerySpec { _spec := &sqlgraph.QuerySpec{ Node: &sqlgraph.NodeSpec{ Table: user.Table, Columns: user.Columns, ID: &sqlgraph.FieldSpec{ Type: field.TypeInt, Column: user.FieldID, }, }, From: uq.sql, Unique: true, } if unique := uq.unique; unique != nil { _spec.Unique = *unique } if fields := uq.fields; len(fields) > 0 { _spec.Node.Columns = make([]string, 0, len(fields)) _spec.Node.Columns = append(_spec.Node.Columns, user.FieldID) for i := range fields { if fields[i] != user.FieldID { _spec.Node.Columns = append(_spec.Node.Columns, fields[i]) } } } if ps := uq.predicates; len(ps) > 0 { _spec.Predicate = func(selector *sql.Selector) { for i := range ps { ps[i](selector) } } } if limit := uq.limit; limit != nil { _spec.Limit = *limit } if offset := uq.offset; offset != nil { _spec.Offset = *offset } if ps := uq.order; len(ps) > 0 { _spec.Order = func(selector *sql.Selector) { for i := range ps { ps[i](selector) } } } return _spec } func (uq *UserQuery) sqlQuery(ctx context.Context) *sql.Selector { builder := sql.Dialect(uq.driver.Dialect()) t1 := builder.Table(user.Table) columns := uq.fields if len(columns) == 0 { columns = user.Columns } selector := builder.Select(t1.Columns(columns...)...).From(t1) if uq.sql != nil { selector = uq.sql selector.Select(selector.Columns(columns...)...) } if uq.unique != nil && *uq.unique { selector.Distinct() } for _, p := range uq.predicates { p(selector) } for _, p := range uq.order { p(selector) } if offset := uq.offset; offset != nil { // limit is mandatory for offset clause. We start // with default value, and override it below if needed. selector.Offset(*offset).Limit(math.MaxInt32) } if limit := uq.limit; limit != nil { selector.Limit(*limit) } return selector } // UserGroupBy is the group-by builder for User entities. type UserGroupBy struct { selector build *UserQuery } // Aggregate adds the given aggregation functions to the group-by query. func (ugb *UserGroupBy) Aggregate(fns ...AggregateFunc) *UserGroupBy { ugb.fns = append(ugb.fns, fns...) return ugb } // Scan applies the selector query and scans the result into the given value. func (ugb *UserGroupBy) Scan(ctx context.Context, v any) error { ctx = newQueryContext(ctx, TypeUser, "GroupBy") if err := ugb.build.prepareQuery(ctx); err != nil { return err } return scanWithInterceptors[*UserQuery, *UserGroupBy](ctx, ugb.build, ugb, ugb.build.inters, v) } func (ugb *UserGroupBy) sqlScan(ctx context.Context, root *UserQuery, v any) error { selector := root.sqlQuery(ctx).Select() aggregation := make([]string, 0, len(ugb.fns)) for _, fn := range ugb.fns { aggregation = append(aggregation, fn(selector)) } if len(selector.SelectedColumns()) == 0 { columns := make([]string, 0, len(*ugb.flds)+len(ugb.fns)) for _, f := range *ugb.flds { columns = append(columns, selector.C(f)) } columns = append(columns, aggregation...) selector.Select(columns...) } selector.GroupBy(selector.Columns(*ugb.flds...)...) if err := selector.Err(); err != nil { return err } rows := &sql.Rows{} query, args := selector.Query() if err := ugb.build.driver.Query(ctx, query, args, rows); err != nil { return err } defer rows.Close() return sql.ScanSlice(rows, v) } // UserSelect is the builder for selecting fields of User entities. type UserSelect struct { *UserQuery selector } // Aggregate adds the given aggregation functions to the selector query. func (us *UserSelect) Aggregate(fns ...AggregateFunc) *UserSelect { us.fns = append(us.fns, fns...) return us } // Scan applies the selector query and scans the result into the given value. func (us *UserSelect) Scan(ctx context.Context, v any) error { ctx = newQueryContext(ctx, TypeUser, "Select") if err := us.prepareQuery(ctx); err != nil { return err } return scanWithInterceptors[*UserQuery, *UserSelect](ctx, us.UserQuery, us, us.inters, v) } func (us *UserSelect) sqlScan(ctx context.Context, root *UserQuery, v any) error { selector := root.sqlQuery(ctx) aggregation := make([]string, 0, len(us.fns)) for _, fn := range us.fns { aggregation = append(aggregation, fn(selector)) } switch n := len(*us.selector.flds); { case n == 0 && len(aggregation) > 0: selector.Select(aggregation...) case n != 0 && len(aggregation) > 0: selector.AppendSelect(aggregation...) } rows := &sql.Rows{} query, args := selector.Query() if err := us.driver.Query(ctx, query, args, rows); err != nil { return err } defer rows.Close() return sql.ScanSlice(rows, v) }