모듈: Mongoid::Association::접근자

확장자:
ActiveSupport::Concern
포함 항목:
Mongoid::Association
다음에 정의됨:
lib/mongoid/association/accessors.rb

개요

이 모듈에는 게터 및 세터를 통해 연결에 액세스하는 것과 관련된 모든 동작과 새 연결을 생성하기 위해 빌더 에 위임하는 방법이 포함되어 있습니다.

클래스 메서드 요약 접기

인스턴스 메서드 요약 접기

클래스 메서드 세부 정보

.describe_builder!(association) ⇒ 클래스

embeddeds_one 연결에 대한 빌더 메서드를 정의합니다. 이는 #build_name으로 정의됩니다.

예시:

Person.define_builder!(association)

매개변수:

반환합니다:

  • (클래스) —

    클래스를 설정하다 중입니다.



387
388
389
390
391
392
393
394
395
396
397
398
399
400
 
# 파일 'lib/mongoid/association/accessors.rb', 줄 387

def self.describe_builder!(연관 관계)
  이름 = 연관 관계.이름
  연관 관계.inverse_class.탭 do |class|
    class.re_define_method("build_#{name}") do |*args|
      속성, _options = parse_args(*args)
      문서 = 공장.빌드(연관 관계.관계 클래스, 속성)
      _build do
        자식 = send("#{name}=", 문서)
        자식.run_callbacks(:build)
        자식
      end
    end
  end
end

.describe_creator!(association) ⇒ 클래스

embeddeds_one 연결에 대한 작성자 메서드를 정의합니다. 이는 #create_name으로 정의됩니다. 객체 가 빌드되면 즉시 저장됩니다.

예시:

Person.define_creator!(association)

매개변수:

반환합니다:

  • (클래스) —

    클래스를 설정하다 중입니다.



412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
 
# 파일 'lib/mongoid/association/accessors.rb', 줄 412

def self.describe_creator!(연관 관계)
  이름 = 연관 관계.이름
  연관 관계.inverse_class.탭 do |class|
    class.re_define_method("create_#{name}") do |*args|
      속성, _options = parse_args(*args)
      문서 = 공장.빌드(연관 관계.class, 속성)
      doc = _assigning do
        send("#{name}=", 문서)
      end
      doc.저장
      저장 만약 new_record? && 연관 관계.Stores_foreign_key?
      doc
    end
  end
end

.정의_존재_확인!(association) ⇒ 클래스

연결에 대한 존재 확인을 추가합니다.

예시:

존재 확인을 추가합니다.

Person.define_existence_check!(association)

연결이 존재하는지 확인합니다.

person = Person.new
person.has_game?
person.game?

매개변수:

반환합니다:

  • (클래스) —

    설정하다 중인 모델입니다.



277
278
279
280
281
282
283
284
285
286
287
 
# 파일 'lib/mongoid/association/accessors.rb', 줄 277

def self.정의_존재_확인!(연관 관계)
  이름 = 연관 관계.이름
  연관 관계.inverse_class.탭 do |class|
    class.모듈_평가 <<-END, __FILE__, __LINE__ + 1
        def #{이름}? without_autobuild { !__send__(:#{이름}).공백? } 종료 별칭 :has_#{이름}? :#{이름}?
    END
  end
end

.정의_게터!(association) ⇒ 클래스

연결에 대한 게터를 정의합니다. 여기서는 그다지 특별한 것이 없습니다: 연관 관계가 존재하는 경우 해당 인스턴스 변수를 반환하거나 사물을 빌드 만 하면 됩니다.

예시:

연결에 대한 게터를 설정합니다.

Person.define_getter!(association)

매개변수:

반환합니다:

  • (클래스) —

    클래스를 설정하다 중입니다.



299
300
301
302
303
304
305
306
307
308
 
# 파일 'lib/mongoid/association/accessors.rb', 줄 299

def self.정의_게터!(연관 관계)
  이름 = 연관 관계.이름
  연관 관계.inverse_class.탭 do |class|
    class.re_define_method(이름) do |다시 로드 = 거짓|
      value = get_relation(이름, 연관 관계, nil, 다시 로드)
      value = send("build_#{name}") 만약 value.nil? && 연관 관계.자동 구축? && !without_autobuild?
      value
    end
  end
end

.describe_ids_getter!(association) ⇒ 클래스

연관 관계에 있는 문서의 ID에 대한 게터를 정의합니다. 참조된 많은 연결에 대해서만 지정해야 합니다.

예시:

연결에 대한 ID 게터를 설정합니다.

Person.define_ids_getter!(association)

매개변수:

반환합니다:

  • (클래스) —

    클래스를 설정하다 중입니다.



319
320
321
322
323
324
325
326
 
# 파일 'lib/mongoid/association/accessors.rb', 줄 319

def self.describe_ids_getter!(연관 관계)
  ids_method = "#{association.name.to_s.singularize}_ids"
  연관 관계.inverse_class.탭 do |class|
    class.re_define_method(ids_method) do
      send(연관 관계.이름).뽑다(:_id)
    end
  end
end

.describe_ids_setter!(association) ⇒ 객체

ID로 이 연관 관계의 문서를 설정하다 수 있는 setter 메서드를 정의합니다. 정의된 세터는 지정된 ID를 가진 문서를 찾고 발견된 문서와 함께 일반 연관 세터를 호출합니다. ID 설정자는 참조된 많은 연결에 대해서만 정의해야 합니다.

@param [ Mongoid::Association::Relatable ] 연관 관계에 대한 연관 관계입니다.

@return [ 클래스 ] 설정하다 중인 클래스입니다.

예시:

연결에 대한 id_setter를 설정합니다.

Person.define_ids_setter!(association)


368
369
370
371
372
373
374
375
376
 
