smsRuby 1.0.0-x86-linux

data/lib/smsruby/connection.rb

@@ -0,0 +1,141 @@
+require 'sms'
+require 'smsruby/error'
+
+#
+# The Connection class represent the connection layer. Contains all values that
+# describe an available connection that is associated with an attach phone.
+# Implements methods for comunicating with the phone for send/receive messages
+# and for obtain information about associated phone
+#
+class Connection
+
+  include Sms
+
+  # Reference the status of the current connection
+  attr_accessor :status
+  # Reference if the current connection it's allow to send, receive or both
+  attr_accessor :typec
+  # Reference the associated port for the current connection
+  attr_reader :port
+  # Represent the unique id of the current connection
+  attr_reader :id_connection
+  # Reference model of the phone attached to the current connection
+  attr_reader :phone_model
+  # Reference manufacter of the phone attached to the current connection
+  attr_reader :phone_manufacter
+  # Reference the installed software revition in the phone attached to the current connection
+  attr_reader :phone_revsoft
+  # Reference imei of the phone attached to the current connection
+  attr_reader :phone_imei
+
+
+  #
+  # Initialize the connection reprensented by name through businit function provided
+  # by the sms shared object. In the same way initialize all class attributes.
+  #
+  def initialize(name,port)
+    begin
+      if RUBY_PLATFORM =~ /(win|w)32$/
+       path = ENV['userprofile']+'/_gnokiirc'
+      elsif RUBY_PLATFORM =~ /linux/
+       path = ENV['HOME']+'/.gnokiirc'
+      end
+      error=businit(name, path)
+      error <= 0  ? (error==-500 ? (raise "The maximum number of connection has been open") : @id_connection=error.to_i*-1) : exception(error)
+      @port = port
+      @phone_model=phoneModel(@id_connection)
+      @phone_manufacter=phoneManufacter(@id_connection)
+      @phone_revsoft=phoneRevSoft(@id_connection)
+      @phone_imei=(phoneImei(@id_connection)).gsub(/[\s\D]/, "")
+      @typec='none'
+      @status='available'
+    end
+  end
+
+  #
+  # Allow to test and existing connection to verify if is still available. Return
+  # 0 if is still available, diferent from 0 otherwise.
+  #
+  def test
+    return testconn(@id_connection)
+  end
+
+  #
+  # Return the signal level of the phone asociatted with the current connection
+  #
+  def signallevel
+    return rf_level(@id_connection)
+  end
+
+  #
+  # Return the battery level of the phone asociatted with the current connection
+  #
+  def batterylevel
+    return bat_level(@id_connection)
+  end
+
+  #
+  # Terminate the current connection
+  #
+  def close
+    busterminate(@id_connection)
+  end
+
+  #
+  # Execute a specific function from the shared object depending of type option value
+  # specified in hsh. If an error occurs an exception will be thrown
+  #
+  def execute(hsh)
+    cmd = hsh[:type]
+
+    case cmd
+    when /send/
+      @status = 'sending'
+      error = 0
+      puts ":: Manufacter sending the message: "+@phone_manufacter.to_s+' in port: '+@port.to_s+' with id: '+@id_connection.to_s+"\n"
+      error= send_sms(hsh[:dst], hsh[:msj], hsh[:smsc], hsh[:report], hsh[:validity], @id_connection)
+      #puts ':: The return error in execute send function is: '+error.to_s+"\n"
+      sleep(7)
+    when /receive/
+      @status = 'receiving'
+      msj=[]
+      nmsj=0
+      error = get_sms(@id_connection)
+      error <= 0 ? number=error.to_i*-1 : exception(error)
+      number.times { |i|
+          m = get_msj(i,@id_connection)
+          if(m.type_sms.eql?("Inbox Message"))
+            msj[nmsj] = m  if (m.error == 0)
+            nmsj+=1 if m.error ==0
+          end
+        }
+      return msj
+    end
+    exception(error) unless error==0
+  end
+
+  def type(status)
+    case status
+      when 0 then return "unread"
+      when 1 then return "read"
+      when 2 then return "sent"
+      when 3 then return "unsent"
+    end
+  end
+
+  #
+  # Throws a diferent exception depending of specified error code
+  #
+  def exception (error)
+    case error
+      when 1..9 then raise ErrorHandler::GeneralError.new(error)
+      when 10..15 then raise ErrorHandler::StatemachineError.new(error)
+      when 16..18 then raise ErrorHandler::LocationError.new(error)
+      when 19..21 then raise ErrorHandler::FormatError.new(error)
+      when 22..25 then raise ErrorHandler::CallError.new(error)
+      when 26..29 then raise ErrorHandler::OtherError.new(error)
+      when 30..35 then raise ErrorHandler::ConfigError.new(error)
+    end
+  end
+
+end

