rapns 3.0.0-java

data/spec/unit/daemon/apns/app_runner_spec.rb

@@ -0,0 +1,39 @@
+require 'unit_spec_helper'
+require File.dirname(__FILE__) + '/../app_runner_shared.rb'
+
+describe Rapns::Daemon::Apns::AppRunner do
+  it_behaves_like 'an AppRunner subclass'
+
+  let(:app_class) { Rapns::Apns::App }
+  let(:app) { app_class.create!(:name => 'my_app', :environment => 'development',
+                                :certificate => TEST_CERT, :password => 'pass') }
+  let(:runner) { Rapns::Daemon::Apns::AppRunner.new(app) }
+  let(:handler) { stub(:start => nil, :stop => nil, :queue= => nil) }
+  let(:receiver) { stub(:start => nil, :stop => nil) }
+  let(:config) { {:feedback_poll => 60 } }
+  let(:logger) { stub(:info => nil) }
+
+  before do
+    Rapns::Daemon.stub(:logger => logger)
+    Rapns::Daemon::Apns::DeliveryHandler.stub(:new => handler)
+    Rapns::Daemon::Apns::FeedbackReceiver.stub(:new => receiver)
+    Rapns::Daemon.stub(:config => config)
+  end
+
+  it 'instantiates a new feedback receiver when started' do
+    Rapns::Daemon::Apns::FeedbackReceiver.should_receive(:new).with(app, 'feedback.sandbox.push.apple.com',
+                                                                    2196, 60)
+    runner.start
+  end
+
+  it 'starts the feedback receiver' do
+    receiver.should_receive(:start)
+    runner.start
+  end
+
+  it 'stops the feedback receiver' do
+    runner.start
+    receiver.should_receive(:stop)
+    runner.stop
+  end
+end

data/spec/unit/daemon/apns/connection_spec.rb

