dependency_injection_build 1.0.0.8

Welcome to the build wiki!

.NET Core 2.1 Dependency Injection framework

Maintainability

Community

Welcome to #build #slack

Channels

#slack

Repository

build

Docs

wiki

v1.0.0.8

• Added totally customizable type system
• Added ability to use interfaces as first-class objects

Examples

Customizable type system

• You can use interfaces as first-class objects instead of classes fot typeholders attributes
• Using interfaces as first-class objects, you will be able to eliminate the need to inject attributes into existing code
• By implemeting type system interfaces, you will get a fully customzable type system, easily
• Registration is bound to interfaces only, which can have a several metods named "Rule" (it is evil, i knew it)
• Type is being instantiatied is actually a return parameter of "Rule" method
• Arguments passed to the constructor is simply arguments of that particular rule
• You definetly can break some more rules, just do not try to build inconsistent type system.

Definition:

interface IMyFunRuleSet
{
    Type1 Rule(Arg1 arg1, Arg2 arg2);
}

class Type1
{
    public Type1(Arg1 arg1, Arg2 arg2)
    {
        Arg1 = arg1;
        Arg2 = arg2;
    }

    public Arg1 Arg1 { get; }

    public Arg2 Arg2 { get; }
}

Usage:

var container = new Container(new MyFunTypeConstructor(), new MyFunTypeFilter(), new MyFunTypeParser(), new MyFunTypeResolver());
container.RegisterType<IMyFunRuleSet>();
var type1 = container.CreateInstance("Build.Interfaces.Tests.Type1(Build.Interfaces.Tests.Arg1,Build.Interfaces.Tests.Arg2)");
Assert.NotNull(type1);

Goal

The goal of development of this framework is to build automation of complex types initialization. Build can use declarative approach to define dependencies between types and their requirements. Constructor injection uses type resolution to resolve devendencies

Examples

Create instance with parameters

Usage:

var container = new Container();
container.RegisterType<SqlDataRepository>();
container.RegisterType<ServiceDataRepository>();
var sql = new SqlDataRepository();
var srv1 = (ServiceDataRepository)container.CreateInstance(
    "UnitTests.TestSet14.ServiceDataRepository(UnitTests.TestSet14.SqlDataRepository)", sql);

Load simple types (not attributes specified)

Usage:

IContainer container = new Container();
container.RegisterType<SqlDataRepository>();
container.RegisterType<ServiceDataRepository>();
var srv1 = container.CreateInstance<ServiceDataRepository>();

API

Classes

Definition:

public interface IPersonRepository
{
    Person GetPerson(int personId);
}

public class Person
{
    readonly IPersonRepository _personRepository;

    public Person(IPersonRepository personRepository)
    {
        _personRepository = personRepository;
    }
}

public class SqlDataRepository : IPersonRepository
{
    public SqlDataRepository()
    {
    }

    public Person GetPerson(int personId)
    {
        // get the data from SQL DB and return Person instance.
        return new Person(this);
    }
}

public class ServiceDataRepository : IPersonRepository
{
    public ServiceDataRepository(SqlDataRepository repository)
    {
        Repository = repository;
    }
    public IPersonRepository Repository { get; }
    public Person GetPerson(int personId)
    {
        // get the data from Web service and return Person instance.
        return new Person(this);
    }
}

Continious Integration

CircleCI TravisCI

Academic papers:

Dependency Injection for Programming by Optimization, Zoltan A. Kocsis and Jerry Swan

1. School of Mathematics, University of Manchester, Oxford Road, Manchester M13 9PL, UK. zoltan.kocsis@postgrad.manchester.ac.uk
2. Computer Science, University of York, Deramore Lane, York, YO10 5GH, UK.

Links

Dependency injection in ASP.NET Core

Inversion of Control Containers and the Dependency Injection pattern

Donate

Please, feel free to donate me 5$ to expand project development (wiki, samples, etc.)