DP44/enriched-qwen3-coder-next/DTS Viewer/DTS.Viewer.Modules/DTS.Viewer.TestModification.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
DTS Viewer/DTS.Viewer.Modules/DTS.Viewer.TestModification/TestModificationModule.cs	2026-04-16T13:42:42.368236+00:00	zai-org/GLM-5-FP8	1	3f67001eaa6ddf3a

Documentation: DTS.Viewer.TestModification Module

1. Purpose

This module serves as the entry point for the "TestModification" feature within the DTS Viewer application. It is a Prism Module (IModule) responsible for registering its associated View (TestModificationView) and ViewModel (TestModificationViewModel) with the Unity dependency injection container. Additionally, it defines assembly-level metadata attributes that expose the module's name, icon, grouping, and region assignment to the main application shell, enabling the module to be discovered and displayed in the UI.

2. Public Interface

Classes

TestModificationModule

The main module class responsible for dependency injection registration.

• TestModificationModule(IUnityContainer unityContainer)
  • Constructor that accepts a reference to the Unity container via dependency injection.
• void RegisterTypes(IContainerRegistry containerRegistry)
  • Implements IModule.RegisterTypes. Calls the local Initialize() method to register views and view models.
• void OnInitialized(IContainerProvider containerProvider)
  • Implements IModule.OnInitialized. Currently contains no implementation logic.
• void Initialize()
  • Registers ITestModificationView to TestModificationView and ITestModificationViewModel to TestModificationViewModel with the Unity container.

TestModificationModuleNameAttribute

An assembly-level attribute providing the module's name as text.

• string AssemblyName { get; }
  • Returns the string representation of AssemblyNames.TestModification.
• Type GetAttributeType()
  • Returns typeof(TextAttribute).
• string GetAssemblyName()
  • Returns the AssemblyName property value.

TestModificationModuleImageAttribute

An assembly-level attribute providing image and categorization metadata for the module.

• BitmapImage AssemblyImage { get; }
  • Retrieves the module's image via AssemblyInfo.GetImage.
• string AssemblyName { get; }
  • Returns the string representation of AssemblyNames.TestModification.
• string AssemblyGroup { get; }
  • Returns eAssemblyGroups.Viewer.ToString().
• eAssemblyRegion AssemblyRegion { get; }
  • Returns eAssemblyRegion.TestModificationRegion.
• BitmapImage GetAssemblyImage()
  • Returns the AssemblyImage property.
• string GetAssemblyName()
  • Returns the AssemblyName property.
• string GetAssemblyGroup()
  • Returns the AssemblyGroup property.
• eAssemblyRegion GetAssemblyRegion()
  • Returns the AssemblyRegion property.

3. Invariants

• Module Name: The module is identified by the string "TestModification" in the [Module] attribute.
• Registration Mapping: ITestModificationView is strictly mapped to TestModificationView, and ITestModificationViewModel is strictly mapped to TestModificationViewModel.
• Attribute Usage: Both custom attributes are decorated with [AttributeUsage(AttributeTargets.Assembly, AllowMultiple = false)], ensuring they are applied only once per assembly.
• Region Assignment: The module is statically bound to eAssemblyRegion.TestModificationRegion.

4. Dependencies

Internal Dependencies

• DTS.Common: Used for AssemblyNames, AssemblyInfo, eAssemblyGroups, and eAssemblyRegion enums/helpers.
• DTS.Common.Interface: Defines TextAttribute and ImageAttribute, which the custom attributes inherit from.
• DTS.Viewer.TestModification (Local Namespace): The module references TestModificationView, TestModificationViewModel, and their interfaces (ITestModificationView, ITestModificationViewModel), which are expected to be defined elsewhere in this project/namespace.

External Dependencies

• Prism.Ioc: Provides IContainerProvider and IContainerRegistry.
• Prism.Modularity: Provides the IModule interface and ModuleAttribute.
• Unity: Provides IUnityContainer for specific dependency injection implementation.
• System.Windows.Media.Imaging: Provides BitmapImage for module imagery.

5. Gotchas

• Mixed Container Abstractions: The class uses IContainerRegistry (Prism abstraction) in RegisterTypes, but immediately delegates to the IUnityContainer (Unity specific) stored in a field to perform the actual registration. This bypasses Prism's container abstraction, making the module tightly coupled to Unity and potentially ignoring the containerRegistry parameter passed to RegisterTypes.
• Side Effects in Property Getters: In TestModificationModuleImageAttribute, the AssemblyImage property getter performs a file/resource load operation (AssemblyInfo.GetImage(...)) and overwrites the private _img field every time it is accessed. This is inefficient and violates standard property getter expectations of low cost and idempotency.
• Unused Constructor Parameters: The constructors for TestModificationModuleNameAttribute(string s) and TestModificationModuleImageAttribute(string s) accept a string parameter s that is never used in the method body.
• Redundant Method: The Initialize() method is public but appears to be legacy code or a specific pattern choice, as RegisterTypes is the standard Prism location for type registration. The separation serves no functional purpose given RegisterTypes immediately calls it.