15 Commits

Author SHA1 Message Date
Adrian Zürcher
7f27579050 add new boolean indicator for when new database is created 2025-11-30 21:01:53 +01:00
Adrian Zürcher
81d7f5b9dc fix wrong test parameter 2025-11-30 20:57:52 +01:00
Adrian Zürcher
2974d80c11 add new relational table requests 2025-11-27 07:45:44 +01:00
Adrian Zürcher
8afcfcfc2d add new function 2025-11-19 23:02:55 +01:00
Adrian Zürcher
4f803b47a7 add relation to delete 2025-11-19 22:49:22 +01:00
Adrian Zürcher
2bcd8a5a08 bug fix findbykey 2025-11-19 16:09:46 +01:00
Adrian Zürcher
5ff6b2b148 combine get with relation request 2025-11-19 14:10:56 +01:00
Adrian Zürcher
02a97b9762 add new functions and create folder of db path if nonexisting 2025-11-19 12:02:10 +01:00
Adrian Zürcher
c6157bb573 add new test file 2025-11-19 12:01:35 +01:00
Adrian Zürcher
98094abf3e fix delete function 2025-11-07 08:17:48 +01:00
Adrian Zürcher
97a3ebf3a0 remove refelect 2025-11-07 08:04:01 +01:00
Adrian Zürcher
f59d3e9b1b fix existing function add reflect, slow but safe 2025-11-07 08:02:19 +01:00
Adrian Zürcher
14cb20f306 fix existing function add reflect, slow but safe 2025-11-07 08:01:50 +01:00
Adrian Zürcher
2b18549f02 fix exist function for array of values and error handling delete 2025-10-29 22:14:07 +01:00
Adrian Zürcher
d2a4a3d548 fix delete and existing for more than one id 2025-10-29 21:38:17 +01:00
2 changed files with 242 additions and 76 deletions

View File

