クラスのエクスポート=

Realm データベース。

コンストラクター

プロパティ

syncSession: null | セッション

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

デフォルト パス: string = ...

アクセス

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

    ブール値を返します

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

    以来

    1.10.3

メソッド

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

    Returns void

  • この 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 オブジェクト、または指定されたコレクション内の各 1 つを削除します。

    パラメーター

    • subject :任意

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

    Returns void

  • すべてのイベント リスナーを削除します(イベント 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

  • 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 、および "" です。

    型パラメータ

    パラメーター

    • objectSchema : export= . ObjectSchema

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

    Tを返します

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

    パラメーター

    • arg : string |構成={}

      Realm の構成またはそのパス。

    ブール値を返します

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

    スロー

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

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

    パラメーター

    • arg : string |構成={}

      Realm の構成またはそのパス。

    gressRealmPromise を返す

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

    スロー

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

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

    パラメーター

    • path : string

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

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

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

    数値を返します

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

    スロー

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

    以来

    0.11.0

  • ロガーのコールバックを設定します。

    パラメーター

    • loggerCallback : LoggerCallback

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

    Returns void

    注意

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

    以来

    12.0.0

TypeDocを使用して生成