【入門編】【プラグイン機構の実装】FileSystemObject と Execute メソッドを組み合わせた、外部 .vbs ファイルを動的にロードして機能を拡張するモジュール設計 – VBScript (Visual Basic Scripting Edition)解析バイブル

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

脱・スパゲッティコード:VBScriptで実現する「プラグイン機構」の設計学

こんにちは。技術の荒波を渡り歩くエンジニアの皆さん。
「マクロの記録」から一歩踏み出し、自分でコードを書き始めたばかりの頃は、誰もが「もっと効率的に、もっとスマートに管理できないだろうか?」という壁にぶつかります。

一つの巨大な `.vbs` ファイルに、何百行、何千行と処理を書き連ねていく……。それは一見、管理が楽に見えるかもしれません。しかし、それは「モノリス(一枚岩)」と呼ばれる、変化に脆い設計です。機能を追加するたびにメインのコードを書き換え、うっかり一箇所ミスをすれば、システム全体が沈没してしまう。

今日は、そんな「硬直したコード」から卒業するための、伝説的な設計手法を伝授しましょう。
テーマは「プラグイン機構の実装」。
`FileSystemObject` でファイルを探索し、`Execute` メソッドでコードを動的に取り込む。この「拡張性」という武器を手に入れれば、あなたのスクリプトは「ただの自動化ツール」から「成長するプラットフォーム」へと進化します。

1. 設計思想:モノリスからモジュールへ

まず、私たちが作ろうとしている仕組みをイメージしてみましょう。

従来のやり方(モノリス)

メインスクリプトの中に、全ての機能(Aの処理、Bの処理、Cの処理……)が詰め込まれている状態。

  • 弱点: 機能が増えるたびにメインファイルが肥大化し、修正ミスが怖くなる。

プラグイン方式(モジュール化)

メインスクリプトは「司令塔」に徹し、実際の「仕事」は外部のファイルに任せる状態。

  • 利点: 新しい機能が欲しければ、特定のフォルダに新しい `.vbs` ファイルを放り込むだけ。メインのコードは一切触らなくて良い。

# 【概念図】

[ 実行環境 (WSH) ]
▼ [ メインスクリプト (Core.vbs) ] <--- 司令塔(スキャンと実行を担当)
+--- [ plugins フォルダ ]
+-- [ Plugin_A.vbs ] (機能A: ログ出力) +-- [ Plugin_B.vbs ] (機能B: ファイル整理) +-- [ Plugin_C.vbs ] (機能C: メッセージ表示)

2. 武器の準備:FSO と Execute

このアーキテクチャを実現するために、VBScriptの2つの強力な武器を使います。

1. `FileSystemObject` (FSO):
Windowsのファイルシステムを操作するためのオブジェクトです。「特定のフォルダにどんなファイルがあるか?」を調査する「スカウト」の役割を果たします。
2. `Execute` メソッド:
これが今回の魔法です。通常、コードはファイルに書かれた状態で実行されますが、`Execute` は「文字列として読み込んだテキストを、その場でプログラムコードとして実行する」という、極めてダイナミックな動きをします。

3. 実装:動的ロード・エンジンの構築

それでは、実際に動くコードを書いていきましょう。
構成は2つです。「司令塔となるメインスクリプト」と、「機能を持つプラグイン」です。

① メインスクリプト (`Core.vbs`)

このファイルが、フォルダを巡回してプラグインを呼び出します。

' =================================================================
' Core.vbs - プラグイン・エンジン
' 役割: pluginsフォルダ内のファイルをスキャンし、動的に実行する
' =================================================================
Option Explicit

Dim fso, pluginFolder, pluginFile, pluginCode, textStream
Dim pluginPath

' --- 設定 ---
pluginPath = ".\plugins" ' プラグインを格納するフォルダ名

Set fso = CreateObject("Scripting.FileSystemObject")

' 1. フォルダの存在確認
If Not fso.FolderExists(pluginPath) Then
    fso.CreateFolder(pluginPath)
    MsgBox "plugins フォルダを作成しました。ここにプラグインを置いてください。", vbInformation
    WScript.Quit
End If

