クラスRealm

Realm データベース。

コンストラクター

  • デフォルト パスに新しいRealmインスタンスを作成します。

    Realm を返す

    スロー

    互換性のない同期された Realm を開くときのエラー。

  • 指定されたパスに新しいRealmインスタンスを作成します。

    パラメーター

    • path : string

      Realm を初めて作成するときに必要です。

    Realm を返す

    スロー

    指定されたパスで Realm を開くことができない場合は、 エラーが発生します。

    スロー

    互換性のない同期された Realm を開くときのエラー。

  • 提供された構成を使用して新しいRealmインスタンスを作成します。 Realm がまだconfig.path (提供されていない場合はRealm.defaultPath )に存在しない場合、このコンストラクターは指定されたconfig.schema (この場合は必須)を使用してそれを作成します。 それ以外の場合、インスタンスはそのパスにある ファイルから既存の Realm にアクセスします。 この場合、 config.schema任意であるか、変更されていない場合にのみ、 config.schemaVersionが増加している場合を除き、Realm は新しいスキーマを使用するように自動的に移行されます。 クエリベースの同期の場合は、 config.schemaが必要です。 config.schemaが定義されていない場合は、例外がスローされます。

    パラメーター

    • config :構成

      Realm を初めて作成するときに必要です。

    Realm を返す

    スロー

    提供された構成内のいずれかが無効な場合は、 エラー。

    スロー

    互換性のない同期された Realm を開くときのエラー。

プロパティ

リスナーに通知する前に: any
変更リスナー: any
クラス: any
初期サブスクリプションの処理: any

必要に応じて、初期サブスクリプションでサブスクライブを更新します。

パラメーター: initialSubscriptions

初期サブスクライブ。

パラメーター: RealmExists

邦土がすでに存在するかどうか。

schema Extras: any
スキーマ リスナー: any
syncSession: null | セッション

同期セッション(同期された Realm の場合)

デフォルト パス: string
暗号化キーの決定: any
パスを決定する: any

注意

パスが相対的で、構成に同期オブジェクトが含まれている場合、Core は既存のファイル拡張子を置き換えるか、「.realm」を追加します 接尾辞。

スキーマ モードを決定する: any
スキーマ追加の抽出: any
internals: any
パスを正規化する: any

TODO: ".realm" を保証することでこれを超えることを検討してください 接尾辞(プロセス内の他の SDK チームと調整)

移行をラップします: any

