Record

データタプルのコンテナ。

説明

Record オブジェクトは RecordSet によって返され、リレーションにより編成されたデータで使用するものです。ソース RecordSet （Record.record-set プロパティからアクセスできます）には、このデータの性質を定義づけるスキーマが含まれています。レコードのデータアイテムは get を使って取得できます。modifiable? RecordSetからのレコードは、set を使って変更でき、delete を使って削除できます。 Record.pending-update? プロパティが true である場合は、元の値とペンディング中の値の両方を使用できます。ペンディング中の値は、revert および commit を使って復帰またはコミットできます。レコードの状態が RecordState.detached である場合、その record-set プロパティは null になります。この状態のレコードのメソッドやプロパティにアクセスするとエラーになります。アプリケーションでは Record のインスタンス単体への参照を保持しないようにする必要があります。基本データの変更に応じて、これらのレコードのインスタンスは RecordSet によって（ detached 状態になると）破棄されたり、異なる論理行を参照するよう再利用される可能性があります。ですので、Record を参照する変数は、ローカライズされたスコープを超えて構文の利便性を提供するのを制限される必要があります。例えば、APIの正しい使用法は次の通りです:

{for i:int = 0 below record-view.size do
    let constant r:Record = record-view[i]
    set r["price"] = r["price"] * 0.5
    set r["discount-applied?"] = true
}

しかし、次のようにするとエラーや予期しない結果を引き起こします:

let last-record:Record = record-view[record-view.size - 1]
....
set record-view.source = new-source
set record-view.filter = ""
....
|| error!: record might be detached, or asssociated with other row.
{last-record.delete}

メソッド継承 Object: object-describe, object-describe-for-debugging, object-serialize

pending-update? (アクセサ)

record-set (アクセサ)

state (アクセサ)

commit (メソッド)

ペンディング中の変更をこのレコードにコミットします。

説明

このメソッドを実行すると、このレコードの state プロパティに次のような変化が起こります。

RecordState.modified -> RecordState.original
RecordState.appended -> RecordState.original
RecordState.deleted -> RecordState.detached

レコードを現在の値にコミットできない場合、CommitFailed 例外がスローされ、レコードの状態はそのまま変更されません。

compare-field (メソッド)

最適な比較メソッドを使って、このレコードの RecordField 内の値を別の値と比較します。

field-name: String。対象フィールド。field-name が見つからない場合は RecordFieldNotFound 例外がスローされます。

val: any。比較の対象にする値。

説明

val またはフィールドの現在値のいずれかが null の場合、null 値がすべての non-null 値の次に来るものと考えて比較の結果を決定します。
val がフィールドの Domain の有効なメンバである (あるいはそのように解析できる) 場合、Domain.compare を使います。
比較ができない場合、ValidationException をスローします。

戻り値

int 値。

-1 : self[field-name] が val より小さい場合。
0 : self[field-name] が val に等しい場合。
1 : self[field-name] が val より大きい場合。

delete (メソッド)

field-pending-update? (メソッド)

フィールドの値を any として返します。

name: String。

pending?: bool。 Record がペンディング中の変更を保持している場合 (つまり、state が RecordState.modified に等しい場合)、この引数によってペンディング中の値か元の値のどちらが返されるかを決定します。既定ではペンディング中の値が返されます。

例外のスロー

このメソッドは、該当する name のフィールドがレコードの record-set に見つからないか、レコードが切り離された場合に RecordFieldNotFound 例外をスローします。

is-null? (メソッド)

revert (メソッド)

このレコードを最後にコミットされたときの状態に戻します。

説明

このレコードは、レコードを作成時の状態か最後に復帰またはコミットしたときの状態に戻します。

このメソッドを実行すると、レコードの state プロパティに次のような変化が起こります。

RecordState.modified -> RecordState.original
RecordState.appended -> RecordState.new
RecordState.deleted -> RecordState.original

復帰したデータを持つレコードの検証に失敗した場合、ValidationException がスローされ、レコードはそのまま変更されません。

フィールドの値を any として設定します。

説明

このメソッドを実行すると、レコードの state プロパティに次のような変化が起こります。

RecordState.original -> RecordState.modified

例外のスロー

RecordFieldNotFound — 該当する name のフィールドがレコードの record-set に見つからないか、レコードが切り離された場合。
ValidationException — フィールドが 1 つまたは複数の制約に反しているため、これを適切に設定できない場合。
DataNotModifiable — レコードセットまたはフィールドのどちらも modifiable? が true でない場合。

validate-value (メソッド)

この値をフィールドに挿入できるかどうかを検証します。

説明

アプリケーションでこのメソッドを使い、Record.set を呼び出す前に入力される値をテストすることができます。

戻り値

ValidationException または null。

例外のスロー

RecordFieldNotFound — 該当する name のフィールドがレコードの record-set に見つからないか、レコードが切り離された場合。