feat(db): 添加对达梦数据库的支持

- 在应用程序中新增对达梦数据库（DM）的配置和连接支持 - 实现 SetDmDB 函数以配置达梦数据库连接 - 更新数据库操作逻辑，支持达梦特有的 SQL 语法和功能 - 在相关文件中添加达梦数据库的处理逻辑，包括表创建、数据插入和查询 - 更新 go.mod 和 go.sum 文件以引入达梦数据库驱动 - 增强文档，详细说明达梦数据库的配置和使用方法
2026-03-20 10:46:51 +08:00
parent 7ab803c5cc
commit b43f968b6c
194 changed files with 211502 additions and 2328 deletions
@@ -0,0 +1,270 @@
+/*
+ * Copyright (c) 2000-2018, 达梦数据库有限公司.
+ * All rights reserved.
+ */
+
+package dm
+
+import "database/sql/driver"
+
+type DmArray struct {
+	TypeData
+	m_arrDesc *ArrayDescriptor // 数组的描述信息
+
+	m_arrData []TypeData // 数组中各行数据值
+
+	m_objArray interface{} // 从服务端获取的
+
+	m_itemCount int // 本次获取的行数
+
+	m_itemSize int // 数组中一个数组项的大小，单位bytes
+
+	m_objCount int // 一个数组项中存在对象类型的个数（class、动态数组)
+
+	m_strCount int // 一个数组项中存在字符串类型的个数
+
+	m_objStrOffs []int // 对象在前，字符串在后
+
+	typeName string
+
+	elements []interface{}
+
+	// Valid为false代表DmArray数据在数据库中为NULL
+	Valid bool
+}
+
+func (da *DmArray) init() *DmArray {
+	da.initTypeData()
+	da.m_itemCount = 0
+	da.m_itemSize = 0
+	da.m_objCount = 0
+	da.m_strCount = 0
+	da.m_objStrOffs = nil
+	da.m_dumyData = nil
+	da.m_offset = 0
+
+	da.m_objArray = nil
+	da.Valid = true
+	return da
+}
+
+// 数据库自定义数组Array构造函数，typeName为库中定义的数组类型名称，elements为该数组类型的每个值
+//
+// 例如，自定义数组类型语句为：create or replace type myArray is array int[];
+//
+// 则绑入绑出的go对象为: val := dm.NewDmArray("myArray", []interface{} {123, 456})
+func NewDmArray(typeName string, elements []interface{}) *DmArray {
+	da := new(DmArray)
+	da.typeName = typeName
+	da.elements = elements
+	da.Valid = true
+	return da
+}
+
+func (da *DmArray) create(dc *DmConnection) (*DmArray, error) {
+	desc, err := newArrayDescriptor(da.typeName, dc)
+	if err != nil {
+		return nil, err
+	}
+	return da.createByArrayDescriptor(desc, dc)
+}
+
+func (da *DmArray) createByArrayDescriptor(arrDesc *ArrayDescriptor, conn *DmConnection) (*DmArray, error) {
+
+	if nil == arrDesc {
+		return nil, ECGO_INVALID_PARAMETER_VALUE.throw()
+	}
+
+	da.init()
+
+	da.m_arrDesc = arrDesc
+	if nil == da.elements {
+		da.m_arrData = make([]TypeData, 0)
+	} else {
+		// 若为静态数组，判断给定数组长度是否超过静态数组的上限
+		if arrDesc.getMDesc() == nil || (arrDesc.getMDesc().getDType() == SARRAY && len(da.elements) > arrDesc.getMDesc().getStaticArrayLength()) {
+			return nil, ECGO_INVALID_ARRAY_LEN.throw()
+		}
+
+		var err error
+		da.m_arrData, err = TypeDataSV.toArray(da.elements, da.m_arrDesc.getMDesc())
+		if err != nil {
+			return nil, err
+		}
+	}
+
+	da.m_itemCount = len(da.m_arrData)
+	return da, nil
+}
+
+func newDmArrayByTypeData(atData []TypeData, desc *TypeDescriptor) *DmArray {
+	da := new(DmArray)
+	da.init()
+	da.m_arrDesc = newArrayDescriptorByTypeDescriptor(desc)
+	da.m_arrData = atData
+	return da
+}
+
+func (da *DmArray) checkIndex(index int64) error {
+	if index < 0 || index > int64(len(da.m_arrData)-1) {
+		return ECGO_INVALID_LENGTH_OR_OFFSET.throw()
+	}
+	return nil
+}
+
+func (da *DmArray) checkIndexAndCount(index int64, count int) error {
+	err := da.checkIndex(index)
+	if err != nil {
+		return err
+	}
+
+	if count <= 0 || index+int64(count) > int64(len(da.m_arrData)) {
+		return ECGO_INVALID_LENGTH_OR_OFFSET.throw()
+	}
+	return nil
+}
+
+// 获取Array对象在数据库中的类型名称
+func (da *DmArray) GetBaseTypeName() (string, error) {
+	if err := da.checkValid(); err != nil {
+		return "", err
+	}
+	return da.m_arrDesc.m_typeDesc.getFulName()
+}
+
+// 获取Array对象的go数组对象
+func (da *DmArray) GetArray() (interface{}, error) {
+	if da.m_arrData == nil || len(da.m_arrData) <= 0 {
+		return nil, nil;
+	}
+
+	return TypeDataSV.toJavaArray(da, 0, len(da.m_arrData), da.m_arrDesc.getItemDesc().getDType())
+}
+
+// 获取Array对象的指定偏移和执行长度go数据对象 index从0开始
+func (da *DmArray) GetObjArray(index int64, count int) (interface{}, error) {
+	var err error
+	if err = da.checkValid(); err != nil {
+		return nil, err
+	}
+	if err = da.checkIndexAndCount(index, count); err != nil {
+		return nil, err
+	}
+
+	return TypeDataSV.toJavaArray(da, index, count, da.m_arrDesc.getItemDesc().getDType())
+}
+
+func (da *DmArray) GetIntArray(index int64, count int) ([]int, error) {
+	var err error
+	if err = da.checkValid(); err != nil {
+		return nil, err
+	}
+	if err = da.checkIndexAndCount(index, count); err != nil {
+		return nil, err
+	}
+
+	tmp, err := TypeDataSV.toNumericArray(da, index, count, ARRAY_TYPE_INTEGER)
+	if err != nil {
+		return nil, err
+	}
+	return tmp.([]int), nil
+}
+
+func (da *DmArray) GetInt16Array(index int64, count int) ([]int16, error) {
+	var err error
+	if err = da.checkValid(); err != nil {
+		return nil, err
+	}
+	if err = da.checkIndexAndCount(index, count); err != nil {
+		return nil, err
+	}
+
+	tmp, err := TypeDataSV.toNumericArray(da, index, count, ARRAY_TYPE_SHORT)
+	if err != nil {
+		return nil, err
+	}
+	return tmp.([]int16), nil
+}
+
+func (da *DmArray) GetInt64Array(index int64, count int) ([]int64, error) {
+	var err error
+	if err = da.checkValid(); err != nil {
+		return nil, err
+	}
+	if err = da.checkIndexAndCount(index, count); err != nil {
+		return nil, err
+	}
+
+	tmp, err := TypeDataSV.toNumericArray(da, index, count, ARRAY_TYPE_LONG)
+	if err != nil {
+		return nil, err
+	}
+
+	return tmp.([]int64), nil
+}
+
+func (da *DmArray) GetFloatArray(index int64, count int) ([]float32, error) {
+	var err error
+	if err = da.checkValid(); err != nil {
+		return nil, err
+	}
+	if err = da.checkIndexAndCount(index, count); err != nil {
+		return nil, err
+	}
+
+	tmp, err := TypeDataSV.toNumericArray(da, index, count, ARRAY_TYPE_FLOAT)
+	if err != nil {
+		return nil, err
+	}
+
+	return tmp.([]float32), nil
+}
+
+func (da *DmArray) GetDoubleArray(index int64, count int) ([]float64, error) {
+	var err error
+	if err = da.checkValid(); err != nil {
+		return nil, err
+	}
+	if err = da.checkIndexAndCount(index, count); err != nil {
+		return nil, err
+	}
+
+	tmp, err := TypeDataSV.toNumericArray(da, index, count, ARRAY_TYPE_DOUBLE)
+	if err != nil {
+		return nil, err
+	}
+
+	return tmp.([]float64), nil
+}
+
+func (dest *DmArray) Scan(src interface{}) error {
+	if dest == nil {
+		return ECGO_STORE_IN_NIL_POINTER.throw()
+	}
+	switch src := src.(type) {
+	case nil:
+		*dest = *new(DmArray)
+		// 将Valid标志置false表示数据库中该列为NULL
+		(*dest).Valid = false
+		return nil
+	case *DmArray:
+		*dest = *src
+		return nil
+	default:
+		return UNSUPPORTED_SCAN.throw()
+	}
+}
+
+func (array DmArray) Value() (driver.Value, error) {
+	if !array.Valid {
+		return nil, nil
+	}
+	return array, nil
+}
+
+func (array *DmArray) checkValid() error {
+	if !array.Valid {
+		return ECGO_IS_NULL.throw()
+	}
+	return nil
+}