【極限の設計思想】VB.NET × WPFにおけるDI(依存性注入)の真髄:大規模開発を支える「疎結合」の魔法
こんにちは。エンジニアの皆さん。
マクロの自動化から一歩踏み出し、「本格的なアプリケーション」を作ろうとしているあなた。素晴らしい挑戦です。
「プログラムは動く。でも、コードがぐちゃぐちゃで、どこを直すとどこが壊れるか分からない……」
「新しい機能を追加しようとすると、既存のコードをあちこち書き換えなきゃいけない……」
もしあなたが今、そんな壁にぶつかっているとしたら、それはあなたが「プロフェッショナルな設計」の入り口に立っている証拠です。
今日は、大規模なWPFアプリケーションを支える屋台骨、DI(Dependency Injection:依存性注入)についてお話しします。少し難しく聞こえるかもしれませんが、大丈夫。ここをクリアすれば、あなたのVB.NETは「ただのツール」から「堅牢なソフトウェア」へと進化します。
一緒に、その極意を学んでいきましょう。
1. なぜ「DI」が必要なのか? 〜「自作」から「依頼」へ〜
まず、DIが必要な理由を理解しましょう。
従来の(いわゆる初心者向けの)書き方では、クラスの中で自分が必要な道具を「自分で作って」いました。
【悪い例】密結合(Tight Coupling)の状態
' ViewModelの中で、直接サービスを生成してしまっている
Public Class MainViewModel
Private ReadOnly _dataService As New DataService() ' ← これが「密結合」の罠!
Public Sub New()
' 自分で作ってしまうと、DataServiceをテスト用(Mock)に差し替えることができない
End Sub
End Class
この書き方の何が問題か分かりますか?
`MainViewModel` は `DataService` という特定のクラスに完全に依存しています。もし、将来的に「データベースからではなく、Web APIからデータを取るように変えたい」となったとき、`MainViewModel` のコードを直接書き換えなければなりません。
これは、「料理人が、料理を作るたびに自分で畑へ行って野菜を育て、牛を育てている」ようなものです。効率が悪いうえに、野菜の育て方が変わると料理も作れなくなってしまいます。
【良い例】DI(Dependency Injection)の状態
DIとは、「必要な道具は、外から(コンストラクタを通じて)受け取る」という考え方です。
料理人は、「新鮮な野菜を届けてくれる人(インターフェース)」さえいれば、その野菜がどこで育ったかを知る必要はありません。
' 料理人は「野菜」という概念(インターフェース)だけを知っていればいい
Public Class MainViewModel
Private ReadOnly _dataService As IDataService ' ← インターフェースに依存
' 道具は「外から」注入される(これがコンストラクタインジェクション)
Public Sub New(dataService As IDataService)
_dataService = dataService
End Sub
End Class
これで、`DataService` を `MockDataService` に差し替えることが、`MainViewModel` を一切触らずに可能になります。これが「疎結合」の力です。
2. 実践:Microsoft.Extensions.DependencyInjection を導入する
現代の.NET開発において、DIコンテナ(道具を管理・配布する司令塔)として最も標準的なのが `Microsoft.Extensions.DependencyInjection` です。
事前準備
NuGetパッケージマネージャーから以下をインストールしてください。
- `Microsoft.Extensions.DependencyInjection`
ステップ1:契約(Interface)を決める
まずは、何ができるのかという「約束事」を決めます。
''' <summary>
''' データの取得に関する契約
''' </summary>
Public Interface IDataService
Function GetData() As String
End Interface
''' <summary>
''' 本番用のデータサービス実装
''' </summary>
Public Class RealDataService
Implements IDataService
Public Function GetData() As String Implements IDataService.GetData
Return "本物のデータベースから取得したデータです。"
End Function
End Class
ステップ2:ViewModelを作る(注入を受ける側)
ViewModelは、インターフェースを通じてサービスを受け取ります。
''' <summary>
''' メイン画面のViewModel
''' </summary>
Public Class MainViewModel
Implements INotifyPropertyChanged
Private ReadOnly _dataService As IDataService
Private _message As String
' コンストラクタでインターフェースを受け取る
Public Sub New(dataService As IDataService)
_dataService = dataService
End Sub
Public Property Message As String
Get
Return _message
End Get
Set(value As String)
_message = value
OnPropertyChanged(NameOf(Message))
End Set
End Property
Public Sub LoadData()
' サービスを使ってデータを取得
Message = _dataService.GetData()
End Sub
' --- INotifyPropertyChanged の実装は省略 ---
End Class
ステップ3:DIコンテナを構築する(司令塔の設定)
ここが一番重要です。`App.xaml.vb` で、どのインターフェースにどのクラスを割り当てるか、そしてその「寿命(ライフサイクル)」を定義します。
' App.xaml.vb
Public Class Application
' DIコンテナ(サービスプロバイダー)を保持する
Public Shared Property ServiceProvider As IServiceProvider
Protected Overrides Sub OnStartup(e As StartupEventArgs)
MyBase.OnStartup(e)
' 1. サービスの登録(ここが設計図!)
Dim services As New ServiceCollection()
' 【重要】ライフサイクルの選択
' Transient: 呼ばれるたびに新しいインスタンスを作る
' Singleton: アプリ起動中、ずっと同じインスタンスを使い回す
services.AddTransient(Of IDataService, RealDataService)()
services.AddTransient(Of MainViewModel)()
services.AddTransient(Of MainWindow)() ' View自体もDI管理下に置くのがベスト
' 2. コンテナの構築
ServiceProvider = services.BuildServiceProvider()
' 3. MainWindowをDIコンテナから解決して表示
Dim mainWindow = ServiceProvider.GetRequiredService(Of MainWindow)()
mainWindow.Show()
End Sub
End Class
ステップ4:Viewを繋ぐ
最後に、`MainWindow` を作ります。View自体もDIコンテナから生成されることで、ViewModelも自動的に注入されます。
' MainWindow.xaml.vb
Public Class MainWindow
Implements INotifyPropertyChanged
Private ReadOnly _viewModel As MainViewModel
' DIコンテナが自動的にViewModelを生成して渡してくれる
Public Sub New(viewModel As MainViewModel)
InitializeComponent()
_viewModel = viewModel
' DataContextにViewModelをセット
Me.DataContext = _viewModel
End Sub
' --- INotifyPropertyChanged の実装は省略 ---
End Class
3. ライフサイクル管理の極意:Singleton vs Transient
DIを使いこなす上で、避けて通れないのが「オブジェクトの寿命」です。これを間違えると、メモリリークやデータの不整合が発生します。
| 登録メソッド | ライフサイクル | 特徴・使いどころ |
|---|---|---|
| `AddTransient` | 一時的 (Transient) | 毎回「新しいもの」を作る。軽量な計算クラスや、状態を持たないサービスに最適。 |
| `AddSingleton` | 単一 (Singleton) | アプリ内で「たった一つ」を使い続ける。設定情報、ログ出力、キャッシュ管理などに。 |
| `AddScoped` | 範囲限定 (Scoped) | Webアプリでは「1リクエストごと」だが、WPFではあまり使いません。 |
プロのアドバイス:
「迷ったら `Transient`」を基本にしてください。`Singleton` は、アプリ全体で共有すべき「状態」がある時だけ慎重に使いましょう。
まとめ:ここをクリアすれば、あなたはもう「設計者」です
いかがでしたか?
最初は `App.xaml.vb` に設定を書いたり、インターフェースを作ったりと、コード量が増えて「面倒だな」と感じるかもしれません。
しかし、この仕組みを導入することで、あなたは以下の力を手にしました。
1. テストの容易性: 本物のDBの代わりに、偽物のデータ(Mock)を注入してテストができる。
2. 変更への強さ: `RealDataService` を `ApiDataService` に変えるとき、ViewModelを1行も書き換える必要がない。
3. 整理された設計: 「誰が何を作るか」と「誰が何を使うか」が明確に分離される。
「動けばいい」の段階を超え、「変化に強い、美しい設計」を目指す。
その一歩を踏み出したあなたを、私は心から応援しています。
さあ、次はもっと複雑なサービスを登録して、あなたのアプリケーションを究極の形へと導いてください!
