Golang中Struct與DB中表字段通過反射自動映射 - sqlmapper

Golang中操作數據庫已經有現成的庫"database/sql"可以用，但是"database/sql"只提供了最基礎的操作接口；

對數據庫中一張表的增刪改查等操作，必須手動編寫sql string，這通常都是一個寫死的字符串（Hard-Code），

並且需要手動維護sql中字段與Golang中的變量的映射關係，這擴展性很差，且非常容易出錯。

通常情況下，我們期望Golang中存在一個Struct與DB中的一個Table建立一個映射關係（Mapper），

之後我們就通過操作這個Struct來操作DB中對應的Table，無須Hard-Coded sql string，無須手動維護字段映射關係。

sqlmapper 就是這樣一個極簡的工具庫（簡單到只有一個go文件）。

原文地址：https://github.com/arthas29/sqlmapper

例如，DB中有一張表，結構如下：

CREATE TABLE `test_table` (
  `field_key` varchar(64) NOT NULL DEFAULT '',
  `field_one` varchar(64) DEFAULT NULL,
  `field_two` tinyint(1) DEFAULT NULL,
  `field_thr` int(12) DEFAULT NULL,
  `field_fou` float DEFAULT NULL,
  PRIMARY KEY (`field_key`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

在Golang中，創建對應的Struct，如下：

// struct in go such as:
type DemoRow struct {
	FieldKey string  `sql:"field_key"`
	FieldOne string  `sql:"field_one"`
	FieldTwo bool    `sql:"field_two"`
	FieldThr int64   `sql:"field_thr"`
	FieldFou float64 `sql:"field_fou"`
}

然後，我們就可以通過這個Struct執行 SELECT/INSERT/UPDATE/DELETE 操作，無須硬編碼的冗長的sql string；

示例 (更多示例參見 fields_map_test.go)：

// select single row
// Query by primary key (field[0])
func QueryByKey(ctx context.Context, tx *sql.Tx, db *sql.DB, fieldKey string) (
	*DemoRow, error) {

	var row DemoRow
	row.FieldKey = fieldKey
	fm, err := NewFieldsMap(table, &row)
	if err != nil {
		return nil, err
	}

	objptr, err := fm.SQLSelectByPriKey(ctx, tx, db)
	if err != nil {
		return nil, err
	}

	return objptr.(*DemoRow), nil
}