IInitialize 1.0.2

Description

IInitialize is an interface that defines a contract for initialization processing. Implementing this interface indicates that an object requires an initialization phase.

This interface provides a single event, Initialize, which is raised when the initialization process is complete.

The Initialize event uses the generic InitializeEventHandler<TSender> delegate, where TSender represents the type of the object that raised the event. Event handlers receive an InitializeEventArgs object, which can contain arguments related to the initialization process, such as information about already initialized properties.

By utilizing this interface, other components or services can asynchronously be notified of the initialization completion of objects implementing IInitialize. This can be useful for scenarios such as starting dependent processes or updating the UI after initialization.

Key Elements:

• IInitialize(Of TSender): The interface to be implemented by objects requiring initialization. TSender specifies the type of the object raising the event.
• InitializeEventHandler(Of TSender) Delegate: Defines the type for the Initialize event's handlers.
• Initialize Event: An event that is raised when initialization processing is complete.
• InitializeEventArgs Class: Provides arguments related to the event, such as information about already initialized properties.

Providing this interface as a library allows you to establish a consistent initialization pattern across your applications, improving code reusability and maintainability.

(Usage Example for C# Developers):

Here's a basic example of how a C# class might implement and use the IInitialize interface, noting that InitializeEventArgs is nullable:

public class MyService : IInitialize<MyService>
{
    public event InitializeEventHandler<MyService> Initialize;

    public void BeginInitialization()
    {
        // Perform initialization tasks here
        Console.WriteLine("MyService is initializing...");
        OnInitialize(null); // InitializeEventArgs can be null
    }

    protected virtual void OnInitialize(InitializeEventArgs? e)
    {
        Initialize?.Invoke(this, e);
    }
}

public class Consumer
{
    public Consumer(MyService service)
    {
        service.Initialize += (sender, e) =>
        {
            Console.WriteLine("MyService has been initialized!");
            // Perform actions that depend on MyService being initialized
        };
    }
}

Release Notes

Version 1.0.0 Release Notes

• Introduction of the IInitialize(Of TSender) Interface:

  • Introduced the IInitialize(Of TSender) interface, which defines an event related to initialization processing.
  • Implementing this interface indicates that an object requires an initialization phase.
  • Defines the Initialize event of type InitializeEventHandler(Of TSender).

• Introduction of the InitializeEventArgs Structure:

  • Introduced the InitializeEventArgs structure, which stores event arguments related to initialization processing.
  • This structure is nullable, so pay attention to the nullable operator.
  • Contains a nested structure AlreadyInitializedProperty to store information about already initialized properties.
  • The AlreadyInitializedProperty structure stores the name and value of an already initialized property and has a constructor that takes these as arguments.
  • The InitializeEventArgs structure has an AlreadyInitialized property that gets the collection of already initialized properties.
  • The InitializeEventArgs structure has constructors that accept either an IEnumerable(Of AlreadyInitializedProperty) or a variable number of AlreadyInitializedProperty objects as arguments.

• Introduction of the InitializeEventHandler(Of TSender) Delegate:

  • Introduced the InitializeEventHandler(Of TSender) delegate, which represents a handler for events related to initialization processing.
  • Takes the object that raised the event and an InitializeEventArgs object containing arguments related to the event as parameters.

Version 1.0.1 Release Notes

• The author has been changed.

Version 1.0.2 Release Notes

• Constructor Added to InitializeEventArgs Structure:
  • Added a new constructor to the InitializeEventArgs structure that accepts a variable number of AlreadyInitializedProperty objects as arguments.
  • This allows for easier creation of InitializeEventArgs instances by individually specifying already initialized properties.

Example:

InitializeEventArgs args = new InitializeEventArgs(
    new AlreadyInitializedProperty("Property1", 1),
    new AlreadyInitializedProperty("Property2", "value")
);