data/lib/smsruby/connection.rb~

@@ -0,0 +1,141 @@
+require 'sms'
+require 'smsruby/error'
+
+#
+# The Connection class represent the connection layer. Contains all values that
+# describe an available connection that is associated with an attach phone.
+# Implements methods for comunicating with the phone for send/receive messages
+# and for obtain information about associated phone
+#
+class Connection
+
+  include Sms
+
+  # Reference the status of the current connection
+  attr_accessor :status
+  # Reference if the current connection it's allow to send, receive or both
+  attr_accessor :typec
+  # Reference the associated port for the current connection
+  attr_reader :port
+  # Represent the unique id of the current connection
+  attr_reader :id_connection
+  # Reference model of the phone attached to the current connection
+  attr_reader :phone_model
+  # Reference manufacter of the phone attached to the current connection
+  attr_reader :phone_manufacter
+  # Reference the installed software revition in the phone attached to the current connection
+  attr_reader :phone_revsoft
+  # Reference imei of the phone attached to the current connection
+  attr_reader :phone_imei
+
+
+  #
+  # Initialize the connection reprensented by name through businit function provided
+  # by the sms shared object. In the same way initialize all class attributes.
+  #
+  def initialize(name,port)
+    begin
+      if RUBY_PLATFORM =~ /(win|w)32$/
+       path = ENV['userprofile']+'/_gnokiirc'
+      elsif RUBY_PLATFORM =~ /linux/
+       path = ENV['HOME']+'/.gnokiirc'
+      end
+      error=businit(name, path)
+      error <= 0  ? (error==-10 ? (raise "The maximum number of connection has been open") : @id_connection=error.to_i*-1) : exception(error)
+      @port = port
+      @phone_model=phoneModel(@id_connection)
+      @phone_manufacter=phoneManufacter(@id_connection)
+      @phone_revsoft=phoneRevSoft(@id_connection)
+      @phone_imei=(phoneImei(@id_connection)).gsub(/[\s\D]/, "")
+      @typec='none'
+      @status='available'
+    end
+  end
+
+  #
+  # Allow to test and existing connection to verify if is still available. Return
+  # 0 if is still available, diferent from 0 otherwise.
+  #
+  def test
+    return testconn(@id_connection)
+  end
+
+  #
+  # Return the signal level of the phone asociatted with the current connection
+  #
+  def signallevel
+    return rf_level(@id_connection)
+  end
+
+  #
+  # Return the battery level of the phone asociatted with the current connection
+  #
+  def batterylevel
+    return bat_level(@id_connection)
+  end
+
+  #
+  # Terminate the current connection
+  #
+  def close
+    busterminate(@id_connection)
+  end
+
+  #
+  # Execute a specific function from the shared object depending of type option value
+  # specified in hsh. If an error occurs an exception will be thrown
+  #
+  def execute(hsh)
+    cmd = hsh[:type]
+
+    case cmd
+    when /send/
+      @status = 'sending'
+      error = 0
+      puts ":: Manufacter sending the message: "+@phone_manufacter.to_s+' in port: '+@port.to_s+' with id: '+@id_connection.to_s+"\n"
+      error= send_sms(hsh[:dst], hsh[:msj], hsh[:smsc], hsh[:report], hsh[:validity], @id_connection)
+      #puts ':: The return error in execute send function is: '+error.to_s+"\n"
+      sleep(7)
+    when /receive/
+      @status = 'receiving'
+      msj=[]
+      nmsj=0
+      error = get_sms(@id_connection)
+      error <= 0 ? number=error.to_i*-1 : exception(error)
+      number.times { |i|
+          m = get_msj(i,@id_connection)
+          if(m.type_sms.eql?("Inbox Message"))
+            msj[nmsj] = m  if (m.error == 0)
+            nmsj+=1 if m.error ==0
+          end
+        }
+      return msj
+    end
+    exception(error) unless error==0
+  end
+
+  def type(status)
+    case status
+      when 0 then return "unread"
+      when 1 then return "read"
+      when 2 then return "sent"
+      when 3 then return "unsent"
+    end
+  end
+
+  #
+  # Throws a diferent exception depending of specified error code
+  #
+  def exception (error)
+    case error
+      when 1..9 then raise ErrorHandler::GeneralError.new(error)
+      when 10..15 then raise ErrorHandler::StatemachineError.new(error)
+      when 16..18 then raise ErrorHandler::LocationError.new(error)
+      when 19..21 then raise ErrorHandler::FormatError.new(error)
+      when 22..25 then raise ErrorHandler::CallError.new(error)
+      when 26..29 then raise ErrorHandler::OtherError.new(error)
+      when 30..35 then raise ErrorHandler::ConfigError.new(error)
+    end
+  end
+
+end

