Record クラス

定義

[Android.Runtime.Register("java/lang/Record", ApiSince=34, DoNotGenerateAcw=true)]
public abstract class Record : Java.Lang.Object

[<Android.Runtime.Register("java/lang/Record", ApiSince=34, DoNotGenerateAcw=true)>]
type Record = class
    inherit Object

継承

Object

JavaObject

Object

Record

属性

RegisterAttribute

注釈

これは、すべてのJava言語レコード クラスの共通基本クラスです。

コンパイラによって合成された暗黙的に宣言されたメソッドの説明など、レコードの詳細については、<cite>Java言語仕様</引用>のセクション 8.10 を参照してください。

<em>record クラス</em>は、<em>record コンポーネント</em>と呼ばれる固定された値のセットに対して、浅く不変の透過的なキャリアです。 Java言語では、レコード クラスを宣言するための簡潔な構文が提供され、レコード コンポーネントがレコード ヘッダーで宣言されます。 レコード ヘッダーで宣言されたレコード コンポーネントのリストは、 <em>record 記述子</em>を形成します。

レコード クラスには、次の必須メンバーがあります。 <em>canonical コンストラクター</em>。レコード クラスと同程度のアクセス権を持ち、その記述子がレコード記述子と同じである必要があります。名前と型がコンポーネントの名前と型と同じである各コンポーネントに対応するプライベート最終フィールド。各コンポーネントに対応するパブリック アクセサー メソッド。 名前と戻り値の型がコンポーネントの名前と戻り値の型と同じである。 レコードの本文で明示的に宣言されていない場合は、これらのメンバーの暗黙的な実装が提供されます。

正規コンストラクターの暗黙的な宣言は、レコード クラスと同じアクセシビリティを持ち、対応するコンストラクター引数からコンポーネント フィールドを初期化します。 アクセサー メソッドの暗黙的な宣言は、対応するコンポーネント フィールドの値を返します。 Object#equals(Object)、Object#hashCode()、およびObject#toString()メソッドの暗黙的な宣言は、すべてのコンポーネント フィールドから派生します。

正規コンストラクターまたはアクセサー メソッドに明示的な宣言を提供する主な理由は、コンストラクターの引数の検証、変更可能なコンポーネントに対する防御コピーの実行、コンポーネントのグループの正規化 (有理数を最下位の用語に減らすなど) です。

すべてのレコード クラスについて、レコード R のコンポーネントが c1, c2, ... cnされている場合、レコード インスタンスが次のようにコピーされる場合は、次のインバリアントを保持する必要があります。

R copy = new R(r.c1(), r.c2(), ..., r.cn());

その場合は、 r.equals(copy)する必要があります。

16 で追加されました。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。