Data Adapter

キャッシュ管理に使用するデータベースとインテグレーション内のデータオブジェクトを中継するデータアダプター。簡易的なDAOないしORMのようなもの。

ビルトインデータアダプター

本インテグレーションには3種類のデータアダプターが同梱されている。

JsonFileDataAdapter (default)

データを単一のJSONファイルに保存するデータアダプター。

• 既定では画像キャッシュディレクトリの cache.json に保存する
• 開発サーバーではデータベースオブジェクトに対する最後の操作から1秒間操作がなければデータをファイルに書き出す

astro.config.ts

import {
  JsonFileDataAdapter,
  type JsonFileDataAdapterOptions,
} from "../src/extras/JsonFileDataAdapter.js";

const options: JsonFileDataAdapterOptions = {
  // ...
}

export default defineConfig({
  integrations: [
    astroImageProcessor({
      dataAdapter: new JsonFileDataAdapter(options),
    })
  ]
});

LokiDataAdapter

JavaScript製の軽量ドキュメントデータベースLokiJSを使用するデータアダプター。

• 既定では画像キャッシュディレクトリの cache.db に保存する
• 開発サーバーでは10秒毎にデータをファイルに書き出す

astro.config.ts

import {
  LokiDataAdapter,
  type LokiDataAdapterOptions,
} from "../src/extras/LokiDataAdapter.js";

const options: LokiDataAdapterOptions = {
  // ...
}

export default defineConfig({
  integrations: [
    astroImageProcessor({
      dataAdapter: new LokiDataAdapter(options),
    })
  ]
});

BunSqliteDataAdapter

BunビルトインSQLiteドライバーを使用するデータアダプター。

• Bunでのみ使用可能
• 既定では画像キャッシュディレクトリの cache.sqlite に保存する

astro.config.ts

import {
  BunSqliteDataAdapter,
  type BunSqliteDataAdapterOptions,
} from "../src/extras/BunSqliteDataAdapter.js";

const options: BunSqliteDataAdapterOptions = {
  // ...
}

export default defineConfig({
  integrations: [
    astroImageProcessor({
      dataAdapter: new BunSqliteDataAdapter(options),
    })
  ]
});

カスタムデータアダプター

ImgProcDataAdapter インターフェースに従って独自のデータアダプターを作成可能。

import { ImgProcDataAdapter } from "astro-image-processor/types";

export class CustomDataAdapter implements ImgProcDataAdapter {
  // ...
}

詳細はビルトインデータアダプター各種の実装を参照。