Class: Railsful::Serializer

Inherits:
Object
  • Object
show all
Includes:
Interceptors::Errors, Interceptors::Include, Interceptors::Pagination, Interceptors::Sorting
Defined in:
lib/railsful/serializer.rb

Overview

This class allows to encapsulate the interceptor logic from the prepended controller, so the controller is not polluted with all needed (helper) methods.

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Interceptors::Include

#include_options, #includes, #should_include?

Methods included from Interceptors::Pagination

#pagination_options

Methods included from Interceptors::Sorting

#sorting_options

Methods included from Interceptors::Errors

#errors, #errors?, #errors_options, #field_errors, #formatted_error

Constructor Details

#initialize(controller) ⇒ Serializer

Keep a reference to the controller, so all helper methods like url_for can be used.



23
24
25
 
# File 'lib/railsful/serializer.rb', line 23

def initialize(controller)
  @controller = controller
end

Instance Attribute Details

#controller ⇒ Object (readonly)

Returns the value of attribute controller.



19
20
21
 
# File 'lib/railsful/serializer.rb', line 19

def controller
  @controller
end

Instance Method Details

#method ⇒ String

Fetch the HTTP method from controllers request.



78
79
80
 
# File 'lib/railsful/serializer.rb', line 78

def method
  controller.request.request_method
end

#params ⇒ Object

Fetch the params from controller.



71
72
73
 
# File 'lib/railsful/serializer.rb', line 71

def params
  controller.params
end

#relation?(options) ⇒ Boolean

Check if given options contain an ActiveRecord::Relation.

:reek:UtilityFunction



88
89
90
 
# File 'lib/railsful/serializer.rb', line 88

def relation?(options)
  options[:json].is_a?(ActiveRecord::Relation)
end

#render(options) ⇒ Hash

The render function every interceptor MUST implement in order to add certain functionality.

:reek:FeatureEnvy



34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
 
# File 'lib/railsful/serializer.rb', line 34

def render(options)
  # Get the renderable (Object that should be rendered) from options hash.
  renderable = options[:json]

  # Return if renderable is blank
  return options unless renderable

  # Try to fetch the right serializer for given renderable.
  serializer = serializer_for(renderable)

  # When no serializer is found just pass the original options hash.
  return options unless serializer

  # Replace json value with new serializer
  options.merge(json: serializer.new(renderable, options))
end

#serializer_for(renderable) ⇒ Class

Find the right serializer for given object.

:reek:UtilityFunction



57
58
59
60
61
62
63
64
65
66
 
# File 'lib/railsful/serializer.rb', line 57

def serializer_for(renderable)
  # Get the class in order to find the right serializer.
  klass = if renderable.is_a?(ActiveRecord::Relation)
            renderable.model.name
          else
            renderable.class.name
          end

  "#{klass}Serializer".safe_constantize
end