Class: ActionCable::Server::Configuration

Inherits:
Object
  • Object
show all
Defined in:
actioncable/lib/action_cable/server/configuration.rb

Overview

Action Cable Server Configuration

An instance of this configuration object is available via ActionCable.server.config, which allows you to tweak Action Cable configuration in a Rails config initializer.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initializeConfiguration

Returns a new instance of Configuration.



16
17
18
19
20
21
22
23
24
25
# File 'actioncable/lib/action_cable/server/configuration.rb', line 16

def initialize
  @log_tags = []

  @connection_class = -> { ActionCable::Connection::Base }
  @worker_pool_size = 4

  @disable_request_forgery_protection = false
  @allow_same_origin_as_host = true
  @filter_parameters = []
end

Instance Attribute Details

#allow_same_origin_as_hostObject

Returns the value of attribute allow_same_origin_as_host



12
13
14
# File 'actioncable/lib/action_cable/server/configuration.rb', line 12

def allow_same_origin_as_host
  @allow_same_origin_as_host
end

#allowed_request_originsObject

Returns the value of attribute allowed_request_origins



12
13
14
# File 'actioncable/lib/action_cable/server/configuration.rb', line 12

def allowed_request_origins
  @allowed_request_origins
end

#cableObject

Returns the value of attribute cable



13
14
15
# File 'actioncable/lib/action_cable/server/configuration.rb', line 13

def cable
  @cable
end

#connection_classObject

Returns the value of attribute connection_class



11
12
13
# File 'actioncable/lib/action_cable/server/configuration.rb', line 11

def connection_class
  @connection_class
end

#disable_request_forgery_protectionObject

Returns the value of attribute disable_request_forgery_protection



12
13
14
# File 'actioncable/lib/action_cable/server/configuration.rb', line 12

def disable_request_forgery_protection
  @disable_request_forgery_protection
end

#filter_parametersObject

Returns the value of attribute filter_parameters



12
13
14
# File 'actioncable/lib/action_cable/server/configuration.rb', line 12

def filter_parameters
  @filter_parameters
end

#log_tagsObject

Returns the value of attribute log_tags



10
11
12
# File 'actioncable/lib/action_cable/server/configuration.rb', line 10

def log_tags
  @log_tags
end

#loggerObject

Returns the value of attribute logger



10
11
12
# File 'actioncable/lib/action_cable/server/configuration.rb', line 10

def logger
  @logger
end

#mount_pathObject

Returns the value of attribute mount_path



13
14
15
# File 'actioncable/lib/action_cable/server/configuration.rb', line 13

def mount_path
  @mount_path
end

#precompile_assetsObject

Returns the value of attribute precompile_assets



14
15
16
# File 'actioncable/lib/action_cable/server/configuration.rb', line 14

def precompile_assets
  @precompile_assets
end

#urlObject

Returns the value of attribute url



13
14
15
# File 'actioncable/lib/action_cable/server/configuration.rb', line 13

def url
  @url
end

#worker_pool_sizeObject

Returns the value of attribute worker_pool_size



11
12
13
# File 'actioncable/lib/action_cable/server/configuration.rb', line 11

def worker_pool_size
  @worker_pool_size
end

Instance Method Details

#pubsub_adapterObject

Returns constant of subscription adapter specified in config/cable.yml. If the adapter cannot be found, this will default to the Redis adapter. Also makes sure proper dependencies are required.



30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
# File 'actioncable/lib/action_cable/server/configuration.rb', line 30

def pubsub_adapter
  adapter = (cable.fetch("adapter") { "redis" })

  # Require the adapter itself and give useful feedback about
  #   1. Missing adapter gems and
  #   2. Adapter gems' missing dependencies.
  path_to_adapter = "action_cable/subscription_adapter/#{adapter}"
  begin
    require path_to_adapter
  rescue LoadError => e
    # We couldn't require the adapter itself. Raise an exception that
    # points out config typos and missing gems.
    if e.path == path_to_adapter
      # We can assume that a non-builtin adapter was specified, so it's
      # either misspelled or missing from Gemfile.
      raise e.class, "Could not load the '#{adapter}' Action Cable pubsub adapter. Ensure that the adapter is spelled correctly in config/cable.yml and that you've added the necessary adapter gem to your Gemfile.", e.backtrace

    # Bubbled up from the adapter require. Prefix the exception message
    # with some guidance about how to address it and reraise.
    else
      raise e.class, "Error loading the '#{adapter}' Action Cable pubsub adapter. Missing a gem it depends on? #{e.message}", e.backtrace
    end
  end

  adapter = adapter.camelize
  adapter = "PostgreSQL" if adapter == "Postgresql"
  "ActionCable::SubscriptionAdapter::#{adapter}".constantize
end