Module: ActiveModelSerializers::Adapter

Extended by:

ActiveSupport::Autoload

Defined in:

lib/active_model_serializers/adapter.rb,
lib/active_model_serializers/adapter/null.rb,
lib/active_model_serializers/adapter/base.rb,
lib/active_model_serializers/adapter/json.rb,
lib/active_model_serializers/adapter/json_api.rb,
lib/active_model_serializers/adapter/attributes.rb,
lib/active_model_serializers/adapter/json_api/meta.rb,
lib/active_model_serializers/adapter/json_api/link.rb,
lib/active_model_serializers/adapter/json_api/error.rb,
lib/active_model_serializers/adapter/json_api/jsonapi.rb,
lib/active_model_serializers/adapter/json_api/relationship.rb,
lib/active_model_serializers/adapter/json_api/deserialization.rb,
lib/active_model_serializers/adapter/json_api/pagination_links.rb,
lib/active_model_serializers/adapter/json_api/resource_identifier.rb

Defined Under Namespace

Classes: Attributes, Base, Json, JsonApi, Null

Constant Summary

UnknownAdapterError =

Class.new(ArgumentError)

Class Method Summary (collapse)

• + (Object) adapter_class(adapter)
• + (Hash<adapter_name, adapter_class>) adapter_map
• + (Array<Symbol>) adapters

  List of adapter names.

• + (Object) configured_adapter
• + (Object) create(resource, options = {})
• + (ActiveModelSerializers::Adapter) lookup(adapter)

  Subclass of Adapter.

• + (Object) new(*args)
• + (Object) register(name, klass = name)

  Adds an adapter 'klass' with 'name' to the 'adapter_map' Names are stringified and underscored.

25
26
27

# File 'lib/active_model_serializers/adapter.rb', line 25

def adapter_class(adapter)
  ActiveModelSerializers::Adapter.lookup(adapter)
end

30
31
32

# File 'lib/active_model_serializers/adapter.rb', line 30

def adapter_map
  ADAPTER_MAP
end

35
36
37

# File 'lib/active_model_serializers/adapter.rb', line 35

def adapters
  adapter_map.keys.sort
end

14
15
16

# File 'lib/active_model_serializers/adapter.rb', line 14

def configured_adapter
  lookup(ActiveModelSerializers.config.adapter)
end

18
19
20
21
22

# File 'lib/active_model_serializers/adapter.rb', line 18

def create(resource, options = {})
  override = options.delete(:adapter)
  klass = override ? adapter_class(override) : configured_adapter
  klass.new(resource, options)
end

57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

# File 'lib/active_model_serializers/adapter.rb', line 57

def lookup(adapter)
  # 1. return if is a class
  return adapter if adapter.is_a?(Class)
  adapter_name = adapter.to_s.underscore
  # 2. return if registered
  adapter_map.fetch(adapter_name) do
    # 3. try to find adapter class from environment
    adapter_class = find_by_name(adapter_name)
    register(adapter_name, adapter_class)
    adapter_class
  end
rescue NameError, ArgumentError => e
  failure_message =
    "NameError: #{e.message}. Unknown adapter: #{adapter.inspect}. Valid adapters are: #{adapters}"
  raise UnknownAdapterError, failure_message, e.backtrace
end

8
9
10
11
12

# File 'lib/active_model_serializers/adapter.rb', line 8

def new(*args)
  fail ArgumentError, 'Adapters inherit from Adapter::Base.' \
    "Adapter.new called with args: '#{args.inspect}', from" \
    "'caller[0]'."
end

AMS::Adapter.register(:my_adapter, MyAdapter)

48
49
50
51
52

# File 'lib/active_model_serializers/adapter.rb', line 48

def register(name, klass = name)
  name = name.to_s.gsub(/\AActiveModelSerializers::Adapter::/, ''.freeze)
  adapter_map[name.underscore] = klass
  self
end