managed 사용자 지정 사용자 데이터 - Kotlin SDK

전제 조건

사용자 지정 사용자 데이터를 사용하려면 사용자 지정 사용자 데이터가 활성화된 App Services App이 있어야 합니다.

사용자 지정 사용자 데이터를 사용하는 App Services App을 설정하려면 다음을 참조하세요.

1. Atlas App Services에 앱 연결

2. App Services 문서에서 사용자 지정 사용자 데이터 활성화

사용자 지정 사용자 데이터 읽기

User.customDataAsBsonDocument() 확장 함수를 사용하여 현재 로그인한 사용자의 사용자 지정 사용자 데이터를 검색할 수 있습니다.

val user = app.currentUser!!
val customUserData = user.customDataAsBsonDocument()

Atlas App Services는 기본 데이터가 변경될 때 클라이언트 사이드 사용자 사용자 지정 데이터 문서의 값을 즉시 동적으로 업데이트하지 않습니다 . 대신 App Services는 사용자가 액세스 토큰을 새로 고칠 때마다 또는 명시적으로 User.refreshCustomData() 함수를 호출하여 사용자의 사용자 지정 데이터의 최신 버전을 요청할 때마다 최신 버전의 사용자 지정 사용자 데이터를 가져옵니다.

// Update the custom data object
user.refreshCustomData()
// Now when you access the custom data, it's the
// updated data object
val updatedUserData = user.customDataAsBsonDocument()

Atlas Function으로 사용자 지정 사용자 데이터 쓰기

Atlas Function을 사용하여 사용자 지정 사용자 데이터에 쓸 수 있습니다. Atlas Function은 백엔드 앱에 내장된 서버 측 JavaScript 함수입니다. Realm 코틀린 SDK (Kotlin SDK)에서 직접 Atlas Function을 호출 할 수 있습니다.

현재 Realm 코틀린 SDK (Kotlin SDK)에서 직접 사용자 지정 사용자 데이터에 쓸 수 없습니다 .

Atlas Function에서 사용자 지정 사용자 데이터를 추가하는 데에는 단일 패턴이 없습니다. 애플리케이션의 사용 사례에 맞게 함수를 작성해야 합니다.

이 예제에서 Atlas Function은 클라이언트가 전달한 객체를 가져와서 Atlas의 사용자 지정 사용자 데이터 컬렉션에 추가합니다. 함수는 사용자 지정 사용자 데이터가 아직 존재하지 않는 경우 이를 생성하고, 존재하는 경우 모든 데이터를 대체합니다.

exports = async function writeCustomUserData(newCustomUserData) {
  const userId = context.user.id;
  const customUserDataCollection = context.services
    .get("mongodb-atlas")
    .db("custom-user-data-database")
    .collection("custom-user-data");
  const filter = { userId };
  // Replace the existing custom user data document with the new one
  const update = { $set: newCustomUserData };
  // Insert document if it doesn't already exist
  const options = { upsert: true };
  const res = await customUserDataCollection.updateOne(filter, update, options);
  return res;
};

이 함수를 호출하는 코틀린 SDK (Kotlin SDK) 코드는 다음과 같습니다.

// Write the custom user data through a call
// to the `writeCustomUserData` function
val functionResponse = user.functions
    .call<BsonDocument>("writeCustomUserData",
        mapOf("userId" to user.id, "favoriteColor" to "blue")
    )
// Refreshed custom user data contains updated
// `favoriteColor` value added in above Atlas Function call
user.refreshCustomData()
val updatedUserData = user.customDataAsBsonDocument()

Atlas Function으로 사용자 지정 데이터 삭제하기

사용자 지정 사용자 데이터는 사용자 객체에 연결된 문서에 저장됩니다.

사용자 지정 사용자 데이터를 삭제하려면 사용자의 사용자 지정 데이터 문서를 수동으로 삭제해야 합니다.

Atlas Function을 사용하여 사용자 지정 사용자 데이터를 삭제할 수 있습니다. 현재 Realm 코틀린 SDK (Kotlin SDK)에서 사용자 지정 사용자 데이터를 직접 삭제할 수 없습니다.

이 예제에서 Atlas Function에는 인수가 필요하지 않습니다. 함수는 함수 컨텍스트를 사용하여 호출자의 사용자 ID를 확인하고, 사용자의 ID와 일치하는 사용자 지정 사용자 데이터 문서를 삭제합니다.

exports = async function deleteCustomUserData() {
  const userId = context.user.id;
  const customUserDataCollection = context.services
    .get("mongodb-atlas")
    .db("custom-user-data-database")
    .collection("custom-user-data");
  const filter = { userId };
  const res = await customUserDataCollection.deleteOne(filter);
  return res;
};

이 함수를 호출하는 코틀린 SDK (Kotlin SDK) 코드는 로그인한 사용자만 함수를 호출하면 됩니다.

val deleteResponse = user.functions
    .call<BsonDocument>("deleteCustomUserData")