DP44/enriched-qwen3-coder-next/DTS Viewer/DTS.Viewer.Loader.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
DTS Viewer/DTS.Viewer.Loader/App.xaml.cs DTS Viewer/DTS.Viewer.Loader/MainWindow.xaml.cs DTS Viewer/DTS.Viewer.Loader/ViewerLoaderSession.cs DTS Viewer/DTS.Viewer.Loader/Bootstrapper.cs	2026-04-16T13:36:22.431378+00:00	zai-org/GLM-5-FP8	1	d7175f2d8133b4b4

Documentation: DTS.Viewer.Loader

1. Purpose

The DTS.Viewer.Loader assembly serves as the initialization and bootstrapping layer for a WPF-based DTS Viewer application. It leverages the Microsoft Prism framework (specifically UnityBootstrapper) to configure dependency injection, dynamically load runtime modules from a predefined directory, and initialize the primary application shell (ShellView) and viewer session. Its role is to act as the entry point that orchestrates the composition of the UI and backend services before handing control over to the loaded modules.

2. Public Interface

Class: App (inherits Application)

• App_OnStartup(object sender, StartupEventArgs e): Private event handler for the application startup. It instantiates ViewerLoaderSession and invokes CreateSession() to initialize the application logic.

Class: MainWindow (inherits Window)

• MainWindow(): Constructor. Calls InitializeComponent(). Note: Based on Bootstrapper logic, this window appears to be unused in the main startup flow, which favors ShellView.

Class: ViewerLoaderSession

• CreateSession(): Public method that initializes the Prism infrastructure. It creates the Bootstrapper, resolves the IUnityContainer, IEventAggregator, IServiceLocator, and IRegionManager, and then starts the viewer session via IViewerModule.
• Terminate(): Public method intended for shutdown/cleanup logic (currently empty implementation).
• Properties:
  • _unityContainer (IUnityContainer): Provides access to the Unity dependency injection container.
  • ServiceLocator (IServiceLocator): Provides access to the service locator abstraction.
  • EventAggregator (IEventAggregator): Provides access to the Prism event aggregation system.
  • RegionManager (IRegionManager): Manages the visual regions of the application.

Class: Bootstrapper (inherits UnityBootstrapper)

• ConfigureContainer(): Override that registers IShellView and IShellViewModel with the Unity container.
• CreateShell(): Override that resolves the shell view model, initializes the view, sets its data context, and returns the ShellView instance.
• CreateModuleCatalog(): Override that initializes an AggregateModuleCatalog.
• ConfigureModuleCatalog(): Override that adds a DirectoryModuleCatalog pointing to the plugin folder defined in settings.
• InitializeModules(): Override that registers IDTSRegionManager as a singleton and initializes modules.

3. Invariants

• Singleton ViewModels: IShellViewModel is registered with a ContainerControlledLifetimeManager, ensuring only one instance of the Shell ViewModel exists during the application lifetime.
• Region Adapter Mappings: The ConfigureRegionAdapterMappings method is explicitly overridden to return null. This implies that region adapters must be defined elsewhere or are not used/required by the shell initialization logic in this specific bootstrapper.
• Module Loading Location: Modules are strictly loaded from the directory specified in Properties.Settings.Default.PluginFolder.
• Shell Initialization: The CreateShell method requires IShellViewModel to be resolvable; otherwise, it returns a generic DependencyObject (which effectively results in no main window being shown).

4. Dependencies

External Dependencies

• Microsoft.Practices.Prism: Specifically Events, Modularity, Regions, and UnityExtensions.
• Microsoft.Practices.Unity: Used for Dependency Injection (IUnityContainer, ContainerControlledLifetimeManager).
• Microsoft.Practices.ServiceLocation: Used for the IServiceLocator abstraction.
• System.Windows: WPF core libraries for Application, Window, DependencyObject.

Internal Dependencies

• DTS.Common: Referenced in ViewerLoaderSession.
• DTS.Common.Base: Referenced in ViewerLoaderSession.
• DTS.Common.Classes: Referenced in ViewerLoaderSession.
• DTS.Common.Core.PluginLib: Used for PluginManager and IModule.
• DTS.Common.Interface: Used for interfaces such as IShellView, IShellViewModel, IViewerModule, IViewerMainViewModel, IDTSRegionManager.

5. Gotchas

• Hardcoded Configuration Path: In ViewerLoaderSession.CreateSession(), the path @"C:\devDTS\RunTimeModules\DTS.Viewer.dll.config" is hardcoded as an argument to viewerModule.StartSession. This will likely cause the application to fail on machines without this specific directory structure.
• Swallowed Exception: Bootstrapper.ConfigureContainer() catches System.Threading.SynchronizationLockException inside a try/catch block with an empty catch body. This suppresses a potential threading error which could mask underlying race conditions.
• Unused MainWindow: The project contains a MainWindow class, but the Bootstrapper.CreateShell() method explicitly creates and shows a ShellView. The MainWindow appears to be dead code or a legacy artifact.
• Memory Constraints: The source code comments in ViewerLoaderSession explicitly warn against re-creating the bootstrapper, noting that it loads ~40MB into memory and cannot be easily unloaded.
• Application Exit Code: The Bootstrapper_Closing event handler calls Application.Current.Shutdown(1), passing an exit code of 1, which conventionally indicates an error or abnormal termination, even though this is the standard closing flow.