Class: RubyAMI::Client

Inherits:
Object show all
Defined in:
lib/ruby_ami/client.rb

Defined Under Namespace

Classes: ErrorHandler

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options) ⇒ Client

Returns a new instance of Client.



5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
 
# File 'lib/ruby_ami/client.rb', line 5

def initialize(options)
  @options          = options
  @logger           = options[:logger]
  @logger.level     = options[:log_level] || Logger::DEBUG if @logger
  @event_handler    = @options[:event_handler]
  @state            = :stopped

  stop_writing_actions

  @pending_actions  = {}
  @sent_actions     = {}
  @actions_lock     = Mutex.new

  @action_queue = GirlFriday::WorkQueue.new(:actions, :size => 1, :error_handler => ErrorHandler) do |action|
    @actions_write_blocker.wait
    _send_action action
    begin
      action.response
    rescue RubyAMI::Error
      nil
    end
  end

  @message_processor = GirlFriday::WorkQueue.new(:messages, :size => 1, :error_handler => ErrorHandler) do |message|
    handle_message message
  end

  @event_processor = GirlFriday::WorkQueue.new(:events, :size => 2, :error_handler => ErrorHandler) do |event|
    handle_event event
  end
end

Instance Attribute Details

#action_queue ⇒ Object (readonly)

Returns the value of attribute action_queue.



3
4
5
 
# File 'lib/ruby_ami/client.rb', line 3

def action_queue
  @action_queue
end

#actions_stream ⇒ Object (readonly)

Returns the value of attribute actions_stream.



3
4
5
 
# File 'lib/ruby_ami/client.rb', line 3

def actions_stream
  @actions_stream
end

#events_stream ⇒ Object (readonly)

Returns the value of attribute events_stream.



3
4
5
 
# File 'lib/ruby_ami/client.rb', line 3

def events_stream
  @events_stream
end

#options ⇒ Object (readonly)

Returns the value of attribute options.



3
4
5
 
# File 'lib/ruby_ami/client.rb', line 3

def options
  @options
end

Instance Method Details

#_send_action(action) ⇒ Object 



103
104
105
106
107
108
 
# File 'lib/ruby_ami/client.rb', line 103

def _send_action(action)
  logger.trace "[SEND]: #{action.inspect}" if logger
  transition_action_to_sent action
  actions_stream.send_action action
  action.state = :sent
end

#handle_event(event) ⇒ Object 



91
92
93
94
95
96
97
98
99
100
101
 
# File 'lib/ruby_ami/client.rb', line 91

def handle_event(event)
  logger.trace "[RECV-EVENTS]: #{event.inspect}" if logger
  case event
  when Stream::Connected
    
  when Stream::Disconnected
    unbind
  else
    pass_event event
  end
end

#handle_message(message) ⇒ Object 



62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
 
# File 'lib/ruby_ami/client.rb', line 62

def handle_message(message)
  logger.trace "[RECV-ACTIONS]: #{message.inspect}" if logger
  case message
  when Stream::Connected
    start_writing_actions
    
  when Stream::Disconnected
    stop_writing_actions
    unbind
  when Event
    action = @current_action_with_causal_events
    raise StandardError, "Got an unexpected event on actions socket! This AMI command may have a multi-message response. Try making Adhearsion treat it as causal action #{message.inspect}" unless action
    message.action = action
    action << message
    @current_action_with_causal_events = nil if action.complete?
  when Response, Error
    action = sent_action_with_id message.action_id
    raise StandardError, "Received an AMI response with an unrecognized ActionID!! This may be an bug! #{message.inspect}" unless action
    message.action = action

    # By this point the write loop will already have started blocking by calling the response() method on the
    # action. Because we must collect more events before we wake the write loop up again, let's create these
    # instance variable which will needed when the subsequent causal events come in.
    @current_action_with_causal_events = action if action.has_causal_events?

    action << message
  end
end

#send_action(action, headers = {}, &block) ⇒ Object 



54
55
56
57
58
59
60
 
# File 'lib/ruby_ami/client.rb', line 54

def send_action(action, headers = {}, &block)
  (action.is_a?(Action) ? action : Action.new(action, headers, &block)).tap do |action|
    logger.trace "[QUEUE]: #{action.inspect}" if logger
    register_pending_action action
    action_queue << action
  end
end

#start ⇒ Object 



41
42
43
44
45
46
47
48
 
# File 'lib/ruby_ami/client.rb', line 41

def start
  EventMachine.run do
    yield if block_given?
    @events_stream  = start_stream lambda { |event| @event_processor << event }
    @actions_stream = start_stream lambda { |message| @message_processor << message }
    @state = :started
  end
end

#stop ⇒ Object 



50
51
52
 
# File 'lib/ruby_ami/client.rb', line 50

def stop
  streams.each { |s| s.close_connection_after_writing }
end

#unbind ⇒ Object 



110
111
112
 
# File 'lib/ruby_ami/client.rb', line 110

def unbind
  EM.reactor_running? && EM.stop
end