Class: Faye::WebSocket

Inherits:
Object
  • Object
show all
Includes:
API
Defined in:
lib/faye/websocket.rb,
lib/faye/websocket/api.rb,
lib/faye/websocket/client.rb,
lib/faye/adapters/rainbows.rb,
lib/faye/websocket/adapter.rb,
lib/faye/adapters/rainbows_client.rb

Defined Under Namespace

Modules: API, Adapter Classes: Client, RainbowsClient, Stream

Constant Summary collapse

ADAPTERS = 
{
  'goliath'  => :Goliath,
  'rainbows' => :Rainbows,
  'thin'     => :Thin
}

Constants included from API

API::CLOSED, API::CLOSING, API::CONNECTING, API::OPEN

Instance Attribute Summary collapse

Attributes included from API

#buffered_amount, #ready_state, #url

Class Method Summary collapse

Instance Method Summary collapse

Methods included from API

#close, #ping, #protocol, #send

Methods included from API::EventTarget

#add_event_listener, #add_listener, #dispatch_event, #remove_event_listener

Constructor Details

#initialize(env, protocols = nil, options = {}) ⇒ WebSocket

Returns a new instance of WebSocket.



55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
 
# File 'lib/faye/websocket.rb', line 55

def initialize(env, protocols = nil, options = {})
  WebSocket.ensure_reactor_running

  @env     = env
  @url     = WebSocket.determine_url(@env)
  @driver  = ::WebSocket::Driver.rack(self, :protocols => protocols)
  @stream  = Stream.new(self)
  @ping    = options[:ping]
  @ping_id = 0

  if callback = @env['async.callback']
    callback.call([101, {}, @stream])
  end

  super()
  @driver.start
end

Instance Attribute Details

#env ⇒ Object (readonly)

Returns the value of attribute env.



52
53
54
 
# File 'lib/faye/websocket.rb', line 52

def env
  @env
end

Class Method Details

.determine_url(env) ⇒ Object 



30
31
32
33
34
 
# File 'lib/faye/websocket.rb', line 30

def self.determine_url(env)
  secure = Rack::Request.new(env).ssl?
  scheme = secure ? 'wss:' : 'ws:'
  "#{ scheme }//#{ env['HTTP_HOST'] }#{ env['REQUEST_URI'] }"
end

.ensure_reactor_running ⇒ Object 



36
37
38
39
 
# File 'lib/faye/websocket.rb', line 36

def self.ensure_reactor_running
  Thread.new { EventMachine.run } unless EventMachine.reactor_running?
  Thread.pass until EventMachine.reactor_running?
end

.load_adapter(backend) ⇒ Object 



41
42
43
44
45
46
 
# File 'lib/faye/websocket.rb', line 41

def self.load_adapter(backend)
  const = Kernel.const_get(ADAPTERS[backend]) rescue nil
  require(backend) unless const
  path = File.expand_path("../adapters/#{backend}.rb", __FILE__)
  require(path) if File.file?(path)
end

.websocket?(env) ⇒ Boolean

Returns:

  • (Boolean) 


48
49
50
 
# File 'lib/faye/websocket.rb', line 48

def self.websocket?(env)
  ::WebSocket::Driver.websocket?(env)
end

Instance Method Details

#rack_response ⇒ Object 



77
78
79
 
# File 'lib/faye/websocket.rb', line 77

def rack_response
  [ -1, {}, [] ]
end

#write(data) ⇒ Object 



73
74
75
 
# File 'lib/faye/websocket.rb', line 73

def write(data)
  @stream.write(data)
end