data/lib/smsruby/error.rb

@@ -0,0 +1,40 @@
+require 'sms'
+module ErrorHandler
+
+  #
+  # The Error class represent the error layer. Inherit from standard error class
+  # of ruby and allows to give a more specific description about produced errors
+  #
+  class Error < StandardError
+    include Sms
+
+    # Reference the id of the current error
+    attr_reader :id
+    # Reference a string message description of the current error
+    attr_reader :message
+
+    #
+    # Initialize all attributes for error class receiving the id error. The
+    # printError function of the shared object is used to obtain the string
+    # message of the current error
+    #
+    def initialize(id)
+      @id = id
+      @message = printError(id)
+    end
+    
+  end
+
+  #
+  # Represent the diferent classes for particular given errors. All the classes
+  # inherits from Error class defined above.
+  #
+  class GeneralError < Error; end
+  class ConfigError < Error; end
+  class StatemachineError < Error; end
+  class CallError < Error; end
+  class OtherError < Error; end
+  class FormatError < Error; end
+  class LocationError < Error; end
+
+end

data/lib/smsruby/receive.rb

@@ -0,0 +1,97 @@
+require 'smsruby/adm_connection'
+require 'rubygems'
+require 'sqlite3'
+
+#
+# The Receive class represent the receive layer. Handles the reception of messages
+# and the initialization of multiples threads to allow multiples connections to receive
+# messages simultaniously
+#
+class Receive
+
+  # Reference an instance for the Connection Administrator
+  attr_reader :adm
+  # Reference the list of messages
+  attr_reader :list
+  # Reference the type of receive that will be used (0: receive for a defined period of time, 1: receive messages ones )
+  attr_accessor :receivetype
+  # Represent the time in seconds that a particular connection will be receiving messages (for receivetype==0)
+  attr_accessor :time
+
+
+  #
+  # Obtains and instance of the Connection Administrator to control all existing
+  # connections. Due to the use of a singleton in the administrator, the same
+  # created instance will be obtain, or will be created if an instance doesn't
+  # exist. The type of receive and the period of time that will be used are passed
+  # to initialize method. An Exception is thrown if the instance of Admconnection fail
+  #
+  def initialize(type,time)
+      begin
+        @receivetype=type
+        @time =time
+        @adm = AdmConnection.instance
+      end
+  end
+
+  #
+  # Represent the receive method of the Receive class. Will create the reception threads
+  # acording with the imeis values passed as an argument. if imeis passed are nil will be 
+  # created as many threads as connections configured to receive are found
+  #
+  def receive(imeis)
+    begin
+      if @adm.avlconn
+        if imeis
+          imeis.each do |i|
+            if @adm.get_connections.inject(false){|res,act| (act[1].phone_imei==i.to_s and act[1].status=='available' and (act[1].typec=='r' or act[1].typec=='sr')) || res}
+              t=Thread.new{receive_internal(i.to_s){|x,y| yield x,y if block_given? }}
+              t[:type]='r'
+            else
+              @adm.log.warn "Can't receive message in connection with imei: #{i}." unless @adm.log.nil?
+            end
+          end
+        else
+          @adm.get_connections.select{ |n,act| (act.typec=='r' or act.typec=='sr') and act.status=='available'}.each do |i|
+            t=Thread.new{receive_internal(i[1].phone_imei){|x,y| yield x,y if block_given? }}
+            t[:type]='r'
+          end
+        end
+      else
+        raise "There are no active connections"
+      end
+    rescue Exception => e
+      @adm.log.error "Error receiving messages #{e.message}. Detail: #{e.message}" unless @adm.log.nil?
+      raise e
+    end
+  end
+
+  #
+  # Represent the method associated to the receive threads. Will handle the BD writting
+  # of the received messages and will make the call of recieve method in the Connection
+  # Administrator
+  #
+  def receive_internal(imei)
+    begin
+      db = SQLite3::Database.new('prueba.s3db')
+      @adm.receive(to_hash(imei)){ |x,y|
+        yield x,y if block_given?
+        db.execute("INSERT INTO inbox (smsdate,phone_number,text) VALUES " + "('#{x.date}', '#{x.source_number}','#{x.text}');")
+      }
+    rescue Exception => e
+      puts e.message
+    end
+  end
+
+  #
+  # Combine all option values into a hash to relate them
+  #
+  def to_hash(imei)
+      { :type => 'receive',
+        :imei => imei.gsub(/[\s\D]/, ""),
+        :receivetype => self.receivetype,
+        :time => self.time
+        }
+  end
+
+end

