ruby-activeldap 0.8.3 → 0.8.3.1

data/lib/active_ldap/adapter/net_ldap_ext.rb

@@ -0,0 +1,29 @@
+require_library_or_gem 'net/ldap'
+
+module Net
+  class LDAP
+    class Entry
+      alias initialize_without_original_attribute_names initialize
+      def initialize(*args)
+        @original_attribute_names = []
+        initialize_without_original_attribute_names(*args)
+      end
+
+      alias aset_without_original_attribute_names []=
+      def []=(name, value)
+        @original_attribute_names << name
+        aset_without_original_attribute_names(name, value)
+      end
+
+      def original_attribute_names
+        @original_attribute_names.compact.uniq
+      end
+
+      def each_attribute
+        attribute_names.sort_by {|name| name.to_s}.each do |name|
+          yield name, self[name]
+        end
+      end
+    end
+  end
+end

data/lib/active_ldap/association/belongs_to.rb

@@ -0,0 +1,47 @@
+require 'active_ldap/association/proxy'
+
+module ActiveLdap
+  module Association
+    class BelongsTo < Proxy
+      def replace(entry)
+        if entry.nil?
+          @target = @owner[@options[:foreign_key_name]] = nil
+        else
+          @target = (Proxy === entry ? entry.target : entry)
+          infect_connection(@target)
+          unless entry.new_entry?
+            @owner[@options[:foreign_key_name]] = entry[primary_key]
+          end
+          @updated = true
+        end
+
+        loaded
+        entry
+      end
+
+      def updated?
+        @updated
+      end
+
+      private
+      def have_foreign_key?
+        not @owner[@options[:foreign_key_name]].nil?
+      end
+
+      def find_target
+        value = @owner[@options[:foreign_key_name]]
+        raise EntryNotFound if value.nil?
+        key = primary_key
+        if key == "dn"
+          result = foreign_class.find(value, find_options)
+        else
+          filter = {key => value}
+          options = find_options(:filter => filter, :limit => 1)
+          result = foreign_class.find(:all, options).first
+        end
+        raise EntryNotFound if result.nil?
+        result
+      end
+    end
+  end
+end

data/lib/active_ldap/association/belongs_to_many.rb

@@ -0,0 +1,42 @@
+require 'active_ldap/association/collection'
+
+module ActiveLdap
+  module Association
+    class BelongsToMany < Collection
+      private
+      def insert_entry(entry)
+        old_value = entry[@options[:many], true]
+        new_value = old_value + @owner[@options[:foreign_key_name], true]
+        new_value = new_value.uniq.sort
+        if old_value != new_value
+          entry[@options[:many]] = new_value
+          entry.save
+        end
+      end
+
+      def delete_entries(entries)
+        entries.each do |entry|
+          old_value = entry[@options[:many], true]
+          new_value = old_value - @owner[@options[:foreign_key_name], true]
+          new_value = new_value.uniq.sort
+          if old_value != new_value
+            entry[@options[:many]] = new_value
+            entry.save
+          end
+        end
+      end
+
+      def find_target
+        values = @owner[@options[:foreign_key_name], true].compact
+        return [] if values.empty?
+
+        key = @options[:many]
+        components = values.collect do |value|
+          [key, value]
+        end
+        options = find_options(:filter => [:or, *components])
+        foreign_class.find(:all, options)
+      end
+    end
+  end
+end

data/lib/active_ldap/association/collection.rb