@@ -0,0 +1,234 @@
+require "unit_spec_helper"
+
+describe Rapns::Daemon::Apns::Connection do
+  let(:ssl_context) { stub(:key= => nil, :cert= => nil) }
+  let(:rsa_key) { stub }
+  let(:certificate) { stub }
+  let(:password) { stub }
+  let(:x509_certificate) { stub }
+  let(:host) { 'gateway.push.apple.com' }
+  let(:port) { '2195' }
+  let(:tcp_socket) { stub(:setsockopt => nil, :close => nil) }
+  let(:ssl_socket) { stub(:sync= => nil, :connect => nil, :close => nil, :write => nil, :flush => nil) }
+  let(:logger) { stub(:info => nil, :error => nil) }
+  let(:connection) { Rapns::Daemon::Apns::Connection.new('Connection 0', host, port, certificate, password) }
+
+  before do
+    OpenSSL::SSL::SSLContext.stub(:new => ssl_context)
+    OpenSSL::PKey::RSA.stub(:new => rsa_key)
+    OpenSSL::X509::Certificate.stub(:new => x509_certificate)
+    TCPSocket.stub(:new => tcp_socket)
+    OpenSSL::SSL::SSLSocket.stub(:new => ssl_socket)
+    Rapns::Daemon.stub(:logger => logger)
+  end
+
+  it "reads the number of bytes from the SSL socket" do
+    ssl_socket.should_receive(:read).with(123)
+    connection.connect
+    connection.read(123)
+  end
+
+  it "selects on the SSL socket until the given timeout" do
+    IO.should_receive(:select).with([ssl_socket], nil, nil, 10)
+    connection.connect
+    connection.select(10)
+  end
+
+  describe "when setting up the SSL context" do
+    it "sets the key on the context" do
+      OpenSSL::PKey::RSA.should_receive(:new).with(certificate, password).and_return(rsa_key)
+      ssl_context.should_receive(:key=).with(rsa_key)
+      connection.connect
+    end
+
+    it "sets the cert on the context" do
+      OpenSSL::X509::Certificate.should_receive(:new).with(certificate).and_return(x509_certificate)
+      ssl_context.should_receive(:cert=).with(x509_certificate)
+      connection.connect
+    end
+  end
+
+  describe "when connecting the socket" do
+    it "creates a TCP socket using the configured host and port" do
+      TCPSocket.should_receive(:new).with(host, port).and_return(tcp_socket)
+      connection.connect
+    end
+
+    it "creates a new SSL socket using the TCP socket and SSL context" do
+      OpenSSL::SSL::SSLSocket.should_receive(:new).with(tcp_socket, ssl_context).and_return(ssl_socket)
+      connection.connect
+    end
+
+    it "sets the sync option on the SSL socket" do
+      ssl_socket.should_receive(:sync=).with(true)
+      connection.connect
+    end
+
+    it "connects the SSL socket" do
+      ssl_socket.should_receive(:connect)
+      connection.connect
+    end
+
+    it "sets the socket option TCP_NODELAY" do
+      tcp_socket.should_receive(:setsockopt).with(Socket::IPPROTO_TCP, Socket::TCP_NODELAY, 1)
+      connection.connect
+    end
+
+    it "sets the socket option SO_KEEPALIVE" do
+      tcp_socket.should_receive(:setsockopt).with(Socket::SOL_SOCKET, Socket::SO_KEEPALIVE, 1)
+      connection.connect
+    end
+  end
+
+  describe "when shuting down the connection" do
+    it "closes the TCP socket" do
+      connection.connect
+      tcp_socket.should_receive(:close)
+      connection.close
+    end
+
+    it "does not attempt to close the TCP socket if it is not connected" do
+      connection.connect
+      tcp_socket.should_not_receive(:close)
+      connection.instance_variable_set("@tcp_socket", nil)
+      connection.close
+    end
+
+    it "closes the SSL socket" do
+      connection.connect
+      ssl_socket.should_receive(:close)
+      connection.close
+    end
+
+    it "does not attempt to close the SSL socket if it is not connected" do
+      connection.connect
+      ssl_socket.should_not_receive(:close)
+      connection.instance_variable_set("@ssl_socket", nil)
+      connection.close
+    end
+
+    it "ignores IOError when the socket is already closed" do
+      tcp_socket.stub(:close).and_raise(IOError)
+      connection.connect
+      expect { connection.close }.to_not raise_error(IOError)
+    end
+  end
+
+  shared_examples_for "when the write fails" do
+    before do
+      connection.stub(:sleep)
+      connection.connect
+      ssl_socket.stub(:write).and_raise(error_type)
+    end
+
+    it "logs that the connection has been lost once only" do
+      logger.should_receive(:error).with("[Connection 0] Lost connection to gateway.push.apple.com:2195 (#{error_type.name}), reconnecting...").once
+      begin
+        connection.write(nil)
+      rescue Rapns::Daemon::Apns::ConnectionError
+      end
+    end
+
+    it "retries to make a connection 3 times" do
+      connection.should_receive(:reconnect).exactly(3).times
+      begin
+        connection.write(nil)
+      rescue Rapns::Daemon::Apns::ConnectionError
+      end
+    end
+
+    it "raises a ConnectionError after 3 attempts at reconnecting" do
+      expect do
+        connection.write(nil)
+      end.to raise_error(Rapns::Daemon::Apns::ConnectionError, "Connection 0 tried 3 times to reconnect but failed (#{error_type.name}).")
+    end
+
+    it "sleeps 1 second before retrying the connection" do
+      connection.should_receive(:sleep).with(1)
+      begin
+        connection.write(nil)
+      rescue Rapns::Daemon::Apns::ConnectionError
+      end
+    end
+  end
+
+  describe "when write raises an Errno::EPIPE" do
+    it_should_behave_like "when the write fails"
+
+    def error_type
+      Errno::EPIPE
+    end
+  end
+
+  describe "when write raises an Errno::ETIMEDOUT" do
+    it_should_behave_like "when the write fails"
+
+    def error_type
+      Errno::ETIMEDOUT
+    end
+  end
+
+  describe "when write raises an OpenSSL::SSL::SSLError" do
+    it_should_behave_like "when the write fails"
+
+    def error_type
+      OpenSSL::SSL::SSLError
+    end
+  end
+
+  describe "when reconnecting" do
+    it 'closes the socket' do
+      connection.should_receive(:close)
+      connection.send(:reconnect)
+    end
+
+    it 'connects the socket' do
+      connection.should_receive(:connect_socket)
+      connection.send(:reconnect)
+    end
+  end
+
+  describe "when sending a notification" do
+    before { connection.connect }
+
+    it "writes the data to the SSL socket" do
+      ssl_socket.should_receive(:write).with("blah")
+      connection.write("blah")
+    end
+
+    it "flushes the SSL socket" do
+      ssl_socket.should_receive(:flush)
+      connection.write("blah")
+    end
+  end
+
+  describe 'idle period' do
+    before { connection.connect }
+
+    it 'reconnects if the connection has been idle for more than the defined period' do
+      Rapns::Daemon::Apns::Connection.stub(:idle_period => 0.1)
+      sleep 0.2
+      connection.should_receive(:reconnect)
+      connection.write('blah')
+    end
+
+    it 'resets the last write time' do
+      now = Time.now
+      Time.stub(:now => now)
+      connection.write('blah')
+      connection.last_write.should == now
+    end
+
+    it 'does not reconnect if the connection has not been idle for more than the defined period' do
+      connection.should_not_receive(:reconnect)
+      connection.write('blah')
+    end
+
+    it 'logs the the connection is idle' do
+      Rapns::Daemon::Apns::Connection.stub(:idle_period => 0.1)
+      sleep 0.2
+      Rapns::Daemon.logger.should_receive(:info).with('[Connection 0] Idle period exceeded, reconnecting...')
+      connection.write('blah')
+    end
+  end
+end

