forked from dadhi/DryIoc
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathHome.cs
173 lines (126 loc) · 6.09 KB
/
Home.cs
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
/*md
<!--Auto-generated from .cs file, the edits here will be lost! -->
# Wiki Home
[TOC]
## Getting Started
Let's define a simple interface and implementation setup:
```cs md*/
// these usings are for later
using DryIoc;
using NUnit.Framework;
// ReSharper disable UnusedVariable
public interface IService { }
public class SomeService : IService { }
// A client consuming the `IService` dependency
public interface IClient
{
IService Service { get; }
}
public class SomeClient : IClient
{
public IService Service { get; }
public SomeClient(IService service) { Service = service; }
} /*md
```
To illustrate the idea of Dependency Injection container, we will start from the problem.
Let's create `SomeClient` by hand, but with [DI principle](http://en.wikipedia.org/wiki/Dependency_inversion_principle) in mind:
```cs md*/
class Created_manually
{
[Test]
public void Example()
{
IClient client = new SomeClient(new SomeService());
}
} /*md
```
The manual implementation is a hard-wired - we are using implementation types `SomeClient` and `SomeService` in-place of
creation of `IClient`. What if we need to change `SomeService` to the `TestService` later, may be after the code for
`IClient` creation is compiled. To enable such scenario, we need a kind of configuration what interface is implemented by
what type. The configuration should be decoupled from actual creation code, in order to be changed independently.
Here goes the DI / IoC container!
Let's try DryIoc:
```cs md*/
class Created_by_DryIoc
{
private IContainer _container;
[SetUp]
public void Configure_types()
{
_container = new Container();
_container.Register<IClient, SomeClient>();
_container.Register<IService, SomeService>();
}
[Test]
public void Create_client()
{
var client = _container.Resolve<IClient>();
Assert.IsInstanceOf<SomeClient>(client);
}
} /*md
```
In the example with DryIoc, configuration of types is separate from the resolution, so that both can be changed independently.
Now we have a configurator and creator Container, the provider of the service instances for our program.
Given that container controls the creation, we may logically extend it further to [control the lifetime](ReuseAndScopes)
as well.
Summarizing, DI / IoC container is the tool to enforce [Open-Closed principle](http://msdn.microsoft.com/en-us/magazine/cc546578.aspx)
and to support __extensibility__ and __testability__ of our code.
## User's Guide
- [Installing DryIoc](InstallationOptions.md)
- [Creating and Disposing Container](CreatingAndDisposingContainer.md)
- [Register and Resolve](RegisterResolve.md)
- [Open-generics](OpenGenerics.md)
- [Specify Constructor or Factory Method](SelectConstructorOrFactoryMethod.md)
- [Specify Dependency or Primitive Value](SpecifyDependencyAndPrimitiveValues.md)
- [Reuse and Scopes](ReuseAndScopes.md)
- [Wrappers](Wrappers.md)
- [Decorators](Decorators.md)
- [Error Detection and Resolution](ErrorDetectionAndResolution.md)
- [Rules and Default Conventions](RulesAndDefaultConventions.md)
- Advanced topics:
- ["Child" Containers](KindsOfChildContainer.md)
- [Required Service Type](RequiredServiceType.md)
- [Examples of context based resolution](ExamplesContextBasedResolution.md)
- [Un-registering service and Resolution Cache](UnregisterAndResolutionCache.md)
- [Auto-mocking in tests](UsingInTestsWithMockingLibrary.md)
- [Interception](Interception.md)
- [Thread-Safety](ThreadSafety.md)
- FAQs
- [FAQ - Migration from Autofac](FaqAutofacMigration.md)
## Companions
- [DryIocZero](Companions/DryIocZero)
- [DryIocAttributes](Companions/DryIocAttributes)
## Extensions
- [DryIoc.MefAttributedModel](Extensions/MefAttributedModel)
for [MEF Attributed Model](http://msdn.microsoft.com/en-us/library/ee155691(v=vs.110).aspx)
- ASP.NET:
- [DryIoc.Web](https://www.nuget.org/packages/DryIoc.Web/)
- [DryIoc.Mvc](https://www.nuget.org/packages/DryIoc.WebApi.dll/)
- [DryIoc.WepApi](https://www.nuget.org/packages/DryIoc.WebApi.dll/)
- [DryIoc.SignalR](Extensions/SignalR)
- [DryIoc.Microsoft.DependencyInjection](https://www.nuget.org/packages/DryIoc.Microsoft.DependencyInjection) adapter for [.NET Core DI](https://github.com/aspnet/DependencyInjection)
- OWIN:
- [DryIoc.Owin](https://www.nuget.org/packages/DryIoc.Owin.dll/)
- [DryIoc.WebApi.Owin](https://www.nuget.org/packages/DryIoc.WebApi.Owin.dll/)
- [Nancy.Bootstrappers.DryIoc](https://www.nuget.org/packages/Nancy.Bootstrappers.DryIoc/) for [NanxyFX](http://nancyfx.org/)
- [Common Service Locator](https://www.nuget.org/packages/DryIoc.CommonServiceLocator.dll/)
## Samples
Located in this repo:
- [DryIoc.WebApi.Owin.Sample](https://bitbucket.org/dadhi/dryioc/src/8e609b011beafd71236f9cfe3bb2d3e0589e76ae/Extensions/DryIoc.WebApi.Owin.Sample/?at=default)
- [DryIoc.AspNetCore.Sample](https://bitbucket.org/dadhi/dryioc/src/8e609b011beafd71236f9cfe3bb2d3e0589e76ae/NetCore/src/DryIoc.AspNetCore.Sample/?at=default)
External links:
- [DryIoc.WebApi sample](https://github.com/graftedbranch/dryiocwebapi.sample)
- [DryIoc with Owin, JWT, Angular.js](https://github.com/lcssk8board/owin-jwt-angularjs)
- [DryIoc for NancyFx](https://github.com/lcssk8board/DryIoc-Nancy) with
[Nancy.SelfHosted.HelloWorld](https://github.com/lcssk8board/DryIoc-Nancy/tree/master/source/Nancy.Bootstrappers.DryIoc/Nancy.SelfHosted.HelloWorld)
- [DryIoc with MediatR](
https://github.com/jbogard/MediatR/blob/master/samples/MediatR.Examples.DryIoc/Program.cs)
## Latest Version
Get from NuGet:
- __DryIoc.dll__ [](https://www.nuget.org/packages/DryIoc.dll)
- __DryIoc__ (source code) [](https://www.nuget.org/packages/DryIoc)
- __DryIoc.Internal__ (source code with public types made internal) [](https://www.nuget.org/packages/DryIoc.Internal)
### v4.2.0 / 2020-05-18
[Release Notes](https://github.com/dadhi/DryIoc/releases/tag/v4.2.0)
### [Previous Versions](VersionHistory.md)
md*/