# 파일 'lib/mongoid/association/accessors.rb', 줄 368

def self.describe_ids_setter!(연관 관계)
  ids_method = "#{association.name.to_s.singularize}_ids="
  연관 관계.inverse_class.aliased_associations[ids_method.자르다] = 연관 관계.이름.to_s
  연관 관계.inverse_class.탭 do |class|
    class.re_define_method(ids_method) do |ID|
      send(연관 관계.세터, 연관 관계.관계 클래스.찾기(ID.거부(&:blank?)))
    end
  end
end

.정의_세터!(association) ⇒ 클래스

연결에 대한 설정자를 정의합니다. 이는 몇 가지 조건에 따라 몇 가지 작업을 수행합니다. 기존 연결이 있는 경우 대상이 대체되고, 그렇지 않으면 제공된 대상으로 새 연결이 생성됩니다.

예시:

연결에 대한 설정자를 설정합니다.

Person.define_setter!(association)

매개변수:

반환합니다:

  • (클래스) —

    클래스를 설정하다 중입니다.



339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
 
# 파일 'lib/mongoid/association/accessors.rb', 줄 339

def self.define_setter!(연관 관계)
  이름 = 연관 관계.이름
  연관 관계.inverse_class.탭 do |class|
    class.re_define_method("#{name}=") do |객체|
      without_autobuild do
        만약 value = get_relation(이름, 연관 관계, 객체)
          value = __build__(이름, value, 연관 관계) 하지 않는 한 value.response_to?(:대체)

          set_relation(이름, value.대체(객체.대체 가능))
        other
          __build__(이름, 객체.대체 가능, 연관 관계)
        end
      end
    end
  end
end

인스턴스 메서드 세부 정보

#__build__(name, 객체,association,selected_fields = nil) ⇒ Proxy

관련 문서를 빌드하고 문서가 nil이 아닌 경우 연관 관계를 생성한 다음, 이 문서에 연관 관계를 설정합니다.

예시:

연관 관계를 구축합니다.

person.__build__(:addresses, { :_id => 1 }, association)

매개변수:

  • 이름 (string | 기호) —

    연관 관계의 이름입니다.

  • 객체 (해시 | BSON::ObjectId) —

    사용할 ID 또는 속성입니다.

  • 연관 관계 (Mongoid::Association::Relatable) —

    연결 메타데이터입니다.

  • selected_fields (해시) (기본값: nil) —

    #only를 통해 조회된 필드입니다. selected_fields를 지정하면 여기에 나열되지 않은 필드는 빌드된 문서 에서 액세스할 수 없습니다.

반환합니다:



25
26
27
28
 
# 파일 'lib/mongoid/association/accessors.rb', 줄 25

def __build__(이름, 객체, 연관 관계, selected_fields = nil)
  관계 = create_relation(객체, 연관 관계, selected_fields)
  set_relation(이름, 관계)
end

#create_relation(객체,association,selected_fields = nil) ⇒ 프록시

객체 및 연결 메타데이터 에서 연결을 만듭니다.

예시:

연관 관계를 생성합니다.

person.create_relation(document, association)

매개변수:

  • 객체 (문서 | 배열<문서>) —

    연결 대상입니다.

  • 연관 관계 (Mongoid::Association::Relatable) —

    연결 메타데이터입니다.

  • selected_fields (해시) (기본값: nil) —

    #only를 통해 조회된 필드입니다. Selected_fields를 지정하면 해당 항목에 나열되지 않은 필드는 생성된 연결 문서 에서 액세스할 수 없습니다.

반환합니다:



42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
 
# 파일 'lib/mongoid/association/accessors.rb', 줄 42

def create_relation(객체, 연관 관계, selected_fields = nil)
  키 = @attributes[연관 관계.inverse_type]
  유형 = 키 ? 연관 관계.리졸버.Model_for(키) : nil
  대상 = 만약 t = 연관 관계.빌드(self, 객체, 유형, selected_fields)
             연관 관계.create_relation(self, t)
           end

  # 포함된 연관 관계에서만 이 작업을 수행하면 됩니다. 보류 중인 콜백
  # 문서를 구체화할 때만 추가됩니다.
  포함된 연결에 대한 #. 데이터베이스 에 대한 호출이 없습니다.
  # 참조된 연관 관계의 구성.
  만약 연관 관계.임베디드?
    배열(대상).각 do |doc|
      doc.try(:run_pending_callbacks)
    end
  end

  대상
end

#reset_relation_criteria(name) ⇒ 객체

연결 프록시 내부의 기준을 재설정합니다. 다대다 연관 관계에서 기본 ID 배열 을 동기화 된 상태로 유지하는 데 사용됩니다.

예시:

연결 기준을 재설정합니다.

person.reset_relation_criteria(:preferences)

매개변수:

  • 이름 (기호) —

    연관 관계의 이름입니다.



69
70
71
72
73
 
# 파일 'lib/mongoid/association/accessors.rb', 줄 69

def reset_relation_criteria(이름)
  반환 하지 않는 한 instance_variable_defined?("@_#{name}")

  send(이름).reset_unloaded
end

#set_relation(이름, 관계) ⇒ 프록시

제공된 연결을 제공된 이름을 가진 클래스의 인스턴스 변수로 설정합니다. 코드를 깔끔하게 정리하기 위한 헬퍼로 사용됩니다.

예시:

문서 에 프록시를 설정합니다.

person.set(:addresses, addresses)

매개변수:

  • 이름 (string | 기호) —

    연관 관계의 이름입니다.

  • 관계 (프록시) —

    설정하다 연결입니다.

반환합니다:



85
86
87
 
# 파일 'lib/mongoid/association/accessors.rb', 줄 85

def set_relation(이름, 관계)
  instance_variable_set("@_#{name}", 관계)
end