@@ -3,6 +3,7 @@ package dbHandler
import ( import (
"errors" "errors"
"fmt" "fmt"
"os"
"path/filepath" "path/filepath"
"reflect" "reflect"
"strings" "strings"
@@ -25,6 +26,7 @@ import (
type DBHandler struct { type DBHandler struct {
db *gorm.DB db *gorm.DB
logger *logging.Logger logger *logging.Logger
NewCreatedDB bool // indicater for new created database
} }
// NewDBHandler // NewDBHandler
@@ -57,12 +59,31 @@ func NewDBHandler(name, path string, logger *logging.Logger) (dH *DBHandler, err
if filepath.Ext(name) == "" { if filepath.Ext(name) == "" {
name += ".db" name += ".db"
} }
if path != "" {
if _, err := os.Stat(path); err != nil {
if err := os.MkdirAll(path, 0666); err != err {
return nil, err
}
dH.NewCreatedDB = true
}
}
dbPath := filepath.Join(path, name) dbPath := filepath.Join(path, name)
logger.Debug("NewDBHandler", "open database "+dbPath) logger.Debug("NewDBHandler", "open database "+dbPath)
dH.db, err = gorm.Open(sqlite.Open(dbPath), &gorm.Config{}) dH.db, err = gorm.Open(sqlite.Open(dbPath), &gorm.Config{})
return return
} }
// close DB
func (dH *DBHandler) Close() error {
sqlDB, err := dH.db.DB()
if err != nil {
return err
}
return sqlDB.Close()
}
// addNewTable // addNewTable
// //
// Description: // Description:
@@ -110,14 +131,21 @@ func (dH *DBHandler) AddNewColum(model any) error {
// //
// Returns: // Returns:
// - error: Any query error or “not found” message. // - error: Any query error or “not found” message.
func (dH *DBHandler) GetById(model any, id uint) error { func (dH *DBHandler) GetById(model any, id uint, relations ...string) (err error) {
dH.logger.Debug("getById", "find id "+fmt.Sprint(id)) dH.logger.Debug("getById", "find id "+fmt.Sprint(id))
if id == 0 { query := dH.db
return dH.db.Find(model).Error
for _, relation := range relations {
query = query.Preload(relation)
} }
err := dH.db.First(model, id).Error if id == 0 {
return query.Find(model).Error
}
err = query.First(model, id).Error
if errors.Is(err, gorm.ErrRecordNotFound) { if errors.Is(err, gorm.ErrRecordNotFound) {
return fmt.Errorf("no record found for id: %v", id) return fmt.Errorf("no record found for id: %v", id)
} else if err != nil { } else if err != nil {
@@ -144,15 +172,20 @@ func (dH *DBHandler) GetById(model any, id uint) error {
// //
// Returns: // Returns:
// - error: Any database query error. // - error: Any database query error.
func (dH *DBHandler) GetByKey(model any, key string, value any, LikeSearch bool) error { func (dH *DBHandler) GetByKey(model any, key string, value any, LikeSearch bool, relations ...string) error {
query := dH.db
for _, relation := range relations {
query = query.Preload(relation)
}
if LikeSearch { if LikeSearch {
value = strings.ReplaceAll(fmt.Sprint(value), "*", "%") value = strings.ReplaceAll(fmt.Sprint(value), "*", "%")
dH.logger.Debug("getByKey", "find like key "+key+" value "+fmt.Sprint(value)) dH.logger.Debug("getByKey", "find like key "+key+" value "+fmt.Sprint(value))
return dH.db.Where(key+" LIKE ?", value).Find(model).Error return query.Where(key+" LIKE ?", value).Find(model).Error
} }
dH.logger.Debug("getByKey", "find equal key "+key+" value "+fmt.Sprint(value)) dH.logger.Debug("getByKey", "find equal key "+key+" value "+fmt.Sprint(value))
return dH.db.Find(model, key+" = ?", value).Error return query.Find(model, key+" = ?", value).Error
} }
// updateValuesById // updateValuesById
@@ -172,18 +205,27 @@ func (dH *DBHandler) GetByKey(model any, key string, value any, LikeSearch bool)
// //
// Returns: // Returns:
// - error: If the model is invalid or query/update fails. // - error: If the model is invalid or query/update fails.
func (dH *DBHandler) UpdateValuesById(model any, id uint) error { func (dH *DBHandler) UpdateValuesById(model any, id uint, relations ...string) error {
dH.logger.Debug("updateValuesById", "model"+fmt.Sprint(model)) dH.logger.Debug("updateValuesByKey", "model"+fmt.Sprint(model))
modelType := reflect.TypeOf(model) modelType := reflect.TypeOf(model)
if modelType.Kind() != reflect.Ptr { if modelType.Kind() != reflect.Ptr {
return errors.New("model must be a pointer to struct") return errors.New("model must be a pointer to struct")
} }
lookUpModel := reflect.New(modelType.Elem()).Interface() lookUpModel := reflect.New(modelType.Elem()).Interface()
if err := dH.GetById(lookUpModel, id); err != nil { if err := dH.GetById(lookUpModel, id, relations...); err != nil {
return err return err
} }
return dH.db.Model(lookUpModel).Updates(model).Error
// Preload relations
query := dH.db
for _, relation := range relations {
query = query.Preload(relation)
}
// Update only provided keys
return query.Model(lookUpModel).Updates(model).Error
} }
// updateValuesByKey // updateValuesByKey
@@ -204,7 +246,7 @@ func (dH *DBHandler) UpdateValuesById(model any, id uint) error {
// //
// Returns: // Returns:
// - error: Any query or update error. // - error: Any query or update error.
func (dH *DBHandler) UpdateValuesByKey(model any, key string, value any) error { func (dH *DBHandler) UpdateValuesByKey(model any, key string, value any, relations ...string) error {
dH.logger.Debug("updateValuesByKey", "model"+fmt.Sprint(model)) dH.logger.Debug("updateValuesByKey", "model"+fmt.Sprint(model))
modelType := reflect.TypeOf(model) modelType := reflect.TypeOf(model)
if modelType.Kind() != reflect.Ptr { if modelType.Kind() != reflect.Ptr {
@@ -212,39 +254,35 @@ func (dH *DBHandler) UpdateValuesByKey(model any, key string, value any) error {
} }
lookUpModel := reflect.New(modelType.Elem()).Interface() lookUpModel := reflect.New(modelType.Elem()).Interface()
if err := dH.GetByKey(lookUpModel, key, value, false); err != nil { if err := dH.GetByKey(lookUpModel, key, value, false, relations...); err != nil {
return err return err
} }
return dH.db.Model(lookUpModel).Updates(model).Error
query := dH.db
for _, relation := range relations {
query = query.Preload(relation)
}
return query.Model(lookUpModel).Updates(model).Error
} }
// deleteById func (dH *DBHandler) DeleteById(model any, relation string, ids ...uint) error {
// if len(ids) == 0 {
// Description: return fmt.Errorf("no IDs provided")
//
// Deletes records by their ID(s).
//
// Behavior:
// - If the first ID == 0, all records in the table are deleted.
// - Otherwise, deletes the provided IDs.
//
// Parameters:
// - model: Model struct type representing the table.
// - id: Variadic list of IDs to delete.
//
// Returns:
// - error: Any deletion error.
func (dH *DBHandler) DeleteById(model any, id ...uint) error {
if id[0] == 0 {
dH.logger.Debug("deleteById", "delete all")
return dH.db.Where("1 = 1").Delete(model).Error
} }
dH.logger.Debug("deleteById", "delete ids"+fmt.Sprint(id)) if len(ids) == 1 && ids[0] == 0 {
if err := dH.Exists(model, "id", id, false); err != nil { dH.logger.Debug("deleteById", "delete ALL records!")
return err return dH.db.Session(&gorm.Session{AllowGlobalUpdate: true, FullSaveAssociations: true}).
Delete(model).Error
} }
return dH.db.Delete(model, id).Error
dH.logger.Debug("deleteById", "delete ids "+fmt.Sprint(ids))
if err := dH.db.Delete(model, ids).Error; err != nil {
return fmt.Errorf("delete failed: %w", err)
}
return nil
} }
// deleteByKey // deleteByKey
@@ -264,7 +302,7 @@ func (dH *DBHandler) DeleteById(model any, id ...uint) error {
// //
// Returns: // Returns:
// - error: Any deletion error. // - error: Any deletion error.
func (dH *DBHandler) DeleteByKey(model any, key string, value any, LikeSearch bool) error { func (dH *DBHandler) DeleteByKey(model any, key string, value any, LikeSearch bool, relations ...string) error {
if LikeSearch { if LikeSearch {
value = strings.ReplaceAll(fmt.Sprint(value), "*", "%") value = strings.ReplaceAll(fmt.Sprint(value), "*", "%")
dH.logger.Debug("deleteByKey", "delete like key "+key+" value "+fmt.Sprint(value)) dH.logger.Debug("deleteByKey", "delete like key "+key+" value "+fmt.Sprint(value))
@@ -272,42 +310,63 @@ func (dH *DBHandler) DeleteByKey(model any, key string, value any, LikeSearch bo
} }
dH.logger.Debug("deleteByKey", "delete equal key "+key+" value "+fmt.Sprint(value)) dH.logger.Debug("deleteByKey", "delete equal key "+key+" value "+fmt.Sprint(value))
return dH.db.Where(key+" = ?", value).Delete(model).Error
}
// exists query := dH.db
//
// Description: for _, relation := range relations {
// query = query.Preload(relation)
// Checks whether a record exists matching the specified key/value filter.
//
// Behavior:
// - Performs a `First` query on the database.
// - If `LikeSearch` is true, performs a LIKE query.
// - Returns an error if the record does not exist or query fails.
//
// Parameters:
// - model: Model struct type to search.
// - key: Column name to filter by.
// - value: Value to match.
// - LikeSearch: Whether to use wildcard search.
//
// Returns:
// - error: “no record found” or DB error.
func (dH *DBHandler) Exists(model any, key string, value any, LikeSearch bool) (err error) {
if LikeSearch {
value = strings.ReplaceAll(fmt.Sprint(value), "*", "%")
key = key + " LIKE ?"
} else {
key = key + " = ?"
} }
dH.logger.Debug("exists", "check if exists key "+key+" value "+fmt.Sprint(value)) return query.Where(key+" = ?", value).Delete(model).Error
err = dH.db.Where(key, value).First(model).Error }
if errors.Is(err, gorm.ErrRecordNotFound) {
return fmt.Errorf("no record found for %s %v", key[:len(key)-1], value) func (dH *DBHandler) Exists(model any, key string, value any, likeSearch bool, relations ...string) (found bool) {
} else if err != nil { var query string
return fmt.Errorf("query failed: %w", err) var args any
}
return // Detect LIKE and IN behavior
val := reflect.ValueOf(value)
isSlice := val.Kind() == reflect.Slice
switch {
case isSlice:
if val.Len() == 0 {
dH.logger.Error("Exists", fmt.Sprintf("empty slice for %s", key))
return false
}
query = fmt.Sprintf("%s IN ?", key)
args = value
case likeSearch:
str := strings.ReplaceAll(fmt.Sprint(value), "*", "%")
query = fmt.Sprintf("%s LIKE ?", key)
args = str
default:
query = fmt.Sprintf("%s = ?", key)
args = value
}
dH.logger.Debug("exists", "checking existence for key "+query+" value "+fmt.Sprint(args))
datababase := dH.db
for _, relation := range relations {
datababase = datababase.Preload(relation)
}
tx := datababase.Where(query, args).Find(model)
if tx.Error != nil {
dH.logger.Error("Exists", fmt.Sprintf("query failed: %v", tx.Error))
return false
}
return tx.RowsAffected > 0
}
func (dH *DBHandler) AddRelation(model, relation any, relationName string) error {
return dH.db.Model(model).Association(relationName).Append(relation)
}
func (dH *DBHandler) DeleteRelation(model, relation any, relationName string) error {
return dH.db.Model(model).Association(relationName).Delete(relation)
} }

107
db_test.go Normal file
View File

@@ -0,0 +1,107 @@
package dbHandler
import (
"os"
"testing"
)
type Event struct {
Id int `gorm:"primaryKey" json:"id"`
Name string `gorm:"column:name" json:"name"`
Attendees []*Member `gorm:"many2many:member_events;"`
}
type Member struct {
Id int `gorm:"primaryKey" json:"id"`
FirstName string `gorm:"column:firstName" json:"firstName,omitempty"`
LastName string `gorm:"column:lastName" json:"lastName,omitempty"`
ResponsiblePersonID *int `json:"responsiblePersonId"`
ResponsiblePerson *Member `gorm:"foreignKey:ResponsiblePersonID" json:"responsiblePerson"`
Events []*Event `gorm:"many2many:member_events;" json:"events"`
}
func TestDbHandler(t *testing.T) {
dbHandler, err := NewDBHandler("test.db", "test", nil)
if err != nil {
t.Fatal(err)
}
if err := dbHandler.AddNewTable(&Member{}); err != nil {
t.Fatal(err)
}
if err := dbHandler.AddNewTable(&Event{}); err != nil {
t.Fatal(err)
}
membersIN := []*Member{{FirstName: "adrian", LastName: "zuercher"}, {FirstName: "adichild", LastName: "zuercher"}}
for _, member := range membersIN {
dbHandler.AddNewColum(member)
event := &Event{
Name: "testEvent",
}
dbHandler.AddNewColum(event)
dbHandler.AddRelation(event, member, "Attendees")
}
var members []Member
if err := dbHandler.GetById(&members, 0); err != nil {
t.Fatal(err)
}
t.Log(members)
if err := dbHandler.GetById(&members, 0, "Events"); err != nil {
t.Fatal(err)
}
t.Log(members)
for _, member := range members {
t.Log("Member:", member.FirstName, member.LastName)
for _, event := range member.Events {
t.Log("Event:", event)
}
}
var events []Event
if err := dbHandler.GetById(&events, 0, "Attendees"); err != nil {
t.Fatal(err)
}
for _, event := range events {
t.Log("event:", event.Name)
for _, member := range event.Attendees {
t.Log("attendee:", member)
}
}
//add responsible
mem1 := &Member{}
if err := dbHandler.GetById(mem1, 2); err != nil {
t.Fatal(err)
}
mem2 := &Member{}
if err := dbHandler.GetById(mem2, 1); err != nil {
t.Fatal(err)
}
mem1.ResponsiblePerson = mem2
dbHandler.UpdateValuesById(mem1, uint(mem1.Id))
if err := dbHandler.GetById(mem1, 2); err != nil {
t.Fatal(err)
}
t.Log(mem1)
t.Log(mem1.ResponsiblePerson)
if err := dbHandler.Close(); err != nil {
t.Fatal(err)
}
if err := os.RemoveAll("test"); err != nil {
t.Fatal(err)
}
}