// 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 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 adds a limit step to the query. func (mq *MediaQuery) Limit(limit int) *MediaQuery { mq.limit = &limit return mq } // Offset adds an offset step to the query. 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 adds an order step to the query. 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(ctx) 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(ctx); 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(ctx) 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(ctx); 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) { if err := mq.prepareQuery(ctx); err != nil { return nil, err } return mq.sqlAll(ctx) } // 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 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) { if err := mq.prepareQuery(ctx); err != nil { return 0, err } return mq.sqlCount(ctx) } // 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) { if err := mq.prepareQuery(ctx); err != nil { return false, err } return mq.sqlExist(ctx) } // 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...), 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 { grbuild := &MediaGroupBy{config: mq.config} grbuild.fields = append([]string{field}, fields...) grbuild.path = func(ctx context.Context) (prev *sql.Selector, err error) { if err := mq.prepareQuery(ctx); err != nil { return nil, err } return mq.sqlQuery(ctx), nil } grbuild.label = media.Label grbuild.flds, grbuild.scan = &grbuild.fields, 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...) selbuild := &MediaSelect{MediaQuery: mq} selbuild.label = media.Label selbuild.flds, selbuild.scan = &mq.fields, selbuild.Scan return selbuild } func (mq *MediaQuery) prepareQuery(ctx context.Context) error { 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) ([]interface{}, error) { return (*Media).scanValues(nil, columns) } _spec.Assign = func(columns []string, values []interface{}) 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) sqlExist(ctx context.Context) (bool, error) { n, err := mq.sqlCount(ctx) if err != nil { return false, fmt.Errorf("entv2: check existence: %w", err) } return n > 0, nil } 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 { config selector fields []string fns []AggregateFunc // intermediate query (i.e. traversal path). sql *sql.Selector path func(context.Context) (*sql.Selector, error) } // 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 group-by query and scans the result into the given value. func (mgb *MediaGroupBy) Scan(ctx context.Context, v interface{}) error { query, err := mgb.path(ctx) if err != nil { return err } mgb.sql = query return mgb.sqlScan(ctx, v) } func (mgb *MediaGroupBy) sqlScan(ctx context.Context, v interface{}) error { for _, f := range mgb.fields { if !media.ValidColumn(f) { return &ValidationError{Name: f, err: fmt.Errorf("invalid field %q for group-by", f)} } } selector := mgb.sqlQuery() if err := selector.Err(); err != nil { return err } rows := &sql.Rows{} query, args := selector.Query() if err := mgb.driver.Query(ctx, query, args, rows); err != nil { return err } defer rows.Close() return sql.ScanSlice(rows, v) } func (mgb *MediaGroupBy) sqlQuery() *sql.Selector { selector := mgb.sql.Select() aggregation := make([]string, 0, len(mgb.fns)) for _, fn := range mgb.fns { aggregation = append(aggregation, fn(selector)) } // If no columns were selected in a custom aggregation function, the default // selection is the fields used for "group-by", and the aggregation functions. if len(selector.SelectedColumns()) == 0 { columns := make([]string, 0, len(mgb.fields)+len(mgb.fns)) for _, f := range mgb.fields { columns = append(columns, selector.C(f)) } columns = append(columns, aggregation...) selector.Select(columns...) } return selector.GroupBy(selector.Columns(mgb.fields...)...) } // MediaSelect is the builder for selecting fields of Media entities. type MediaSelect struct { *MediaQuery selector // intermediate query (i.e. traversal path). sql *sql.Selector } // Scan applies the selector query and scans the result into the given value. func (ms *MediaSelect) Scan(ctx context.Context, v interface{}) error { if err := ms.prepareQuery(ctx); err != nil { return err } ms.sql = ms.MediaQuery.sqlQuery(ctx) return ms.sqlScan(ctx, v) } func (ms *MediaSelect) sqlScan(ctx context.Context, v interface{}) error { rows := &sql.Rows{} query, args := ms.sql.Query() if err := ms.driver.Query(ctx, query, args, rows); err != nil { return err } defer rows.Close() return sql.ScanSlice(rows, v) }