【テクニカル・上級編】【上級者向け】VB.NETとWPFによるMVVMパターンにおけるDI(依存性注入)コンテナ(Microsoft.Extensions.DependencyInjection)の導入 – Visual Basic (VB / VB.NET)解析バイブル

スポンサーリンク
スポンサーリンク

VB.NETとWPFにおけるDIコンテナの真髄:疎結合なアーキテクチャへの昇華

大規模なエンタープライズ・アプリケーションの保守、あるいはレガシーなWinForms資産をWPFへとモダン化するプロセスにおいて、我々エンジニアが直面する最大の敵は「密結合(Tight Coupling)」である。

`New` キーワードによってViewModelの中でサービスを直接インスタンス化する。その瞬間、コードのユニットテストは不可能になり、メモリの解放タイミングは制御不能となり、システムの拡張性は死に絶える。

本稿では、`Microsoft.Extensions.DependencyInjection` を用い、VB.NETとWPFの境界にDI(依存性注入)を組み込むことで、オブジェクトのライフサイクルを完全に掌握し、堅牢なアーキテクチャを構築するための極限の知見を共有する。

1. 密結合という名の「技術的負債」からの脱却

多くの開発者が陥る罠は、ViewModelが「何をするか」ではなく「どう作るか」を知っている状態だ。

' --- 避けるべきアンチパターン ---
Public Class MainViewModel
    Private ReadOnly _hardwareService As New HardwareService() ' 直接生成している

    Public Sub New()
        ' これでは HardwareService が内部で Win32 API を叩いていても、
        ' テスト時に Mock に差し替えることができない
    End Sub
End Class

この設計では、`HardwareService` が Windows API を呼び出して物理デバイスを操作する場合、テスト実行時にも実機が必要となる。これはCI/CDパイプラインにおける致命的な欠陥だ。

我々が目指すべきは、「依存関係は外部から注入されるもの」という原則である。

2. 実装:DIコンテナによる依存性の管理

まずは、`Microsoft.Extensions.DependencyInjection` をプロジェクトに導入することから始める。次に、インターフェースに基づいた設計を行う。

2.1 サービスの定義と Win32 API のカプセル化

レガシーなシステムとの連携では、Windows API (P/Invoke) の呼び出しが不可避となる。これをサービスとして抽象化し、DIの管理下に置く。

Imports System.Runtime.InteropServices

''' <summary>
''' ハードウェア制御の抽象インターフェース
''' </summary>
Public Interface IHardwareService
    Implements IDisposable

    Function GetSystemStatus() As String
End Interface

''' <summary>
''' Win32 API を用いた実体実装
''' </summary>
Public Class HardwareService
    Implements IHardwareService

    ' Windows API の宣言 (例: GetTickCount)
    <DllImport("kernel32.dll")>
    Private Shared Function GetTickCount() As UInt32
    End Function

    Private _isDisposed As Boolean = False

    Public Function GetSystemStatus() As String Implements IHardwareService.GetSystemStatus
        ' 低レイヤーの API 呼び出しをカプセル化
        Dim tick As UInt32 = GetTickCount()
        Return $"System Uptime: {tick} ms"
    End Function

    ''' <summary>
    ''' オブジェクトのライフサイクル管理(メモリ最適化)
    ''' </summary>
    Public Sub Dispose() Implements IDisposable.Dispose
        If Not _isDisposed Then
            ' Win32 ハンドルなどの明示的な解放処理をここに記述
            _isDisposed = True
        End If
    End Sub
End Class

2.2 ViewModel へのコンストラクタインジェクション

ViewModel は、インターフェースのみを知っていればよい。

''' <summary>
''' DIによって注入される ViewModel
''' </summary>
Public Class MainViewModel
    Implements INotifyPropertyChanged

    Private ReadOnly _hardwareService As IHardwareService
    Private _statusText As String

    ' コンストラクタによるインジェクション
    ' 実装クラスではなく、インターフェースに依存させる
    Public Sub New(hardwareService As IHardwareService) Implements New
        _hardwareService = hardwareService
    End Sub

    Public Property StatusText As String
        Get
            Return _statusText
        End Get
        Set(value As String) Implements INotifyPropertyChanged.PropertyChanged
            _statusText = value
            RaiseEvent PropertyChanged(Me, New PropertyChangedEventArgs(NameOf(StatusText)))
        End Set
    End Property

    Public Async Function RefreshStatusAsync() As Task
        ' 非同期での実行を想定
        StatusText = Await Task.Run(Function() _hardwareService.GetSystemStatus())
    End Function

    ' INotifyPropertyChanged の実装は省略
