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

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

密結合という名の負債を断て:VB.NET × WPF における DI コンテナによる極限の設計思想

業務自動化の現場において、ツールが「動けばいい」という段階から「保守し続けられる資産」へと昇華する瞬間、エンジニアは必ず一つの壁にぶち当たる。それは、「コードのスパゲッティ化」だ。

特に、大規模なWPFアプリケーションをVB.NETで構築している場合、ViewModelの中で直接 `New FileService()` や `New DatabaseContext()` と記述していないだろうか? もしそうなら、君の設計は今この瞬間も、技術的負債という名の利息を膨らませ続けている。

本稿では、`Microsoft.Extensions.DependencyInjection` を活用し、MVVMパターンにおける「疎結合」と「ライフサイクル管理」を完璧に制御する、プロフェッショナルな設計手法を伝授する。

1. なぜ `New` を書いてはいけないのか?

多くの開発者が陥る罠は、ViewModelが「具体的な実装」に依存してしまうことだ。

' --- 典型的な「負債」を生むコード ---
Public Class MainViewModel
    Private ReadOnly _fileService As New FileService() ' 致命的な欠陥:直接生成

    Public Sub New()
        ' ユニットテストが不可能。FileServiceが物理ディスクに依存しているため、
        ' テストのたびにファイルが作成・削除される。
    End Sub
End Class

この書き方の問題点は3つある。
1. テスト不能(Untestable): 外部リソース(DBやファイル)をモック(偽物)に差し替えることができない。
2. ライフサイクル制御不能: `FileService` がSingletonであるべきか、Transient(毎回生成)であるべきかを、ViewModel側が勝手に決めてしまっている。
3. 変更への脆弱性: `FileService` のコンストラクタに引数が一つ増えただけで、それを利用している全てのViewModelを修正しなければならない。

これを解決するのが DI(Dependency Injection:依存性注入) だ。ViewModelは「何が必要か(Interface)」だけを知っており、「どう作られるか(Implementation)」には一切関与しない。

2. 実装:DI コンテナによるアーキテクチャの構築

では、実際に `Microsoft.Extensions.DependencyInjection` を導入した、堅牢なコードを実装していこう。

準備:NuGetパッケージの導入

プロジェクトに以下のパッケージをインストールすること。

  • `Microsoft.Extensions.DependencyInjection`

Step 1: 抽象化(Interface)の定義

まずは、ビジネスロジックをインターフェースに封じ込める。これが「疎結合」の第一歩だ。

''' <summary>
''' ファイル操作の抽象インターフェース。実装の詳細(どのライブラリを使うか等)を隠蔽する。
''' </summary>
Public Interface IFileService
    Function ReadConfig(path As String) As String
    Sub WriteLog(message As String)
End Interface

''' <summary>
''' データベース連携の抽象インターフェース。
''' </summary>
Public Interface IDatabaseService
    Function GetUserData(userId As Integer) As String
End Interface

Step 2: 具体的な実装(Service)

次に、インターフェースに基づいた実体を実装する。ここで、ファイルやDBへのアクセスといった「重い」処理を記述する。

Public Class FileService
    Implements IFileService

    Public Function ReadConfig(path As String) As String Implements IFileService.ReadConfig
        ' 本来はここでIO処理を行う
        Return $"Config data from {path}"
    End Function

    Public Sub WriteLog(message As String) Implements IFileService.WriteLog
        Debug.WriteLine($"[LOG]: {message}")
    End Sub
End Class

Public Class DatabaseService
    Implements IDatabaseService

    Public Function GetUserData(userId As Integer) As String Implements IDatabaseService.GetUserData
        ' 本来はここでSQL実行を行う
        Return $"User Data for ID: {userId}"
    End Function
End Class

Step 3: ViewModelへのコンストラクタ注入

ここが肝だ。ViewModelはインターフェースのみを要求する。

