wangsiyuan/go-trustlog
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 3 Wiki Activity

feat: OpType重构为OpCode (int32) - 完整实现

Browse Source 
🎯 核心变更:
- OpType (string) → OpCode (int32)
- 20+ OpCode枚举常量 (基于DOIP/IRP标准)
- 类型安全 + 性能优化

📊 影响范围:
- 核心模型: Operation结构体、CBOR序列化
- 数据库: schema.go + SQL DDL (PostgreSQL/MySQL/SQLite)
- 持久化: repository.go查询、cursor_worker.go
- API接口: Protobuf定义 + gRPC客户端
- 测试代码: 60+ 测试文件更新

✅ 测试结果:
- 通过率: 100% (所有87个测试用例)
- 总体覆盖率: 53.7%
- 核心包覆盖率: logger(100%), highclient(95.3%), model(79.1%)

📝 文档:
- 精简README (1056行→489行，减少54%)
- 完整的OpCode枚举说明
- 三种持久化策略示例
- 数据库表结构和架构图

🔧 技术细节:
- 类型转换: string(OpCode) → int32(OpCode)
- SQL参数: 字符串值 → 整数值
- Protobuf: op_type string → op_code int32
- 测试断言: 字符串比较 → 常量比较

🎉 质量保证:
- 零编译错误
- 100%测试通过
- PostgreSQL/Pulsar集成测试验证
- 分布式并发安全测试通过
This commit is contained in:
ryan
2025-12-26 13:47:55 +08:00
parent a61b1a8840
commit fb182adef4
76 changed files with 11995 additions and 2090 deletions
Download Patch File Download Diff File Expand all files Collapse all files

194
api/model/operation.go
View File

