// Copyright GoFrame Author(https://goframe.org). All Rights Reserved. // // This Source Code Form is subject to the terms of the MIT License. // If a copy of the MIT was not distributed with this file, // You can obtain one at https://github.com/gogf/gf. package gdb import ( "fmt" "github.com/gogf/gf/v2/container/gset" "github.com/gogf/gf/v2/text/gstr" "github.com/gogf/gf/v2/util/gconv" ) // Fields appends `fieldNamesOrMapStruct` to the operation fields of the model, multiple fields joined using char ','. // The parameter `fieldNamesOrMapStruct` can be type of string/map/*map/struct/*struct. // // Eg: // Fields("id", "name", "age") // Fields([]string{"id", "name", "age"}) // Fields(map[string]interface{}{"id":1, "name":"john", "age":18}) // Fields(User{ Id: 1, Name: "john", Age: 18}) func (m *Model) Fields(fieldNamesOrMapStruct ...interface{}) *Model { length := len(fieldNamesOrMapStruct) if length == 0 { return m } switch { // String slice. case length >= 2: return m.appendFieldsByStr(gstr.Join( m.mappingAndFilterToTableFields(gconv.Strings(fieldNamesOrMapStruct), true), ",", )) // It needs type asserting. case length == 1: structOrMap := fieldNamesOrMapStruct[0] switch r := structOrMap.(type) { case string: return m.appendFieldsByStr(gstr.Join( m.mappingAndFilterToTableFields([]string{r}, false), ",", )) case []string: return m.appendFieldsByStr(gstr.Join( m.mappingAndFilterToTableFields(r, true), ",", )) default: return m.appendFieldsByStr(gstr.Join( m.mappingAndFilterToTableFields(getFieldsFromStructOrMap(structOrMap), true), ",", )) } } return m } // FieldsPrefix performs as function Fields but add extra prefix for each field. func (m *Model) FieldsPrefix(prefix string, fieldNamesOrMapStruct ...interface{}) *Model { model := m.Fields(fieldNamesOrMapStruct...) array := gstr.SplitAndTrim(model.fields, ",") gstr.PrefixArray(array, prefix+".") model.fields = gstr.Join(array, ",") return model } // FieldsEx appends `fieldNamesOrMapStruct` to the excluded operation fields of the model, // multiple fields joined using char ','. // Note that this function supports only single table operations. // The parameter `fieldNamesOrMapStruct` can be type of string/map/*map/struct/*struct. // // Also see Fields. func (m *Model) FieldsEx(fieldNamesOrMapStruct ...interface{}) *Model { length := len(fieldNamesOrMapStruct) if length == 0 { return m } model := m.getModel() switch { case length >= 2: model.fieldsEx = gstr.Join(m.mappingAndFilterToTableFields(gconv.Strings(fieldNamesOrMapStruct), true), ",") return model case length == 1: switch r := fieldNamesOrMapStruct[0].(type) { case string: model.fieldsEx = gstr.Join(m.mappingAndFilterToTableFields([]string{r}, false), ",") case []string: model.fieldsEx = gstr.Join(m.mappingAndFilterToTableFields(r, true), ",") default: model.fieldsEx = gstr.Join(m.mappingAndFilterToTableFields(getFieldsFromStructOrMap(r), true), ",") } return model } return m } // FieldsExPrefix performs as function FieldsEx but add extra prefix for each field. func (m *Model) FieldsExPrefix(prefix string, fieldNamesOrMapStruct ...interface{}) *Model { model := m.FieldsEx(fieldNamesOrMapStruct...) array := gstr.SplitAndTrim(model.fieldsEx, ",") gstr.PrefixArray(array, prefix+".") model.fieldsEx = gstr.Join(array, ",") return model } // FieldCount formats and appends commonly used field `COUNT(column)` to the select fields of model. func (m *Model) FieldCount(column string, as ...string) *Model { asStr := "" if len(as) > 0 && as[0] != "" { asStr = fmt.Sprintf(` AS %s`, m.db.GetCore().QuoteWord(as[0])) } return m.appendFieldsByStr(fmt.Sprintf(`COUNT(%s)%s`, m.db.GetCore().QuoteWord(column), asStr)) } // FieldSum formats and appends commonly used field `SUM(column)` to the select fields of model. func (m *Model) FieldSum(column string, as ...string) *Model { asStr := "" if len(as) > 0 && as[0] != "" { asStr = fmt.Sprintf(` AS %s`, m.db.GetCore().QuoteWord(as[0])) } return m.appendFieldsByStr(fmt.Sprintf(`SUM(%s)%s`, m.db.GetCore().QuoteWord(column), asStr)) } // FieldMin formats and appends commonly used field `MIN(column)` to the select fields of model. func (m *Model) FieldMin(column string, as ...string) *Model { asStr := "" if len(as) > 0 && as[0] != "" { asStr = fmt.Sprintf(` AS %s`, m.db.GetCore().QuoteWord(as[0])) } return m.appendFieldsByStr(fmt.Sprintf(`MIN(%s)%s`, m.db.GetCore().QuoteWord(column), asStr)) } // FieldMax formats and appends commonly used field `MAX(column)` to the select fields of model. func (m *Model) FieldMax(column string, as ...string) *Model { asStr := "" if len(as) > 0 && as[0] != "" { asStr = fmt.Sprintf(` AS %s`, m.db.GetCore().QuoteWord(as[0])) } return m.appendFieldsByStr(fmt.Sprintf(`MAX(%s)%s`, m.db.GetCore().QuoteWord(column), asStr)) } // FieldAvg formats and appends commonly used field `AVG(column)` to the select fields of model. func (m *Model) FieldAvg(column string, as ...string) *Model { asStr := "" if len(as) > 0 && as[0] != "" { asStr = fmt.Sprintf(` AS %s`, m.db.GetCore().QuoteWord(as[0])) } return m.appendFieldsByStr(fmt.Sprintf(`AVG(%s)%s`, m.db.GetCore().QuoteWord(column), asStr)) } func (m *Model) appendFieldsByStr(fields string) *Model { if fields != "" { model := m.getModel() if model.fields == defaultFields { model.fields = "" } if model.fields != "" { model.fields += "," } model.fields += fields return model } return m } func (m *Model) appendFieldsExByStr(fieldsEx string) *Model { if fieldsEx != "" { model := m.getModel() if model.fieldsEx != "" { model.fieldsEx += "," } model.fieldsEx += fieldsEx return model } return m } // GetFieldsStr retrieves and returns all fields from the table, joined with char ','. // The optional parameter `prefix` specifies the prefix for each field, eg: GetFieldsStr("u."). func (m *Model) GetFieldsStr(prefix ...string) string { prefixStr := "" if len(prefix) > 0 { prefixStr = prefix[0] } tableFields, err := m.TableFields(m.tablesInit) if err != nil { panic(err) } if len(tableFields) == 0 { panic(fmt.Sprintf(`empty table fields for table "%s"`, m.tables)) } fieldsArray := make([]string, len(tableFields)) for k, v := range tableFields { fieldsArray[v.Index] = k } newFields := "" for _, k := range fieldsArray { if len(newFields) > 0 { newFields += "," } newFields += prefixStr + k } newFields = m.db.GetCore().QuoteString(newFields) return newFields } // GetFieldsExStr retrieves and returns fields which are not in parameter `fields` from the table, // joined with char ','. // The parameter `fields` specifies the fields that are excluded. // The optional parameter `prefix` specifies the prefix for each field, eg: FieldsExStr("id", "u."). func (m *Model) GetFieldsExStr(fields string, prefix ...string) string { prefixStr := "" if len(prefix) > 0 { prefixStr = prefix[0] } tableFields, err := m.TableFields(m.tablesInit) if err != nil { panic(err) } if len(tableFields) == 0 { panic(fmt.Sprintf(`empty table fields for table "%s"`, m.tables)) } fieldsExSet := gset.NewStrSetFrom(gstr.SplitAndTrim(fields, ",")) fieldsArray := make([]string, len(tableFields)) for k, v := range tableFields { fieldsArray[v.Index] = k } newFields := "" for _, k := range fieldsArray { if fieldsExSet.Contains(k) { continue } if len(newFields) > 0 { newFields += "," } newFields += prefixStr + k } newFields = m.db.GetCore().QuoteString(newFields) return newFields } // HasField determine whether the field exists in the table. func (m *Model) HasField(field string) (bool, error) { return m.db.GetCore().HasField(m.tablesInit, field) }