密結合という名の負債を断て: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コンテナを導入することは、単なる流行の追随ではない。それは、「変化に強い、プロフェッショナルな防壁」を構築する行為だ。この設計思想をマスターすれば、君が作る業務自動化ツールは、数年経ってもメンテナンスが可能で、テスト可能で、そして何より、君のエンジニアとしての誇りを守る堅牢なものになるだろう。
さあ、コードを書き直せ。負債を、資産へ変えるために。