data/spec/unit/daemon/apns/delivery_handler_spec.rb

@@ -0,0 +1,48 @@
+require 'unit_spec_helper'
+require File.dirname(__FILE__) + '/../delivery_handler_shared.rb'
+
+describe Rapns::Daemon::Apns::DeliveryHandler do
+  it_should_behave_like 'an DeliveryHandler subclass'
+
+  let(:host) { 'localhost' }
+  let(:port) { 2195 }
+  let(:certificate) { stub }
+  let(:password) { stub }
+  let(:app) { stub(:password => password, :certificate => certificate, :name => 'MyApp')}
+  let(:delivery_handler) { Rapns::Daemon::Apns::DeliveryHandler.new(app, host, port) }
+  let(:connection) { stub('Connection', :select => false, :write => nil, :reconnect => nil, :close => nil, :connect => nil) }
+  let(:notification) { stub }
+  let(:http) { stub(:shutdown => nil)}
+  let(:queue) { Rapns::Daemon::DeliveryQueue.new }
+
+  before do
+    Rapns::Daemon::Apns::Connection.stub(:new => connection)
+    Rapns::Daemon::Apns::Delivery.stub(:perform)
+    delivery_handler.queue = queue
+    queue.push(notification)
+  end
+
+  it "instantiates a new connection" do
+    Rapns::Daemon::Apns::Connection.should_receive(:new).with(app.name, host, port, certificate, password)
+    Rapns::Daemon::Apns::DeliveryHandler.new(app, host, port)
+  end
+
+  it 'performs delivery of an notification' do
+    Rapns::Daemon::Apns::Delivery.should_receive(:perform).with(app, connection, notification)
+    delivery_handler.start
+    delivery_handler.stop
+  end
+
+  it "connects the socket when instantiated" do
+    connection.should_receive(:connect)
+    Rapns::Daemon::Apns::DeliveryHandler.new(app, host, port)
+    delivery_handler.start
+    delivery_handler.stop
+  end
+
+  it 'closes the connection stopped' do
+    connection.should_receive(:close)
+    delivery_handler.start
+    delivery_handler.stop
+  end
+end

data/spec/unit/daemon/apns/delivery_spec.rb