@@ -0,0 +1,83 @@
+require 'active_ldap/association/proxy'
+
+module ActiveLdap
+  module Association
+    class Collection < Proxy
+      include Enumerable
+
+      def to_ary
+        load_target
+        @target.to_ary
+      end
+
+      def reset
+        @target = []
+        @loaded = false
+      end
+
+      def <<(*entries)
+        add_entries(*entries)
+      end
+      alias_method(:push, :<<)
+      alias_method(:concat, :<<)
+
+      def each(&block)
+        to_ary.each(&block)
+      end
+
+      def delete(*entries)
+        entries = flatten_deeper(entries).reject do |entry|
+          @target.delete(entry) if entry.new_entry?
+          entry.new_entry?
+        end
+        return if entries.empty?
+
+        delete_entries(entries)
+        entries.each do |entry|
+          @target.delete(entry)
+        end
+      end
+
+      def replace(others)
+        load_target
+        deleted_entries = @target - others
+        added_entries = others - @target
+
+        delete(deleted_entries)
+        concat(added_entries)
+      end
+
+      def exists?
+        load_target
+        not @target.empty?
+      end
+
+      private
+      def flatten_deeper(array)
+        array.collect do |element|
+          element.respond_to?(:flatten) ? element.flatten : element
+        end.flatten
+      end
+
+      def insert_entry(entry)
+        entry[@options[:foreign_key_name]] = @owner[@options[:local_key_name]]
+        entry.save
+      end
+
+      def add_entries(*entries)
+        result = true
+        load_target
+
+        flatten_deeper(entries).each do |entry|
+          unless @owner.new_entry?
+            infect_connection(entry)
+            result &&= insert_entry(entry)
+          end
+          @target << entry
+        end
+
+        result && self
+      end
+    end
+  end
+end

data/lib/active_ldap/association/has_many.rb

@@ -0,0 +1,31 @@
+require 'active_ldap/association/collection'
+require 'active_ldap/association/has_many_utils'
+
+module ActiveLdap
+  module Association
+    class HasMany < Collection
+      include HasManyUtils
+
+      private
+      def insert_entry(entry)
+        entry[primary_key] = @owner[@options[:foreign_key_name]]
+        entry.save
+      end
+
+      def find_target
+        collect_targets(:foreign_key_name)
+      end
+
+      def delete_entries(entries)
+        key = primary_key
+        components = @owner[@options[:foreign_key_name], true].reject do |value|
+          value.nil?
+        end
+        filter = [:and,
+                  [:and, {key => components}],
+                  [:or, {foreign_class.dn_attribute => entries.collect(&:id)}]]
+        foreign_class.update_all({key => []}, filter)
+      end
+    end
+  end
+end

data/lib/active_ldap/association/has_many_utils.rb

@@ -0,0 +1,35 @@
+module ActiveLdap
+  module Association
+    module HasManyUtils
+      private
+      def collect_targets(requested_target_key, need_requested_targets=false)
+        foreign_base_key = primary_key
+        return [] if foreign_base_key.nil?
+
+        requested_targets = @owner[@options[requested_target_key], true]
+
+        components = requested_targets.reject(&:nil?)
+        unless foreign_base_key == "dn"
+          components = components.collect do |value|
+            [foreign_base_key, value]
+          end
+        end
+
+        if components.empty?
+          targets = []
+        elsif foreign_base_key == "dn"
+          targets = foreign_class.find(components, find_options)
+        else
+          options = find_options(:filter => [:or, *components])
+          targets = foreign_class.find(:all, options)
+        end
+
+        if need_requested_targets
+          [targets, requested_targets]
+        else
+          targets
+        end
+      end
+    end
+  end
+end

data/lib/active_ldap/association/has_many_wrap.rb

@@ -0,0 +1,46 @@
+require 'active_ldap/association/collection'
+require 'active_ldap/association/has_many_utils'
+
+module ActiveLdap
+  module Association
+    class HasManyWrap < Collection
+      include HasManyUtils
+
+      private
+      def insert_entry(entry)
+        old_value = @owner[@options[:wrap], true]
+        new_value = (old_value + entry[primary_key, true]).uniq.sort
+        if old_value != new_value
+          @owner[@options[:wrap]] = new_value
+          @owner.save
+        end
+      end
+
+      def delete_entries(entries)
+        old_value = @owner[@options[:wrap], true]
+        new_value = old_value - entries.collect {|entry| entry[primary_key]}
+        new_value = new_value.uniq.sort
+        if old_value != new_value
+          @owner[@options[:wrap]] = new_value
+          @owner.save
+        end
+      end
+
+      def find_target
+        targets, requested_targets = collect_targets(:wrap, true)
+        return [] if targets.nil?
+
+        found_targets = {}
+        foreign_base_key = primary_key
+        targets.each do |target|
+          found_targets[target.send(foreign_base_key)] ||= target
+        end
+
+        klass = foreign_class
+        requested_targets.collect do |name|
+          found_targets[name] || klass.new(name)
+        end
+      end
+    end
+  end
+end

