@BlancoCache アノテーション

メソッドに対してキャッシュ機能を追加します。

仕様

適用箇所

• メソッド

アノテーション要素

詳細

• 同じパラメータでメソッドが呼び出された際に、直近の実行結果をキャッシュから取り出して戻します。
• キャッシュはソフト参照による実装です。
• キャッシュのキーとしたいメソッド・パラメータに @BlancoCacheKey アノテーションを付与します。少なくとも 1 つは @BlancoCacheKey が付与されたメソッド・パラメータが必要です。

ソースコード自動生成の例

入力ソースコード: AbstractSampleCache.java

 package sample.cache;
 
 import blanco.cache.BlancoCache;
 import blanco.cache.BlancoCacheKey;
 
 /**
  * メソッド・キャッシュをおこなうソースコードを自動生成するサンプル。
  */
 public abstract class AbstractSampleCache {
         /**
          * キャッシュをおこないたい、処理コストの高いメソッド。
          * 
          * @param arg1
          *            引数その１
          * @param arg2
          *            引数その２
          * @return メソッドの戻り値。ただしキャッシュにヒットした場合は前回のメソッド呼び出し時の実行結果。
          */
         @BlancoCache(maxperiod = 1000)
         public String methodWithHighCost(@BlancoCacheKey final String arg1, @BlancoCacheKey final String arg2) {
                 // ここに実際の処理を記述します。
                 return "戻り値: " + arg1;
         }
 }

出力ソースコード: SampleCache.java ★以下のソースコードは Blanco2g によって自動生成されたものです。

 /*
  * このクラスは 'AbstractSampleCache' の具象クラスとして blanco Framework によって自動生成されました。
  */
 package sample.cache;
 
 import java.util.Map;
 
 import blanco.fw.BlancoGeneratedBy;
 
 /**
  * メソッド・キャッシュをおこなうソースコードを自動生成するサンプル。
  */
 @BlancoGeneratedBy(name = "Blanco2g")
 public class SampleCache extends AbstractSampleCache {
     /**
      * [@BlancoCache] Cache object for method 'methodWithHighCost'.
      */
     private final Map<String, java.lang.ref.SoftReference<CacheObjectForSampleCacheMethodWithHighCost>> blanco2gCacheMethodmethodWithHighCost = java.util.Collections.synchronizedMap(new java.util.HashMap<java.lang.String, java.lang.ref.SoftReference<CacheObjectForSampleCacheMethodWithHighCost>>(8192));
 
     /**
      * キャッシュをおこないたい、処理コストの高いメソッド。
      *
      * @param arg1 引数その１
      * @param arg2 引数その２
      * @return  メソッドの戻り値。ただしキャッシュにヒットした場合は前回のメソッド呼び出し時の実行結果。
      */
     public String methodWithHighCost(String arg1, String arg2) {
         java.lang.String autoValMethodResult;
         {
             // [@BlancoCache] Search cache.
             final java.lang.ref.SoftReference<CacheObjectForSampleCacheMethodWithHighCost> autoValMethodResultCacheReference = blanco2gCacheMethodmethodWithHighCost.get("" + arg1 + "\t" + arg2 + "");
             if (autoValMethodResultCacheReference != null) {
                 final CacheObjectForSampleCacheMethodWithHighCost autoValCacheLookup = autoValMethodResultCacheReference.get();
                 if (autoValCacheLookup != null) {
                     if (Math.abs(System.currentTimeMillis() - autoValCacheLookup.birthMillisec) <= 1000) {
                         // Hit cache.
                         return autoValCacheLookup.cachedValue;
                     }
                 }
             }
         }
         autoValMethodResult = super.methodWithHighCost(arg1, arg2);
         {
             // [@BlancoCache] Remember cache.
             final CacheObjectForSampleCacheMethodWithHighCost autoValCacheObject = new CacheObjectForSampleCacheMethodWithHighCost();
             autoValCacheObject.birthMillisec = System.currentTimeMillis();
             autoValCacheObject.cachedValue = autoValMethodResult;
             blanco2gCacheMethodmethodWithHighCost.put("" + arg1 + "\t" + arg2 + "", new java.lang.ref.SoftReference<CacheObjectForSampleCacheMethodWithHighCost>(autoValCacheObject));
         }
         return autoValMethodResult;
     }
 }
 /**
  * Cache object for method 'methodWithHighCost'.
  */
 class CacheObjectForSampleCacheMethodWithHighCost {
     /**
      * Birth millisec for cache object.
      */
     long birthMillisec;
 
     /**
      * Cached object value.
      */
     String cachedValue;
 }

リンク

• Blanco2g アノテーション一覧
• Blanco2g トップページ