@shimataro/resource-manager v1.3.1

Resource Manager for JavaScript

• English
• 日本語

機能

• 任意のリソースを取得
• 以前に取得したことがあるリソースを使いまわす（Singleton）
• 取得したリソースをまとめて解放

どこで必要？

JavaScriptのクラスにはデストラクタがないので、メモリ以外のリソースは自動的に解放されません。 これは特にサーバサイドで動かす場合に深刻な問題になる可能性があります。

そのため通常はリソースが不要になったら都度解放する必要がありますが、リクエストの終了時にまとめて解放したほうが見通しが良くなることも多いです。

また、例えばDB接続は一度確保したらそのリクエストの間は同じ接続を使い回したほうが接続コストやトランザクションの面で便利なことがあります。

インストール

npm install -S @shimataro/resource-manager

使い方（Express.jsの例）

こんな感じのミドルウェアを、ルーティング前（リソース使用前）に app.use() で登録しておきます。

import ResourceManager from "@shimataro/resource-manager";

function middleware(req, res, next) {
    // リソースマネージャーをreqのプロパティに追加
    const objResourceManager = ResourceManager.factory();
    req.objResourceManager = objResourceManager;

    // リソース名・取得方法・解放方法を指定
    objResourceManager.register(
        "mysql",
        (options) => {
            return mysql.createConnection(options);
        },
        (conn) => {
            conn.end();
        });

    // 終了時にリソースをすべて解放
    res
        .on("close", () => {
            // 切断
            objResourceManager.close();
        })
        .on("finish", () => {
            // 処理完了
            objResourceManager.close();
        });
    if (res.socket.destroyed) {
        // そもそもこの時点で切断されていた
        objResourceManager.close();
    }

    next();
}

on-finishedパッケージを使うと、リソースの解放部分を簡潔に記述できます。

import ResourceManager from "@shimataro/resource-manager";
import onFinished from "on-finished";

function middleware(req, res, next) {
    // ...

    // 終了時にリソースをすべて解放
    onFinished(res, () => {
        objResourceManager.close();
    });

    next();
}

リソースの取得方法はこんな感じで。

app.get("/", (req, res, next) => {
    // DB接続
    const conn1 = req.objResourceManager.open("mysql", {/* 接続オプション1 */});

    // openSingleton() は同じリソース名・同じオプションなら何度コールしても最初のリソースを使いまわす
    // （この場合、conn2_1とconn2_2は同じものを返す）
    const conn2_1 = req.objResourceManager.openSingleton("mysql", {/* 接続オプション2 */});
    const conn2_2 = req.objResourceManager.openSingleton("mysql", {/* 接続オプション2 */});

    // リクエスト終了時にすべて解放される
    res.send("OK");
});

ビルトインリソース

以下のリソース名は「ビルトインリソース」としてあらかじめ定義されているため、登録なしで使用できます。

• array: 配列
• map: マップ
• set: 集合

これらのリソースも close() メソッドをコールすれば中身は解放されるので、その時点でMapやSetのキーもガベージコレクションの対象となります。 つまり、WeakMapやWeakSetを使用する必要はありません。

また、 openSingleton() をコールすることで「リクエスト内でローカルなコレクション」として使うこともできます。

function middleware1(req, res, next) {
    const map1 = req.objResourceManager.openSingleton("map", 1);
    console.log(map1.size); // 0
    map1.set(1, "a");

    const map2 = req.objResourceManager.openSingleton("map", 2);
    console.log(map2.size); // 0
    map2.set(2, "b");

    next();
}

function middleware2(req, res, next) {
    const map1 = req.objResourceManager.openSingleton("map", 1);
    const map2 = req.objResourceManager.openSingleton("map", 2);
    console.log(map1.get(1)); // "a"
    console.log(map1.get(2)); // undefined
    console.log(map2.get(1)); // undefined
    console.log(map2.get(2)); // "b"

    next();
}

ライセンス

MITライセンス

著作権

© 2018 shimataro