DP44/enriched-qwen3-coder-next/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-16T13:37:20.992121+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 specific View, ViewModel, and Model implementations with the Unity dependency injection container. Additionally, it defines assembly-level attributes to expose metadata (name, image, group, and region) to the main application shell, enabling the module to be discovered and displayed as an available component.

2. Public Interface

Class: PSDReportSettingsModule

Implements Prism.Modularity.IModule.

• Constructor: PSDReportSettingsModule(IUnityContainer unityContainer)
  • Accepts an IUnityContainer instance via constructor injection and stores it in a readonly field.
• Method: void Initialize()
  • Registers three type mappings in the Unity container:
    • IPSDReportSettingsViewModel mapped to PSDReportSettingsViewModel.
    • IPSDReportSettingsModel mapped to PSDReportSettingsModel.
    • IPSDReportSettingsView mapped to PSDReportSettingsView.
• Method: void RegisterTypes(IContainerRegistry containerRegistry)
  • Implements IModule.RegisterTypes. It invokes the Initialize() method.
• Method: void OnInitialized(IContainerProvider containerProvider)
  • Implements IModule.OnInitialized. This method is currently empty.

Class: PSDReportSettingsModuleNameAttribute

Inherits from TextAttribute.

• Constructor: PSDReportSettingsModuleNameAttribute() / PSDReportSettingsModuleNameAttribute(string s)
  • Hardcodes the AssemblyName property to AssemblyNames.PSDReportSettings.ToString(). The string argument s in the overloaded constructor is ignored.
• Property: string AssemblyName { get; }
  • Returns the hardcoded assembly name string.
• Method: Type GetAttributeType()
  • Returns typeof(TextAttribute).
• Method: string GetAssemblyName()
  • Returns the value of the AssemblyName property.

Class: PSDReportSettingsModuleImageAttribute

Inherits from ImageAttribute.

• Constructor: PSDReportSettingsModuleImageAttribute() / PSDReportSettingsModuleImageAttribute(string s)
  • Initializes a private BitmapImage field (_img) by calling AssemblyInfo.GetImage. The string argument s is ignored.
• Property: BitmapImage AssemblyImage { get; }
  • Gets the image by calling AssemblyInfo.GetImage with the AssemblyNames.PSDReportSettings enum value.
• Property: string AssemblyName { get; }
  • Returns AssemblyNames.PSDReportSettings.ToString().
• Property: string AssemblyGroup { get; }
  • Returns eAssemblyGroups.Viewer.ToString().
• Property: eAssemblyRegion AssemblyRegion { get; }
  • Returns eAssemblyRegion.PSDReportSettingsRegion.
• Methods:
  • 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 Prism module is identified by the string "PSDReportSettings" via the [Module] attribute.
• Assembly Attributes: The assembly is decorated with both PSDReportSettingsModuleNameAttribute and PSDReportSettingsModuleImageAttribute with AllowMultiple = false.
• Registration Mapping: The Initialize method guarantees that IPSDReportSettingsViewModel, IPSDReportSettingsModel, and IPSDReportSettingsView are registered with the container upon module initialization.
• Region Assignment: This module is statically bound to the region eAssemblyRegion.PSDReportSettingsRegion.

4. Dependencies

Internal Dependencies

• DTS.Common: Referenced for AssemblyNames, AssemblyInfo, eAssemblyGroups, and eAssemblyRegion.
• DTS.Common.Interface: Referenced for base classes TextAttribute and ImageAttribute.
• Local Types: The module depends on the existence of PSDReportSettingsViewModel, PSDReportSettingsModel, and PSDReportSettingsView (and their corresponding interfaces), though these types are not defined in the provided source snippet.

External Dependencies

• Prism.Ioc: For IContainerProvider and IContainerRegistry.
• Prism.Modularity: For IModule and ModuleAttribute.
• Unity: For IUnityContainer (used for specific registration logic).
• System.Windows.Media.Imaging: For BitmapImage.

Consumers

• The DTS Viewer main application shell (inferred from the module structure and eAssemblyGroups.Viewer group assignment).

5. Gotchas

• Mixed Container Abstractions: The module implements IModule, which provides a RegisterTypes(IContainerRegistry containerRegistry) method intended for container-agnostic registration. However, the implementation ignores the containerRegistry argument and instead uses the injected IUnityContainer instance via the Initialize() method. This ties the module specifically to Unity, bypassing Prism's container abstraction layer.
• Redundant Constructor Arguments: Both attribute classes possess constructors accepting a string s argument. This argument is unused in both constructors, suggesting legacy code or a requirement of the base attribute constructor signature that was implemented but not utilized.
• Property Side Effects: In PSDReportSettingsModuleImageAttribute, the getter for AssemblyImage re-executes AssemblyInfo.GetImage(...) and reassigns the private field _img every time it is accessed, rather than returning the cached value.
• Empty OnInitialized: The OnInitialized method is explicitly empty. If the View needs to be loaded into a region automatically upon startup, that logic is absent from this module class.