Module: Alba::Resource::InstanceMethods

Included in:
Alba::Resource
Defined in:
lib/alba/resource.rb

Overview

Instance methods

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#object ⇒ Object (readonly)

Returns the value of attribute object.



44
45
46
 
# File 'lib/alba/resource.rb', line 44

def object
  @object
end

#params ⇒ Object (readonly)

Returns the value of attribute params.



44
45
46
 
# File 'lib/alba/resource.rb', line 44

def params
  @params
end

Instance Method Details

#as_json(_options = {}, root_key: nil, meta: {}) ⇒ Hash

Returns a Hash corresponding #serialize

Parameters:

  • _options (Hash) (defaults to: {}) —

    dummy parameter for Rails compatibility

  • root_key (Symbol, nil, true) (defaults to: nil)
  • meta (Hash) (defaults to: {}) —

    metadata for this serialization

Returns:

  • (Hash) 


87
88
89
90
91
92
93
94
95
96
 
# File 'lib/alba/resource.rb', line 87

def as_json(_options = {}, root_key: nil, meta: {})
  key = root_key.nil? ? fetch_key : root_key
  key = Alba.regularize_key(key)
  if key && !key.empty?
    h = {key => serializable_hash}
    hash_with_metadata(h, meta)
  else
    serializable_hash
  end
end

#initialize(object, params: {}, within: WITHIN_DEFAULT) ⇒ Object

Parameters:

  • object (Object) —

    the object to be serialized

  • params (Hash) (defaults to: {}) —

    user-given Hash for arbitrary data

  • within (Object, nil, false, true) (defaults to: WITHIN_DEFAULT) —

    determines what associations to be serialized. If not set, it serializes all associations.



49
50
51
52
53
54
 
# File 'lib/alba/resource.rb', line 49

def initialize(object, params: {}, within: WITHIN_DEFAULT)
  @object = object
  @params = params
  @within = within
  _setup
end

#serializable_hash ⇒ Hash Also known as: to_h

A Hash for serialization

Returns:

  • (Hash) 


101
102
103
 
# File 'lib/alba/resource.rb', line 101

def serializable_hash
  Alba.collection?(@object) ? serializable_hash_for_collection : converter.call(@object)
end

#serialize(root_key: nil, meta: {}) ⇒ String

Serialize object into JSON string

Parameters:

  • root_key (Symbol, nil, true) (defaults to: nil)
  • meta (Hash) (defaults to: {}) —

    metadata for this serialization

Returns:

  • (String) —

    serialized JSON string



61
62
63
 
# File 'lib/alba/resource.rb', line 61

def serialize(root_key: nil, meta: {})
  serialize_with(as_json(root_key: root_key, meta: meta))
end

#to_json(options = {}, root_key: nil, meta: {}) ⇒ Object

For Rails compatibility The first options is a dummy parameter

See Also:



70
71
72
73
74
75
76
77
78
79
 
# File 'lib/alba/resource.rb', line 70

def to_json(options = {}, root_key: nil, meta: {})
  confusing_options = options.keys.select { |k| k.to_sym == :only || k.to_sym == :except }
  unless confusing_options.empty?
    confusing_options.sort!
    confusing_options.map! { |s| "\"#{s}\"" }
    message = "You passed #{confusing_options.join(' and ')} options but ignored. Please refer to the document: https://github.com/okuramasafumi/alba/blob/main/docs/rails.md"
    Kernel.warn(message)
  end
  serialize(root_key: root_key, meta: meta)
end