data/lib/active_ldap/association/proxy.rb

@@ -0,0 +1,102 @@
+module ActiveLdap
+  module Association
+    class Proxy
+      alias_method :proxy_respond_to?, :respond_to?
+      alias_method :proxy_extend, :extend
+
+      def initialize(owner, options)
+        @owner = owner
+        @options = options
+        extend(options[:extend]) if options[:extend]
+        reset
+      end
+
+      def respond_to?(symbol, include_priv=false)
+        proxy_respond_to?(symbol, include_priv) or
+          (load_target && @target.respond_to?(symbol, include_priv))
+      end
+
+      def ===(other)
+        load_target and other === @target
+      end
+
+      def reset
+        @target = nil
+        @loaded = false
+      end
+
+      def reload
+        reset
+        load_target
+      end
+
+      def loaded?
+        @loaded
+      end
+
+      def loaded
+        @loaded = true
+      end
+
+      def target
+        @target
+      end
+
+      def target=(target)
+        @target = target
+        loaded
+      end
+
+      def exists?
+        load_target
+        not @target.nil?
+      end
+
+      private
+      def method_missing(method, *args, &block)
+        load_target
+        @target.send(method, *args, &block)
+      end
+
+      def foreign_class
+        klass = @owner.class.associated_class(@options[:association_id])
+        klass = @owner.class.module_eval(klass) if klass.is_a?(String)
+        klass
+      end
+
+      def have_foreign_key?
+        false
+      end
+
+      def primary_key
+        @options[:primary_key_name] || foreign_class.dn_attribute
+      end
+
+      def load_target
+        if !@owner.new_entry? or have_foreign_key?
+          begin
+            @target = find_target unless loaded?
+          rescue EntryNotFound
+            reset
+          end
+        end
+
+        loaded if target
+        target
+      end
+
+      def find_options(options={})
+        if @owner.connection != @owner.class.connection
+          {:connection => @owner.connection}.merge(options)
+        else
+          options
+        end
+      end
+
+      def infect_connection(target)
+        conn = @owner.instance_variable_get("@connection")
+        target.connection = conn if conn
+      end
+    end
+  end
+end

data/lib/active_ldap/associations.rb

