intra-mart Accel Platform セットアップガイド 第45版 2024-01-31

5.3.4.10. アイコンキャッシュ

intra-mart Accel Platform のアイコンのキャッシュについて設定します。
アイコンキャッシュで対象とするアイコンは、アイコン管理で登録されたアイコンです。
アイコンキャッシュは、登録されたアイコンを表示する際に利用されます。

コラム

アイコンキャッシュ設定は テナント管理機能 に含まれています。

コラム

アイコン管理についての詳細は、「 intra-mart 要件情報公開サイト 」-「 要件 #25242 アイコン管理機能を提供します。 」 を参照してください。

注意

アイコンキャッシュは、intra-mart Accel Platform 2017 Winter(Rebecca) 以降で利用できます。
  1. 「ProjectNavigator」内の <conf/im-ehcache-config/icon-picker.xml> ファイルをダブルクリックで開き、「ソース」タブを選択してください。
  2. <im-ehcache-config>/<cache> の内容を運用規模に応じて変更します。
<cache
  name="IM_TENANT-ICON-PICKER"
  enable="true"
  max-elements-on-memory="100"
  max-bytes-memory="500k"
  overflow-to-disk="false"
  max-elements-on-disk="100"
  max-bytes-disk="500k"
  time-to-live-seconds="3600"
  time-to-idle-seconds="1800"
/>

注意

デフォルトは、以下の属性が無効です。

  • max-elements-on-memory
  • max-elements-on-disk
  • max-bytes-disk

各属性の詳細については、「 設定ファイルリファレンス 」-「 キャッシュ設定 」を参照してください。

コラム

「max-bytes-memory」及び、「max-bytes-disk」属性が設定されている場合、Cacheにオブジェクトを登録する際に、そのオブジェクトのサイズの計算処理が行われます。
この際、登録するオブジェクトが、別のオブジェクトの参照を大量に持つ場合、計算処理に時間がかかりパフォーマンスの低下の原因となる可能性があります。
登録するオブジェクトが1000以上の参照を持つ場合、下記のようなメッセージがログに出力されます。
The configured limit of 1,000 object references was reached while attempting to calculate the size of the object graph.
Severe performance degradation could occur if the sizing operation continues.
This can be avoided by setting the CacheManger or Cache <sizeOfPolicy> elements maxDepthExceededBehavior to "abort" or adding stop points with @IgnoreSizeOf annotations.
If performance degradation is NOT an issue at the configured limit, raise the limit value using the CacheManager or Cache <sizeOfPolicy> elements maxDepth attribute.
For more information, see the Ehcache configuration documentation.
このログが出力される場合は、キャッシュに格納するオブジェクトの構成を見直すか、「max-bytes-memory」または、「max-bytes-disk」の代わりに、「max-elements-on-memory」または「max-elements-on-disk」の利用を検討して下さい。

5.3.4.10.1. キャッシュするオブジェクトの単位

アイコンは、テナント単位でキャッシュされます。
デフォルトでは、1テナントあたり100個のアイコンをキャッシュします。

5.3.4.10.2. キャッシュサイズの計算式

キャッシュが行われる対象データのおおまかなサイズは以下の計算式で求めることができます。

キャッシュサイズ = (1) × (2)

(1) ... アイコンの中で一番大きいバイト数
(2) ... キャッシュするオブジェクトの数

intra-mart Accel Platform のデフォルト値は以下の計算をもとに設定されています。

5000 × 100 = 500000
⇒ 500KB