// 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" "fmt" "math" "entgo.io/ent/dialect/sql" "entgo.io/ent/dialect/sql/sqlgraph" "entgo.io/ent/entc/integration/migrate/entv2/media" "entgo.io/ent/entc/integration/migrate/entv2/predicate" "entgo.io/ent/schema/field" ) // MediaQuery is the builder for querying Media entities. type MediaQuery struct { config limit *int offset *int unique *bool order []OrderFunc fields []string inters []Interceptor predicates []predicate.Media // intermediate query (i.e. traversal path). sql *sql.Selector path func(context.Context) (*sql.Selector, error) } // Where adds a new predicate for the MediaQuery builder. func (mq *MediaQuery) Where(ps ...predicate.Media) *MediaQuery { mq.predicates = append(mq.predicates, ps...) return mq } // Limit the number of records to be returned by this query. func (mq *MediaQuery) Limit(limit int) *MediaQuery { mq.limit = &limit return mq } // Offset to start from. func (mq *MediaQuery) Offset(offset int) *MediaQuery { mq.offset = &offset return mq } // 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 (mq *MediaQuery) Unique(unique bool) *MediaQuery { mq.unique = &unique return mq } // Order specifies how the records should be ordered. func (mq *MediaQuery) Order(o ...OrderFunc) *MediaQuery { mq.order = append(mq.order, o...) return mq } // First returns the first Media entity from the query. // Returns a *NotFoundError when no Media was found. func (mq *MediaQuery) First(ctx context.Context) (*Media, error) { nodes, err := mq.Limit(1).All(newQueryContext(ctx, TypeMedia, "First")) if err != nil { return nil, err } if len(nodes) == 0 { return nil, &NotFoundError{media.Label} } return nodes[0], nil } // FirstX is like First, but panics if an error occurs. func (mq *MediaQuery) FirstX(ctx context.Context) *Media { node, err := mq.First(ctx) if err != nil && !IsNotFound(err) { panic(err) } return node } // FirstID returns the first Media ID from the query. // Returns a *NotFoundError when no Media ID was found. func (mq *MediaQuery) FirstID(ctx context.Context) (id int, err error) { var ids []int if ids, err = mq.Limit(1).IDs(newQueryContext(ctx, TypeMedia, "FirstID")); err != nil { return } if len(ids) == 0 { err = &NotFoundError{media.Label} return } return ids[0], nil } // FirstIDX is like FirstID, but panics if an error occurs. func (mq *MediaQuery) FirstIDX(ctx context.Context) int { id, err := mq.FirstID(ctx) if err != nil && !IsNotFound(err) { panic(err) } return id } // Only returns a single Media entity found by the query, ensuring it only returns one. // Returns a *NotSingularError when more than one Media entity is found. // Returns a *NotFoundError when no Media entities are found. func (mq *MediaQuery) Only(ctx context.Context) (*Media, error) { nodes, err := mq.Limit(2).All(newQueryContext(ctx, TypeMedia, "Only")) if err != nil { return nil, err } switch len(nodes) { case 1: return nodes[0], nil case 0: return nil, &NotFoundError{media.Label} default: return nil, &NotSingularError{media.Label} } } // OnlyX is like Only, but panics if an error occurs. func (mq *MediaQuery) OnlyX(ctx context.Context) *Media { node, err := mq.Only(ctx) if err != nil { panic(err) } return node } // OnlyID is like Only, but returns the only Media ID in the query. // Returns a *NotSingularError when more than one Media ID is found. // Returns a *NotFoundError when no entities are found. func (mq *MediaQuery) OnlyID(ctx context.Context) (id int, err error) { var ids []int if ids, err = mq.Limit(2).IDs(newQueryContext(ctx, TypeMedia, "OnlyID")); err != nil { return } switch len(ids) { case 1: id = ids[0] case 0: err = &NotFoundError{media.Label} default: err = &NotSingularError{media.Label} } return } // OnlyIDX is like OnlyID, but panics if an error occurs. func (mq *MediaQuery) OnlyIDX(ctx context.Context) int { id, err := mq.OnlyID(ctx) if err != nil { panic(err) } return id } // All executes the query and returns a list of MediaSlice. func (mq *MediaQuery) All(ctx context.Context) ([]*Media, error) { ctx = newQueryContext(ctx, TypeMedia, "All") if err := mq.prepareQuery(ctx); err != nil { return nil, err } qr := querierAll[[]*Media, *MediaQuery]() return withInterceptors[[]*Media](ctx, mq, qr, mq.inters) } // AllX is like All, but panics if an error occurs. func (mq *MediaQuery) AllX(ctx context.Context) []*Media { nodes, err := mq.All(ctx) if err != nil { panic(err) } return nodes } // IDs executes the query and returns a list of Media IDs. func (mq *MediaQuery) IDs(ctx context.Context) ([]int, error) { var ids []int ctx = newQueryContext(ctx, TypeMedia, "IDs") if err := mq.Select(media.FieldID).Scan(ctx, &ids); err != nil { return nil, err } return ids, nil } // IDsX is like IDs, but panics if an error occurs. func (mq *MediaQuery) IDsX(ctx context.Context) []int { ids, err := mq.IDs(ctx) if err != nil { panic(err) } return ids } // Count returns the count of the given query. func (mq *MediaQuery) Count(ctx context.Context) (int, error) { ctx = newQueryContext(ctx, TypeMedia, "Count") if err := mq.prepareQuery(ctx); err != nil { return 0, err } return withInterceptors[int](ctx, mq, querierCount[*MediaQuery](), mq.inters) } // CountX is like Count, but panics if an error occurs. func (mq *MediaQuery) CountX(ctx context.Context) int { count, err := mq.Count(ctx) if err != nil { panic(err) } return count } // Exist returns true if the query has elements in the graph. func (mq *MediaQuery) Exist(ctx context.Context) (bool, error) { ctx = newQueryContext(ctx, TypeMedia, "Exist") switch _, err := mq.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 (mq *MediaQuery) ExistX(ctx context.Context) bool { exist, err := mq.Exist(ctx) if err != nil { panic(err) } return exist } // Clone returns a duplicate of the MediaQuery builder, including all associated steps. It can be // used to prepare common query builders and use them differently after the clone is made. func (mq *MediaQuery) Clone() *MediaQuery { if mq == nil { return nil } return &MediaQuery{ config: mq.config, limit: mq.limit, offset: mq.offset, order: append([]OrderFunc{}, mq.order...), inters: append([]Interceptor{}, mq.inters...), predicates: append([]predicate.Media{}, mq.predicates...), // clone intermediate query. sql: mq.sql.Clone(), path: mq.path, unique: mq.unique, } } // 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 { // Source string `json:"source,omitempty"` // Count int `json:"count,omitempty"` // } // // client.Media.Query(). // GroupBy(media.FieldSource). // Aggregate(entv2.Count()). // Scan(ctx, &v) func (mq *MediaQuery) GroupBy(field string, fields ...string) *MediaGroupBy { mq.fields = append([]string{field}, fields...) grbuild := &MediaGroupBy{build: mq} grbuild.flds = &mq.fields grbuild.label = media.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 { // Source string `json:"source,omitempty"` // } // // client.Media.Query(). // Select(media.FieldSource). // Scan(ctx, &v) func (mq *MediaQuery) Select(fields ...string) *MediaSelect { mq.fields = append(mq.fields, fields...) sbuild := &MediaSelect{MediaQuery: mq} sbuild.label = media.Label sbuild.flds, sbuild.scan = &mq.fields, sbuild.Scan return sbuild } // Aggregate returns a MediaSelect configured with the given aggregations. func (mq *MediaQuery) Aggregate(fns ...AggregateFunc) *MediaSelect { return mq.Select().Aggregate(fns...) } func (mq *MediaQuery) prepareQuery(ctx context.Context) error { for _, inter := range mq.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, mq); err != nil { return err } } } for _, f := range mq.fields { if !media.ValidColumn(f) { return &ValidationError{Name: f, err: fmt.Errorf("entv2: invalid field %q for query", f)} } } if mq.path != nil { prev, err := mq.path(ctx) if err != nil { return err } mq.sql = prev } return nil } func (mq *MediaQuery) sqlAll(ctx context.Context, hooks ...queryHook) ([]*Media, error) { var ( nodes = []*Media{} _spec = mq.querySpec() ) _spec.ScanValues = func(columns []string) ([]any, error) { return (*Media).scanValues(nil, columns) } _spec.Assign = func(columns []string, values []any) error { node := &Media{config: mq.config} nodes = append(nodes, node) return node.assignValues(columns, values) } for i := range hooks { hooks[i](ctx, _spec) } if err := sqlgraph.QueryNodes(ctx, mq.driver, _spec); err != nil { return nil, err } if len(nodes) == 0 { return nodes, nil } return nodes, nil } func (mq *MediaQuery) sqlCount(ctx context.Context) (int, error) { _spec := mq.querySpec() _spec.Node.Columns = mq.fields if len(mq.fields) > 0 { _spec.Unique = mq.unique != nil && *mq.unique } return sqlgraph.CountNodes(ctx, mq.driver, _spec) } func (mq *MediaQuery) querySpec() *sqlgraph.QuerySpec { _spec := &sqlgraph.QuerySpec{ Node: &sqlgraph.NodeSpec{ Table: media.Table, Columns: media.Columns, ID: &sqlgraph.FieldSpec{ Type: field.TypeInt, Column: media.FieldID, }, }, From: mq.sql, Unique: true, } if unique := mq.unique; unique != nil { _spec.Unique = *unique } if fields := mq.fields; len(fields) > 0 { _spec.Node.Columns = make([]string, 0, len(fields)) _spec.Node.Columns = append(_spec.Node.Columns, media.FieldID) for i := range fields { if fields[i] != media.FieldID { _spec.Node.Columns = append(_spec.Node.Columns, fields[i]) } } } if ps := mq.predicates; len(ps) > 0 { _spec.Predicate = func(selector *sql.Selector) { for i := range ps { ps[i](selector) } } } if limit := mq.limit; limit != nil { _spec.Limit = *limit } if offset := mq.offset; offset != nil { _spec.Offset = *offset } if ps := mq.order; len(ps) > 0 { _spec.Order = func(selector *sql.Selector) { for i := range ps { ps[i](selector) } } } return _spec } func (mq *MediaQuery) sqlQuery(ctx context.Context) *sql.Selector { builder := sql.Dialect(mq.driver.Dialect()) t1 := builder.Table(media.Table) columns := mq.fields if len(columns) == 0 { columns = media.Columns } selector := builder.Select(t1.Columns(columns...)...).From(t1) if mq.sql != nil { selector = mq.sql selector.Select(selector.Columns(columns...)...) } if mq.unique != nil && *mq.unique { selector.Distinct() } for _, p := range mq.predicates { p(selector) } for _, p := range mq.order { p(selector) } if offset := mq.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 := mq.limit; limit != nil { selector.Limit(*limit) } return selector } // MediaGroupBy is the group-by builder for Media entities. type MediaGroupBy struct { selector build *MediaQuery } // Aggregate adds the given aggregation functions to the group-by query. func (mgb *MediaGroupBy) Aggregate(fns ...AggregateFunc) *MediaGroupBy { mgb.fns = append(mgb.fns, fns...) return mgb } // Scan applies the selector query and scans the result into the given value. func (mgb *MediaGroupBy) Scan(ctx context.Context, v any) error { ctx = newQueryContext(ctx, TypeMedia, "GroupBy") if err := mgb.build.prepareQuery(ctx); err != nil { return err } return scanWithInterceptors[*MediaQuery, *MediaGroupBy](ctx, mgb.build, mgb, mgb.build.inters, v) } func (mgb *MediaGroupBy) sqlScan(ctx context.Context, root *MediaQuery, v any) error { selector := root.sqlQuery(ctx).Select() aggregation := make([]string, 0, len(mgb.fns)) for _, fn := range mgb.fns { aggregation = append(aggregation, fn(selector)) } if len(selector.SelectedColumns()) == 0 { columns := make([]string, 0, len(*mgb.flds)+len(mgb.fns)) for _, f := range *mgb.flds { columns = append(columns, selector.C(f)) } columns = append(columns, aggregation...) selector.Select(columns...) } selector.GroupBy(selector.Columns(*mgb.flds...)...) if err := selector.Err(); err != nil { return err } rows := &sql.Rows{} query, args := selector.Query() if err := mgb.build.driver.Query(ctx, query, args, rows); err != nil { return err } defer rows.Close() return sql.ScanSlice(rows, v) } // MediaSelect is the builder for selecting fields of Media entities. type MediaSelect struct { *MediaQuery selector } // Aggregate adds the given aggregation functions to the selector query. func (ms *MediaSelect) Aggregate(fns ...AggregateFunc) *MediaSelect { ms.fns = append(ms.fns, fns...) return ms } // Scan applies the selector query and scans the result into the given value. func (ms *MediaSelect) Scan(ctx context.Context, v any) error { ctx = newQueryContext(ctx, TypeMedia, "Select") if err := ms.prepareQuery(ctx); err != nil { return err } return scanWithInterceptors[*MediaQuery, *MediaSelect](ctx, ms.MediaQuery, ms, ms.inters, v) } func (ms *MediaSelect) sqlScan(ctx context.Context, root *MediaQuery, v any) error { selector := root.sqlQuery(ctx) aggregation := make([]string, 0, len(ms.fns)) for _, fn := range ms.fns { aggregation = append(aggregation, fn(selector)) } switch n := len(*ms.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 := ms.driver.Query(ctx, query, args, rows); err != nil { return err } defer rows.Close() return sql.ScanSlice(rows, v) }