Cache::Cache -- Cacheインターフェース Cacheモジュールは、指定された期間データを永続化させることで開発者を 助けるように設計されています。このモジュールは、リモート・マシンや データベースへの繰り返され、冗長で高価な呼び出しを節約するために データをローカルに格納するためにWebアプリケーションで、よく使われます。 また人々はCache::Cacheがわかりやすいインターフェースを アプリケーションの実行やCGIスタイルのスクリプトの呼び出しを、 またがってデータを共有する時の、わかりやすいインタフェースのために 使ったり、単純にファイルシステムや共有メモリの抽象化を簡単に利用する ことを知っています。 Cache::Cacheインターフェースはget, set, remove, size, purge, そしてclear インスタンス・メソッドと、メソッドの呼び出しを越えてデータを永続化する ための、それらに対応する静的メソッドサポートをサポートしているクラスに よって実装されます。 最初に、あなたの必要にとって一番よいキャッシュの実装を選択してください。 最も単純なキャッシュはMemoryCacheです。これは複数の連続したリクエストを サービスし、冗長で高価な問い合わせを行うことを避けたい、データベースに アクセスするApache/mod_perlアプリケーションのようなアプリケーションに 適しています。プロセス間でデータを共有したいのであれば、 おそらくSharedMemoryCacheが適しているでしょう。しかしシステムによって 違いのあるベースとなるIPCメカニズムに強く結び付けられ、大きなオブジェクトや 多くのオブジェクトには向いていません。SharedMemoryCacheが受け入れられない ときには、FileCacheが同じ機能を、同じくらいのパフォーマンスで提供します。 しかもオブジェクトの数やそれらの大きさによって制限されません。 もしキャッシュのベースとなるファイル・システムの大きさを厳密に制限したい のであればSizeAwareFileCacheで実現できます。同様にSizeAwareMemoryCacheと SizeAwareSharedMemoryCacheは大きさ管理機能を、それぞれ MemoryCacheとSharedMemoryCacheに追加します。 キャッシュの使い方は簡単です。以下のサンプル・コードはファイルシステムを ベースとしてキャッシュのインスタンスを作り、利用しています。 get( $name ); ]]> set( $name, $customer, "10 minutes" ); } ]]> $EXPIRES_NEVER 設定されたキャッシュの中の要素は、決して期限切れになりません。 $EXPIRES_NOW 設定されたキャッシュの中の要素は、即、期限切れになります。 Clear( ) このタイプの全てのキャッシュから全てのオブジェクトを削除します。 Purge( ) このタイプの全てのキャッシュから期限切れになっている全てのオブジェクトを 削除します。 Size( ) このタイプの全てのキャッシュでの全てのオブジェクトの大きさの合計を返します。 new( $options_hash_ref ) Cache::Cacheの新しいインスタンスを組み立てます。$options_hash_refは 構成オプションが入ったハッシュへのリファレンスです;下記のオプションの セクションをご覧ください。 clear( ) このキャッシュ・インスタンスに関連付けられた名前空間から、 全てのオブエジェクトを削除します。 get( $key ) $keyに関連付けられたデータを返します。 get_object( $key ) $keyに関連付けられたキャッシュされたデータを格納するために 使われている、ベースになっているCache::Objectオブジェクトを返します。 そのオブジェクトが期限切れであったとしても、キャッシュされたオブジェクトの 削除を引き起こしません。 purge( ) 名前空間から、このキャッシュ・インスタンスに関連付けられている、 期限が切れている全てのオブジェクトを削除します。 remove( $key ) キャッシュから$keyに関連付けられているデータを削除します。 set( $key, $data, [$expires_in] ) キャッシュの中で$dataを$keyに関連付けます。$expires_inは データが削除されるまでの時間を秒数で、あるいは定数$EXPIRES_NOWや $EXPIRES_NEVERで示します。デフォルトは$EXPIRES_NEVERになります。 この変数は"[number] [unit]"、例えば"10 minutes"という拡張された 書式にすることもできます。適切な単位はs, second, seconds, sec, m, minute, minutes, min, h, hour, hours, w, week, weeks, M, month, months, y, year, そして yearsです。 さらに$EXPIRES_NOWは"now"で、$EXPIRES_NEVERは"never"で表すことも できます。 set_object( $key, $object ) $keyをCache::Object $objectに関連付けます。set_objectを使うこと は（setとは逆である）期限の切れたオブジェクトの自動的な削除は 引き起こしません。 size( ) このキャッシュ・インスタンスに関連付けられた名前空間でのすべての オブジェクトの大きさの合計を返します。 get_namespaces( ) このタイプのキャッシュに関連付けられた全ての名前空間を返します。 以下のいずれかのキーを持っているハッシュへのリファレンスで渡されることにより オプションが設定されます: namespace このキャッシュに関連付けられる名前空間。明示的に指定されなければ デフォルトは"Default"です。 default_expires_in キャッシュに置かれたオブジェクトのデフォルトの期限切れ時間。明示的に 設定されなければデフォルトは$EXPIRES_NEVERです。 auto_purge_interval 自動削除の間隔を設定します。（expires_inと同じ書式で）このオプションに 特定の時間が設定されると、間隔を越えた最初のsetのとき、purge( )ルーチンが 呼び出されます。そして間隔はリセットされます。 auto_purge_on_set もしこのオプションがtrueであれば、自動削除間隔ルーチンがsetの度に チェックされます。 auto_purge_on_get もしこのオプションがtrueであれば、自動削除間隔ルーチンがgetの度に チェックされます。 (get|set)_namespace( ) このキャッシュ・インスタンスの名前空間 get_default_expires_in( ) このキャッシュ・インスタンに置かれたオブジェクトのデフォルトの期限切れ時間 get_keys( ) このキャッシュ・インスタンスに関連付けられた名前空間でのオブジェクトを 指定するキーのリスト get_identifiers( ) このメソッドではなく、get_keys( )を使うようにしてください。 (get|set)_auto_purge_interval( ) 自動削除間隔にアクセスします。このオプションが（expires_inと同じ書式で） 特定の時間に設定されていれば、その間隔の後の最初のgetのとき、 purge( )ルーチンが呼び出されます。そして間隔はリセットされます。 (get|set)_auto_purge_on_set( ) このプロパティがtrueであれば、自動削除間隔ルーチンがsetの度にチェックされます。 (get|set)_auto_purge_on_get( ) このプロパティがtrueであれば、自動削除間隔ルーチンがgetの度にチェックされます。 Cache::Object, Cache::MemoryCache, Cache::FileCache, Cache::SharedMemoryCache, and Cache::SizeAwareFileCache Original author: DeWitt Clinton <dewitt@unto.net> Last author: $Author: hippo2000 $ Copyright (C) 2001, 2002 DeWitt Clinton