@@ -0,0 +1,160 @@
+require 'unit_spec_helper'
+
+describe Rapns::Daemon::Apns::Delivery do
+  let(:app) { stub(:name => 'MyApp') }
+  let(:notification) { stub.as_null_object }
+  let(:logger) { stub(:error => nil, :info => nil) }
+  let(:config) { stub(:check_for_errors => true) }
+  let(:connection) { stub(:select => false, :write => nil, :reconnect => nil, :close => nil, :connect => nil) }
+  let(:delivery) { Rapns::Daemon::Apns::Delivery.new(app, connection, notification) }
+
+  def perform
+    begin
+      delivery.perform
+    rescue Rapns::DeliveryError, Rapns::Apns::DisconnectionError
+    end
+  end
+
+  before do
+    Rapns.stub(:config => config)
+    Rapns::Daemon.stub(:logger => logger)
+  end
+
+  it "sends the binary version of the notification" do
+    notification.stub(:to_binary => "hi mom")
+    connection.should_receive(:write).with("hi mom")
+    perform
+  end
+
+  it "logs the notification delivery" do
+    notification.stub(:id => 666, :device_token => 'abc123')
+    logger.should_receive(:info).with("[MyApp] 666 sent to abc123")
+    perform
+  end
+
+  it "marks the notification as delivered" do
+    notification.should_receive(:delivered=).with(true)
+    perform
+  end
+
+  it "sets the time the notification was delivered" do
+    now = Time.now
+    Time.stub(:now).and_return(now)
+    notification.should_receive(:delivered_at=).with(now)
+    perform
+  end
+
+  it "does not trigger validations when saving the notification" do
+    notification.should_receive(:save!).with(:validate => false)
+    perform
+  end
+
+  it "updates notification with the ability to reconnect the database" do
+    delivery.should_receive(:with_database_reconnect_and_retry)
+    perform
+  end
+
+  it 'does not check for errors if check_for_errors config option is false' do
+    config.stub(:check_for_errors => false)
+    delivery.should_not_receive(:check_for_error)
+    perform
+  end
+
+  describe "when delivery fails" do
+    before { connection.stub(:select => true, :read => [8, 4, 69].pack("ccN")) }
+
+    it "updates notification with the ability to reconnect the database" do
+      delivery.should_receive(:with_database_reconnect_and_retry)
+      perform
+    end
+
+    it "sets the notification as not delivered" do
+      notification.should_receive(:delivered=).with(false)
+      perform
+    end
+
+    it "sets the notification delivered_at timestamp to nil" do
+      notification.should_receive(:delivered_at=).with(nil)
+      perform
+    end
+
+    it "sets the notification as failed" do
+      notification.should_receive(:failed=).with(true)
+      perform
+    end
+
+    it "sets the notification failed_at timestamp" do
+      now = Time.now
+      Time.stub(:now).and_return(now)
+      notification.should_receive(:failed_at=).with(now)
+      perform
+    end
+
+    it "sets the notification error code" do
+      notification.should_receive(:error_code=).with(4)
+      perform
+    end
+
+    it "logs the delivery error" do
+      # checking for the stubbed error doesn't work in jruby, but checking
+      # for the exception by class does.
+
+      #error = Rapns::DeliveryError.new(4, 12, "Missing payload")
+      #Rapns::DeliveryError.stub(:new => error)
+      #expect { delivery.perform }.to raise_error(error)
+
+      expect { delivery.perform }.to raise_error(Rapns::DeliveryError)
+    end
+
+    it "sets the notification error description" do
+      notification.should_receive(:error_description=).with("Missing payload")
+      perform
+    end
+
+    it "skips validation when saving the notification" do
+      notification.should_receive(:save!).with(:validate => false)
+      perform
+    end
+
+    it "reads 6 bytes from the socket" do
+      connection.should_receive(:read).with(6).and_return(nil)
+      perform
+    end
+
+    it "does not attempt to read from the socket if the socket was not selected for reading after the timeout" do
+      connection.stub(:select => nil)
+      connection.should_not_receive(:read)
+      perform
+    end
+
+    it "reconnects the socket" do
+      connection.should_receive(:reconnect)
+      perform
+    end
+
+    it "logs that the connection is being reconnected" do
+      Rapns::Daemon.logger.should_receive(:error).with("[MyApp] Error received, reconnecting...")
+      perform
+    end
+
+    context "when the APNs disconnects without returning an error" do
+      before do
+        connection.stub(:read => nil)
+      end
+
+      it 'raises a DisconnectError error if the connection is closed without an error being returned' do
+        expect { delivery.perform }.to raise_error(Rapns::Apns::DisconnectionError)
+      end
+
+      it 'does not set the error code on the notification' do
+        notification.should_receive(:error_code=).with(nil)
+        perform
+      end
+
+      it 'sets the error description on the notification' do
+        notification.should_receive(:error_description=).with("APNs disconnected without returning an error.")
+        perform
+      end
+    end
+  end
+end