Set pluginFolder = fso.GetFolder(pluginPath)

MsgBox "システム起動: プラグインをロードします...", vbInformation

' 2. フォルダ内のファイルをループ処理
For Each pluginFile In pluginFolder.Files
    ' 拡張子が .vbs のファイルのみを対象とする
    If LCase(fso.GetExtensionName(pluginFile.Name)) = "vbs" Then
        
        WScript.Echo "--- ロード中: " & pluginFile.Name & " ---"
        
        ' 3. ファイルの内容をテキストとして読み込む
        Set textStream = pluginFile.OpenAsTextStream(1) ' 1 = ForReading
        pluginCode = textStream.ReadAll
        textStream.Close
        
        ' 4. 【核心】Executeメソッドによる動的実行
        ' 文字列として読み込んだコードを、その場でプログラムとして走らせる
        On Error Resume Next ' プラグインのエラーでメインが止まらないように保護
        Execute(pluginCode)
        
        If Err.Number <> 0 Then
            WScript.Echo "エラー発生 (" & pluginFile.Name & "): " & Err.Description
            Err.Clear
        End If
        On Error GoTo 0 ' エラーハンドリングを元に戻す
        
        WScript.Echo "--- 完了: " & pluginFile.Name & " ---"
    End If
Next

WScript.Echo "全プラグインの実行が終了しました。"

Set fso = Nothing

② プラグイン例1 (`plugins\Plugin_Hello.vbs`)

' =================================================================
' Plugin_Hello.vbs
' 役割: シンプルな挨拶を表示する
' =================================================================
MsgBox "こんにちは!プラグインから挨拶しています。", vbInformation

③ プラグイン例2 (`plugins\Plugin_SystemInfo.vbs`)

' =================================================================
' Plugin_SystemInfo.vbs
' 役割: 実行時の時刻を表示する
' =================================================================
MsgBox "現在の時刻は " & Now & " です。", vbInformation

4. 伝説のアーキテクトが教える「陥りやすい罠」

ここまで読んで「よし、これで何でもできるぞ!」と思ったあなた。少しだけ立ち止まってください。`Execute` は強力すぎるがゆえに、非常に危険な側面も持っています。プロの現場で生き残るために、以下の2点は必ず覚えておいてください。

罠その1:スコープ(変数の生存範囲)の混乱

`Execute` で実行されるコードは、メインスクリプトと同じスコープ(変数領域)で実行されます。

例えば、メインスクリプトで `Dim x` と定義していて、プラグイン側でも `x = 100` と書いた場合、メインスクリプトの `x` が書き換えられてしまいます。これを「意図しない変数の汚染」と呼びます。

  • 対策: プラグイン側では、可能な限り変数名を具体的にする(`user_count` など)か、プラグインの処理を `Sub` や `Function` で包み、メイン側からはその関数を呼ぶだけの設計にすることです。

罠その2:エラーによる連鎖停止

もしプラグインの一つに記述ミス(構文エラー)があった場合、通常ならメインスクリプトごとクラッシュしてしまいます。

  • 対策: 上記のコード例でも実装しましたが、`On Error Resume Next` を使って、プラグイン実行中のエラーをキャッチし、エラーが起きても「次のプラグイン」へ進めるように隔離(アイソレーション)することが不可欠です。

まとめ:ここをクリアすれば、基本はバッチリです

今回の実装で学んだポイントを振り返りましょう。

1. `FileSystemObject` を使って、動的にファイル一覧を取得する。
2. `OpenAsTextStream` で、ファイルの中身を「文字列」として読み込む。
3. `Execute` を使い、文字列を「生きたコード」に変身させる。
4. エラーハンドリング を行い、一つの失敗が全体に波及しないように守る。

これらをマスターすれば、あなたの作るツールは、後からいくらでも機能を追加できる「拡張性の高いシステム」へと昇華されます。

プログラミングは、単に命令を並べる作業ではありません。「どうすれば、未来の自分が楽をできるか?」という設計の美学です。このプラグイン機構を入り口に、ぜひオブジェクト指向的な考え方にも挑戦してみてください。

応援していますよ。次はもっと高度な設計でお会いしましょう!

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