지원되는 유형 - Kotlin SDK

지원되는 데이터 유형 목록

코틀린 SDK (Kotlin SDK) 고유 식별자, 타임스탬프, 카운터 및 컬렉션에 사용할 수 있는 다음과 같은 코틀린 (Kotlin) 유형, BSON 유형 및 Realm별 유형을 지원합니다.

Kotlin SDK는 기본적으로 다음을 지원하지 않습니다.

• 사용자 정의 열거형 속성. Realm 객체에서 열거형을 사용하는 방법에 대한 자세한 내용은 열거형 섹션을 참조하세요.

• Kotlin의 기본 제공 Date 또는 Instant. Realm 객체에서 타임스탬프를 사용하는 방법에 대한 자세한 내용은 RealmInstant 섹션을 참조하세요.

Realm 객체 속성은 반드시 변경 가능해야 하고 선언 시 초기화되어야 합니다. Kotlin SDK는 현재 추상 속성을 지원하지 않습니다. 기본 제공 ? Kotlin 연산자를 사용하여 속성을 선택적(null 허용)으로 선언하거나 속성을 선언할 때 기본값을 지정할 수 있습니다.

Kotlin 데이터 유형

다음 표에는 지원되는 Kotlin 데이터 유형과 이를 객체 모델에서 필수 또는 선택적 속성으로 선언하는 방법의 예가 나와 있습니다.

var stringReq: String = ""

var stringOpt: String? = null

var byteReq: Byte = 0

var byteOpt: Byte? = null

var shortReq: Short = 0

var shortOpt: Short? = null

var intReq: Int = 0

var intOpt: Int? = null

var longReq: Long = 0L

var longOpt: Long? = null

var floatReq: Float = 0.0f

var floatOpt: Float? = null

var doubleReq: Double = 0.0

var doubleOpt: Double? = null

var boolReq: Boolean = false

var boolOpt: Boolean? = null

var charReq: Char = 'a'

var charOpt: Char? = null

MongoDB BSON Types

다음 표에는 지원되는 MongoDB BSON 데이터 유형과 이를 객체 모델에서 필수 또는 선택적 속성으로 선언하는 방법의 예가 나와 있습니다. 이러한 유형을 사용하려면 org.mongodb.kbson 패키지에서 가져와야 합니다.

var objectIdReq: ObjectId = ObjectId()

var objectIdOpt: ObjectId? = null

var decimal128Req: Decimal128 = Decimal128("123.456")

var decimal128Opt: Decimal128? = null

Realm별 유형

다음 표에는 지원되는 Realm별 데이터 유형과 이를 객체 모델에서 필수 또는 선택적 속성으로 선언하는 방법의 예시가 나와 있습니다.

var uuidReq: RealmUUID = RealmUUID.random()

var uuidOpt: RealmUUID? = null

var realmInstantReq: RealmInstant = RealmInstant.now()

var realmInstantOpt: RealmInstant? = null

var realmAnyOpt: RealmAny? = RealmAny.create("foo")

var mutableRealmIntReq: MutableRealmInt = MutableRealmInt.create(0)

var mutableRealmIntOpt: MutableRealmInt? = null

var listReq: RealmList<CustomObjectType> = realmListOf()

var setReq: RealmSet<String> = realmSetOf()

var dictionaryReq: RealmDictionary<String> = realmDictionaryOf()

var realmObjectPropertyOpt: CustomObjectType? = null

var embeddedProperty: EmbeddedObjectType? = null

Unique Identifiers

코틀린 SDK (Kotlin SDK) Realm 객체의 고유 식별자로 UUID 및 ObjectId 를 지원합니다.

val uuid1 = RealmUUID.from("46423f1b-ce3e-4a7e-812f-004cf9c42d76")
val uuid2 = RealmUUID.random()

MutableRealmInt (카운터)

코틀린 SDK (Kotlin SDK) 여러 분산된 클라이언트에서 숫자 변경 사항을 정확하게 동기화하기 위한 논리적 카운터로 사용할 수 있는 특수 정수 유형으로 MutableRealmInt를 제공합니다. Long 처럼 작동하지만 충돌 없는 복제된 데이터 유형 구현 increment 및 decrement 메서드도 지원합니다. 이렇게 하면 순서에 관계없이 숫자 업데이트를 동일한 값으로 수렴할 수 있습니다.

MutableRealmInt 속성입니다:

• 기본 키로 사용할 수 없습니다

• null 값은 저장할 수 없지만 null을 허용하도록 선언할 수 있습니다(MutableRealmInt?).

또한 MutableRealmInt 필드입니다:

• Kotlin의 숫자 유형에 의해 지원되므로 숫자 필드 MutableRealmInt로 변경할 때 마이그레이션이 필요하지 않습니다.

• Long에서 제공하는 것과 유사한 연산자 및 접두사 함수를 사용할 수 있습니다. 하지만 set, increment, decrement 이외의 작업은 해당 작업이 실행되는 인스턴스를 변경하지 않는다는 점에 유의합니다. 대신 업데이트된 값으로 관리되지 않는 새 MutableRealmInt 인스턴스를 생성합니다.

MutableRealmInt (카운터) 속성 생성 및 MutableRealmInt (카운터) 속성 업데이트 방법을 알아보세요.

RealmInstant (타임스탬프)

Kotlin의 기본 제공 Date 또는 Instant 유형을 Realm에 저장할 수 없습니다.

대신, Kotlin SDK는 RealmInstant 유형을 사용하여 시간 정보를 Unix 시간 타임스탬프로 저장합니다.

