feat(core): add Module

Author: lvan100

README.md

@@ -211,8 +211,6 @@ Go-Spring provides multiple ways to register Beans:
 - **`gs.Object(obj)`** - Registers an existing object as a Bean
 - **`gs.Provide(ctor, args...)`** - Uses a constructor to generate and register a Bean
 - **`gs.Register(bd)`** - Registers a complete Bean definition (suitable for low-level encapsulation or advanced usage)
-- **`gs.GroupRegister(fn)`** - Batch registers multiple Beans (commonly used for module initialization and other
-  scenarios)
 
 Example:
 
@@ -221,14 +219,6 @@ gs.Object(&Service{})  // Register a struct instance
 gs.Provide(NewService) // Register using a constructor
 gs.Provide(NewRepo, gs.ValueArg("db")) // Constructor with parameters
 gs.Register(gs.NewBean(NewService)) // Complete definition registration
-
-// Batch register multiple Beans
-gs.GroupRegister(func (p conf.Properties) []*gs.BeanDefinition {
-   return []*gs.BeanDefinition{
-      gs.NewBean(NewUserService),
-      gs.NewBean(NewOrderService),
-   }
-})
 ```
 
 ### 2️⃣ Injection Methods
@@ -317,11 +307,10 @@ feature toggles, and gray release scenarios.
 ### 🎯 Common Condition Types
 
 - **`OnProperty("key")`**: Activates when the specified configuration key exists
-- **`OnMissingProperty("key")`**: Activates when the specified configuration key does not exist
 - **`OnBean[Type]("name")`**: Activates when a Bean of the specified type/name exists
 - **`OnMissingBean[Type]("name")`**: Activates when a Bean of the specified type/name does not exist
 - **`OnSingleBean[Type]("name")`**: Activates when a Bean of the specified type/name is the only instance
-- **`OnFunc(func(ctx CondContext) bool)`**: Uses custom condition logic to determine activation
+- **`OnFunc(func(ctx ConditionContext) bool)`**: Uses custom condition logic to determine activation
 
 Example:
 

README_CN.md

@@ -189,7 +189,6 @@ Go-Spring 提供多种方式注册 Bean：
 - **`gs.Object(obj)`** - 将已有对象注册为 Bean
 - **`gs.Provide(ctor, args...)`** - 使用构造函数生成并注册 Bean
 - **`gs.Register(bd)`** - 注册完整 Bean 定义（适合底层封装或高级用法）
-- **`gs.GroupRegister(fn)`** - 批量注册多个 Bean（常用于模块初始化等场景）
 
 示例:
 
@@ -198,14 +197,6 @@ gs.Object(&Service{})  // 注册结构体实例
 gs.Provide(NewService) // 使用构造函数注册
 gs.Provide(NewRepo, gs.ValueArg("db")) // 构造函数带参数
 gs.Register(gs.NewBean(NewService))    // 完整定义注册
-
-// 批量注册多个 Bean
-gs.GroupRegister(func (p conf.Properties) []*gs.BeanDefinition {
-    return []*gs.BeanDefinition{
-        gs.NewBean(NewUserService),
-        gs.NewBean(NewOrderService),
-    }
-})
 ```
 
 ### 2️⃣ 注入方式
@@ -291,11 +282,10 @@ Go-Spring 借鉴 Spring 的 `@Conditional` 思想，实现了灵活强大的条
 ### 🎯 常用条件类型
 
 - **`OnProperty("key")`**：当指定配置 key 存在时激活
-- **`OnMissingProperty("key")`**：当指定配置 key 不存在时激活
 - **`OnBean[Type]("name")`**：当指定类型/名称的 Bean 存在时激活
 - **`OnMissingBean[Type]("name")`**：当指定类型/名称的 Bean 不存在时激活
 - **`OnSingleBean[Type]("name")`**：当指定类型/名称的 Bean 是唯一实例时激活
-- **`OnFunc(func(ctx CondContext) bool)`**：使用自定义条件逻辑判断是否激活
+- **`OnFunc(func(ctx ConditionContext) bool)`**：使用自定义条件逻辑判断是否激活
 
 示例：
 

conf/bind.go

@@ -301,7 +301,7 @@ func getSlice(p Properties, et reflect.Type, param BindParam) (Properties, error
 	r := New()
 	for i, s := range arrVal {
 		k := fmt.Sprintf("%s[%d]", param.Key, i)
-		_ = r.Set(k, s) // always no error
+		_ = r.Set(k, s, 0) // always no error
 	}
 	return r, nil
 }

conf/bind_test.go

