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

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

【極限の設計思想】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. 整理された設計: 「誰が何を作るか」と「誰が何を使うか」が明確に分離される。

「動けばいい」の段階を超え、「変化に強い、美しい設計」を目指す。
その一歩を踏み出したあなたを、私は心から応援しています。

さあ、次はもっと複雑なサービスを登録して、あなたのアプリケーションを究極の形へと導いてください!

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