Class SC_DB_MasterData

Description

マスタデータを扱うクラス.

プルダウン等で使用するマスタデータを扱う. マスタデータは, DB に格納されているが, パフォーマンスを得るため, 初回のみ DBへアクセスし, データを定義したキャッシュファイルを生成する.

マスタデータのテーブルは, 下記のようなカラムが必要がある.

  1. キーとなる文字列
  2. 表示文字列
  3. 表示順
上記カラムのデータ型は特に指定しないが, 1 と 2 は常に string 型となる.

マスタデータがキャッシュされると, key => value 形式の配列として使用できる. マスタデータのキャッシュは, MASTER_DATA_DIR/マスタデータ名.php というファイルが生成される.

  • author: LOCKON CO.,LTD.
  • version: $Id:SC_DB_MasterData.php 15532 2007-08-31 14:39:46Z nanasess $

Located in /class/db/SC_DB_MasterData.php (line 44)


	
			
Direct descendents
Class Description
SC_DB_MasterData_Ex マスタデータを扱うクラス(拡張).
Variable Summary
mixed $columns
mixed $objQuery
Method Summary
bool clearCache (string $name)
bool createCache (string $name, array $masterData, [bool $isDefine = false], [array $commentColumn = array()])
integer deleteMasterData (string $name, [bool $autoCommit = true])
array getDbMasterData (string $name, [array $columns = array()])
array getDefaultColumnName ([array $columns = array()])
array getMasterData (string $name, [array $columns = array()])
integer insertMasterData (string $name, string $key,  $value, string $comment, [bool $autoCommit = true])
integer registMasterData (string $name, array $columns, array $masterData, [bool $autoCommit = true])
integer updateMasterData (string $name, array $columns, array $masterData, [bool $autoCommit = true])
Variables
mixed $columns = array("id", "name", "rank", "remarks") (line 52)

デフォルトのテーブルカラム名

mixed $objQuery (line 49)

SC_Query インスタンス

Methods
clearCache (line 232)

マスタデータのキャッシュを消去する.

  • return: 消去した場合 true
bool clearCache (string $name)
  • string $name: マスタデータ名
createCache (line 255)

マスタデータのキャッシュを生成する.

引数 $name のマスタデータキャッシュを生成する. 既存のキャッシュが存在する場合は上書きする.

引数 $isDefine が true の場合は, 定数を生成する. 定数コメントを生成する場合は, $commentColumn を指定する.

  • return: キャッシュの生成に成功した場合 true
bool createCache (string $name, array $masterData, [bool $isDefine = false], [array $commentColumn = array()])
  • string $name: マスタデータ名
  • array $masterData: マスタデータ
  • bool $isDefine: 定数を生成する場合 true
  • array $commentColumn: [0] => キー, [1] => コメント文字列,
deleteMasterData (line 210)

マスタデータを削除する.

引数 $name のマスタデータを削除し, キャッシュも削除する.

  • return: マスタデータの削除数
integer deleteMasterData (string $name, [bool $autoCommit = true])
  • string $name: マスタデータ名
  • bool $autoCommit: トランザクションを自動的に commit する場合 true
getDbMasterData (line 302)

DBからマスタデータを取得する.

キャッシュの有無に関係なく, DBからマスタデータを検索し, 取得する.

返り値は, key => value 形式の配列である.

  • return: マスタデータ
array getDbMasterData (string $name, [array $columns = array()])
  • string $name: マスタデータ名
  • array $columns: [0] => キー, [1] => 表示文字列, [2] => 表示順 を表すカラム名を格納した配列
getDefaultColumnName (line 332)

デフォルトのカラム名の配列を返す.

引数 $columns が空の場合, デフォルトのカラム名の配列を返す. 空でない場合は, 引数の値をそのまま返す.

  • return: カラム名を格納した配列
array getDefaultColumnName ([array $columns = array()])
  • array $columns: [0] => キー, [1] => 表示文字列, [2] => 表示順 を表すカラム名を格納した配列
getMasterData (line 74)

マスタデータを取得する.

以下の順序でマスタデータを取得する.

  1. MASTER_DATA_DIR のマスタデータキャッシュを include_once() で読み込む
  2. 1 で読み込んだ値をチェックし, 値が変数定義されていれば値を返す. されていなければ, 次の処理を行う.
  3. 値が未定義の場合は, DBからマスタデータを取得する.
  4. 取得した後, マスタデータのキャッシュを生成し, 値を返す.
返り値は, key => value 形式の配列である.

  • return: マスタデータ
array getMasterData (string $name, [array $columns = array()])
  • string $name: マスタデータ名
  • array $columns: [0] => キー, [1] => 表示文字列, [2] => 表示順 を表すカラム名を格納した配列
insertMasterData (line 178)

マスタデータを追加する.

引数 $masterData の値でマスタデータを更新する. $masterData は key => value 形式の配列である必要がある.

  • return: マスタデータの更新数
integer insertMasterData (string $name, string $key,  $value, string $comment, [bool $autoCommit = true])
  • string $name: マスタデータ名
  • string $key: キー名
  • string $comment: コメント
  • bool $autoCommit: トランザクションを自動的に commit する場合 true
  • $value
registMasterData (line 109)

マスタデータをDBに追加する.

引数 $masterData をマスタデータとしてDBに追加し, キャッシュを生成する. 既存のキャッシュが存在する場合は上書きする. $masterData は key => value 形式の配列である必要がある.

  • return: マスタデータの登録数
integer registMasterData (string $name, array $columns, array $masterData, [bool $autoCommit = true])
  • string $name: マスタデータ名
  • array $columns: [0] => キー, [1] => 表示文字列, [2] => 表示順 を表すカラム名を格納した配列
  • array $masterData: マスタデータ
  • bool $autoCommit: トランザクションを自動的に commit する場合 true
updateMasterData (line 144)

マスタデータを更新する.

引数 $masterData の値でマスタデータを更新する. $masterData は key => value 形式の配列である必要がある.

  • return: マスタデータの更新数
integer updateMasterData (string $name, array $columns, array $masterData, [bool $autoCommit = true])
  • string $name: マスタデータ名
  • array $columns: [0] => キー, [1] => 表示文字列, [2] => 表示順 を表すカラム名を格納した配列
  • array $masterData: マスタデータ
  • bool $autoCommit: トランザクションを自動的に commit する場合 true

Documentation generated on Tue, 28 Apr 2009 18:13:16 +0900 by phpDocumentor 1.4.2