catlib / core Goto Github PK

View Code? Open in Web Editor NEW

189.0 14.0 40.0 2.81 MB

CatLib lightweight dependency injection container

Home Page: https://catlib.io

License: MIT License

C# 99.45% PowerShell 0.55%

unity framework unity3d ioc-container injection-container catlib

core's Introduction

About CatLib

CatLib is the lightweight dependency injection container and helper functions library.

Install CatLib Core

Installed with Nuget

$ Install-Package CatLib.Core -Version 2.0.0

Installed with Bucket

$ bucket require catlib/core

Installed with Github Release

Download the latest version。

Learning CatLib

CatLib has the most extensive and thorough documentation, making it a breeze to get started with the framework.

需要中文支持? 请访问CatLib中文文档。

Contribution

CatLib is still a young framework, and her growth and your contribution are inseparable. If you want to contribute to the project, please refer to: CatLib Contribution Guide Your contribution will be included in the list of contributors，Welcome Pull Request!

License

The open source license used by CatLib is MIT license.

Support

email: [email protected]
slack: catlib.slack

core's People

Contributors

Stargazers

Watchers

core's Issues

Netstandard 2.0 项目增加链接文件

CombineStream.cs
WrapperStream.cs
SegmentStream.cs

服务容器增加App.Alias<TService, TAlias>()的拓展方法支持

增加SortSet.ReverseIterator(bool forward)指定反转方向的接口

Arr.Map 支持迭代器

c#7.0语法优化

增加 WrapperStream 包装流

如果尝试在注册流程中Invoke函数，那么会引发一个异常。

增加单元测试覆盖率至98%

v1.2.11更新记录

PipelineStream支持SetLength
增加ToStream();

v1.3.0 更新记录

CatLib v1.3.0 alpha 版本更新日志：

框架

