nablarch.core.date (Nablarch-API)

Interface Summary
Interface	Description
BusinessDateProvider	業務日付を提供するクラスのインタフェース。
SystemTimeProvider	システム日時を提供するクラスのインタフェース。

Class Description

BasicBusinessDateProvider

業務日付を提供するクラス。

本クラスでは、テーブルで管理されている業務日付を取得する機能を提供する。

業務日付の取得要求の都度データベースアクセスを行うとパフォーマンス上問題となる場合がある。このため、BasicBusinessDateProvider.cacheEnabledプロパティを使用して業務日付のキャッシュ有無を設定でき、データベースアクセスを最小限に抑えることが可能となっている。

BasicBusinessDateProvider.cacheEnabledにtrueを設定するとキャッシュが有効になり、初回アクセス時にテーブルの情報がThreadContextにキャッシュされる。キャッシュされた値の生存期間は、ThreadContextがクリアされるか、スレッドが破棄されるかのどちらかである。

例えば、画面オンライン処理の場合は、リクエスト受付時にThreadContextの情報がクリアされるため、業務日付のキャッシュ有効期間はクライアントからの１リクエストを処理する間となる。

業務日付を管理するテーブルのレイアウトを以下に示す。

カラム名説明区分業務日付を特定するための区分
例えば、画面処理とバッチ処理で日付の更新タイミングが異なる場合は、
画面処理用とバッチ処理用の区分を設けて日付を管理すれば良い。日付区分に対応する業務日付

なお、本クラスでは特定の区分の業務日付をリポジトリ(SystemRepository) に登録した日付で上書きする機能を提供する。この機能は、バッチアプリケーションなどで指定した日付で業務処理を実行したい場合に使用する。
リポジトリに登録された日付の形式が不正な場合、初回アクセス時にRuntimeExceptionを送出する。

リポジトリには、下記形式で上書きを行いたい日付を登録すること。

キー値 BasicBusinessDateProvider.区分値上書く日付以下に例を示す。:

BasicSystemTimeProvider	`Date.Date()`を現在日時とする`SystemTimeProvider`。
BusinessDateUtil	業務日付を取得するユーティリティクラス。業務日付の取得処理は`BusinessDateProvider`によって提供される。 BusinessDateProviderの実装は、`SystemRepository`からコンポーネント名 businessDateProvider で取得される。業務日付の複数設定について本フレームワークでは、オンラインとバッチで別の業務日付を使用するなど、用途ごとに複数の業務日付を管理できる。業務日付には、それぞれを識別するための「区分」が設定される。本クラスは、区分を指定して業務日付を取得する機能を提供する。
SystemTimeUtil	システム日付を取得するユーティリティ。日時、及び日付の取得処理は`SystemTimeProvider`によって提供される。 `SystemTimeProvider`の実装は、`SystemRepository`からコンポーネント名 systemTimeProvider で取得される。

Package nablarch.core.date Description

日付取得機能を提供する。

Skip navigation links

All Classes