data/lib/smsruby/receive.rb~

@@ -0,0 +1,97 @@
+require 'adm_connection'
+require 'rubygems'
+require 'sqlite3'
+
+#
+# The Receive class represent the receive layer. Handles the reception of messages
+# and the initialization of multiples threads to allow multiples connections to receive
+# messages simultaniously
+#
+class Receive
+
+  # Reference an instance for the Connection Administrator
+  attr_reader :adm
+  # Reference the list of messages
+  attr_reader :list
+  # Reference the type of receive that will be used (0: receive for a defined period of time, 1: receive messages ones )
+  attr_accessor :receivetype
+  # Represent the time in seconds that a particular connection will be receiving messages (for receivetype==0)
+  attr_accessor :time
+
+
+  #
+  # Obtains and instance of the Connection Administrator to control all existing
+  # connections. Due to the use of a singleton in the administrator, the same
+  # created instance will be obtain, or will be created if an instance doesn't
+  # exist. The type of receive and the period of time that will be used are passed
+  # to initialize method. An Exception is thrown if the instance of Admconnection fail
+  #
+  def initialize(type,time)
+      begin
+        @receivetype=type
+        @time =time
+        @adm = AdmConnection.instance
+      end
+  end
+
+  #
+  # Represent the receive method of the Receive class. Will create the reception threads
+  # acording with the imeis values passed as an argument. if imeis passed are nil will be 
+  # created as many threads as connections configured to receive are found
+  #
+  def receive(imeis)
+    begin
+      if @adm.avlconn
+        if imeis
+          imeis.each do |i|
+            if @adm.get_connections.inject(false){|res,act| (act[1].phone_imei==i.to_s and act[1].status=='available' and (act[1].typec=='r' or act[1].typec=='sr')) || res}
+              t=Thread.new{receive_internal(i.to_s){|x,y| yield x,y if block_given? }}
+              t[:type]='r'
+            else
+              @adm.log.warn "Can't receive message in connection with imei: #{i}." unless @adm.log.nil?
+            end
+          end
+        else
+          @adm.get_connections.select{ |n,act| (act.typec=='r' or act.typec=='sr') and act.status=='available'}.each do |i|
+            t=Thread.new{receive_internal(i[1].phone_imei){|x,y| yield x,y if block_given? }}
+            t[:type]='r'
+          end
+        end
+      else
+        raise "There are no active connections"
+      end
+    rescue Exception => e
+      @adm.log.error "Error receiving messages #{e.message}. Detail: #{e.message}" unless @adm.log.nil?
+      raise e
+    end
+  end
+
+  #
+  # Represent the method associated to the receive threads. Will handle the BD writting
+  # of the received messages and will make the call of recieve method in the Connection
+  # Administrator
+  #
+  def receive_internal(imei)
+    begin
+      db = SQLite3::Database.new('prueba.s3db')
+      @adm.receive(to_hash(imei)){ |x,y|
+        yield x,y if block_given?
+        db.execute("INSERT INTO inbox (smsdate,phone_number,text) VALUES " + "('#{x.date}', '#{x.source_number}','#{x.text}');")
+      }
+    rescue Exception => e
+      puts e.message
+    end
+  end
+
+  #
+  # Combine all option values into a hash to relate them
+  #
+  def to_hash(imei)
+      { :type => 'receive',
+        :imei => imei.gsub(/[\s\D]/, ""),
+        :receivetype => self.receivetype,
+        :time => self.time
+        }
+  end
+
+end