RealmInstant 이외의 형식으로 타임스탬프 데이터가 필요한 경우 다음 예제를 기반으로 모델 클래스에 전환 코드를 추가할 수 있습니다.

// model class that stores an Instant (kotlinx-datetime) field as a RealmInstant via a conversion
class RealmInstantConversion : RealmObject {
    private var _timestamp: RealmInstant = RealmInstant.from(0, 0)
    public var timestamp: Instant
        get() {
            return _timestamp.toInstant()
        }
        set(value) {
            _timestamp = value.toRealmInstant()
        }
}
fun RealmInstant.toInstant(): Instant {
    val sec: Long = this.epochSeconds
    // The value always lies in the range `-999_999_999..999_999_999`.
    // minus for timestamps before epoch, positive for after
    val nano: Int = this.nanosecondsOfSecond
    return if (sec >= 0) { // For positive timestamps, conversion can happen directly
        Instant.fromEpochSeconds(sec, nano.toLong())
    } else {
        // For negative timestamps, RealmInstant starts from the higher value with negative
        // nanoseconds, while Instant starts from the lower value with positive nanoseconds
        // TODO This probably breaks at edge cases like MIN/MAX
        Instant.fromEpochSeconds(sec - 1, 1_000_000 + nano.toLong())
    }
}
fun Instant.toRealmInstant(): RealmInstant {
    val sec: Long = this.epochSeconds
    // The value is always positive and lies in the range `0..999_999_999`.
    val nano: Int = this.nanosecondsOfSecond
    return if (sec >= 0) { // For positive timestamps, conversion can happen directly
        RealmInstant.from(sec, nano)
    } else {
        // For negative timestamps, RealmInstant starts from the higher value with negative
        // nanoseconds, while Instant starts from the lower value with positive nanoseconds
        // TODO This probably breaks at edge cases like MIN/MAX
        RealmInstant.from(sec + 1, -1_000_000 + nano)
    }
}

RealmAny (혼합)

RealmAny 는 null을 허용하지 않는 혼합 데이터 유형 을 나타냅니다. 이는 포함된 값 유형처럼 작동합니다. RealmAny 는 다음을 보유할 수 있습니다.

• 지원되는 코틀린 (Kotlin) 데이터 유형 ( Byte, Char, Int, Long, Short 값은 내부적으로 int64_t 값으로 변환됩니다)

• 지원 가능한 BSON 유형

• RealmList 및 RealmDictionary 혼합 데이터 컬렉션

• 다음 Realm별 유형을 사용할 수 있습니다:

  • RealmInstant

  • RealmUUID

  • RealmObject(객체의 복사본이 아닌 객체에 대한 참조를 보유합니다.)

RealmAny EmbeddedRealmObject 유형, RealmSet 또는 다른 RealmAny 을(를) 보유 할 수 없습니다 .

RealmAny 속성:

• 인덱싱이 가능하지만 프라이머리 키로 사용할 수 없음

• null이 가능한 (RealmAny?) 으로 선언해야 하지만 null 값을 저장할 수 없습니다.

• RealmQuery.max 와 애그리게이션 할 수 있습니다. RealmQuery.min 및 RealmQuery.sum.

• 정렬될 수 있습니다. 가장 높은 순서에서 가장 낮은 순서로 정렬합니다:

  1. Boolean

  2. Byte, Double, Decimal128, Int, Float, Long, Short

  3. byte[], String

  4. Date

  5. ObjectId

  6. UUID

  7. RealmObject

RealmList, RealmDictionary 또는 RealmSet 필드에 여러 개의 RealmAny 인스턴스를 저장할 수 있습니다.

컬렉션 유형

Kotlin SDK는 데이터 모델에서 속성으로 사용할 수 있는 여러 collection 유형을 제공합니다. collection은 하나의 Realm 유형의 인스턴스를 0개 이상 포함하는 객체입니다. Realm 컬렉션은 동질적입니다(컬렉션의 모든 객체는 같은 타입입니다) 그리고 이는 관련 빌트인 Kotlin 클래스에 의해 지원됩니다.

collection 유형은 null이 아닙니다. collection 속성을 정의할 때는 반드시 초기화해야 합니다. 자세한 내용은 collection 생성을 참조하세요.

속성으로서의 RealmObjects

AsymmetricRealmObject을(를) 제외한 RealmObject 및 하위 클래스를 객체 모델의 속성으로 사용할 수 있습니다.

지리 공간적 유형

Kotlin SDK는 다음 데이터 유형을 사용하여 지리적 공간 쿼리를 지원합니다:

• GeoPoint

• GeoCircle

• GeoBox

• GeoPolygon

지리 공간적 데이터를 사용한 쿼리에 대한 자세한 내용은 지리 공간적 데이터를 참조하세요.

Enums

Kotlin SDK는 네이티브 환경에서 열거형 또는 열거 항목을 지원하지 않습니다. Realm 객체 클래스에서 열거형을 사용하려면 열거형의 기본 데이터 유형과 일치하는 유형으로 필드를 정의하세요.

그런 다음 필드에 대한 getter 및 setter를 만들어 필드 값을 기본 값과 열거형 형식 간에 변환합니다.

enum class EnumClass(var state: String) {
    NOT_STARTED("NOT_STARTED"),
    IN_PROGRESS("IN_PROGRESS"),
    COMPLETE("COMPLETE")
}
class EnumObject : RealmObject {
    var name: String? = null
    private var state: String = EnumClass.NOT_STARTED.state
    var stateEnum: EnumClass
        get() = EnumClass.valueOf(state)
        set(value) {
            state = value.state
        }
}