连接到 Atlas App Services 后端 - Node.js SDK

开始之前

1. 创建 App Services App

2. 安装 Realm Node.js SDK

访问应用程序客户端

要从客户端连接到 App Services 后端，您需要创建一个配置对象。然后，将该配置对象传递给 Realm.App()实例。

您必须包含 App Services App 的id字段和 App ID ，您可以在 App Services 用户界面中找到它们。

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

您可以创建多个应用客户端实例以连接多个应用。共享相同 App ID 的所有 App 客户端实例使用相同的底层连接。

检索应用程序客户端的实例

要从应用程序中的任何位置检索 App Client 实例，请调用Realm.App.getApp()并传入App ID 。

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

为 App Client 配置超时

您可以在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并导入其他依赖项：

2. 创建包含metadata属性的应用配置对象。

3. 将 metadata.mode 设置为 MetadataMode.Encryption。

4. 将metadata.encryptionKey设置为要用于加密的密钥。

5. 将应用配置对象传递给new Realm.App() 。