qpid_proton 0.9.0 → 0.10

data/lib/reactor/session_per_connection.rb

@@ -0,0 +1,45 @@
+#--
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#++
+
+module Qpid::Proton::Reactor
+
+  class SessionPerConnection
+
+    include Qpid::Proton::Util::Reactor
+
+    def initialize
+      @default_session = nil
+    end
+
+    def session(connection)
+      if @default_session.nil?
+        @default_session = self.create_session
+        @default_session.context = self
+      end
+      return @default_session
+    end
+
+    def on_session_remote_close(event)
+      event.connection.close
+      @default_session = nil
+    end
+
+  end
+
+end

data/lib/reactor/ssl_config.rb

@@ -0,0 +1,41 @@
+#--
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#++
+
+module Qpid::Proton::Reactor
+
+  class SSLConfig
+
+    def initialize
+      @client = Qpid::Proton::SSLDomain.new(Qpid::Proton::SSLDomain::MODE_CLIENT)
+      @server = Qpid::Proton::SSLDomain.new(Qpid::Proton::SSLDomain::MODE_SERVER)
+    end
+
+    def set_credentials(cert_file, key_file, password)
+      @client.set_credentials(cert_file, key_file, password)
+      @server.set_credentials(cert_file, key_file, password)
+    end
+
+    def set_trusted_ca_db(certificate_db)
+      @client.set_trusted_ca_db(certificate_db)
+      @server.set_trusted_ca_db(certificate_db)
+    end
+
+  end
+
+end

data/lib/reactor/task.rb

@@ -0,0 +1,39 @@
+#--
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#++
+
+module Qpid::Proton::Reactor
+
+  class Task
+
+    # @private
+    include Qpid::Proton::Util::Wrapper
+
+    def self.wrap(impl)
+      return nil if impl.nil?
+      self.fetch_instance(impl, :pn_task_attachments) || Task.new(impl)
+    end
+
+    def initialize(impl)
+      @impl = impl
+      self.class.store_instance(self, :pn_task_attachments)
+    end
+
+  end
+
+end

data/lib/{qpid_proton/subscription.rb → reactor/urls.rb}

@@ -17,23 +17,22 @@
 # under the License.
 #++
 
-module Qpid # :nodoc:
+module Qpid::Proton::Reactor
 
-  module Proton # :nodoc:
+  class URLs
 
-    # A +Subscription+ is an opaque object for working with a +Messenger+'s
-    # subscriptions.
-    #
-    class Subscription
-
-      def initialize(impl) # :nodoc:
-          @impl = impl
-      end
+    def initialize(values)
+      @values = [values].flatten
+      @iter = @values.each
+    end
 
-      def impl # :nodoc:
-          @impl
+    def next
+      begin
+        return @iter.next
+      rescue StopIteration
+        @iter = @values.each
+        return @iter.next
       end
-
     end
 
   end

data/lib/{qpid_proton → types}/array.rb

@@ -22,43 +22,42 @@
 # to a Qpid::Proton::Data instance.
 #++
 
-module Qpid # :nodoc:
-
-  module Proton # :nodoc:
-
-    # Holds the information for an AMQP Array compound type.
-    #
-    # It holds the type for the array and the descriptor if the
-    # array is described.
-    #
-    class ArrayHeader
-      attr_reader :type
-      attr_reader :descriptor
-
-      def initialize(type, descriptor = nil)
-        @type = type
-        @descriptor = descriptor
-      end
+module Qpid::Proton::Types
 
-      # Returns true if the array is described.
-      def described?
-        !@descriptor.nil?
-      end
+  # Holds the information for an AMQP Array compound type.
+  #
+  # It holds the type for the array and the descriptor if the
+  # array is described.
+  #
+  # @private
+  #
+  class ArrayHeader
+    attr_reader :type
+    attr_reader :descriptor
 
-      def ==(that)
-        ((@type == that.type) && (@descriptor == that.descriptor))
-      end
+    def initialize(type, descriptor = nil)
+      @type = type
+      @descriptor = descriptor
+    end
+
+    # Returns true if the array is described.
+    def described?
+      !@descriptor.nil?
     end
 
+    def ==(that)
+      ((@type == that.type) && (@descriptor == that.descriptor))
+    end
   end
 
 end
 
+# @private
 class Array # :nodoc:
 
   # Used to declare an array as an AMQP array.
   #
-  # The value, if defined, is an instance of Qpid::Proton::ArrayHeader
+  # The value, if defined, is an instance of Qpid::Proton::Types::ArrayHeader
   attr_accessor :proton_array_header
 
   # Returns true if the array is the a Proton described type.
@@ -85,7 +84,7 @@ class Array # :nodoc:
     data.enter
     each do |element|
       # get the proton type for the element
-      mapping = Qpid::Proton::Mapping.for_class(element.class)
+      mapping = Qpid::Proton::Codec::Mapping.for_class(element.class)
       # add the element
       mapping.put(data, element)
     end
@@ -116,9 +115,9 @@ class Array # :nodoc:
 
       type = data.type
 
-      if type == Qpid::Proton::LIST
+      if type == Qpid::Proton::Codec::LIST
         result = proton_get_list(data)
-      elsif type == Qpid::Proton::ARRAY
+      elsif type == Qpid::Proton::Codec::ARRAY
         result = proton_get_array(data)
       else
         raise TypeError, "element is not a list and not an array"
@@ -154,7 +153,7 @@ class Array # :nodoc:
         descriptor = data.symbol
       end
 
