Atlas App Services バックエンドへの接続 - Node.js SDK

始める前に

1. App Services アプリの作成

2. Realm Node.js SDKのインストール

アプリ クライアントへのアクセス

クライアントから App Services バックエンドに接続するには、構成オブジェクトを作成する必要があります。 次に、その構成オブジェクトを Realm.App()インスタンスに渡します。

App Services App には、 idフィールドと App IDを含める必要があります。これは App Services UI で確認できます。

// Initialize your App.
const app = new Realm.App({
  id: "<yourAppId>",
});

複数のアプリに接続するには、複数のアプリクライアントインスタンスを作成します。 同じアプリ ID を共有するすべてのアプリクライアント インスタンスは、同じ基礎の接続を使用します。

アプリ クライアントのインスタンスの取得

アプリケーション内の任意の場所からアプリクライアントのインスタンスを取得するには、 Realm.App.getApp()を呼び出し、 App IDを渡します。

const app = Realm.App.getApp("<yourAppId>");

アプリ クライアントのタイムアウトの設定

AppConfigurationでリクエストに任意のtimeoutを構成できます。 リクエストがタイムアウトする前に、数ミリ秒を受け入れます。

このタイムアウト間隔は任意の同期構成cancelWaitsOnNonFatalErrorsブール値で使用できます。 タイムアウト間隔が経過すると、アップロードとダウンロードを待機している未処理の作業がキャンセルされます。 この設定が false の場合、アップロードとダウンロードを待機してもキャンセルされません。これは、Realm がこれらのタイムアウトを致命的でないエラーとして扱うためです。

例については、「 タイムアウト後に非同期操作をキャンセルする 」を参照してください。

const app = new Realm.App({
  id: APP_ID,
  // You can optionally specify a timeout in milliseconds
  timeout: 10000,
});

アプリ メタデータの暗号化

App Services がクライアント デバイスに保存するメタデータを暗号化できます。 暗号化動作を決定するには、 MetadataMode 列挙型の値を使用します。

アプリのメタデータを暗号化するには:

1. Realm MetadataModeをインポートし、他の依存関係をインポートします。

   JavaScript

   TypeScript

   import Realm, { BSON, MetadataMode } from "realm";

   import Realm, {
     AppConfiguration,
     BSON,
     MetadataMode,
     Configuration,
   } from "realm";

2. metadataプロパティを含むアプリ構成オブジェクトを作成します。

3. metadata.modeをMetadataMode.Encryptionに設定します。

4. 暗号化に使用するキーにmetadata.encryptionKeyを設定します。

5. アプリ構成オブジェクトをnew Realm.App()に渡します。

// Retrieve encryption key from secure location or create one
const encryptionKey = new ArrayBuffer(64);
// Use encryption key in app configuration
const config = {
  id: APP_ID,
  metadata: { mode: MetadataMode.Encryption, encryptionKey: encryptionKey },
};
const app = new Realm.App(config);

// Retrieve encryption key from secure location or create one
const encryptionKey = new ArrayBuffer(64);
// Use encryption key in app configuration
const config: AppConfiguration = {
  id: APP_ID,
  metadata: { mode: MetadataMode.Encryption, encryptionKey: encryptionKey },
};
const app = new Realm.App(config);

特定のサーバーへの接続

デフォルトでは、Atlas Device SDK はhttps://services.cloud.mongodb.comのグローバルbaseURLを使用して Atlas に接続します。 場合によっては、別のサーバーに接続する必要があるかもしれません。

• App Services Appはローカル配置を使用しており、リージョン内のローカル baseURL に直接接続する場合があります。

AppConfigurationでbaseURLを指定できます。

.. code-block:: javascript
   const appConfig = {
     id: APP_ID,
     baseUrl: "https://example.com",
   };
   const app = new App(appConfig);

.. code-block:: typescript
   const appConfig: AppConfiguration = {
     id: APP_ID,
     baseUrl: "https://example.com",
   };
   const app = new App(appConfig);

const app = new App(EDGE_APP_ID);
await app.updateBaseUrl("http://localhost:80");
// ... log in a user and use the app...
// ... some time later...
// Reset baseURL to the default: https://services.cloud.mongodb.com
await app.updateBaseUrl(null);

const app = new App(EDGE_APP_ID);
await app.updateBaseUrl("http://localhost:80");
// ... log in a user and use the app...
// ... some time later...
// Reset baseURL to the default: https://services.cloud.mongodb.com
await app.updateBaseUrl(null);

import "realm/experimental/base-url";

{
   "target": "es2022",
   "module": "node16",
   "moduleResolution": "node16",
   // ...
}