속성 주석 - Flutter SDK
Realm 객체 모델의 속성에 기능을 추가하려면 주석을 사용합니다.
필수 및 선택 속성
다트 에서 값 유형은 암시적으로 null을 허용하지 않지만?. 속성을 선택 사항으로 ? 만들려면 를 포함합니다.
class _Vehicle { () late ObjectId id; late String? maybeDescription; // optional value late double milesTravelled = 0; // 0 is default value () late String notInRealmModel; () late String make; ('wheels') // 'wheels' is property name in the RealmObject late int numberOfWheels; }
기본 필드 값
내장된 언어 기능을 사용하여 속성에 기본값을 지정할 수 있습니다. 속성 선언에서 기본값을 지정합니다.
class _Vehicle { () late ObjectId id; late String? maybeDescription; // optional value late double milesTravelled = 0; // 0 is default value () late String notInRealmModel; () late String make; ('wheels') // 'wheels' is property name in the RealmObject late int numberOfWheels; }
기본 키
프라이머리 키 주석은 기본 키 속성을 나타냅니다. 기본 키는 영역에 있는 객체의 고유 식별자입니다. 동일한 유형의 다른 객체는 객체의 기본 키를 공유할 수 없습니다.
기본 키의 중요한 측면:
영역에 객체를 추가한 후에는 기본 키를 변경할 수 없습니다.
RealmModel에서 하나의 속성에만 기본 키를 추가합니다.
String,int,ObjectId및Uuid유형만 기본 키가 될 수 있습니다.Realm은 기본 키를 자동으로 인덱싱합니다.
기본 키는 null을 허용합니다.
null은 컬렉션에 있는 한 객체의 기본 키만 될 수 있습니다.
class _Vehicle { () late ObjectId id; late String? maybeDescription; // optional value late double milesTravelled = 0; // 0 is default value () late String notInRealmModel; () late String make; ('wheels') // 'wheels' is property name in the RealmObject late int numberOfWheels; }
속성 또는 클래스를 다른 이름에 매핑
MapTo 주석은 모델 또는 속성이 다른 이름으로 유지되어야 함을 나타냅니다. 코드 스타일 규칙이 다를 수 있는 다양한 바인딩에서 Realm을 열 때 유용합니다. 예를 들면 다음과 같습니다.
명명 규칙이 서로 다른 플랫폼에서 더 쉽게 작업할 수 있습니다. 예를 들면 Device Sync 스키마 속성 이름은 스네이크 표기법을 사용하고, 프로젝트는 카멜 표기법을 사용하는 경우입니다.
마이그레이션을 강제하지 않고 클래스 또는 필드 이름을 변경합니다.
() ('naval_ship') class _Boat { () late ObjectId id; late String name; late int? maxKnots; late int? nauticalMiles; }
class _Vehicle { () late ObjectId id; late String? maybeDescription; // optional value late double milesTravelled = 0; // 0 is default value () late String notInRealmModel; () late String make; ('wheels') // 'wheels' is property name in the RealmObject late int numberOfWheels; }
Realm 스키마에서 속성 무시
무시됨을 추가하면 의 속성에 주석을 RealmModel 추가하면 Realm 객체 생성기 가 스키마의 속성을 포함하거나 RealmObject Realm에 유지하지 않습니다.
class _Vehicle { () late ObjectId id; late String? maybeDescription; // optional value late double milesTravelled = 0; // 0 is default value () late String notInRealmModel; () late String make; ('wheels') // 'wheels' is property name in the RealmObject late int numberOfWheels; }
색인 속성
인덱스 추가 필드에 인덱스를 생성하는 주석을 추가합니다. 인덱스를 사용하면 쓰기 시간이 약간 느려지고 스토리지 및 메모리 오버헤드가 늘어나지만, 일부 쿼리 속도를 크게 높일 수 있습니다. Realm은 인덱스를 디스크에 저장하므로 Realm 파일이 더 커집니다. 각 인덱스 항목은 최소 12 바이트입니다. 인덱스는 null을 허용할 수 있습니다.
인덱싱할 수 있는 데이터 유형은 다음과 같습니다.
boolintStringObjectIdUuidDateTimeRealmValue
class _Vehicle { () late ObjectId id; late String? maybeDescription; // optional value late double milesTravelled = 0; // 0 is default value () late String notInRealmModel; () late String make; ('wheels') // 'wheels' is property name in the RealmObject late int numberOfWheels; }
전체 텍스트 검색 인덱스
Realm은 표준 인덱스 외에도 문자열 속성에 대한 FTS(Full-Text Search) 인덱스도 지원합니다. 표준 인덱스 유무에 관계없이 문자열 필드를 쿼리할 수 있지만 FTS 인덱스를 사용하면 여러 단어와 구를 검색하고 나머지는 제외할 수 있습니다.
FTS 인덱스 쿼리에 대한 자세한 내용은 Full Text Search를 참조하세요.
속성에 FTS 인덱스를 만들려면 @Indexed 주석을 입력하고 RealmIndexType 을 fullText 지정합니다. 로 . 이를 통해 속성에 대한 전체 텍스트 쿼리가 가능합니다. 다음 예제에서는 FTS 주석을 사용하여 패턴과 재료 속성을 표시합니다.
() class _Rug { () late ObjectId id; (RealmIndexType.fullText) late String pattern; (RealmIndexType.fullText) late String material; late int softness; }