Class: ROM::Processor::Transproc

Inherits:
ROM::Processor show all
Includes:
Transproc::Composer
Defined in:
lib/rom/processor/transproc.rb

Overview

Data mapping transformer builder using Transproc

This builds a transproc function that is used to map a whole relation

See Also:

Defined Under Namespace

Modules: Functions

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from ROM::Processor

inherited

Constructor Details

#initialize(mapper, header) ⇒ Transproc

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of Transproc.



88
89
90
91
92
93
94
 
# File 'lib/rom/processor/transproc.rb', line 88

def initialize(mapper, header)
  @mapper = mapper
  @header = header
  @model = header.model
  @mapping = header.mapping
  initialize_row_proc
end

Instance Attribute Details

#header ⇒ Header (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns header from a mapper.

Returns:

  • (Header) —

    header from a mapper



59
60
61
 
# File 'lib/rom/processor/transproc.rb', line 59

def header
  @header
end

#mapper ⇒ Mapper (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns mapper that this processor belongs to.

Returns:

  • (Mapper) —

    mapper that this processor belongs to



54
55
56
 
# File 'lib/rom/processor/transproc.rb', line 54

def mapper
  @mapper
end

#mapping ⇒ Hash (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns header’s attribute mapping.

Returns:

  • (Hash) —

    header’s attribute mapping



69
70
71
 
# File 'lib/rom/processor/transproc.rb', line 69

def mapping
  @mapping
end

#model ⇒ Class (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns model class from a mapper.

Returns:

  • (Class) —

    model class from a mapper



64
65
66
 
# File 'lib/rom/processor/transproc.rb', line 64

def model
  @model
end

#row_proc ⇒ Proc (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns row-processing proc.

Returns:

  • (Proc) —

    row-processing proc



74
75
76
 
# File 'lib/rom/processor/transproc.rb', line 74

def row_proc
  @row_proc
end

Class Method Details

.build(mapper, header) ⇒ Transproc::Function

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Build a transproc function from the header

Parameters:

Returns:

  • (Transproc::Function) 


83
84
85
 
# File 'lib/rom/processor/transproc.rb', line 83

def self.build(mapper, header)
  new(mapper, header).to_transproc
end

Instance Method Details

#to_transproc ⇒ Transproc::Function

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Coerce mapper header to a transproc data mapping function

Returns:

  • (Transproc::Function) 


101
102
103
104
105
106
107
108
109
 
# File 'lib/rom/processor/transproc.rb', line 101

def to_transproc
  compose(t(:identity)) do |ops|
    combined = header.combined
    ops << t(:combine, combined.map(&method(:combined_args))) if combined.any?
    ops << header.preprocessed.map { |attr| visit(attr, true) }
    ops << t(:map_array, row_proc) if row_proc
    ops << header.postprocessed.map { |attr| visit(attr, true) }
  end
end