// 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 ent import ( "context" "fmt" "math" "entgo.io/ent/dialect" "entgo.io/ent/dialect/sql" "entgo.io/ent/dialect/sql/sqlgraph" "entgo.io/ent/entc/integration/ent/api" "entgo.io/ent/entc/integration/ent/predicate" "entgo.io/ent/schema/field" ) // APIQuery is the builder for querying Api entities. type APIQuery struct { config ctx *QueryContext order []api.OrderOption inters []Interceptor predicates []predicate.Api modifiers []func(*sql.Selector) // intermediate query (i.e. traversal path). sql *sql.Selector path func(context.Context) (*sql.Selector, error) } // Where adds a new predicate for the APIQuery builder. func (aq *APIQuery) Where(ps ...predicate.Api) *APIQuery { aq.predicates = append(aq.predicates, ps...) return aq } // Limit the number of records to be returned by this query. func (aq *APIQuery) Limit(limit int) *APIQuery { aq.ctx.Limit = &limit return aq } // Offset to start from. func (aq *APIQuery) Offset(offset int) *APIQuery { aq.ctx.Offset = &offset return aq } // 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 (aq *APIQuery) Unique(unique bool) *APIQuery { aq.ctx.Unique = &unique return aq } // Order specifies how the records should be ordered. func (aq *APIQuery) Order(o ...api.OrderOption) *APIQuery { aq.order = append(aq.order, o...) return aq } // First returns the first Api entity from the query. // Returns a *NotFoundError when no Api was found. func (aq *APIQuery) First(ctx context.Context) (*Api, error) { nodes, err := aq.Limit(1).All(setContextOp(ctx, aq.ctx, "First")) if err != nil { return nil, err } if len(nodes) == 0 { return nil, &NotFoundError{api.Label} } return nodes[0], nil } // FirstX is like First, but panics if an error occurs. func (aq *APIQuery) FirstX(ctx context.Context) *Api { node, err := aq.First(ctx) if err != nil && !IsNotFound(err) { panic(err) } return node } // FirstID returns the first Api ID from the query. // Returns a *NotFoundError when no Api ID was found. func (aq *APIQuery) FirstID(ctx context.Context) (id int, err error) { var ids []int if ids, err = aq.Limit(1).IDs(setContextOp(ctx, aq.ctx, "FirstID")); err != nil { return } if len(ids) == 0 { err = &NotFoundError{api.Label} return } return ids[0], nil } // FirstIDX is like FirstID, but panics if an error occurs. func (aq *APIQuery) FirstIDX(ctx context.Context) int { id, err := aq.FirstID(ctx) if err != nil && !IsNotFound(err) { panic(err) } return id } // Only returns a single Api entity found by the query, ensuring it only returns one. // Returns a *NotSingularError when more than one Api entity is found. // Returns a *NotFoundError when no Api entities are found. func (aq *APIQuery) Only(ctx context.Context) (*Api, error) { nodes, err := aq.Limit(2).All(setContextOp(ctx, aq.ctx, "Only")) if err != nil { return nil, err } switch len(nodes) { case 1: return nodes[0], nil case 0: return nil, &NotFoundError{api.Label} default: return nil, &NotSingularError{api.Label} } } // OnlyX is like Only, but panics if an error occurs. func (aq *APIQuery) OnlyX(ctx context.Context) *Api { node, err := aq.Only(ctx) if err != nil { panic(err) } return node } // OnlyID is like Only, but returns the only Api ID in the query. // Returns a *NotSingularError when more than one Api ID is found. // Returns a *NotFoundError when no entities are found. func (aq *APIQuery) OnlyID(ctx context.Context) (id int, err error) { var ids []int if ids, err = aq.Limit(2).IDs(setContextOp(ctx, aq.ctx, "OnlyID")); err != nil { return } switch len(ids) { case 1: id = ids[0] case 0: err = &NotFoundError{api.Label} default: err = &NotSingularError{api.Label} } return } // OnlyIDX is like OnlyID, but panics if an error occurs. func (aq *APIQuery) OnlyIDX(ctx context.Context) int { id, err := aq.OnlyID(ctx) if err != nil { panic(err) } return id } // All executes the query and returns a list of Apis. func (aq *APIQuery) All(ctx context.Context) ([]*Api, error) { ctx = setContextOp(ctx, aq.ctx, "All") if err := aq.prepareQuery(ctx); err != nil { return nil, err } qr := querierAll[[]*Api, *APIQuery]() return withInterceptors[[]*Api](ctx, aq, qr, aq.inters) } // AllX is like All, but panics if an error occurs. func (aq *APIQuery) AllX(ctx context.Context) []*Api { nodes, err := aq.All(ctx) if err != nil { panic(err) } return nodes } // IDs executes the query and returns a list of Api IDs. func (aq *APIQuery) IDs(ctx context.Context) (ids []int, err error) { if aq.ctx.Unique == nil && aq.path != nil { aq.Unique(true) } ctx = setContextOp(ctx, aq.ctx, "IDs") if err = aq.Select(api.FieldID).Scan(ctx, &ids); err != nil { return nil, err } return ids, nil } // IDsX is like IDs, but panics if an error occurs. func (aq *APIQuery) IDsX(ctx context.Context) []int { ids, err := aq.IDs(ctx) if err != nil { panic(err) } return ids } // Count returns the count of the given query. func (aq *APIQuery) Count(ctx context.Context) (int, error) { ctx = setContextOp(ctx, aq.ctx, "Count") if err := aq.prepareQuery(ctx); err != nil { return 0, err } return withInterceptors[int](ctx, aq, querierCount[*APIQuery](), aq.inters) } // CountX is like Count, but panics if an error occurs. func (aq *APIQuery) CountX(ctx context.Context) int { count, err := aq.Count(ctx) if err != nil { panic(err) } return count } // Exist returns true if the query has elements in the graph. func (aq *APIQuery) Exist(ctx context.Context) (bool, error) { ctx = setContextOp(ctx, aq.ctx, "Exist") switch _, err := aq.FirstID(ctx); { case IsNotFound(err): return false, nil case err != nil: return false, fmt.Errorf("ent: check existence: %w", err) default: return true, nil } } // ExistX is like Exist, but panics if an error occurs. func (aq *APIQuery) ExistX(ctx context.Context) bool { exist, err := aq.Exist(ctx) if err != nil { panic(err) } return exist } // Clone returns a duplicate of the APIQuery builder, including all associated steps. It can be // used to prepare common query builders and use them differently after the clone is made. func (aq *APIQuery) Clone() *APIQuery { if aq == nil { return nil } return &APIQuery{ config: aq.config, ctx: aq.ctx.Clone(), order: append([]api.OrderOption{}, aq.order...), inters: append([]Interceptor{}, aq.inters...), predicates: append([]predicate.Api{}, aq.predicates...), // clone intermediate query. sql: aq.sql.Clone(), path: aq.path, } } // 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. func (aq *APIQuery) GroupBy(field string, fields ...string) *APIGroupBy { aq.ctx.Fields = append([]string{field}, fields...) grbuild := &APIGroupBy{build: aq} grbuild.flds = &aq.ctx.Fields grbuild.label = api.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. func (aq *APIQuery) Select(fields ...string) *APISelect { aq.ctx.Fields = append(aq.ctx.Fields, fields...) sbuild := &APISelect{APIQuery: aq} sbuild.label = api.Label sbuild.flds, sbuild.scan = &aq.ctx.Fields, sbuild.Scan return sbuild } // Aggregate returns a APISelect configured with the given aggregations. func (aq *APIQuery) Aggregate(fns ...AggregateFunc) *APISelect { return aq.Select().Aggregate(fns...) } func (aq *APIQuery) prepareQuery(ctx context.Context) error { for _, inter := range aq.inters { if inter == nil { return fmt.Errorf("ent: uninitialized interceptor (forgotten import ent/runtime?)") } if trv, ok := inter.(Traverser); ok { if err := trv.Traverse(ctx, aq); err != nil { return err } } } for _, f := range aq.ctx.Fields { if !api.ValidColumn(f) { return &ValidationError{Name: f, err: fmt.Errorf("ent: invalid field %q for query", f)} } } if aq.path != nil { prev, err := aq.path(ctx) if err != nil { return err } aq.sql = prev } return nil } func (aq *APIQuery) sqlAll(ctx context.Context, hooks ...queryHook) ([]*Api, error) { var ( nodes = []*Api{} _spec = aq.querySpec() ) _spec.ScanValues = func(columns []string) ([]any, error) { return (*Api).scanValues(nil, columns) } _spec.Assign = func(columns []string, values []any) error { node := &Api{config: aq.config} nodes = append(nodes, node) return node.assignValues(columns, values) } if len(aq.modifiers) > 0 { _spec.Modifiers = aq.modifiers } for i := range hooks { hooks[i](ctx, _spec) } if err := sqlgraph.QueryNodes(ctx, aq.driver, _spec); err != nil { return nil, err } if len(nodes) == 0 { return nodes, nil } return nodes, nil } func (aq *APIQuery) sqlCount(ctx context.Context) (int, error) { _spec := aq.querySpec() if len(aq.modifiers) > 0 { _spec.Modifiers = aq.modifiers } _spec.Node.Columns = aq.ctx.Fields if len(aq.ctx.Fields) > 0 { _spec.Unique = aq.ctx.Unique != nil && *aq.ctx.Unique } return sqlgraph.CountNodes(ctx, aq.driver, _spec) } func (aq *APIQuery) querySpec() *sqlgraph.QuerySpec { _spec := sqlgraph.NewQuerySpec(api.Table, api.Columns, sqlgraph.NewFieldSpec(api.FieldID, field.TypeInt)) _spec.From = aq.sql if unique := aq.ctx.Unique; unique != nil { _spec.Unique = *unique } else if aq.path != nil { _spec.Unique = true } if fields := aq.ctx.Fields; len(fields) > 0 { _spec.Node.Columns = make([]string, 0, len(fields)) _spec.Node.Columns = append(_spec.Node.Columns, api.FieldID) for i := range fields { if fields[i] != api.FieldID { _spec.Node.Columns = append(_spec.Node.Columns, fields[i]) } } } if ps := aq.predicates; len(ps) > 0 { _spec.Predicate = func(selector *sql.Selector) { for i := range ps { ps[i](selector) } } } if limit := aq.ctx.Limit; limit != nil { _spec.Limit = *limit } if offset := aq.ctx.Offset; offset != nil { _spec.Offset = *offset } if ps := aq.order; len(ps) > 0 { _spec.Order = func(selector *sql.Selector) { for i := range ps { ps[i](selector) } } } return _spec } func (aq *APIQuery) sqlQuery(ctx context.Context) *sql.Selector { builder := sql.Dialect(aq.driver.Dialect()) t1 := builder.Table(api.Table) columns := aq.ctx.Fields if len(columns) == 0 { columns = api.Columns } selector := builder.Select(t1.Columns(columns...)...).From(t1) if aq.sql != nil { selector = aq.sql selector.Select(selector.Columns(columns...)...) } if aq.ctx.Unique != nil && *aq.ctx.Unique { selector.Distinct() } for _, m := range aq.modifiers { m(selector) } for _, p := range aq.predicates { p(selector) } for _, p := range aq.order { p(selector) } if offset := aq.ctx.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 := aq.ctx.Limit; limit != nil { selector.Limit(*limit) } return selector } // ForUpdate locks the selected rows against concurrent updates, and prevent them from being // updated, deleted or "selected ... for update" by other sessions, until the transaction is // either committed or rolled-back. func (aq *APIQuery) ForUpdate(opts ...sql.LockOption) *APIQuery { if aq.driver.Dialect() == dialect.Postgres { aq.Unique(false) } aq.modifiers = append(aq.modifiers, func(s *sql.Selector) { s.ForUpdate(opts...) }) return aq } // ForShare behaves similarly to ForUpdate, except that it acquires a shared mode lock // on any rows that are read. Other sessions can read the rows, but cannot modify them // until your transaction commits. func (aq *APIQuery) ForShare(opts ...sql.LockOption) *APIQuery { if aq.driver.Dialect() == dialect.Postgres { aq.Unique(false) } aq.modifiers = append(aq.modifiers, func(s *sql.Selector) { s.ForShare(opts...) }) return aq } // Modify adds a query modifier for attaching custom logic to queries. func (aq *APIQuery) Modify(modifiers ...func(s *sql.Selector)) *APISelect { aq.modifiers = append(aq.modifiers, modifiers...) return aq.Select() } // APIGroupBy is the group-by builder for Api entities. type APIGroupBy struct { selector build *APIQuery } // Aggregate adds the given aggregation functions to the group-by query. func (agb *APIGroupBy) Aggregate(fns ...AggregateFunc) *APIGroupBy { agb.fns = append(agb.fns, fns...) return agb } // Scan applies the selector query and scans the result into the given value. func (agb *APIGroupBy) Scan(ctx context.Context, v any) error { ctx = setContextOp(ctx, agb.build.ctx, "GroupBy") if err := agb.build.prepareQuery(ctx); err != nil { return err } return scanWithInterceptors[*APIQuery, *APIGroupBy](ctx, agb.build, agb, agb.build.inters, v) } func (agb *APIGroupBy) sqlScan(ctx context.Context, root *APIQuery, v any) error { selector := root.sqlQuery(ctx).Select() aggregation := make([]string, 0, len(agb.fns)) for _, fn := range agb.fns { aggregation = append(aggregation, fn(selector)) } if len(selector.SelectedColumns()) == 0 { columns := make([]string, 0, len(*agb.flds)+len(agb.fns)) for _, f := range *agb.flds { columns = append(columns, selector.C(f)) } columns = append(columns, aggregation...) selector.Select(columns...) } selector.GroupBy(selector.Columns(*agb.flds...)...) if err := selector.Err(); err != nil { return err } rows := &sql.Rows{} query, args := selector.Query() if err := agb.build.driver.Query(ctx, query, args, rows); err != nil { return err } defer rows.Close() return sql.ScanSlice(rows, v) } // APISelect is the builder for selecting fields of API entities. type APISelect struct { *APIQuery selector } // Aggregate adds the given aggregation functions to the selector query. func (as *APISelect) Aggregate(fns ...AggregateFunc) *APISelect { as.fns = append(as.fns, fns...) return as } // Scan applies the selector query and scans the result into the given value. func (as *APISelect) Scan(ctx context.Context, v any) error { ctx = setContextOp(ctx, as.ctx, "Select") if err := as.prepareQuery(ctx); err != nil { return err } return scanWithInterceptors[*APIQuery, *APISelect](ctx, as.APIQuery, as, as.inters, v) } func (as *APISelect) sqlScan(ctx context.Context, root *APIQuery, v any) error { selector := root.sqlQuery(ctx) aggregation := make([]string, 0, len(as.fns)) for _, fn := range as.fns { aggregation = append(aggregation, fn(selector)) } switch n := len(*as.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 := as.driver.Query(ctx, query, args, rows); err != nil { return err } defer rows.Close() return sql.ScanSlice(rows, v) } // Modify adds a query modifier for attaching custom logic to queries. func (as *APISelect) Modify(modifiers ...func(s *sql.Selector)) *APISelect { as.modifiers = append(as.modifiers, modifiers...) return as }