End Class

3. アプリケーションの心臓部:ServiceProvider の構築

WPFにおいて DI を機能させるには、`App.xaml.vb` でコンテナを初期化し、View と ViewModel の橋渡しを行う必要がある。ここで重要なのは、「サービスのライフサイクル(Lifetime)」の選択だ。

  • Singleton: アプリケーション終了まで生存。状態を持つサービスに。
  • Transient: 要求されるたびに新規生成。軽量なオブジェクトに。
  • Scoped: WPFでは単一のコンテキスト管理が難しいため、基本は Singleton か Transient を使い分ける。
Imports Microsoft.Extensions.DependencyInjection
Imports System.Windows

Public Class App
    Inherits Application

    ' DIコンテナの保持
    Public Shared Property ServiceProvider As IServiceProvider

    Protected Overrides Sub OnStartup(e As StartupEventArgs)
        MyBase.OnStartup(e)

        ' 1. ServiceCollection の構築
        Dim services As New ServiceCollection()

        ' 2. サービスの登録
        ' HardwareService は状態管理が必要なため Singleton とする
        services.AddSingleton(Of IHardwareService, HardwareService)()
        
        ' ViewModel は要求ごとに生成される Transient とする
        services.AddTransient(Of MainViewModel)()

        ' 3. Provider のビルド
        ServiceProvider = services.BuildServiceProvider()

        ' 4. メインウィンドウの起動
        ' View 自体も DI 経由で生成するか、ViewModelLocator を使用する
        Dim mainWindow As New MainWindow()
        mainWindow.DataContext = ServiceProvider.GetRequiredService(Of MainViewModel)()
        mainWindow.Show()
    End Sub

    Protected Overrides Sub OnExit(e As EventArgs)
        ' コンテナの破棄。これにより IDisposable なサービスが適切に解放される
        If ServiceProvider IsNot Nothing Then
            DirectCast(ServiceProvider, IDisposable).Dispose()
        End If
        MyBase.OnExit(e)
    End Sub
End Class

4. アーキテクトの視点:メモリ管理とパフォーマンスの極限

DI コンテナを導入した際、シニアエンジニアが最も注意すべきは 「Dispose の連鎖」 である。

4.1 決定論的な破棄 (Deterministic Disposal)

`Microsoft.Extensions.DependencyInjection` は、`AddSingleton` で登録された `IDisposable` を実装しているクラスを、コンテナ(`ServiceProvider`)が破棄される際に自動的に `Dispose` する。

しかし、`AddTransient` で登録したオブジェクトが `IDisposable` を実装している場合、「誰がそれを Dispose するのか?」 という問題が発生する。コンテナは Transient オブジェクトの参照を保持し続けることがあり、これが原因でメモリリークを引き起こすケースがある。

鉄則:
1. `IDisposable` を実装するサービスは、可能な限り `Singleton` として管理し、アプリケーションのライフサイクルと同期させる。
2. `Transient` なオブジェクトが重いリソース(ファイルハンドル、Win32 API のハンドル等)を持つ場合は、手動で `Dispose` を管理するか、スコープを厳密に定義せよ。

4.2 Win32 API とのインターフェース設計

Windows API を扱うサービスは、低レイヤーの例外(Access Violation 等)を発生させるリスクがある。DI 経由でこれらを注入することで、ViewModel 層に低レイヤーの例外を伝播させず、サービス層で捕捉・変換(Wrap)して、ViewModel には「意味のあるビジネス例外」として渡す設計にせよ。

結言

VB.NET と WPF を用いたモダンな開発において、DI コンテナは単なる「便利ツール」ではない。それは、複雑怪奇なレガシーシステムを、テスト可能で、メンテナンス可能で、そして何より「制御可能」なコードへと変貌させるための、アーキテクチャの基盤である。

`New` を捨て、インターフェースを手に取れ。オブジェクトの寿命をコンテナに委ね、君はビジネスロジックの真髄に集中せよ。それが、真のアーキテクトへの道である。

タイトルとURLをコピーしました