Register<T>(Action<T> postConstructionAction = null)

You can register an implementation class only using Services.Register<T>()

using DSoft.ServiceRegistrar;
...
Services.Register<TestImplementation4>();

You can also specify a post-construcion action to execute after the implementation has been instantiated.

using DSoft.ServiceRegistrar;
...
Services.Register<TestImplementation4>(obj =>
        {
            obj.Message = "Hello, init!";
        });

Register<T, T2>(Action<T2> postConstructionAction = null)

You can register an individual interface/implementation combination using Services.Register<T,T2>()

using DSoft.ServiceRegistrar;
...
Services.Register<ITestInterface4, TestImplementation4>();

You can also specify a post-construcion action to execute after the implementation has been instantiated.

using DSoft.ServiceRegistrar;
...
Services.Register<ITestInterface4, TestImplementation4>(obj =>
        {
            ((TestImplementation4)obj.Context).Message = "Hello, init!";
        });

Register(Assembly[])

Services.Register(Assembly[]) will process the specified assemblies to find instances of the DiscoverableServiceAttribute attribute and register them with the system.

DiscoverableServiceAttribute can be included anywhere in the assembly or within the class definition itself.

using DSoft.ServiceRegistrar;
...

[assembly: DiscoverableServiceAttribute(typeof(ITestInterface1), typeof(TestImplementation1))]
namespace TestImplementations
{
    public class TestImplementation1 : ITestInterface1
    {
        public int TestInt()
        {
            return 1;
        }
    }
}

Note: if the implementation class is decorated with the SingletonServiceAttribute then it will configured as a singleton and cached after the first instantiation.

Singletons

You can resgiter a implementation class as a singleton by adding the SingletonServiceAttribute attribute to the class definition either through Services.Register<T>(), Services.Register<T,T2>() or Services.Register(Assembly[])

using DSoft.ServiceRegistrar;
...

[SingletonService]
public class TestImplementation2 : ITestInterface2
{
    public int TestInt()
    {
        return 2;
    }
}

Note: if the implementation class is decorated with the SingletonServiceAttribute then it will configured as a singleton and cached after the first instantiation

Get

To access the implementation of a interface you call Services.Get<T>(). This will return an instance of the implementation of the interface.

using DSoft.ServiceRegistrar;
...
var serv4 = Services.Get<ITestInterface4>();
serv4.DoAThing();

You can also pass through initialisation objects that can be passed to a matching constructor within the implementation class.

using DSoft.ServiceRegistrar;
...
var serv = Services.Get<ITestInterface2>();

var result = serv.TestInt();

var serv2 = Services.Get<TestInterface3>(new object[] { serv });

If the service is a singleton and a post-construcion action is defined, it will be executed the first time the implementation is instantiated.

Dependency Injection

ServiceRegistrar can inject dependencies from other registered interface implementations, but only under the following conditions.

• There can be only one constructor on the implementing class of the service being requested
  • It can have more than one parameter but they must be references to other registered interfaces
• Each implementating class, that is being injected, can have only one constructor that:
  • Either has no parameters
  • Or references other registered interface implementations
• Dependency Injection is ignored if intitilization objects are passed to Services.Get<T>()

Note: Work will be done on the Depdency Injection to remove some of the limitations