상속

개요

이 가이드 에서는 Mongoid 모델에 상속을 구현 방법을 학습 수 있습니다. 상속을 사용하면 하나의 "부모" 클래스의 특성을 하나 이상의 "자식" 클래스에 적용 .

Mongoid는 최상위 문서와 내장된 문서에서 상속을 지원합니다. 하위 모델 클래스가 상위 클래스로부터 상속을 받으면 Mongoid는 상위 클래스의 필드, 연관 관계, 유효성 검사 및 범위를 하위 클래스에 복사합니다.

상속 할당

하위 모델 클래스를 만들 때 < 문자를 사용하여 지정된 상위 클래스에서 상속을 구현 . 다음 모델 클래스는 Person, Employee 및 Manager 모델 간에 상위 및 하위 클래스를 생성하는 방법을 보여 줍니다.

class Person
  include Mongoid::Document
  field :name, type: String
end
class Employee < Person
  field :company, type: String
  field :tenure, type: Integer
  scope :new_hire, ->{ where(:tenure.lt => 1) }
end
class Manager < Employee
end

Mongoid는 Person, Employee, Manager 인스턴스를 people 컬렉션 에 저장합니다. Mongoid는 _type 판별자 필드 문서의 모델 클래스 이름으로 설정하여 읽기 작업을 수행할 때 문서가 예상되는 유형으로 반환되도록 합니다.

class Person
  include Mongoid::Document
  field :name, type: String
  embeds_many :infos
end
...
class Info
  include Mongoid::Document
  field :active, type: Boolean
  embedded_in :person
end
class Phone < Info
  field :value, type: Float
  field :country, type: String
end
class Email < Info
  field :value, type: String
  field :category, type: String
end

판별자 키 변경

다음과 같은 이유로 기본값 필드 이름 _type 에서 판별자 키를 변경할 수 있습니다.

• 최적화: _t와 같이 더 짧은 키를 선택할 수 있습니다.

• 기존 시스템과의 일관성: 사전 정의된 키가 있는 기존 시스템 또는 데이터 세트를 사용하고 있을 수 있습니다.

클래스 수준 또는 전역 수준에서 판별자 키를 변경할 수 있습니다. 클래스 수준에서 판별자 키를 변경하려면 discriminator_key 메서드를 사용하여 상위 클래스에서 사용자 지정 키 이름을 설정하다 하면 됩니다.

다음 예시 모델 클래스를 정의할 때 사용자 지정 판별자 키를 설정하다 방법을 보여 줍니다.

class Person
  include Mongoid::Document
  field :name, type: String
  self.discriminator_key = "sub_type"
end

Person 또는 해당 하위 클래스의 인스턴스 생성하면 Mongoid는 MongoDB 의 문서에 sub_type 필드 추가합니다.

하위 클래스를 정의한 후 판별자 키를 변경하면 Mongoid는 새 키 필드 추가하지만 이전 필드 변경되지 않습니다. 예시 들어 모델 클래스를 정의한 후 애플리케이션 에 다음 코드를 추가한다고 가정해 보겠습니다.

Person.discriminator_key = "sub_type"

이 경우 Employee와 같은 하위 클래스의 인스턴스 생성하면 Mongoid가 문서 에 sub_type 및 _type 필드를 모두 추가합니다.

전역 수준에서 판별자 키를 변경하여 모든 클래스가 _type 필드 대신 지정된 키를 사용하도록 할 수도 있습니다.

모델 클래스를 정의하기 전에 애플리케이션 에 다음 코드를 추가하여 글로벌 키를 설정하다 수 있습니다.

Mongoid.discriminator_key = "sub_type"

모든 클래스는 sub_type 을 판별자 키로 사용하며 _type 필드 포함하지 않습니다.

판별자 값 변경

Mongoid가 MongoDB 에서 판별자 값으로 설정하는 값을 사용자 지정할 수 있습니다. 다음 예시 와 같이 클래스를 정의하여 판별자 값을 사용자 지정할 때 discriminator_value 메서드를 사용합니다.

class Employee
  include Mongoid::Document
  field :company, type: String
  self.discriminator_value = "Worker"
end

Employee의 인스턴스 만들면 문서의 _type 판별자 필드 클래스 이름 대신 "Worker" 값이 지정됩니다.

내장된 연관 관계

할당을 통해 또는 build 및 create 메서드를 사용하여 포함된 연결에서 모든 유형의 상위 클래스 또는 하위 클래스를 만들 수 있습니다. 원하는 모델 클래스를 build 및 create 메서드에 두 번째 매개변수로 전달하여 Mongoid가 해당 특정 인스턴스 내장된 문서 로 생성하도록 지시할 수 있습니다.

다음 코드에서는 Employee 인스턴스 를 만든 다음 다양한 생성 메서드를 사용하여 내장된 문서를 추가하는 방법을 보여 줍니다.

# Creates a new Employee instance
e = Employee.create(
  name: "Lance Huang",
  company: "XYZ Communications",
  tenure: 2
)
# Builds an Info object
e.infos.build({ active: true })
# Builds a Phone object
e.infos.build(
  { active: true, value: 1239007777, country: "USA" }, 
  Phone
)
# Creates an Email object
e.infos.create(
  { active: true, value: "l.huang@company.com", category: "work" }, 
  Email
)
# Creates and assigns an Email object
p = Email.new(active: false, value: "lanceh11@mymail.com", category: "personal" )
e.infos << p
# Saves the Employee instance to database
e.save

다음 문서 people 데이터베이스 에 저장됩니다.

{
  "_id": {...},
  "name": "Lance Huang",
  "company": "XYZ Communications",
  "tenure": 2,
  "_type": "Employee",
  "infos": [
    {
      "_id": {...},
      "active": true,
      "value": "l.huang@company.com",
      "category": "work",
      "_type": "Email"
    },
    {
      "_id": {...},
      "active": false,
      "value": "lanceh11@mymail.com",
      "category": "personal",
      "_type": "Email"
    },
    {
      "_id": {...},
      "active": true,
      "_type": "Info"
    },
    {
      "_id": {...},
      "active": true,
      "value": 1239007777,
      "country": "USA",
      "_type": "Phone"
    }
  ]
}

지속성 컨텍스트

부모 클래스의 지속성 컨텍스트에서 하위 클래스의 지속성 컨텍스트를 변경하여 기본값 아닌 다른 위치 에 문서 저장 수 있습니다. store_in 메서드를 사용하면 하위 클래스의 인스턴스 상위 모델의 인스턴스 와 다른 컬렉션, 데이터베이스 또는 클러스터 에 저장 수 있습니다.

다음 모델 정의는 store_in 메서드를 사용하여 Employee 및 Manager 인스턴스를 people 컬렉션 아닌 다른 컬렉션 에 저장 방법을 보여 줍니다.

class Person
  include Mongoid::Document
end
class Employee < Person
  # Specifies "employees" as target collection
  store_in collection: :employees
end
class Manager < Employee
  # Specifies "managers" as target collection
  store_in collection: :managers
end

일부 하위 클래스에는 대체 대상 컬렉션 설정하다 하고 다른 클래스에는 설정하지 않으면 지정된 컬렉션이 없는 클래스의 인스턴스가 상위 클래스와 연결된 컬렉션 에 저장됩니다.

추가 정보

작업의 대상 컬렉션 구성하는 방법에 대해 자세히 학습 지속성 구성 가이드 참조하세요.