module ActiveScaffold::Finder
Constants
- NullComparators
- NumericComparators
- StringComparators
Attributes
Public Class Methods
# File lib/active_scaffold/finder.rb, line 206 def self.included(klass) klass.extend ClassMethods end
# File lib/active_scaffold/finder.rb, line 3 def self.like_operator @@like_operator ||= ::ActiveRecord::Base.connection.adapter_name == "PostgreSQL" ? "ILIKE" : "LIKE" end
Protected Instance Methods
# File lib/active_scaffold/finder.rb, line 213 def active_scaffold_conditions @active_scaffold_conditions ||= [] end
# File lib/active_scaffold/finder.rb, line 223 def active_scaffold_habtm_joins @active_scaffold_habtm_joins ||= [] end
# File lib/active_scaffold/finder.rb, line 218 def active_scaffold_includes @active_scaffold_includes ||= [] end
# File lib/active_scaffold/finder.rb, line 227 def all_conditions merge_conditions( active_scaffold_conditions, # from the search modules conditions_for_collection, # from the dev conditions_from_params, # from the parameters (e.g. /users/list?first_name=Fred) conditions_from_constraints, # from any constraints (embedded scaffolds) active_scaffold_session_storage[:conditions] # embedding conditions (weaker constraints) ) end
# File lib/active_scaffold/finder.rb, line 296 def append_to_query(query, options) options.assert_valid_keys :where, :select, :group, :order, :limit, :offset, :joins, :includes, :lock, :readonly, :from options.reject{|k, v| v.blank?}.inject(query) do |query, (k, v)| # default ordering of model has a higher priority than current queries ordering # fix this by removing existing ordering from arel if k.to_sym == :order query = query.where('1=1') unless query.is_a?(ActiveRecord::Relation) query = query.except(:order) end query.send((k.to_sym), v) end end
returns a single record (the given id) but only if it’s allowed for the specified action. accomplishes this by checking model.#{action}_authorized? TODO: this should reside on the model, not the controller
# File lib/active_scaffold/finder.rb, line 240 def find_if_allowed(id, crud_type, klass = beginning_of_chain) record = klass.find(id) raise ActiveScaffold::RecordNotAllowed, "#{klass} with id = #{id}" unless record.authorized_for?(:crud_type => crud_type.to_sym) return record end
returns a Paginator::Page
(not from ActiveRecord::Paginator
) for the given parameters options may include:
-
:sorting - a Sorting DataStructure (basically an array of hashes of field => direction, e.g. [{:field1 => ‘asc’}, {:field2 => ‘desc’}]). please note that multi-column sorting has some limitations: if any column in a multi-field sort uses method-based sorting, it will be ignored. method sorting only works for single-column sorting.
-
:per_page
-
:page
TODO: this should reside on the model, not the controller
# File lib/active_scaffold/finder.rb, line 252 def find_page(options = {}) options.assert_valid_keys :sorting, :per_page, :page, :count_includes, :pagination search_conditions = all_conditions full_includes = (active_scaffold_includes.blank? ? nil : active_scaffold_includes) options[:per_page] ||= 999999999 options[:page] ||= 1 options[:count_includes] ||= full_includes unless search_conditions.nil? klass = beginning_of_chain # create a general-use options array that's compatible with Rails finders finder_options = { :order => options[:sorting].try(:clause), :where => search_conditions, :joins => joins_for_finder, :includes => options[:count_includes]} finder_options.merge! custom_finder_options # NOTE: we must use :include in the count query, because some conditions may reference other tables count_query = append_to_query(klass, finder_options.reject{|k, v| [:select, :order].include?(k)}) count = count_query.count unless options[:pagination] == :infinite # Converts count to an integer if ActiveRecord returned an OrderedHash # that happens when finder_options contains a :group key count = count.length if count.is_a? ActiveSupport::OrderedHash finder_options.merge! :includes => full_includes # we build the paginator differently for method- and sql-based sorting if options[:sorting] and options[:sorting].sorts_by_method? pager = ::Paginator.new(count, options[:per_page]) do |offset, per_page| sorted_collection = sort_collection_by_column(append_to_query(klass, finder_options).all, *options[:sorting].first) sorted_collection = sorted_collection.slice(offset, per_page) if options[:pagination] sorted_collection end else pager = ::Paginator.new(count, options[:per_page]) do |offset, per_page| finder_options.merge!(:offset => offset, :limit => per_page) if options[:pagination] append_to_query(klass, finder_options).all end end pager.page(options[:page]) end
# File lib/active_scaffold/finder.rb, line 309 def joins_for_finder case joins_for_collection when String [ joins_for_collection ] when Array joins_for_collection else [] end + active_scaffold_habtm_joins end
# File lib/active_scaffold/finder.rb, line 320 def merge_conditions(*conditions) segments = [] conditions.each do |condition| unless condition.blank? sql = active_scaffold_config.model.send(:sanitize_sql, condition) segments << sql unless sql.blank? end end "(#{segments.join(') AND (')})" unless segments.empty? end
TODO: this should reside on the column, not the controller
# File lib/active_scaffold/finder.rb, line 332 def sort_collection_by_column(collection, column, order) sorter = column.sort[:method] collection = collection.sort_by { |record| value = (sorter.is_a? Proc) ? record.instance_eval(&sorter) : record.instance_eval(sorter) value = '' if value.nil? value } collection.reverse! if order.downcase == 'desc' collection end