Atlas App Services 백엔드에 연결 - Java SDK

이 페이지의 내용

Realm 초기화

앱 클라이언트에 액세스
구성

Atlas Device SDK는 더 이상 사용되지 않습니다. 자세한 내용은 지원 중단 페이지 를 참조하세요.

앱 클라이언트 는 App Services 백엔드 의 인터페이스입니다. 인증 기능 및 동기화 관리에 대한 액세스 를 제공합니다.

Realm 초기화

앱에서 Realm을 사용하려면 먼저 Realm 라이브러리를 초기화해야 합니다. 애플리케이션은 애플리케이션이 실행될 때마다 Realm을 한 번만 초기화해야 합니다.

Realm 라이브러리를 초기화하려면 Realm.init() 정적 함수에 Android context 를 제공합니다. 동작의 차이 없이 초기화를 위해 활동, 프래그먼트 또는 애플리케이션 context 을(를) 제공할 수 있습니다. 애플리케이션 하위 클래스 의 메서드에서 Realm 라이브러리를 초기화할 수 onCreate() 있습니다. 애플리케이션 이 실행될 때마다 Realm 을 한 번만 초기화하도록 합니다.

Realm.init(this); // context, usually an Activity or Application

Realm.init(this) // context, usually an Activity or Application

팁

Android 매니페스트에 애플리케이션 서브클래스 등록

자체 Application 하위 클래스를 생성하는 경우 사용자 지정 애플리케이션 로직을 실행하려면 이를 애플리케이션의 AndroidManifest.xml 에 추가해야 합니다. 매니페스트 애플리케이션 정의의 android.name 속성을 설정하여 사용자가 애플리케이션을 실행할 때 Android가 다른 클래스보다 먼저 Application 하위 클래스를 인스턴스화하도록 합니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="com.mongodb.example">
   <application
      android:name=".MyApplicationSubclass"
      ...
   />
</manifest>

앱 클라이언트에 액세스

Realm UI 에서 찾을수 있는 앱의 앱 ID 를 전달합니다.

String appID = YOUR_APP_ID; // replace this with your App ID
App app = new App(new AppConfiguration.Builder(appID).build());

val appID : String = YOUR_APP_ID // replace this with your App ID
val app: App = App(AppConfiguration.Builder(appID).build())

중요

인스턴스를 생성하기 전에 앱 초기화

App 인스턴스 를 만들기 전에 Realm.init() 으)로 앱 연결을 초기화해야 합니다.

구성

대부분의 사용 사례에서는 애플리케이션의 앱 ID 만 있으면 App Services 에 연결할 수 있습니다. 연결에 대한 사용자 지정 시간 초과, MongoDB 데이터 액세스에 사용되는 코덱, 로컬 암호화 를 위한 키와 같은 앱 연결의 세부 정보를 더 세밀하게 제어하려면 선택적으로 AppConfiguration 빌더를 사용하여 App 의 세부 정보를 제어할 수 있습니다.

String appID = YOUR_APP_ID; // replace this with your App ID
App app = new App(new AppConfiguration.Builder(appID)
        .appName("My App")
        .requestTimeout(30, TimeUnit.SECONDS)
        .build());

val appID = YOUR_APP_ID // replace this with your App ID
val app: App = App(AppConfiguration.Builder(appID)
    .appName("My App")
    .requestTimeout(30, TimeUnit.SECONDS)
    .build())

여러 앱 클라이언트 인스턴스를 만들어 여러 앱에 연결할 수 있습니다. 동일한 앱 ID 를 주식 하는 모든 앱 클라이언트 인스턴스는 동일한 기본 연결을 사용합니다.

중요

앱 초기화 후 앱 구성 변경하기

버전 v10.18.0에서 변경됨: urlPrefix 이(가) 앱 구성에 캐시되지 않습니다.

앱 클라이언트 를 초기화하면 구성이 내부적으로 캐시됩니다. 동일한 프로세스 내에서 구성이 변경된 앱을 닫았다가 다시 열려고해도 아무런 효과가 없습니다. 클라이언트 는 캐시된 구성을 계속 사용합니다.

Java SDK 버전 10.18.0 이상에서는 urlPrefix 가 더 이상 앱 구성에 캐시되지 않습니다. 즉, urlPrefix 을 변경할 수 있으며 앱 클라이언트 는 업데이트된 구성을 사용합니다. 이전 SDK 버전에서는 캐시된 앱 구성의 urlPrefix 변경 사항이 적용되지 않았습니다.

돌아가기

Atlas App Services

함수 호출