DP44/enriched-partialglm/DTS Viewer/DTS.Viewer.Reports/DTS.Viewer.PSDReportSettings.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
DTS Viewer/DTS.Viewer.Reports/DTS.Viewer.PSDReportSettings/PSDReportSettingsModule.cs	2026-04-16T10:59:04.135002+00:00	zai-org/GLM-5-FP8	1	272bb780c04413d3

Documentation: PSDReportSettingsModule

1. Purpose

This module serves as the entry point for the "PSD Report Settings" feature within the DTS Viewer application. It is a Prism Module (PSDReportSettingsModule) responsible for registering its associated View, ViewModel, and Model dependencies with the Unity dependency injection container. Additionally, it defines assembly-level attributes to expose metadata (name, image, grouping, and region) to the main application shell, allowing the module to be discovered and displayed in the UI as an available component.

2. Public Interface

Classes

PSDReportSettingsModule Inherits from: IModule

• PSDReportSettingsModule(IUnityContainer unityContainer): Constructor that accepts a IUnityContainer instance and stores it in a readonly field.
• void RegisterTypes(IContainerRegistry containerRegistry): Implements IModule.RegisterTypes. Executes the Initialize() method to register types with the container.
• void OnInitialized(IContainerProvider containerProvider): Implements IModule.OnInitialized. Currently contains no implementation logic.
• void Initialize(): Registers the following interface-to-concrete-type mappings using the injected _unityContainer:
  • IPSDReportSettingsViewModel → PSDReportSettingsViewModel
  • IPSDReportSettingsModel → PSDReportSettingsModel
  • IPSDReportSettingsView → PSDReportSettingsView

PSDReportSettingsModuleNameAttribute Inherits from: TextAttribute

• [AttributeUsage(AttributeTargets.Assembly, AllowMultiple = false)]
• PSDReportSettingsModuleNameAttribute(): Default constructor.
• PSDReportSettingsModuleNameAttribute(string s): Overloaded constructor (parameter s is unused).
• string AssemblyName { get; }: Overrides the base property. Returns the string representation of AssemblyNames.PSDReportSettings.
• Type GetAttributeType(): Returns typeof(TextAttribute).
• string GetAssemblyName(): Returns the value of the AssemblyName property.

PSDReportSettingsModuleImageAttribute Inherits from: ImageAttribute

• [AttributeUsage(AttributeTargets.Assembly, AllowMultiple = false)]
• PSDReportSettingsModuleImageAttribute(): Default constructor.
• PSDReportSettingsModuleImageAttribute(string s): Overloaded constructor (parameter s is unused).
• BitmapImage AssemblyImage { get; }: Returns a BitmapImage retrieved via AssemblyInfo.GetImage(AssemblyNames.PSDReportSettings.ToString()).
• string AssemblyName { get; }: Returns the string representation of AssemblyNames.PSDReportSettings.
• string AssemblyGroup { get; }: Returns eAssemblyGroups.Viewer.ToString().
• eAssemblyRegion AssemblyRegion { get; }: Returns eAssemblyRegion.PSDReportSettingsRegion.
• Type GetAttributeType(): Returns typeof(ImageAttribute).
• BitmapImage GetAssemblyImage(): Returns AssemblyImage.
• string GetAssemblyName(): Returns AssemblyName.
• string GetAssemblyGroup(): Returns AssemblyGroup.
• eAssemblyRegion GetAssemblyRegion(): Returns AssemblyRegion.

3. Invariants

• Module Name: The module is identified by the string "PSDReportSettings" in the [Module] attribute.
• Assembly Group: The module belongs to the Viewer assembly group (defined by eAssemblyGroups.Viewer).
• Region: The module is associated with the PSDReportSettingsRegion (defined by eAssemblyRegion.PSDReportSettingsRegion).
• Registration: The types IPSDReportSettingsViewModel, IPSDReportSettingsModel, and IPSDReportSettingsView are registered with the Unity container as transient types (default RegisterType behavior) upon module initialization.

4. Dependencies

Internal Dependencies (referenced types):

• DTS.Common: Uses AssemblyNames enum.
• DTS.Common.Interface: Uses TextAttribute, ImageAttribute, eAssemblyGroups, eAssemblyRegion. Also implies the existence of IPSDReportSettingsViewModel, IPSDReportSettingsModel, and IPSDReportSettingsView interfaces.
• DTS.Viewer.PSDReportSettings: Uses PSDReportSettingsViewModel, PSDReportSettingsModel, PSDReportSettingsView concrete classes and AssemblyInfo static class.

External Frameworks:

• Prism.Ioc: Uses IContainerProvider, IContainerRegistry.
• Prism.Modularity: Uses IModule, ModuleAttribute.
• Unity: Uses IUnityContainer.
• System.Windows.Media.Imaging: Uses BitmapImage.

5. Gotchas

• Ignored Constructor Parameters: Both PSDReportSettingsModuleNameAttribute and PSDReportSettingsModuleImageAttribute have constructors that accept a string s parameter, but this parameter is completely ignored in the logic. It is unclear why this parameter exists.
• Mixed Container Usage: The RegisterTypes method receives an IContainerRegistry (Prism abstraction) but the actual registration logic inside Initialize() uses the injected IUnityContainer (Unity specific). This bypasses the Prism abstraction layer, which could cause issues if the container implementation details differ or if the container wrapper is expected to manage lifestyle scopes.
• Property Getter Side Effects: In PSDReportSettingsModuleImageAttribute, the AssemblyImage property getter performs a method call AssemblyInfo.GetImage(...) and assigns it to the private field _img every time the getter is accessed. This is not a pure getter; it causes a new image lookup (and potentially a new object allocation) on every read access, rather than returning a cached value.
• Empty OnInitialized: The OnInitialized method is empty. If the module requires runtime initialization logic (like starting services or registering region views), it is not present here. The module currently only performs type registration.