クッキーモジュール(Cookie)
このモジュールはデータを管理するためのモジュールです。
パラメータモジュールはメモリ上で管理するのに対し、クッキーはデータベース上で管理しますので、サーバを再起動してもデータが永続的に保持されます。
クッキーはユーザごとに保持され、ゲストユーザはゲストログインしたときのデフォルト値が保持されています。
用途は以下のようなものになります。
- 実行するユーティリティのフラグ
- チャットルームなどの入室状況
- 接続しているクライアントの状況
- ユーザレベルやハンドルネームなどのアカウント情報
- メニューモードなどの端末環境設定
new()
オブジェクトを作成します。
設定名 | 説明 |
---|---|
userid | ユーザID BIG-ModelアプリケーションでのユーザIDを指定します。 |
db_username | データベースのユーザ名 |
db_password | データベースのパスワード |
schema_name | データベースのスキーマ名 |
table_name | データベースのテーブル名 |
obj | |
---|---|
返り値 | 説明 |
(生成されたオブジェクト) | 成功 |
(undef) | 失敗 |
ユーザIDはアスキー文字(半角英数字)の他、漢字やひらがななども使用することができます。
ユーザIDは半角英字の大文字小文字を区別していますので'user'と'USER'はそれぞれ別のユーザになります。
クッキーモジュールが使用するテーブルはテーブル構造が厳密に決められていて、id, userid, k, vの4つのフィールドが定義されていることが必要です。
CREATE TABLE `cookie` ( `id` INT(11) NOT NULL AUTO_INCREMENT, `userid` VARCHAR(50) NULL DEFAULT NULL COLLATE 'utf8_general_ci', `k` VARCHAR(255) NULL DEFAULT NULL COLLATE 'utf8_general_ci', `v` TEXT NULL DEFAULT NULL COLLATE 'utf8_general_ci', PRIMARY KEY (`id`) USING BTREE ) COLLATE='utf8_general_ci' ENGINE=InnoDB ;
関数new()を呼び出したとき、4つのフィールドが定義されていないとオブジェクトが作成されません。
フィールド名が違っていたり、フィールドが不足もしくは4つのフィールド以外のフィールドが定義されていても無効とみなされ、オブジェクトが作成されません。