@@ -0,0 +1,172 @@
+require 'active_ldap/association/belongs_to'
+require 'active_ldap/association/belongs_to_many'
+require 'active_ldap/association/has_many'
+require 'active_ldap/association/has_many_wrap'
+
+module ActiveLdap
+  # Associations
+  #
+  # Associations provides the class methods needed for
+  # the extension classes to create methods using
+  # belongs_to and has_many
+  module Associations
+    def self.append_features(base)
+      super
+      base.extend(ClassMethods)
+      base.class_inheritable_array(:associations)
+      base.associations = []
+    end
+
+    module ClassMethods
+      def set_associated_class(name, klass)
+        @associated_classes ||= {}
+        @associated_classes[name.to_s] = klass
+      end
+
+      def associated_class(name)
+        @associated_classes[name.to_s]
+      end
+
+      # belongs_to
+      #
+      # This defines a method for an extension class map its DN key
+      # attribute value on to multiple items which reference it by
+      # |:foreign_key| in the other LDAP entry covered by class |:class_name|.
+      #
+      # Example:
+      #  belongs_to :groups, :class_name => "Group",
+      #             :many => "memberUid" # Group#memberUid
+      #             # :foreign_key => "uid" # User#uid
+      #             # dn attribute value is used by default
+      #  belongs_to :primary_group, :class_name => "Group",
+      #             :foreign_key => "gidNumber", # User#gidNumber
+      #             :primary_key => "gidNumber"  # Group#gidNumber
+      #
+      def belongs_to(association_id, options={})
+        validate_belongs_to_options(options)
+        klass = options[:class] || Inflector.classify(association_id)
+        foreign_key = options[:foreign_key]
+        primary_key = options[:primary_key]
+        many = options[:many]
+        set_associated_class(association_id, klass)
+
+        opts = {
+          :association_id => association_id,
+          :foreign_key_name => foreign_key,
+          :primary_key_name => primary_key,
+          :many => many,
+          :extend => options[:extend],
+        }
+        if opts[:many]
+          association_class = Association::BelongsToMany
+          opts[:foreign_key_name] ||= dn_attribute
+        else
+          association_class = Association::BelongsTo
+          opts[:foreign_key_name] ||= "#{association_id}_id"
+
+          before_save(<<-EOC)
+            if defined?(@#{association_id})
+              association = @#{association_id}
+              if association and association.updated?
+                self[association.__send__(:primary_key)] =
+                  association[#{opts[:foreign_key_name].dump}]
+              end
+            end
+          EOC
+        end
+
+        association_accessor(association_id) do |target|
+          association_class.new(target, opts)
+        end
+      end
+
+
+      # has_many
+      #
+      # This defines a method for an extension class expand an 
+      # existing multi-element attribute into ActiveLdap objects.
+      # This discards any calls which result in entries that
+      # don't exist in LDAP!
+      #
+      # Example:
+      #   has_many :primary_members, :class_name => "User",
+      #            :primary_key => "gidNumber", # User#gidNumber
+      #            :foreign_key => "gidNumber"  # Group#gidNumber
+      #   has_many :members, :class_name => "User",
+      #            :wrap => "memberUid" # Group#memberUid
+      def has_many(association_id, options = {})
+        validate_has_many_options(options)
+        klass = options[:class] || Inflector.classify(association_id)
+        foreign_key = options[:foreign_key] || association_id.to_s + "_id"
+        primary_key = options[:primary_key]
+        set_associated_class(association_id, klass)
+
+        opts = {
+          :association_id => association_id,
+          :foreign_key_name => foreign_key,
+          :primary_key_name => primary_key,
+          :wrap => options[:wrap],
+          :extend => options[:extend],
+        }
+        if opts[:wrap]
+          association_class = Association::HasManyWrap
+        else
+          association_class = Association::HasMany
+        end
+
+        association_accessor(association_id) do |target|
+          association_class.new(target, opts)
+        end
+      end
+
+      private
+      def association_accessor(name, &make_association)
+        define_method("__make_#{name}") do
+          make_association.call(self)
+        end
+        associations << name
+        association_reader(name, &make_association)
+        association_writer(name, &make_association)
+      end
+
+      def association_reader(name, &make_association)
+        class_eval(<<-EOM, __FILE__, __LINE__ + 1)
+          def #{name}
+            @#{name} ||= __make_#{name}
+          end
+        EOM
+      end
+
+      def association_writer(name, &make_association)
+        class_eval(<<-EOM, __FILE__, __LINE__ + 1)
+          def #{name}=(new_value)
+            association = defined?(@#{name}) ? @#{name} : nil
+            association ||= __make_#{name}
+            association.replace(new_value)
+            @#{name} = new_value.nil? ? nil : association
+            @#{name}
+          end
+        EOM
+      end
+
+      VALID_BELONGS_TO_OPTIONS = [:class, :foreign_key, :primary_key, :many,
+                                  :extend]
+      def validate_belongs_to_options(options)
+        options.assert_valid_keys(VALID_BELONGS_TO_OPTIONS)
+      end
+
+      VALID_HAS_MANY_OPTIONS = [:class, :foreign_key, :primary_key, :wrap,
+                                :extend]
+      def validate_has_many_options(options)
+        options.assert_valid_keys(VALID_HAS_MANY_OPTIONS)
+      end
+    end
+
+    def clear_association_cache
+      return if new_record?
+      (self.class.associations || []).each do |association|
+        instance_variable_set("@#{association}", nil)
+      end
+    end
+  end
+end