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

5.3.4.11. クロスオリジンリソース共有のキャッシュ

クロスオリジンリソース共有のキャッシュについて設定します。
クロスオリジンリソース共有のキャッシュはアプリケーションサーバにつき1つだけ保持されます。

コラム

クロスオリジンリソース共有のキャッシュ設定は テナント管理機能 に含まれています。

注意

クロスオリジンリソース共有のキャッシュは、intra-mart Accel Platform 2019 Summer(Waltz) 以降で利用できます。

  1. 「ProjectNavigator」内の <conf/im-ehcache-config/im_tenant_cors.xml> ファイルをダブルクリックで開き、「ソース」タブを選択してください。
  2. <im-ehcache-config>/<cache> の内容を運用規模に応じて変更します。
<cache
  name="IM_TENANT-SYSTEM-CORS-CONFIG"
  enable="true"
  max-bytes-memory="110k"
  time-to-live-seconds="259200"
  time-to-idle-seconds="259200"
/>

コラム

「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.11.1. キャッシュするオブジェクトの単位

クロスオリジンリソース共有設定情報は、クロスオリジンリクエストによるアクセスがあったパス単位でキャッシュされます。
そのため、キャッシュするオブジェクト数は、クロスオリジンリクエストによるアクセスが想定されるパス数によって見積もります。

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

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

(1) ... クロスオリジンリソース共有設定情報(平均 1100byte)
(1) = (1a) + (1b) + (1c)
(1a) ... パス情報
(1b) ... オリジン情報
(1c) ... その他ヘッダ情報
(2) ... クロスオリジンリクエストによるアクセスが想定されるパス数
intra-mart Accel Platform のデフォルト値は以下の計算をもとに設定されています。
1100 × 100 = 100000
⇒ 110KB

コラム

上記を算出するために利用している各要素の想定数については以下の通りです
  • クロスオリジンリクエストによるアクセスが想定されるパス数 : 100