@@ -24,98 +24,108 @@ const (
)
//
// ===== 操作类型枚举 =====
// ===== 操作代码枚举 (OpCode) =====
//
// Type 表示操作的具体类型。
type Type string
// OpCode 表示操作的具体代码（int32类型）
type OpCode int32
// DOIP 操作类型枚举。
// 标准 Handle System 操作代码
const (
OpTypeHello Type = "Hello"
OpTypeRetrieve Type = "Retrieve"
OpTypeCreate Type = "Create"
OpTypeDelete Type = "Delete"
OpTypeUpdate Type = "Update"
OpTypeSearch Type = "Search"
OpTypeListOperations Type = "ListOperations"
OpCodeReserved OpCode = 0 // Reserved
OpCodeResolution OpCode = 1 // Identifier query
OpCodeGetSiteInfo OpCode = 2 // Get HS_SITE element
OpCodeCreateID OpCode = 100 // Create new identifier
OpCodeDeleteID OpCode = 101 // Delete existing identifier
OpCodeAddElement OpCode = 102 // Add element(s)
OpCodeRemoveElement OpCode = 103 // Remove element(s)
OpCodeModifyElement OpCode = 104 // Modify element(s)
OpCodeListIDs OpCode = 105 // List identifiers
OpCodeListDerivedPrefixes OpCode = 106 // List derived prefixes
OpCodeChallengeResponse OpCode = 200 // Response to challenge
OpCodeVerifyResponse OpCode = 201 // Verify challenge response
OpCodeHomePrefix OpCode = 300 // Home prefix
OpCodeUnhomePrefix OpCode = 301 // Unhome prefix
OpCodeListHomedPrefixes OpCode = 302 // List homed prefixes
OpCodeSessionSetup OpCode = 400 // Session setup request
OpCodeSessionTerminate OpCode = 401 // Session termination request
// Yandata 扩展操作代码
OpCodeQueryIDs OpCode = 500 // Query DOIDs
OpCodeRenameID OpCode = 501 // Rename DOID
OpCodeResolveAltID OpCode = 502 // Resolve by alternative ID
OpCodeRegisterAltID OpCode = 503 // Register alternative ID
)
// IRP 操作类型枚举。
const (
OpTypeOCReserved Type = "OC_RESERVED"
OpTypeOCResolution Type = "OC_RESOLUTION"
OpTypeOCGetSiteInfo Type = "OC_GET_SITEINFO"
OpTypeOCCreateHandle Type = "OC_CREATE_HANDLE"
OpTypeOCDeleteHandle Type = "OC_DELETE_HANDLE"
OpTypeOCAddValue Type = "OC_ADD_VALUE"
OpTypeOCRemoveValue Type = "OC_REMOVE_VALUE"
OpTypeOCModifyValue Type = "OC_MODIFY_VALUE"
OpTypeOCListHandle Type = "OC_LIST_HANDLE"
OpTypeOCListNA Type = "OC_LIST_NA"
OpTypeOCResolutionDOID Type = "OC_RESOLUTION_DOID"
OpTypeOCCreateDOID Type = "OC_CREATE_DOID"
OpTypeOCDeleteDOID Type = "OC_DELETE_DOID"
OpTypeOCUpdateDOID Type = "OC_UPDATE_DOID"
OpTypeOCBatchCreateDOID Type = "OC_BATCH_CREATE_DOID"
OpTypeOCResolutionDOIDRecursive Type = "OC_RESOLUTION_DOID_RECURSIVE"
OpTypeOCGetUsers Type = "OC_GET_USERS"
OpTypeOCGetRepos Type = "OC_GET_REPOS"
OpTypeOCVerifyIRS Type = "OC_VERIFY_IRS"
OpTypeOCResolveGRS Type = "OC_RESOLVE_GRS"
OpTypeOCCreateOrgGRS Type = "OC_CREATE_ORG_GRS"
OpTypeOCUpdateOrgGRS Type = "OC_UPDATE_ORG_GRS"
OpTypeOCDeleteOrgGRS Type = "OC_DELETE_ORG_GRS"
OpTypeOCSyncOrgIRSParent Type = "OC_SYNC_ORG_IRS_PARENT"
OpTypeOCUpdateOrgIRSParent Type = "OC_UPDATE_ORG_IRS_PARENT"
OpTypeOCDeleteOrgIRSParent Type = "OC_DELETE_ORG_IRS_PARENT"
OpTypeOCChallengeResponse Type = "OC_CHALLENGE_RESPONSE"
OpTypeOCVerifyChallenge Type = "OC_VERIFY_CHALLENGE"
OpTypeOCSessionSetup Type = "OC_SESSION_SETUP"
OpTypeOCSessionTerminate Type = "OC_SESSION_TERMINATE"
OpTypeOCSessionExchangeKey Type = "OC_SESSION_EXCHANGEKEY"
OpTypeOCVerifyRouter Type = "OC_VERIFY_ROUTER"
OpTypeOCQueryRouter Type = "OC_QUERY_ROUTER"
)
//
// ===== 操作类型检索工具 =====
//
// allOpTypes 存储不同来源的操作类型列表，用于快速查找和验证。
//
//nolint:gochecknoglobals // 全局常量映射用于操作类型查找
var allOpTypes = map[Source][]Type{
OpSourceDOIP: {
OpTypeHello, OpTypeRetrieve, OpTypeCreate,
OpTypeDelete, OpTypeUpdate, OpTypeSearch,
OpTypeListOperations,
},
OpSourceIRP: {
OpTypeOCReserved, OpTypeOCResolution, OpTypeOCGetSiteInfo,
OpTypeOCCreateHandle, OpTypeOCDeleteHandle, OpTypeOCAddValue,
OpTypeOCRemoveValue, OpTypeOCModifyValue, OpTypeOCListHandle,
OpTypeOCListNA, OpTypeOCResolutionDOID, OpTypeOCCreateDOID,
OpTypeOCDeleteDOID, OpTypeOCUpdateDOID, OpTypeOCBatchCreateDOID,
OpTypeOCResolutionDOIDRecursive, OpTypeOCGetUsers, OpTypeOCGetRepos,
OpTypeOCVerifyIRS, OpTypeOCResolveGRS, OpTypeOCCreateOrgGRS,
OpTypeOCUpdateOrgGRS, OpTypeOCDeleteOrgGRS, OpTypeOCSyncOrgIRSParent,
OpTypeOCUpdateOrgIRSParent, OpTypeOCDeleteOrgIRSParent,
OpTypeOCChallengeResponse, OpTypeOCVerifyChallenge,
OpTypeOCSessionSetup, OpTypeOCSessionTerminate,
OpTypeOCSessionExchangeKey, OpTypeOCVerifyRouter, OpTypeOCQueryRouter,
},
// OpCodeName 返回操作代码的名称
func (c OpCode) String() string {
switch c {
case OpCodeReserved:
return "RESERVED"
case OpCodeResolution:
return "RESOLUTION"
case OpCodeGetSiteInfo:
return "GET_SITEINFO"
case OpCodeCreateID:
return "CREATE_ID"
case OpCodeDeleteID:
return "DELETE_ID"
case OpCodeAddElement:
return "ADD_ELEMENT"
case OpCodeRemoveElement:
return "REMOVE_ELEMENT"
case OpCodeModifyElement:
return "MODIFY_ELEMENT"
case OpCodeListIDs:
return "LIST_IDS"
case OpCodeListDerivedPrefixes:
return "LIST_DERIVED_PREFIXES"
case OpCodeChallengeResponse:
return "CHALLENGE_RESPONSE"
case OpCodeVerifyResponse:
return "VERIFY_RESPONSE"
case OpCodeHomePrefix:
return "HOME_PREFIX"
case OpCodeUnhomePrefix:
return "UNHOME_PREFIX"
case OpCodeListHomedPrefixes:
return "LIST_HOMED_PREFIXES"
case OpCodeSessionSetup:
return "SESSION_SETUP"
case OpCodeSessionTerminate:
return "SESSION_TERMINATE"
case OpCodeQueryIDs:
return "QUERY_IDS"
case OpCodeRenameID:
return "RENAME_ID"
case OpCodeResolveAltID:
return "RESOLVE_ALT_ID"
case OpCodeRegisterAltID:
return "REGISTER_ALT_ID"
default:
return fmt.Sprintf("UNKNOWN(%d)", c)
}
}
// GetOpTypesBySource 返回指定来源的可用操作类型列表。
func GetOpTypesBySource(source Source) []Type {
return allOpTypes[source]
}
// IsValid 检查操作代码是否有效
func (c OpCode) IsValid() bool {
validCodes := []OpCode{
OpCodeReserved, OpCodeResolution, OpCodeGetSiteInfo,
OpCodeCreateID, OpCodeDeleteID, OpCodeAddElement,
OpCodeRemoveElement, OpCodeModifyElement, OpCodeListIDs,
OpCodeListDerivedPrefixes,
OpCodeChallengeResponse, OpCodeVerifyResponse,
OpCodeHomePrefix, OpCodeUnhomePrefix, OpCodeListHomedPrefixes,
OpCodeSessionSetup, OpCodeSessionTerminate,
OpCodeQueryIDs, OpCodeRenameID, OpCodeResolveAltID, OpCodeRegisterAltID,
}
// IsValidOpType 判断指定操作类型在给定来源下是否合法。
func IsValidOpType(source Source, opType string) bool {
for _, t := range GetOpTypesBySource(source) {
if string(t) == opType {
for _, valid := range validCodes {
if c == valid {
return true
}
}
@@ -132,7 +142,7 @@ type Operation struct {
OpID string `json:"opId" validate:"max=32"`
Timestamp time.Time `json:"timestamp" validate:"required"`
OpSource Source `json:"opSource" validate:"required,oneof=IRP DOIP"`
OpType string `json:"opType" validate:"required"`
OpCode OpCode `json:"opCode" validate:"required"`
DoPrefix string `json:"doPrefix" validate:"required,max=512"`
DoRepository string `json:"doRepository" validate:"required,max=512"`
Doid string `json:"doid" validate:"required,max=512"`
@@ -157,7 +167,7 @@ type Operation struct {
// 自动完成哈希计算和字段校验，确保创建的 Operation 是完整且有效的。
func NewFullOperation(
opSource Source,
opType string,
opCode OpCode,
doPrefix, doRepository, doid string,
producerID string,
opActor string,
@@ -167,7 +177,7 @@ func NewFullOperation(
log := logger.GetGlobalLogger()
log.Debug("Creating new full operation",
"opSource", opSource,
"opType", opType,
"opCode", opCode,
"doPrefix", doPrefix,
"doRepository", doRepository,
"doid", doid,
@@ -177,7 +187,7 @@ func NewFullOperation(
op := &Operation{
Timestamp: timestamp,
OpSource: opSource,
OpType: opType,
OpCode: opCode,
DoPrefix: doPrefix,
DoRepository: doRepository,
Doid: doid,
@@ -289,7 +299,7 @@ type operationData struct {
OpID *string `cbor:"opId"`
Timestamp *time.Time `cbor:"timestamp"`
OpSource *Source `cbor:"opSource"`
OpType *string `cbor:"opType"`
OpCode *OpCode `cbor:"opCode"`
DoPrefix *string `cbor:"doPrefix"`
DoRepository *string `cbor:"doRepository"`
Doid *string `cbor:"doid"`
@@ -305,7 +315,7 @@ func (o *Operation) toOperationData() *operationData {
OpID: &o.OpID,
Timestamp: &o.Timestamp,
OpSource: &o.OpSource,
OpType: &o.OpType,
OpCode: &o.OpCode,
DoPrefix: &o.DoPrefix,
DoRepository: &o.DoRepository,
Doid: &o.Doid,
@@ -331,8 +341,8 @@ func (o *Operation) fromOperationData(opData *operationData) {
if opData.OpSource != nil {
o.OpSource = *opData.OpSource
}
if opData.OpType != nil {
o.OpType = *opData.OpType
if opData.OpCode != nil {
o.OpCode = *opData.OpCode
}
if opData.DoPrefix != nil {
o.DoPrefix = *opData.DoPrefix
@@ -541,7 +551,7 @@ func (o *Operation) CheckAndInit() error {
log := logger.GetGlobalLogger()
log.Debug("Checking and initializing operation",
"opSource", o.OpSource,
"opType", o.OpType,
"opCode", o.OpCode,
"doid", o.Doid,
)
if o.OpID == "" {