升级为 c# 7.0 语法(#64 )
增加LogicException逻辑错误异常(#80 )
增加CodeStandardException代码规范异常(#62 )
ServiceProvider.Register不再是abstract
增加了ICoroutineInit 协同初始化接口(默认的迭代器为同步迭代器和Init没有本质区别,在其他环境下可能受到环境影响)
ApplicationEvents.OnIniting被标记为已过时，使用：ApplicationEvents.OnProviderInit替换
新增了ApplicationEvents.OnProviderInit 服务提供者初始化之前
新增了ApplicationEvents.OnProviderInited 服务提供者初始化完成
Application Version现在是静态化的了(#90 )

代码规范性检查

- 如果尝试为同一个单例化的实例注册不同的服务名，则会异常发一个异常(#62)
- 如果尝试在注册流程中Make服务，那么会引发一个异常。 (#59)
- 通过容器Watch一个对象时，只有当对象时可以被构建时才允许被watch。因为我们认为观察的只能是一个已经被确定的服务，而不是一个未知服务。 (#59)
- 如果尝试在注册流程中Invoke函数，那么会引发一个异常。(#62)

容器服务

服务容器增加了解决事件和释放事件的条件筛选(#84 )
服务容器增加OnAfterResolving的支持。(#83 )
使用this[] set对象时会进行隐式的对象绑定(bind)(#82 )
增加Extend函数，用于处理服务的覆盖及拓展关系，OnResolving不再允许覆盖对象。(#79)
服务容器Watch接口从容器实现转移至扩展函数(#81)
增加服务特殊字符@,$和:识别，如果包含则不允许注册。(#61)
增加变量标签$同@一样，具备相同的变量映射作用。(#61)
容器在flush对象时将会按照构建顺序的相反顺序释放服务（之前是需要通过辅助组件来完成）(#55)
服务容器增加App.Alias<TService, TAlias>()的拓展方法支持(#57)

支持库

增加 SegmentStream 分片流(#74)
增加 WrapperStream 包装流(#69)
增加 CombineStream 组合流(#70)
Arr.Filter 支持迭代器(#67)
Arr.Map 支持迭代器(#66)
增加了SortSet.ReverseIterator(bool forward)指定反转方向的接口(#56)
StreamExtension.ToText() 加入对不能读取流的判断(#75)
管理器模版支持OnAfterResolving(#92 )

修复初始化顺序不正确的异常，不同运行时环境不一致(这个异常并不影响使用)

该问题在unity - net35环境下可以被复现，net40正常。

unity net35环境下List的排序，优先级相等的话是乱序的。
unity net40下是相对顺序的。
.net 环境下是相对顺序的。

服务容器Watch接口从容器实现转移至扩展函数

v1.2.8 Version

新增了 Stream 扩展函数 AppendTo
修复了 SortSet.GetRangeCount 在一定情况下引发异常的bug
增加了内存存储结构 MemoryStorage
增加了存储流 StorageStream
修复了Facade中Instance导致40B的GC Alloc

StreamExtension.ToText() 加入对不能读取流的判断

修复Dict.Modify始终替换内容的问题

修复一个bug ，这个bug导致 Dict.Modify 无论如何内容都会被替换。

追加遗漏项目：管理器类支持OnAfterResolving

服务容器增加了解决事件和释放事件的条件筛选

container.OnResolving<IContainer>((instance) =>
 {
     // 只有 instance 实现了 IContainer 接口才会被触发
});

对：OnResolving, OnAfterResolving, OnRelease有效

Given 允许返回一个闭包

上下文关系允许传入一个闭包来解决上下文。

container.Bind<MyClass>().Needs<IInterface>().Given(()=>{
      return new InterfaceClass();
});

这对于一些需要从管理器中获取接口实现的类非常有用。

增加LogicException逻辑错误异常

v1.3.0-Alpha.2更新日志

Type2Service 将不允许为虚方法。(#96 )
服务提供者的传入顺序为初始化顺序(#97 )
Given 允许返回一个闭包 (#98 )

Arr.Filter 支持迭代器

增加Extend函数，用于处理服务的覆盖及拓展关系，OnResolving不再允许覆盖对象。

增加 SegmentStream.cs

分片流可以用于包装指定分片的流。
使指定分片的流访问起来就像传统流那样从开头到结尾。

BindMethod 支持无返回值的函数绑定，且不限制返回值类型

由于重载问题，所以该内容搁置

如果尝试为同一个单例化的实例注册不同的服务名，则会异常发一个异常

如果尝试在注册流程中Make服务，那么会引发一个异常。

resolved #58

增加 CombineStream 组合流

验证`App`是否已经支持新增内容的静态函数

服务提供者的传入顺序为初始化顺序

这个问题并不影响实际使用，因为同一优先级内不应该区分先后顺序。但是为了更好的调试可读性，我们修复了这个问题。

检查服务名是否包含不允许的字符 & 使用字符串内插处理字符串拼接

增加虚方法 GuardServiceName
- 对方法Bind生效
- 对方法Instance生效
增加虚方法 GuardMethodName
- 对方法BindMethod生效

验证生效后应该使用Alias来代替拥有非法字符的服务名，例如：

container.Instance("@num", 777);

被替换为:

container.Instance("num",777);
container.Alias("@num", "num");

因为一个服务可能对应多个特殊别名，如果以服务名作为别名的简化来写，从语意上来说显得不清晰。

通过容器Watch一个对象时，只有当对象时可以被构建时才允许被watch

支持`Singleton`和`Bind`时同时给与别名，并且通过闭包返回实现

方案被废弃

容器允许通过Wrap包装指定的的函数，在调用包装的时候注入函数需求的依赖项

建议考虑添加 Timer Manager Catch异常处理

目前如果不做catch处理，当timer内逻辑发生错误，会一直逐帧报错，导致程序非常卡，无法进行。建议给timer添加一个是否略过异常的标记，可以选择性的抛出异常，防止程序因为大量LOG导致性能下降！

明确出现的异常调用，对于代码规范检测类的异常使用CodeStandardException替换

v1.3.0-Alpha.3更新日志

框架相关

修复初始化顺序不正确的异常，不同运行时环境不一致(#102 )
copyright 名称变更为 CatLib(#106 )
为Type增加ToService扩展函数(#105 )
注释中的文档地址更新为 https(#108 )
DebugLevels允许在Register中被使用（#109）
提示内容优化(#117 )
App门面增加IsResolved(string service)的支持(#118 )
移除实验的属性App.AutoInstance; 如果全局实例没有被构建则引发一个异常（#129）
如果在构建CatLib实例时，允许传入一个bool值决定是否应用到全局（#128）

服务容器

将IContainer接口缩减，缩减的接口将会被移动到扩展方法(#111 )
-- Factory
语意行为变更：Bind和Singleton相关(#112 )
IContainer.Release接口参数由string变更为object,允许通过对象实例来进行释放(#115 )
优化UnresolvableException的异常提示消息（#120）
允许在Needs时提供需求的变量名，以支持变量名需求，改善变量名上下文关系的流程 (#122 )
服务容器的构建策略可以通过虚函数覆写（#124）
移除了Inject的别名支持（#126）

其他

清理了无用代码(#119 )

服务容器增加OnAfterResolving的支持。

SortSet.GetRangeCount Exception

rank ^= leftRank ^= rank ^= leftRank;

代码错误

v1.2.10 更新记录

增加 Stream.ToText(); 扩展函数
Arr.Merge支持对于null元素的合并兼容
增加了PipelineStream 管道流，可以用于安全的线程间通讯

增加虚函数GetVariableTags允许获取变量标签

Application Version现在是静态化的了

v1.2.12 更新记录

增加模版方法的门面静态类
修复Dict.Modify的bug，这个bug导致不必要的字典实例 #52
DebugLevels 枚举命名调整
-- Prod标记为已过时
-- Dev标记为已过时
-- 增加 Production
-- 增加 Development
尝试重复调用引导(Bootstrap)时会引发一个RuntimeException而不是静默忽略。
尝试重复调用初始化(Init)时会引发一个RuntimeException而不是静默忽略。
增加了ApplicationEvents.OnBootstrap在引导开始之前
增加了ApplicationEvents.Bootstrapping在引导进行中
增加了ApplicationEvents.OnInit在初始化开始之前
增加了ApplicationEvents.OnInited在初始化完成之后
增加了ApplicationEvents.OnRegisterProvider注册服务提供者事件
允许ApplicationEvents.Bootstrapping返回一个不为null的值(一般是false)来终止当前引导激活。
允许ApplicationEvents.OnRegisterProvider返回一个不为null的值(一般是false)来终止服务提供者注册。