data/spec/unit/daemon/apns/disconnection_error_spec.rb

@@ -0,0 +1,18 @@
+require 'unit_spec_helper'
+
+describe Rapns::Apns::DisconnectionError do
+  let(:error) { Rapns::Apns::DisconnectionError.new }
+
+  it 'returns a nil error code' do
+    error.code.should be_nil
+  end
+
+  it 'contains an error description' do
+    error.description
+  end
+
+  it 'returns a message' do
+    error.message
+    error.to_s
+  end
+end

data/spec/unit/daemon/apns/feedback_receiver_spec.rb

@@ -0,0 +1,118 @@
+require "unit_spec_helper"
+
+describe Rapns::Daemon::Apns::FeedbackReceiver, 'check_for_feedback' do
+  let(:host) { 'feedback.push.apple.com' }
+  let(:port) { 2196 }
+  let(:poll) { 60 }
+  let(:certificate) { stub }
+  let(:password) { stub }
+  let(:app) { stub(:name => 'my_app', :password => password, :certificate => certificate) }
+  let(:connection) { stub(:connect => nil, :read => nil, :close => nil) }
+  let(:logger) { stub(:error => nil, :info => nil) }
+  let(:receiver) { Rapns::Daemon::Apns::FeedbackReceiver.new(app, host, port, poll) }
+
+  before do
+    receiver.stub(:interruptible_sleep)
+    Rapns::Daemon.logger = logger
+    Rapns::Daemon::Apns::Connection.stub(:new => connection)
+    Rapns::Apns::Feedback.stub(:create!)
+    receiver.instance_variable_set("@stop", false)
+  end
+
+  def stub_connection_read_with_tuple
+    connection.unstub(:read)
+
+    def connection.read(bytes)
+      if !@called
+        @called = true
+        "N\xE3\x84\r\x00 \x83OxfU\xEB\x9F\x84aJ\x05\xAD}\x00\xAF1\xE5\xCF\xE9:\xC3\xEA\a\x8F\x1D\xA4M*N\xB0\xCE\x17"
+      end
+    end
+  end
+
+  it 'instantiates a new connection' do
+    Rapns::Daemon::Apns::Connection.should_receive(:new).with("FeedbackReceiver:#{app.name}", host, port, certificate, password)
+    receiver.check_for_feedback
+  end
+
+  it 'connects to the feeback service' do
+    connection.should_receive(:connect)
+    receiver.check_for_feedback
+  end
+
+  it 'closes the connection' do
+    connection.should_receive(:close)
+    receiver.check_for_feedback
+  end
+
+  it 'reads from the connection' do
+    connection.should_receive(:read).with(38)
+    receiver.check_for_feedback
+  end
+
+  it 'logs the feedback' do
+    stub_connection_read_with_tuple
+    Rapns::Daemon.logger.should_receive(:info).with("[FeedbackReceiver:my_app] Delivery failed at 2011-12-10 16:08:45 UTC for 834f786655eb9f84614a05ad7d00af31e5cfe93ac3ea078f1da44d2a4eb0ce17")
+    receiver.check_for_feedback
+  end
+
+  it 'creates the feedback' do
+    stub_connection_read_with_tuple
+    Rapns::Apns::Feedback.should_receive(:create!).with(:failed_at => Time.at(1323533325), :device_token => '834f786655eb9f84614a05ad7d00af31e5cfe93ac3ea078f1da44d2a4eb0ce17', :app => app)
+    receiver.check_for_feedback
+  end
+
+  it 'logs errors' do
+    error = StandardError.new('bork!')
+    connection.stub(:read).and_raise(error)
+    Rapns::Daemon.logger.should_receive(:error).with(error)
+    receiver.check_for_feedback
+  end
+
+  it 'sleeps for the feedback poll period' do
+    receiver.stub(:check_for_feedback)
+    receiver.should_receive(:interruptible_sleep).with(60).at_least(:once)
+    Thread.stub(:new).and_yield
+    receiver.stub(:loop).and_yield
+    receiver.start
+  end
+
+  it 'checks for feedback when started' do
+    receiver.should_receive(:check_for_feedback).at_least(:once)
+    Thread.stub(:new).and_yield
+    receiver.stub(:loop).and_yield
+    receiver.start
+  end
+
+  it 'interrupts sleep when stopped' do
+    receiver.stub(:check_for_feedback)
+    receiver.should_receive(:interrupt_sleep)
+    receiver.stop
+  end
+
+  it 'calls the apns_feedback_callback when feedback is received and the callback is set' do
+    stub_connection_read_with_tuple
+    Rapns.config.apns_feedback_callback = Proc.new {}
+    feedback = Object.new
+    Rapns::Apns::Feedback.stub(:create! => feedback)
+    Rapns.config.apns_feedback_callback.should_receive(:call).with(feedback)
+    receiver.check_for_feedback
+  end
+
+  it 'catches exceptions in the apns_feedback_callback' do
+    error = StandardError.new('bork!')
+    stub_connection_read_with_tuple
+    callback = Proc.new { raise error }
+    Rapns.config.on_apns_feedback &callback
+    expect { receiver.check_for_feedback }.not_to raise_error
+  end
+
+  it 'logs an exception from the apns_feedback_callback' do
+    error = StandardError.new('bork!')
+    stub_connection_read_with_tuple
+    callback = Proc.new { raise error }
+    Rapns::Daemon.logger.should_receive(:error).with(error)
+    Rapns.config.on_apns_feedback &callback
+    receiver.check_for_feedback
+  end
+end

