Conectar a um Backend do Atlas App Services - SDK do Node.js

Antes de começar

1. Criar um App Services App

2. Instalar o Realm Node.js SDK

Acesse o cliente do aplicativo

Para se conectar ao backend do App Services a partir do seu cliente, você precisa criar um objeto de configuração. Em seguida, passe esse objeto de configuração para uma instância Realm.App() .

Você deve incluir o campo id e o App ID para seu App Services App, que você pode encontrar na UI do App Services.

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

Você pode criar várias instâncias do cliente de aplicativo para se conectar a vários aplicativos. Todas as instâncias de cliente de aplicativo que compartilham a mesma ID de aplicativo usam a mesma conexão subjacente.

Recuperar uma instância do cliente do aplicativo

Para recuperar uma instância do cliente de aplicativo de qualquer lugar em seu aplicativo, chame Realm.App.getApp() e passe seu App ID.

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

Configurar um tempo limite para o cliente do aplicativo

Você pode configurar um timeout opcional para solicitações em seu AppConfiguration. Ele aceita vários milissegundos antes que a solicitação expire.

Você pode usar esse intervalo de tempo limite com o booleano opcional da configuração de sincronização cancelWaitsOnNonFatalErrors . Quando o intervalo de tempo limite termina, qualquer trabalho pendente que esteja aguardando uploads e downloads é cancelado. Quando essa configuração é falsa, a espera por uploads e downloads não é cancelada porque o Realm trata esses tempos limite como erros não fatais.

Para obter um exemplo, consulte Cancelar operações assíncronas após um tempo-limite.

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

Criptografar metadados de aplicativos

Você pode criptografar os metadados que o Atlas App Services armazena nos dispositivos do cliente. Use os valores do enum MetadataMode para determinar o comportamento da criptografia.

Para criptografar os metadados do app:

1. Importar MetadataMode de Realm e importar outras dependências:

   JavaScript

   TypeScript

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

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

2. Crie um objeto de configuração do aplicativo que contenha a propriedade metadata .

3. Defina metadata.mode como MetadataMode.Encryption.

4. Defina metadata.encryptionKey para a chave que você deseja usar para criptografia.

5. Passe o objeto de configuração do aplicativo para 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);

Conecte-se a um servidor MongoDB específico

Por padrão, o Atlas Device SDK se conecta ao Atlas usando o baseURL global de https://services.cloud.mongodb.com. Em alguns casos, você pode querer se conectar a um servidor diferente:

• Seu App Services App usa o sistema local e você deseja se conectar diretamente a um baseURL local em sua região.

Você pode especificar um baseURL no AppConfiguration:

.. 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",
   // ...
}