脱・スパゲッティコード: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. エラーハンドリング を行い、一つの失敗が全体に波及しないように守る。
これらをマスターすれば、あなたの作るツールは、後からいくらでも機能を追加できる「拡張性の高いシステム」へと昇華されます。
プログラミングは、単に命令を並べる作業ではありません。「どうすれば、未来の自分が楽をできるか?」という設計の美学です。このプラグイン機構を入り口に、ぜひオブジェクト指向的な考え方にも挑戦してみてください。
応援していますよ。次はもっと高度な設計でお会いしましょう!