@@ -537,20 +537,22 @@ func TestProperties_Bind(t *testing.T) {
 		p, err := conf.Load("./testdata/config/app.yaml")
 		assert.That(t, err).Nil()
 
-		err = p.Set("extra.intsV0", "")
+		fileID := p.AddFile("bind_test.go")
+
+		err = p.Set("extra.intsV0", "", fileID)
 		assert.That(t, err).Nil()
-		err = p.Set("extra.intsV2", "1,2,3")
+		err = p.Set("extra.intsV2", "1,2,3", fileID)
 		assert.That(t, err).Nil()
-		err = p.Set("prefix.extra.intsV2", "1,2,3")
+		err = p.Set("prefix.extra.intsV2", "1,2,3", fileID)
 		assert.That(t, err).Nil()
 
-		err = p.Set("extra.mapV2.a", "1")
+		err = p.Set("extra.mapV2.a", "1", fileID)
 		assert.That(t, err).Nil()
-		err = p.Set("extra.mapV2.b", "2")
+		err = p.Set("extra.mapV2.b", "2", fileID)
 		assert.That(t, err).Nil()
-		err = p.Set("prefix.extra.mapV2.a", "1")
+		err = p.Set("prefix.extra.mapV2.a", "1", fileID)
 		assert.That(t, err).Nil()
-		err = p.Set("prefix.extra.mapV2.b", "2")
+		err = p.Set("prefix.extra.mapV2.b", "2", fileID)
 		assert.That(t, err).Nil()
 
 		var c DBConfig

conf/conf.go

@@ -121,18 +121,18 @@ package conf
 import (
 	"errors"
 	"fmt"
-	"maps"
 	"os"
 	"path/filepath"
 	"reflect"
+	"runtime"
 	"strings"
 	"time"
 
+	"github.com/go-spring/barky"
 	"github.com/go-spring/spring-core/conf/reader/json"
 	"github.com/go-spring/spring-core/conf/reader/prop"
 	"github.com/go-spring/spring-core/conf/reader/toml"
 	"github.com/go-spring/spring-core/conf/reader/yaml"
-	"github.com/go-spring/spring-core/conf/storage"
 	"github.com/go-spring/spring-core/util"
 	"github.com/spf13/cast"
 )
@@ -222,13 +222,13 @@ var _ Properties = (*MutableProperties)(nil)
 // but it costs more CPU time when getting properties because it reads property node
 // by node. So `conf` uses a tree to strictly verify and a flat map to store.
 type MutableProperties struct {
-	*storage.Storage
+	*barky.Storage
 }
 
 // New creates empty *MutableProperties.
 func New() *MutableProperties {
 	return &MutableProperties{
-		Storage: storage.NewStorage(),
+		Storage: barky.NewStorage(),
 	}
 }
 
@@ -247,20 +247,24 @@ func Load(file string) (*MutableProperties, error) {
 	if err != nil {
 		return nil, err
 	}
-	return Map(m), nil
+	p := New()
+	_ = p.merge(util.FlattenMap(m), file)
+	return p, nil
 }
 
 // Map creates *MutableProperties from map.
 func Map(m map[string]any) *MutableProperties {
 	p := New()
-	_ = p.merge(util.FlattenMap(m))
+	_, file, _, _ := runtime.Caller(1)
+	_ = p.merge(util.FlattenMap(m), file)
 	return p
 }
 
 // merge flattens the map and sets all keys and values.
-func (p *MutableProperties) merge(m map[string]string) error {
+func (p *MutableProperties) merge(m map[string]string, file string) error {
+	fileID := p.AddFile(file)
 	for key, val := range m {
-		if err := p.Set(key, val); err != nil {
+		if err := p.Set(key, val, fileID); err != nil {
 			return err
 		}
 	}
@@ -270,7 +274,9 @@ func (p *MutableProperties) merge(m map[string]string) error {
 // Data returns key-value pairs of the properties.
 func (p *MutableProperties) Data() map[string]string {
 	m := make(map[string]string)
-	maps.Copy(m, p.RawData())
+	for k, v := range p.RawData() {
+		m[k] = v.Value
+	}
 	return m
 }
 
@@ -281,11 +287,11 @@ func (p *MutableProperties) Keys() []string {
 
 // Get returns key's value, using Def to return a default value.
 func (p *MutableProperties) Get(key string, def ...string) string {
-	val, ok := p.RawData()[key]
+	v, ok := p.RawData()[key]
 	if !ok && len(def) > 0 {
 		return def[0]
 	}
-	return val
+	return v.Value
 }
 
 // Resolve resolves string value that contains references to other
@@ -338,5 +344,18 @@ func (p *MutableProperties) Bind(i any, tag ...string) error {
 
 // CopyTo copies properties into another by override.
 func (p *MutableProperties) CopyTo(out *MutableProperties) error {
-	return out.merge(p.RawData())
+	rawFile := p.RawFile()
+	newfile := make(map[string]int8)
+	oldFile := make([]string, len(rawFile))
+	for k, v := range rawFile {
+		oldFile[v] = k
+		newfile[k] = out.AddFile(k)
+	}
+	for key, v := range p.RawData() {
+		fileID := newfile[oldFile[v.File]]
+		if err := out.Set(key, v.Value, fileID); err != nil {
+			return err
+		}
+	}
+	return nil
 }