Basilisque.DependencyInjection 1.0.0-RC13

Basilisque - Dependency Injection

Overview

This project provides functionality to easily register all services of the target project at the IServiceCollection.

Description

This project contains functionality for registering services at the IServiceCollection.
It also contains a source generator, that generates code to registers all services of the target project.
The services simply have to be marked with an attribute. The attribute can also be attached to base classes or interfaces. This means that all implementations of the base class or interface will be automatically registered.

The generated code is marked as partial. This means it can be easily extended with custom logic.

Getting Started

Install the NuGet package Basilisque.DependencyInjection.
Installing the package will also install the package Basilisque.DependencyInjection.CodeAnalysis as a child dependency. This contains the source generator.

Now you're ready to register your first service.

Features

• Generates code that registers all marked services of a project.
  This means anyone who uses your project can call a single method to register all of your provided services.

• The generated code automatically calls the registration methods of all dependencies that also use Basilisque.DependencyInjection.
  This means if you use Basilisque.DependencyInjection in multiple related projects, you have to call the registration method only once and all dependencies will be registered, too.

• Configuration of the registration

  • Lifetime (Transient, Scoped, Singleton)
  • Type as that the service will be registered can be specified
  • ImplementsITypeName
    When the service implements an interface with the same name but starting with an I, it will be registered as this interface (e.g. 'PersonService' as 'IPersonService').

• Marker attributes on interfaces and base classes.
  This means for example, that you can register all implementations of an interface with the same configuration and you don't have to worry about registration whenever you create a new implementation of it.

• Custom marker attributes
  You can create custom attributes with predefined configuration by inheriting from the provided attributes. Whenever you use your attribute you can be sure, that the same configuraiton will be used.

• Multiple registrations of the same service
  A service can have multiple registrations with different configurations.

Examples

All implementations of this interface will be registered as singleton:

[RegisterServiceSingleton()]
public interface IMyInterface
{
}

You can get the same result writing it like this:

[RegisterService(RegistrationScope.Singleton)]
public interface IMyInterface
{
}

For details see the wiki.

License

The Basilisque framework (including this repository) is licensed under the Apache License, Version 2.0.