feat: publish v1.0.0-rc.36-custom.1

model/json_column_test.go

@@ -0,0 +1,94 @@
+package model
+
+import (
+	"database/sql/driver"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+// 保护契约:PostgreSQL 走 simple protocol(PrepareStmt 关闭)时,driver.Valuer
+// 返回 []byte 会被 pgx 按 bytea 十六进制字面量编码,写入 json 列触发
+// SQLSTATE 22P02。所有 json 列的 Value() 必须返回 string(或 nil)。
+func TestJSONColumnValuersReturnString(t *testing.T) {
+	testCases := []struct {
+		name   string
+		valuer driver.Valuer
+		want   string
+	}{
+		{
+			name:   "ChannelInfo",
+			valuer: ChannelInfo{IsMultiKey: true, MultiKeySize: 2},
+			want:   `{"is_multi_key":true,"multi_key_size":2,"multi_key_status_list":null,"multi_key_polling_index":0,"multi_key_mode":""}`,
+		},
+		{
+			name:   "Properties",
+			valuer: Properties{Input: "hello"},
+			want:   `{"input":"hello"}`,
+		},
+		{
+			name:   "TaskPrivateData",
+			valuer: TaskPrivateData{Key: "k"},
+			want:   `{"key":"k"}`,
+		},
+		{
+			name:   "JSONValue",
+			valuer: JSONValue(`[{"k":"v"}]`),
+			want:   `[{"k":"v"}]`,
+		},
+	}
+
+	for _, testCase := range testCases {
+		t.Run(testCase.name, func(t *testing.T) {
+			value, err := testCase.valuer.Value()
+			require.NoError(t, err)
+			str, ok := value.(string)
+			require.True(t, ok, "Value() must return string, got %T", value)
+			assert.JSONEq(t, testCase.want, str)
+		})
+	}
+}
+
+// 空值仍返回 nil,保持列的 NULL 语义。
+func TestJSONColumnValuersZeroValueIsNil(t *testing.T) {
+	for name, valuer := range map[string]driver.Valuer{
+		"Properties":      Properties{},
+		"TaskPrivateData": TaskPrivateData{},
+		"JSONValue":       JSONValue(nil),
+	} {
+		t.Run(name, func(t *testing.T) {
+			value, err := valuer.Value()
+			require.NoError(t, err)
+			assert.Nil(t, value)
+		})
+	}
+}
+
+// 保护契约:json 列的 Scan 必须同时接受 []byte 与 string——不同驱动/协议
+// 模式返回类型不同,静默丢弃 string 会把已有数据清零。
+func TestJSONColumnScannersAcceptStringAndBytes(t *testing.T) {
+	toInput := func(kind string, payload string) any {
+		if kind == "bytes" {
+			return []byte(payload)
+		}
+		return payload
+	}
+
+	for _, kind := range []string{"bytes", "string"} {
+		t.Run(kind, func(t *testing.T) {
+			var info ChannelInfo
+			require.NoError(t, info.Scan(toInput(kind, `{"is_multi_key":true,"multi_key_size":2}`)))
+			assert.True(t, info.IsMultiKey)
+			assert.Equal(t, 2, info.MultiKeySize)
+
+			var props Properties
+			require.NoError(t, props.Scan(toInput(kind, `{"input":"hello"}`)))
+			assert.Equal(t, "hello", props.Input)
+
+			var private TaskPrivateData
+			require.NoError(t, private.Scan(toInput(kind, `{"key":"k"}`)))
+			assert.Equal(t, "k", private.Key)
+		})
+	}
+}