data/spec/unit/daemon/app_runner_shared.rb

@@ -0,0 +1,66 @@
+shared_examples_for "an AppRunner subclass" do
+  let(:queue) { stub(:notifications_processed? => true, :push => nil) }
+
+  before { Rapns::Daemon::DeliveryQueue.stub(:new => queue) }
+  after { Rapns::Daemon::AppRunner.runners.clear }
+
+  describe 'start' do
+    it 'starts a delivery handler for each connection' do
+      handler.should_receive(:start)
+      runner.start
+    end
+
+    it 'assigns the queue to the handler' do
+      handler.should_receive(:queue=).with(queue)
+      runner.start
+    end
+  end
+
+  describe 'enqueue' do
+    let(:notification) { stub }
+
+    it 'enqueues the notification' do
+      queue.should_receive(:push).with(notification)
+      runner.enqueue(notification)
+    end
+  end
+
+  describe 'stop' do
+    before { runner.start }
+
+    it 'stops the delivery handlers' do
+      handler.should_receive(:stop)
+      runner.stop
+    end
+  end
+
+  describe 'idle?' do
+    it 'is idle if all notifications have been processed' do
+      queue.stub(:notifications_processed? => true)
+      runner.idle?.should be_true
+    end
+
+    it 'is not idle if not all notifications have been processed' do
+      queue.stub(:notifications_processed? => false)
+      runner.idle?.should be_false
+    end
+  end
+
+  describe 'sync' do
+    before { runner.start }
+
+    it 'reduces the number of handlers if needed' do
+      handler.should_receive(:stop)
+      new_app = app_class.new
+      new_app.stub(:connections => app.connections - 1)
+      runner.sync(new_app)
+    end
+
+    it 'increases the number of handlers if needed' do
+      runner.should_receive(:start_handler).and_return(handler)
+      new_app = app_class.new
+      new_app.stub(:connections => app.connections + 1)
+      runner.sync(new_app)
+    end
+  end
+end