-      elements.proton_array_header = Qpid::Proton::ArrayHeader.new(type, descriptor)
+      elements.proton_array_header = Qpid::Proton::Types::ArrayHeader.new(type, descriptor)
       (0...count).each do |which|
         if data.next
           etype = data.type

data/lib/types/described.rb

@@ -0,0 +1,63 @@
+#--
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#++
+
+module Qpid::Proton::Types
+
+  # @private
+  class Described
+
+    attr_reader :descriptor
+    attr_reader :value
+
+    def initialize(descriptor, value)
+      @descriptor = descriptor
+      @value = value
+    end
+
+    # Puts the description into the Data object.
+    #
+    # ==== Arguments
+    #
+    # * data - the Qpid::Proton::Data instance
+    #
+    # ==== Examples
+    #
+    #   described = Qpid::Proton::Described.new("my-descriptor", "the value")
+    #   data = Qpid::Proton::Data.new
+    #   ...
+    #   described.put(data)
+    #
+    def put(data)
+      data.symbol = @descriptor
+      data.string = @value
+    end
+
+    def ==(that) # :nodoc:
+      (that.is_a?(Qpid::Proton::Types::Described) &&
+       (self.descriptor == that.descriptor) &&
+       (self.value == that.value))
+    end
+
+    def to_s # :nodoc:
+      "descriptor=#{descriptor} value=#{value}"
+    end
+
+  end
+
+end

data/lib/{qpid_proton → types}/hash.rb

@@ -22,6 +22,7 @@
 # to a Qpid::Proton::Data instance.
 #++
 
+# @private
 class Hash # :nodoc:
 
   # Places the contents of the hash into the specified data object.
@@ -43,9 +44,9 @@ class Hash # :nodoc:
     data.enter
 
     each_pair do |key, value|
-      type = Qpid::Proton::Mapping.for_class(key.class)
+      type = Qpid::Proton::Codec::Mapping.for_class(key.class)
       type.put(data, key)
-      type = Qpid::Proton::Mapping.for_class(value.class)
+      type = Qpid::Proton::Codec::Mapping.for_class(value.class)
       type.put(data, value)
     end
 
@@ -59,7 +60,7 @@ class Hash # :nodoc:
 
       type = data.type
 
-      raise TypeError, "element is not a map" unless type == Qpid::Proton::MAP
+      raise TypeError, "element is not a map" unless type == Qpid::Proton::Codec::MAP
 
       count = data.map
       result = {}

data/lib/types/strings.rb

@@ -0,0 +1,62 @@
+#--
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#++
+
+module Qpid::Proton::Types
+
+  # @private
+  def self.is_valid_utf?(value)
+    # In Ruby 1.9+ we have encoding methods that can check the content of
+    # the string, so use them to see if what we have is unicode. If so,
+    # good! If not, then just treat is as binary.
+    #
+    # No such thing in Ruby 1.8. So there we need to use Iconv to try and
+    # convert it to unicode. If it works, good! But if it raises an
+    # exception then we'll treat it as binary.
+    if RUBY_VERSION < "1.9"
+      return true if value.isutf8
+      return false
+    else
+      return true if (value.encoding == "UTF-8" ||
+                      value.encode("UTF-8").valid_encoding?)
+
+      return false
+    end
+  end
+
+  # UTFString lets an application explicitly state that a
+  # string of characters is to be UTF-8 encoded.
+  #
+  class UTFString < ::String
+
+    def initialize(value)
+      if !Qpid::Proton::Types.is_valid_utf?(value)
+        raise RuntimeError.new("invalid UTF string")
+      end
+
+      super(value)
+    end
+
+  end
+
+  # BinaryString lets an application explicitly declare that
+  # a string value represents arbitrary data.
+  #
+  class BinaryString < ::String; end
+
+end

data/lib/util/class_wrapper.rb

@@ -0,0 +1,54 @@
+#--
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#++
+
+module Qpid::Proton::Util
+
+  # This mixin provides a method for mapping from an underlying Proton
+  # C library class to a Ruby class.
+  #
+  # @private
+  #
+  module ClassWrapper
+
+    WRAPPERS =
+      {
+        "pn_void" => proc {|x| Cproton.pn_void2rb(x)},
+        "pn_rbref" => proc {|x| Cproton.pn_void2rb(x)},
+        "pn_connection" => proc {|x| Qpid::Proton::Connection.wrap(Cproton.pn_cast_pn_connection(x))},
+        "pn_session" => proc {|x| Qpid::Proton::Session.wrap(Cproton.pn_cast_pn_session(x))},
+        "pn_link" => proc {|x| Qpid::Proton::Link.wrap(Cproton.pn_cast_pn_link(x))},
+        "pn_delivery" => proc {|x| Qpid::Proton::Delivery.wrap(Cproton.pn_cast_pn_delivery(x))},
+        "pn_transport" => proc {|x| Qpid::Proton::Transport.wrap(Cproton.pn_cast_pn_transport(x))},
+        "pn_selectable" => proc {|x| Qpid::Proton::Selectable.wrap(Cproton.pn_cast_pn_selectable(x))},
+        "pn_reactor" => proc {|x| Qpid::Proton::Reactor::Reactor.wrap(Cproton.pn_cast_pn_reactor(x))},
+        "pn_task" => proc {|x| Qpid::Proton::Reactor::Task.wrap(Cproton.pn_cast_pn_task(x))},
+      }
+
+    def class_wrapper(clazz, c_impl, &block)
+      proc_func = WRAPPERS[clazz]
+      if !proc_func.nil?
+        proc_func.yield(c_impl)
+      elsif block_given?
+        yield(c_impl)
+      end
+    end
+
+  end
+
+end