Module: JSONAPI::ResourceIdentifier

Defined in:
lib/json_api/support/resource_identifier.rb

Class Method Summary collapse

Class Method Details

.determine_model_class(record, association:, definition:, use_instance_class:) ⇒ Object 



72
73
74
75
76
77
78
 
# File 'lib/json_api/support/resource_identifier.rb', line 72

def determine_model_class(record, association:, definition:, use_instance_class:)
  return record.class if association.nil?
  return record.class if polymorphic_association_for_association?(association, definition)
  return record.class if use_instance_class && sti_subclass?(record.class, association.klass)

  association.klass
end

.extract_id(identifier) ⇒ Object 



16
17
18
 
# File 'lib/json_api/support/resource_identifier.rb', line 16

def extract_id(identifier)
  identifier[:id].to_s.presence
end

.extract_type(identifier) ⇒ Object 



20
21
22
 
# File 'lib/json_api/support/resource_identifier.rb', line 20

def extract_type(identifier)
  identifier[:type]
end

.find_related_record(type, id, association, is_polymorphic) ⇒ Object 



42
43
44
45
46
47
48
49
 
# File 'lib/json_api/support/resource_identifier.rb', line 42

def find_related_record(type, id, association, is_polymorphic)
  related_model_class = resolve_related_model_class(type, association, is_polymorphic)
  related_model_class.find(id)
rescue ActiveRecord::RecordNotFound
  raise ArgumentError, "Related resource not found: #{type} with id #{id}"
rescue NameError
  raise ArgumentError, "Invalid relationship type: #{type} does not correspond to a valid model class"
end

.polymorphic_association?(definition, relationship_name) ⇒ Boolean

Returns:

  • (Boolean) 


57
58
59
60
61
62
63
64
 
# File 'lib/json_api/support/resource_identifier.rb', line 57

def polymorphic_association?(definition, relationship_name)
  relationship_def = definition.relationship_definitions.find do |r|
    r[:name].to_s == relationship_name.to_s
  end
  return false unless relationship_def

  relationship_def[:options][:polymorphic] == true
end

.polymorphic_association_for_association?(association, definition) ⇒ Boolean

Returns:

  • (Boolean) 


80
81
82
83
84
85
 
# File 'lib/json_api/support/resource_identifier.rb', line 80

def polymorphic_association_for_association?(association, definition)
  return false unless definition

  relationship_name = association.name
  polymorphic_association?(definition, relationship_name)
end

.resolve_and_find_related_record(identifier, association:, definition:, relationship_name:) ⇒ Object

Raises:

  • (ArgumentError) 


24
25
26
27
28
29
30
31
32
33
 
# File 'lib/json_api/support/resource_identifier.rb', line 24

def resolve_and_find_related_record(identifier, association:, definition:, relationship_name:)
  type = extract_type(identifier)
  id = extract_id(identifier)
  raise ArgumentError, "Missing type or id in relationship data" unless type && id

  is_polymorphic = polymorphic_association?(definition, relationship_name)
  validate_relationship_type!(type, association) unless is_polymorphic

  find_related_record(type, id, association, is_polymorphic)
end

.resolve_related_model_class(type, association, is_polymorphic) ⇒ Object 



51
52
53
54
55
 
# File 'lib/json_api/support/resource_identifier.rb', line 51

def resolve_related_model_class(type, association, is_polymorphic)
  return TypeConversion.type_to_class_name(type).constantize if is_polymorphic

  association.klass
end

.serialize_identifier(record, association:, definition:, use_instance_class: false) ⇒ Object 



7
8
9
10
11
12
13
14
 
# File 'lib/json_api/support/resource_identifier.rb', line 7

def serialize_identifier(record, association:, definition:, use_instance_class: false)
  model_class = determine_model_class(record, association:, definition:,
                                              use_instance_class:,)
  related_definition = JSONAPI::ResourceLoader.find_for_model(model_class)
  related_type = TypeConversion.resource_type_name(related_definition)

  { type: related_type, id: record.id.to_s }
end

.sti_subclass?(instance_class, association_class) ⇒ Boolean

Returns:

  • (Boolean) 


66
67
68
69
70
 
# File 'lib/json_api/support/resource_identifier.rb', line 66

def sti_subclass?(instance_class, association_class)
  return false unless instance_class.respond_to?(:base_class)

  instance_class.base_class == association_class && instance_class != association_class
end

.validate_relationship_type!(type, association) ⇒ Object

Raises:

  • (ArgumentError) 


35
36
37
38
39
40
 
# File 'lib/json_api/support/resource_identifier.rb', line 35

def validate_relationship_type!(type, association)
  expected_type = TypeConversion.model_type_name(association.klass)
  return if type == expected_type

  raise ArgumentError, "Invalid relationship type: expected #{expected_type}, got #{type}"
end