アクセス

  • get isClosed ( ) :ブール値
  • この Realm が閉じているかどうかを示します。

    ブール値を返します

    true 閉じている場合はfalse 、閉じている場合は 。

    以来

    2.1.0

  • get isEmpty ( ) :ブール値
  • この Realm にオブジェクトが含まれているかどうかを示します。

    ブール値を返します

    true 空の場合は 、それ以外の場合はfalse

    以来

    1.10.0

  • get isInMemory ( ) :ブール値
  • この Realm がメモリ内で開かれているかどうかを示します。

    ブール値を返します

    true この Realm がメモリ内である場合は 、それ以外の場合はfalseになります。

  • get isInMigration ( ) :ブール値
  • この Realm が移行中かどうかを示します。

    ブール値を返します

    true 移行している場合は、それ以外の場合はfalse

    以来

    12.3.0

  • get isInTransaction ( ) :ブール値
  • この Realm が書込みトランザクション (write transaction) 内かどうかを示します。

    ブール値を返します

    true 書込みトランザクション(write transaction)にある場合は、それ以外の場合はfalse

    以来

    1.10.3

  • get isReadOnly ( ) :ブール値
  • この Realm が読み取り専用として開かれているかどうかを示します。

    ブール値を返します

    true この Realm が読み取り専用の場合は 、それ以外の場合はfalseになります。

    以来

    0.12.0

  • パスを取得します : string
  • この Realm が保存されているファイルへのパス。

    string を返します

    この Realm が保存されているファイルへのパスを含む string。

    以来

    0.12.0

  • スキーマを取得する : CanonicalObjectSchema []
  • この Realm が構築されたときに構成で提供されたスキーマの正規化された表現。

    CanonicalObjectSchema を返します[]

    この Realm 内のすべてのオブジェクトを記述するCanonicalObjectSchemaの配列。

    以来

    0.12.0

  • get schemaVersion ( ) : number
  • Realm の現在のスキーマ バージョン。

    数値を返します

    この Realm のスキーマ バージョン( number

    以来

    0.12.0

  • サブスクリプションを取得する : SubscriptionSet
  • Flexible Sync サブスクライブの最新セット。

    SubscriptionSet を返す

    SubscriptionSetオブジェクト。

    スロー

    このアプリでフレキシブルな同期が有効になっていない場合は、 エラーが発生します。

メソッド

  • 型パラメータ

    パラメーター

    • タイプ:コンストラクター< T >
    • objectKey : string

    次の未定義の|を返します。 T

  • 指定された eventName のリスナー コールバックを追加します。

    パラメーター

    • eventName : RealmEventName

      コールバックを呼び出すイベントの名前。

    • callback: RealmListenerCallback

      変更イベントが発生したときに呼び出される関数。 各コールバックは、追加された回数に関係なく、イベントごとに 1 回のみ呼び出されます。

    Returns void

    スロー

    無効なイベント eventName が指定されている場合、Realm が閉じている場合、またはコールバックが関数でない場合は、エラーが発生します。

  • 書込みトランザクション (write transaction) を開始します。

    トランザクションを実行するときは、エラー処理を行うことを強くお勧めします。 エラーを処理しないと、データの整合性が失われる可能性があります。 エラー処理には、多くの場合トランザクションのキャンセルが含まれます。

    Returns void

    スロー

    すでに書込みトランザクションが実行されている場合は エラー

    詳細は、次を参照してください:

    realm.beginTransaction();
    try {
    realm.create('Person', { name: 'Arthur Dent', origin: 'Earth' });
    realm.create('Person', { name: 'Ford Prefect', origin: 'Betelgeuse Five' });
    realm.commitTransaction();
    } catch (e) {
    realm.cancelTransaction();
    throw e;
    }
  • 書込みトランザクション (write transaction) をキャンセルします。

    Returns void

    詳細は、次を参照してください:

    startTransaction

  • この Realm を閉じて、新しいスキーマ バージョンで再度開かれるようにします。 このメソッドを呼び出すと、この Realm のすべてのオブジェクトとコレクションは有効ではなくなります。 メソッドは偶数です。

    Returns void

  • 書込みトランザクション (write transaction) をコミットします。

    Returns void

    詳細は、次を参照してください:

    startTransaction

  • この Realm 内のすべての string 列を string 列挙列に置き換え、データベースファイルを圧縮します。

    書込みトランザクション (write transaction) からは呼び出せません。

    他のRealmインスタンスが存在する場合は、圧縮は行われません。

    圧縮の進行中、 は他のスレッドまたはプロセスによるデータベースを開こうとする試行を待機します。

    圧縮のためのリソース要件は、データベース内のライブ データの量に比例することに注意してください。 Compaction works by writing the database contents to a temporary database file and then replacing the database with the temporary one.

    ブール値を返します

    true 圧縮が成功した場合は 、成功しない場合はfalseになります。

  • 指定されたタイプと指定されたプロパティを持つ新しいRealm オブジェクトを作成します。 非対称マークされたオブジェクトの場合、 undefinedが返されます。 非対称オブジェクトの API は、将来変更される可能性があります。

    型パラメータ

    • T = DefaultObject

    パラメーター

    • : string

      作成する Realm オブジェクトのタイプ。

    • :部分的な< T > |部分的な<管理されていない< T > >

      デフォルト値のないすべての必須プロパティのプロパティ値。

    • Optional モード:ブール値|しない|変更された|すべて

      任意の更新モード。 デフォルトはUpdateMode.Neverです。

    オブジェクト < T を返し、 > & T は返され ません

    RealmObjectまたはオブジェクトが非対称の場合はundefined

  • 型パラメータ

    パラメーター

    Tを返します

  • 指定された Realm オブジェクト、または指定されたコレクション内の各 1 つを削除します。

    パラメーター

    • subject :任意

      削除する Realm オブジェクト、または削除する複数の Realm オブジェクトを含むコレクション。

    Returns void

  • 警告:これにより、Realm 内のすべてのオブジェクトが削除されます。

    Returns void

  • すべてのオブジェクトを含む Realm モデルを削除します。 移行関数外で呼び出されると、スキーマschemaVersionが更新されます。

    パラメーター

    • name : string

      モデル名。

    Returns void

  • プライマリキーで Realm オブジェクトを検索します。

    型パラメータ

    • T = DefaultObject

    パラメーター

    • : string

      検索する Realm オブジェクトのタイプ。

    • プライマリキー : T [ T のキー ]

      検索するオブジェクトのプライマリキー値。

    null |を返すオブジェクト< T 絶対> & T

    RealmObjectまたはオブジェクトが見つからない場合はnull

    スロー

    このメソッドに渡される型が無効な場合、またはオブジェクト型のスキーマでプライマリキーが指定されていない場合、あるいは非対称としてマークされている場合は、 エラー。

    以来

    0.14.0

  • 型パラメータ

    パラメーター

    • タイプ:コンストラクター< T >
    • プライマリキー : T [ T のキー ]

    null |を返すT

  • Realm 内の指定された型のすべてのオブジェクトを返します。

    型パラメータ

    • T = DefaultObject

    パラメーター

    • : string

      検索する Realm オブジェクトのタイプ。

    結果 < オブジェクト < T で、 > & T > は返され ません

    オブジェクトが作成、変更、破棄されるにつれてライブアップデートされる結果。

    スロー

    このメソッドに渡される型が無効な場合、または型が埋め込みまたは非対称としてマークされている場合は、エラーが発生します。

  • 型パラメータ

    パラメーター

    • タイプ:コンストラクター< T >

    結果< T >を返す

  • すべてのイベント リスナーを削除します(イベント eventName が提供されている場合は、このリスナーに制限されます)。

    パラメーター

    • Optional eventName : RealmEventName

      リスナーを削除するイベントの名前。

    Returns void

    スロー

    無効なイベント eventName が指定された場合はエラー。

  • 指定されたイベント eventName のリスナー コールバックを削除します。

    パラメーター

    Returns void

    スロー

    無効なイベント eventName が指定されている場合、Realm が閉じている場合、またはコールバックが関数でない場合は、 エラー。

  • 書込みトランザクション (write transaction) 内で、指定されたコールバックを同期して呼び出します。 トランザクション内で例外が発生した場合、そのトランザクションの変更は失われますが、Realm 自体は影響を受けません(または破損)。 より正確には、 startTransactioncommitTransactionが自動的に呼び出されます。 トランザクション中に例外が発生した場合、 commitTransaction ではなく CancelTransaction が呼び出され、例外は Write の呼び出し元に再スローされます。

    ネストされたトランザクション(書込み内での書込みの呼び出し)は実行できません。

    型パラメータ

    • t

    パラメーター

    • コールバック: => T

      書込みトランザクション (write transaction) 内で呼び出される関数。

        • (): t
        • Tを返します

    Tを返します

    コールバックからの戻り値。

  • 指定された構成を持つ Realm の圧縮されたコピーを書込みます。

    宛先ファイルがすでに存在することはできません。 同期された Realm と同期されていない Realm 間のすべての変換はサポートされており、 出力を記述する必要な構成パラメーターに従って実行されます。

    このメソッドが書込みトランザクション (write transaction) 内から呼び出されると、前の書込みトランザクションがコミットされた時点のデータではなく、現在のデータが書き込まれることに注意してください。

    パラメーター

    • config :構成

      出力邦土を記述する Realm 構成。

    Returns void

  • Private

    デフォルト ディレクトリ内のすべての Realm を閉じて削除し、すべてのユーザーをログアウトして状態をクリアします。 注: パブリック API の一部ではなく、主にライブラリのテストで使用されます。

    Returns void

  • Realm ファイル( *.realm )は、アプリケーション ディレクトリからアプリケーションのドキュメント ディレクトリにバンドルされており、Realm で開いて使用できるようになります。 ファイルがすでにドキュメント ディレクトリに存在する場合は、上書きされないため、これは複数回安全に呼び出せます。

    バンドルされている Realm ファイルを書き込みできる場所に移動するには、Realm を開く前にこれを呼び出す必要があります。

    Returns void

    // Given a bundled file, example.realm, this will copy example.realm (and any other .realm files)
    // from the app bundle into the app's documents directory. If the file already exists, it will
    // not be overwritten, so it is safe to call this every time the app starts.
    Realm.copyBundledRealmFiles();

    const realm = await Realm.open({
    // This will open example.realm from the documents directory, with the bundled data in.
    path: "example.realm"
    });

    これは React Native にのみ実装されています。

    スロー

    I/O エラーが発生した場合、またはメソッドが実装されていない場合は エラー 。

  • Realm モデル クラスのテンプレート オブジェクトを作成します。ここでは、すべてのオプション フィールドは未定義で、すべての必須フィールドには指定されたデータ型のデフォルト値(スキーマのデフォルト プロパティによって設定されている値、またはスキーマが作成されている場合はデータ型のデフォルト値)が含まれます。は 1 つの を指定しません。つまり、0、false 、および "" です。

    型パラメータ

    • t 拡張 レコード<string, 不明>

    パラメーター

    • objectSchema : ObjectSchema

      作成するオブジェクトを記述するスキーマ。

    Tを返します

  • 指定された構成の Realm ファイルを削除します。

    パラメーター

    • config :構成

      削除される Realm の構成。

    Returns void

    スロー

    提供された構成内のいずれかが無効な場合は、 エラー。

  • Realm がすでにディスク上に存在するかどうかを確認します。

    パラメーター

    • path : string

      Realm のパス。

    ブール値を返します

    true デバイスに Realm が存在する場合は 、存在しない場合はfalse

    スロー

    指定されたパス内のいずれかが無効な場合は、 エラーが発生します。

  • Realm がすでにディスク上に存在するかどうかを確認します。

    パラメーター

    • config :構成

      Realm の構成。

    ブール値を返します

    true デバイスに Realm が存在する場合は 、存在しない場合はfalse

    スロー

    提供された構成内のいずれかが無効な場合は、 エラー。

  • Promise を使用してデフォルトの Realm を非同期に開きます。

    gressRealmPromise を返す

    Realm インスタンスが利用可能になると、それによって解決される Promise 。

  • Promise を使用して非同期に Realm を開きます。 Realm が同期されている場合は、使用可能になる前に完全に同期されます。

    パラメーター

    • path : string

      Realm のパス。

    gressRealmPromise を返す

    Realm インスタンスが利用可能になると、それによって解決される Promise 。

  • Promise を使用して非同期に Realm を開きます。 Realm が同期されている場合は、使用可能になる前に完全に同期されます。 クエリベースの同期の場合は、 Configuration.schemaが必要です。 Configuration.schemaが定義されていない場合は、例外がスローされます。

    パラメーター

    • config :構成

      Realm の構成。

    gressRealmPromise を返す

    Realm インスタンスが利用可能になると、それによって解決される Promise 。

    スロー

    提供された構成内のいずれかが無効な場合は、 エラー。

  • 指定されたパスにある Realm の現在のスキーマ バージョンを取得します。

    パラメーター

    • path : string

      Realm データベースが保存されているファイルへのパス。

    • Optional encryptionKey : Arrayバッファ| Arrayバッファビュー

      暗号化された Realm にアクセスする場合にのみ必要です。

    数値を返します

    整数で表されたスキーマのバージョン。または、パス上に Realm が存在しない場合は-1です。

    スロー

    無効な、または一致しない暗号化キーを渡す場合は、 エラーが発生します。

    以来

    0.11.0

  • ログ レベルを設定します。

    パラメーター

    • レベル: LogLevel

      ロガーが使用するログレベル。 デフォルト値はinfoです。

    • Optional カテゴリ: "Realm" | "Realm.Storage" | "Realm.Storage.Transaction" | "Realm.Storage.Query" | "Realm.Storage.Object" | "Realm.Storage.Notification" | "Realm.Sync" | "Realm.Sync.Client" | "Realm.Sync.Client.Session" | "Realm.Sync.Client.changeset" | "Realm.Sync.Client.Network" | "Realm.Sync.Client.Reset" | "Realm.Sync.Server" | "Realm.App" | "Realm.SDK"

      ログ レベルを設定するカテゴリ。 省略した場合、ログ レベルはすべてのカテゴリに設定されます( "Realm" )。

    Returns void

    注意

    ログ レベルは、アプリケーションの有効期間中に変更できます。

    以来

    12.0.0

    Realm.setLogLevel("all");
    
  • ロガーのコールバックを設定します。

    パラメーター

    • loggerCallback : LoggerCallback 2

      ロガーによって呼び出されるコールバック。 デフォルトのコールバックでは、メッセージのレベルに応じて、 console.logconsole.warnconsole.errorが使用されます。

    Returns void

    注意

    最初の Realm を開く前に、ロガー コールバックを設定する必要があります。

    以来

    12.0.0

    Realm.setLogger(({ category, level, message }) => {
    console.log(`[${category} - ${level}] ${message}`);
    });
  • ロガーのコールバックを設定します。

    パラメーター

    • loggerCallback : LoggerCallback 1

      ロガーによって呼び出されるコールバック。 デフォルトのコールバックでは、メッセージのレベルに応じて、 console.logconsole.warnconsole.errorが使用されます。

    Returns void

    注意

    最初の Realm を開く前に、ロガー コールバックを設定する必要があります。

    以来

    12.0.0

    非推奨

    代わりに、単一のオブジェクト引数を受け取るコールバックを渡します。

    Realm.setLogger((level, message) => {
    console.log(`[${level}] ${message}`);
    });
  • すべての Realm を閉じ、保留中のすべてのRealm.open呼び出しをキャンセルし、内部キャッシュをクリアし、ロガーをリセットして、ゴミ箱を収集します。 このメソッドを呼び出してイベント ループを解放し、Node.js がグレースフル終了を実行できるようにします。

    Returns void

TypeDocを使用して生成