Prism Dependency Injection
1.Container Locator
1.1. Container Locator的引入:
- Container Locator是在Prism 8.0版本中新引入的一个特性。
- 它的目的是为了帮助Prism框架摆脱对CommonServiceLocator的依赖,并解决一些必须回退到ServiceLocator模式的内部问题,比如在XAML扩展中。
1.2. ContainerLocator的好处:
- ContainerLocator对于使用Prism框架的开发者来说,尤其是那些开发跨平台应用(如Xamarin.Forms或Uno Platform)的开发者,提供了额外的好处。
- 在某些情况下,开发者可能需要在初始化PrismApplication之前先初始化容器。一个常见的例子是使用Shiny框架的应用。在这种情况下,开发者可能希望将ServiceCollection添加到Prism容器中,然后将ServiceProvider返回给Shiny。这样,Prism和Shiny可以共同维护一个单一的容器,而不是拥有多个容器。
1.3. 对赞助Dan Siegel的开发者的特别说明:
- 对于那些赞助Dan Siegel的开发者,推荐使用Prism.Magician这个工具来实现上述功能。
2.如何使用Container Locator
2.1. 如何使用ContainerLocator:
- ContainerLocator可以通过一个委托(delegate)来延迟设置容器实例。这意味着,直到调用
ContainerLocator.Container
之前,容器不会被创建。
2.2. 示例代码:
var createContainerExtension = () => new DryIocContainerExtension();
ContainerLocator.SetContainerExtension(createContainerExtension);
- 首先,定义一个委托
createContainerExtension
,当调用时会创建一个新的DryIocContainerExtension
实例。 - 然后,使用
ContainerLocator.SetContainerExtension
方法来设置这个委托。
2.3. 警告:
- 如果在设置创建委托之后,你没有调用
ContainerLocator.Current
或ContainerLocator.Container
,那么后续对SetContainerExtension
的调用将会覆盖你最初设置的委托。
强调了ContainerLocator的延迟创建特性,以及如何通过委托来设置容器实例。同时,提醒开发者在设置委托后需要调用相关方法,否则之前设置的委托可能会被新的调用覆盖。这是在使用ContainerLocator时需要注意的一个关键点。
3.高级用法
3.1. 高级用法:
- 这部分内容仅适用于高级用户。这些API故意在智能感知( intellisense )中隐藏,因为它们不适用于普通用户。使用这些API时需要谨慎,并且只在正确的情境下使用。
- 如果需要访问原始的IContainerExtension,可以通过访问ContainerLocator.Current来实现。
3.2. 测试:
- 在单元测试中,通常建议重置ContainerLocator。这样可以确保容器被释放,容器实例和创建容器的委托都被清除,从而可以创建一个新的实例。
- 给出了一个示例代码,展示了如何在测试类中实现IDisposable接口,并在Dispose方法中调用ContainerLocator.ResetContainer()来重置ContainerLocator。
public class SomeTests : IDisposable
{public void Dispose(){ContainerLocator.ResetContainer();}
}
在使用高级API时需要谨慎,并在单元测试中重置ContainerLocator以确保容器被正确释放和清理。这对于确保测试的准确性和可靠性非常重要。
4.用法示例
4.1在ShinyStartup中
public class MyStartup : ShinyStartup
{private void RegisterTypes(IContainerRegistry container){// Your normal registrations here...}private IContainerExtension CreateContainerExtension() =>new DryIocContainerExtension();public override IServiceProvider CreateServiceProvider(IServiceCollection services){ContainerLocator.SetContainerExtension(CreateContainerExtension);var container = ContainerLocator.Container;container.RegisterServices(services);RegisterTypes(container);return container.GetContainer();}
}
4.2在XAML扩展中
public class SomeMarkupExtension : IMarkupExtension
{private static readonly Lazy<IEventAggregator> _lazyEventAggregator =new Lazy<IEventAggregator>(() => ContainerLocator.Container.Resolve<IEventAggregator>());private IEventAggregator EventAggregator => _lazyEventAggregator.Value;public object ProvideValue(IServiceProvider provider){// your logic here...}
}
相关链接
- 介绍(Introduction)
- 命令(Commands)
- 命令(Commanding)
- 复合命令(Composite Commands)
- 异步命令(Async Commands)
- 错误处理(Error Handling)
- 依赖注入(Dependency Injection)
- 依赖注入(Dependency Injection)
- 注册类型(Registering Types)
- 处理解析错误
- ContainerLocator