열거형 RealmNamingPolicy

io.realm.annotations

이 열거형은 클래스 및 필드 이름을 Java에서 사용되는 이름에서 Realm 파일에서 내부적으로 사용되는 이름으로 매핑할 수 있는 가능한 방법을 정의합니다.

• 이름은 같지만 패키지가 다른 두 모델 클래스를 지원합니다.

• 명명 규칙이 다르기 때문에 크로스 플랫폼 스키마로 더 쉽게 작업할 수 있습니다.

• Realm에서 시행하는 57자 제한보다 긴 Java 클래스 이름을 사용하려는 경우.

• 앱 사용자에게 마이그레이션 프로세스를 강제하지 않고 Java에서 필드 이름을 변경하고자 하는 경우.

정책이 적용되는 위치에 따라 의미가 약간 달라집니다.

• RealmModule.classNamingPolicy 에 적용된 경우 해당 모듈의 모든 클래스 일부가 영향을 받습니다. 클래스가 여러 모듈의 일부인 경우 두 모듈에 동일한 명명 정책을 적용해야 하며, 그렇지 않으면 오류가 발생합니다.

• RealmModule.fieldNamingPolicy 에 적용된 경우 이 모듈의 모든 클래스 일부에 있는 모든 지속 가능 필드가 영향을 받습니다.

• RealmClass.fieldNamingPolicy 를 적용하면 해당 클래스의 모든 필드가 영향을 받습니다. 이렇게 하면 모듈에 지정된 모든 필드 명명 정책이 재정의됩니다.

예를 들면 다음과 같습니다.

@RealmClass(name = "__person", fieldNamingPolicy = RealmNamingPolicy.LOWER_CASE_WITH_UNDERSCORES)
public class Person implements RealmModel { // is converted to "__person" internally
    public string firstName; // Is converted to "first_name" internally
}

Java 모델 클래스에 사용된 이름과 다른 내부 이름을 선택하면 다음과 같은 의미가 있습니다.

• DynamicRealm 에 대한 쿼리는 내부 이름을 사용해야 합니다. 일반 Realm 인스턴스에 대한 쿼리는 Java 클래스에 정의된 이름을 계속 사용해야 합니다.

• 마이그레이션은 클래스 및 필드를 만들 때 내부 이름을 사용해야 합니다.

• 보고된 스키마 오류에는 내부 이름이 사용됩니다.

Java 변수 이름을 자동으로 변환할 때 각 변수 이름은 단어 목록으로 분할된 다음 대상 형식의 규칙을 사용하여 결합되는 방식으로 정규화됩니다. 다음과 같은 휴리스틱은 "단어"를 구성하는 항목을 결정하는 데 사용됩니다.

1. _ 또는 $ 이(가) 발생할 때마다 발생합니다. 예를 들면 '_FirstName', '_First_Name', '$First$Name'이 있으며, 이는 모두 'First' 및 'Name'이 됩니다.

2. Character.isUpperCase(int) 로 식별되는 소문자에서 대문자로 전환할 때마다 및 Character.isLowerCase(int) . 예를 들어 'FirstName'은 'First'와 'Name'이 됩니다.

3. 둘 이상의 대문자에서 소문자로 전환할 때마다 발생합니다. 마지막 대문자는 다음 단어의 일부로 간주됩니다. 이는 Character.isUpperCase(int) 및 Character.isLowerCase(int) . 예를 들어 'FIRSTName'은 'FIRST' 및 'Name.

4. 그림과 같은 일부 문자는 대문자도 소문자도 아니므로 현재 단어의 일부가 됩니다. 예를 들어 'my'와 'my '가 있으며, 이는 둘 다 하나의 단어로 취급됩니다.

5. 헝가리어 표기법, 즉 소문자 "m"으로 시작하고 그 뒤에 대문자가 오는 변수 이름은 제거되며 어떤 단어의 일부로 간주되지 않습니다. 예를 들면 "mFirstName" 및 "mFIRSTName"이(가) "First"와 "Name.

내부 이름을 변경해도 JSON에서 데이터 가져오기에는 영향을 주지 않습니다 . JSON 데이터는 여전히 Realm Java 클래스에 정의된 이름을 따라야 합니다.

Mashi, GSON 또는 잭슨과 같은 표준 라이브러리를 사용하여 JSON을 구문 분석할 때 이러한 라이브러리는 JSON에서 Java로의 변환을 정의하는 반면 내부 Realm 이름 설정은 Java에서 Realm 파일로의 변환을 정의한다는 점을 명심해야 합니다.

즉, 이러한 라이브러리를 사용하여 JSON에서 Realm으로 데이터를 가져오려면 JSON 구문 분석기 라이브러리와 Realm 모두에서 주석을 제공해야 합니다.

Mashi를 사용하면 다음과 같이 표시됩니다.

public class Person extends RealmObject {
    @Json(name = "first_name") // Name used in JSON input.
    @RealmField(name = "first_name") // Name used internally in the Realm file.
    public string firstName; // name used in Java
}

열거형 상수 요약

메서드 요약

상속된 메서드

• 클래스 java.lang.Object 에서 상속된 메서드 : getClass , hashCode , equals , clone , toString , notify , notifyAll , wait , wait , wait , finalize

• 클래스 java.lang.Enum 에서 상속된 메서드 : name , ordinal , toString , equals , hashCode , clone , compareTo , getDeclaringClass , valueOf , finalize

열거형 상수 세부 정보

메서드 세부 정보