https://github.com/eran-gil/autofac.log4net

Autofac module for using the log4net logging framework
https://github.com/eran-gil/autofac.log4net

autofac autofac-container dependency-injection ioc log4net logging

Last synced: 6 days ago
JSON representation

Autofac module for using the log4net logging framework

• Host: GitHub
• URL: https://github.com/eran-gil/autofac.log4net
• Owner: eran-gil
• License: mit
• Created: 2017-04-09T15:50:20.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-01-06T20:05:05.000Z (almost 2 years ago)
• Last Synced: 2024-12-05T16:06:08.692Z (18 days ago)
• Topics: autofac, autofac-container, dependency-injection, ioc, log4net, logging
• Language: C#
• Homepage:
• Size: 63.5 KB
• Stars: 8
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Autofac.log4net

=====================

## Description

Autofac.log4net is a library that allows easy integration of log4net with the Autofac IoC container.

It contains a Log4NetModule to support injection of ILog properties and constructor parameter to instances created through the Autofac container.

[![CI Status](https://dev.azure.com/erangil/autofac.log4net/_apis/build/status/autofac.log4net%20CI?branchName=master)](https://dev.azure.com/erangil/autofac.log4net/_build/latest?definitionId=10&branchName=master)

## Requirements

- Supports .NET 4.6.1 and above.

- The package has 2 package dependencies:

    - log4net >= 2.0.8

    - Autofac >= 6.0.0

## Features

- If a class has a property or constructor parameter of type ILog, it will inject it with a logger.

    - The logger instance will be by default the logger with the class type name.

    - If the type/namespace of the class is mapped in the module, the logger instance will be the mapped logger.

- There are 2 type of mappings the Log4NetModule:

    1. Mapping by types.

    2. Mapping by namespaces - when injecting the logger, the most specific namespace mapping will be used.

- The module allows configuring the application to a custom logger configuration file and watching it.

## License:

[MIT License](https://github.com/erangil2/autofac.log4net/blob/master/LICENSE)

## Examples

#### Class with an ILog Constructor Parameter

```cs

public class InjectableClass {

    private readonly ILog _logger;

    

    public InjectableClass(ILog logger){

        _logger = logger;

    }

}

```

#### Class with an ILog Property

```cs

public class InjectableClass {

    public ILog Logger { get; set; }

}

```

#### Simple Module Registration

```cs

var builder = new ContainerBuilder();

builder.RegisterModule();

```

#### Custom Module Registration

```cs

var builder = new ContainerBuilder();

var loggingModule = new Log4NetModule("logger.config", true);

builder.RegisterModule(loggingModule);

```

#### Mapping Types and Namespaces to Loggers

```cs

var builder = new ContainerBuilder();

var loggingModule = new Log4NetModule();

loggingModule.MapTypeToLoggerName(typeof(InjectableClass), "Logger1");

loggingModule.MapNamespaceToLoggerName("Autofac.log4net", "Logger2");

builder.RegisterModule(loggingModule);

```