Open.Infra 1.0.9

Introduce

OpenInfra is an universal infrastructure library designed to provide developers with common and universal basic functional modules, helping to quickly build efficient and reliable applications.

Features

• Automatically handle uncaught exceptions
  • You must create logs\crash firstly if you want record crash information.
• Manage services to achieve decoupling
• Application running state support
• Some useful tool classes

Usage

• Call initialize on you app startup.

InfraApp.Instance.Start();

Classes

InfraApp

Initialize

Should be called before all other operations.

Explore

Explore the app directory

Sleep

Sleep special time and return true, if process is closing return false.

Services manager.

Mapping manager for service interfaces to service instances.

API Reference

Load()

Try load service from "services" directory.

Load(IEnumerable<string> files)

Loads service implementations from a DLL and registers them.

This operation should only be executed once when the main program starts.

// Add your service assembly files to a list(You can user your seach logic to make it).
var files = new List<string> { "a.dll", "b.dll", "c.dll" };

// Load assemblies
ServiceManager.Instance.Load(files)

T Singleton<T>()

T Singleton<T>(string name)

Retrieves a singleton instance of the service.

// Get unique log service.
var logService = ServiceManager.Instance.Singleton<ILogService>();

// Get log service  or with name
var mainLogService = ServiceManager.Instance.Singleton<ILogService>("main");

T Create<T>()

Creates a new instance of the service.

var service = ServiceManager.Instance.Create<ILogService>();

Debug

Add your own debug information output function if you need.

 ServiceManager.Instance.Log = (message) =>
 {
     Console.WriteLine(message);
 };

SafeAction

SafeAction<int> bufferedDelegate = new SafeAction<int>(3);
bufferedDelegate.Invoke(1);
bufferedDelegate += arg => Console.WriteLine($"Execute: {arg}");
bufferedDelegate.Invoke(2);

CacheAction

CacheAction _cacheAction = new CacheAction();
public event Action<string>? UserHandler
{
    add
    {
        if (value != null) return;
        _cacheAction.Attach((args) =>
        {
            value.Invoke((string)args[0]);
        });
    }
    remove {...}
}

public void Execute(string user)
{
    _cacheAction.Run(user);
}

DebugHelper

IsDebugMode

• Setting the environment variable DebugMode=true is considered debugging mode

Measure

• Measure function execution time

Directories

• Manage various directories of the program, create subdirectories in the directory where the program is located by default, and redirect to other locations through same name environment variables

string Get(string name)

• Get the full path of the directory with the specified name

SettingBase

• a base class for configuration

static T Load<T>(string filename)

• Loads a configuration instance from xml file, if the file not exist create a default.
• The first instance of the configuration type can be automatically loaded
• The config is suggested to be single instance.

void Save()

• Write the instance to xml, the instance should be created by Load function.

License

Copyright (c) [2025] [OpenCommon]. All rights reserved.

This software is provided "as-is" without any warranties. You may not modify, distribute, or reverse-engineer this software without explicit permission from the author.