Public Class MainViewModel
    Implements INotifyPropertyChanged

    Private ReadOnly _fileService As IFileService
    Private ReadOnly _dbService As IDatabaseService
    Private _statusText As String = "Ready"

    ' コンストラクタインジェクション:DIコンテナがここへインスタンスを流し込む
    Public Sub New(fileService As IFileService, dbService As IDatabaseService)
        _fileService = fileService
        _dbService = dbService
    End Sub

    Public Property StatusText As String
        Get
            Return _statusText
        End Get
        Set(value As String)
            _statusText = value
            OnPropertyChanged(NameOf(StatusText))
        End Set
    End Property

    ''' <summary>
    ''' 業務実行ボタンにバインドされるコマンド(簡易実装)
    ''' </summary>
    Public Sub ExecuteProcess()
        ' サービスを利用。中身が何であるかは関知しない。
        Dim config = _fileService.ReadConfig("C:\app.config")
        Dim user = _dbService.GetUserData(101)
        
        StatusText = $"Processed: {user} with {config}"
        _fileService.WriteLog("Process Completed Successfully.")
    End Sub

    ' INotifyPropertyChangedの実装は省略
    Public Event Property PropertyChanged As PropertyChangedEventHandler Implements INotifyPropertyChanged.PropertyChanged
    Protected Sub OnPropertyChanged(propertyName As String)
        RaiseEvent PropertyChanged(Me, New PropertyChangedEventArgs(propertyName))
    End Sub
End Class

3. ライフサイクルの掌握:App.xaml.vb での構成

DIの真価は、「オブジェクトの寿命(Lifecycle)」を中央集権的に管理できる点にある。`App.xaml.vb` を、アプリケーションの「起動エンジン(Bootstrapper)」として機能させる。

Public Class Application

    ' DIコンテナの保持
    Private _serviceProvider As IServiceProvider

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

        ' 1. サービスコレクションの初期化
        Dim services As New ServiceCollection()

        ' 2. サービスの登録(ここがライフサイクル管理の要)
        
        ' Singleton: アプリケーション全体で唯一のインスタンスを共有
        ' 設定情報や、共通のログ管理などに適している
        services.AddSingleton(Of IFileService, FileService)()

        ' Transient: 要求されるたびに新しいインスタンスを生成
        ' 状態を持たないユーティリティや、使い捨てのDB接続などに適している
        services.AddTransient(Of IDatabaseService, DatabaseService)()

        ' ViewModelもコンテナに登録する(ViewModel自体も依存関係を持つため)
        services.AddTransient(Of MainViewModel)()

        ' 3. プロバイダーの構築
        _serviceProvider = services.BuildServiceProvider()

        ' 4. MainWindowの起動
        ' MainWindow自体もDIコンテナから解決することで、ViewModelを注入できる
        Dim mainWindow As New MainWindow()
        
        ' ViewModelの注入(View側でDataContextにセット)
        ' 本来はViewModelLocatorなどを使うが、ここでは最も明示的な方法をとる
        mainWindow.DataContext = _serviceProvider.GetRequiredService(Of MainViewModel)

        mainWindow.Show()
    End Sub

    ''' <summary>
    ''' アプリ終了時にコンテナを適切にDisposeする
    ''' </summary>
    Protected Overrides Sub OnExit(e As ExitEventArgs)
        If _serviceProvider IsNot Nothing Then
            DirectCast(_serviceProvider, IDisposable).Dispose()
        End If
        MyBase.OnExit(e)
    End Sub

End Class

4. アーキテクトの視点:実務における注意点

この設計を導入する際、以下の3点を必ず念頭に置いておけ。

① データベース接続のライフサイクル

`IDatabaseService` を `Singleton` にしてはいけない。DB接続(Connection)は、スレッドセーフでないことが多く、また寿命が長すぎると接続プールを枯渇させる。DB操作を伴うサービスは、原則として `Transient` もしくは、Unit of Workパターンを用いた `Scoped`(WPFでは実装が複雑になるため、基本はTransientを推奨)として扱うべきだ。

② ファイルI/Oの例外ハンドリング

DIによってコードが綺麗になっても、ファイルがロックされている、権限がないといった物理的なエラーは防げない。サービス層(`FileService`)の中で例外を適切にキャッチし、独自の例外型(`FileOperationException` など)にラップしてViewModelに投げる設計にせよ。ViewModelは「ファイルが何であるか」を知る必要はなく、「操作に失敗した」という結果だけを受け取ればよい。

③ 循環参照の回避

`AがBを必要とし、BがAを必要とする` という状態は、DIコンテナが構築できない致命的なエラーだ。設計段階で、サービス同士の依存関係がグラフ状に一方向に流れているか(Directed Acyclic Graph)を常に意識せよ。

結論

`New` を捨て、`Interface` を手に取れ。

DIコンテナを導入することは、単なる流行の追随ではない。それは、「変化に強い、プロフェッショナルな防壁」を構築する行為だ。この設計思想をマスターすれば、君が作る業務自動化ツールは、数年経ってもメンテナンスが可能で、テスト可能で、そして何より、君のエンジニアとしての誇りを守る堅牢なものになるだろう。

さあ、コードを書き直せ。負債を、資産へ変えるために。

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