SearchObject
1.0.0
用於建立搜尋對象的 DSL。
搜尋物件從初始集合（範圍）開始，並允許根據各種選項對其進行過濾。
用途：
將此行新增至應用程式的 Gemfile 中：
gem 'search_object'然後執行：
$ bundle
或自己安裝：
$ gem install search_object
變更可在 CHANGELOG.md 中找到
只需包含SearchObject.module並定義您的搜尋選項：
class PostSearch
include SearchObject . module
scope { Post . all }
option ( :name ) { | scope , value | scope . where name : value }
option ( :created_at ) { | scope , dates | scope . created_after dates }
option ( :published , false ) { | scope , value | value ? scope . unopened : scope . opened }
end然後你可以只搜尋給定的範圍：
search = PostSearch . new ( filters : params [ :filters ] )
# accessing search options
search . name # => name option
search . created_at # => created at option
# accessing results
search . count # => number of found results
search . results? # => is there any results found
search . results # => found results
# params for url generations
search . params # => option values
search . params opened : false # => overwrites the 'opened' option您可以在這裡找到最重要的功能和插件的範例。
SearchObject支援插件，這些插件被傳遞給SearchObject.module方法。
插件只是普通的 Ruby 模組，包含在SearchObject.module中。它們位於SearchObject::Plugin模組下。
非常簡單的分頁插件，它使用簡單的.limit和.offset方法。
class ProductSearch
include SearchObject . module ( :paging )
scope { Product . all }
option :name
option :category_name
# per page defaults to 10
per_page 10
# range of values is also possible
min_per_page 5
max_per_page 100
end
search = ProductSearch . new ( filters : params [ :filters ] , page : params [ :page ] , per_page : params [ :per_page ] )
search . page # => page number
search . per_page # => per page (10)
search . results # => paginated page results當然，如果您想要更複雜的分頁插件，您可以使用：
include SearchObject . module ( :will_paginate )
include SearchObject . module ( :kaminari )為您提供一個具有預先定義選項的過濾器。
class ProductSearch
include SearchObject . module ( :enum )
scope { Product . all }
option :order , enum : %w( popular date )
private
# Gets called when order with 'popular' is given
def apply_order_with_popular ( scope )
scope . by_popularity
end
# Gets called when order with 'date' is given
def apply_order_with_date ( scope )
scope . by_date
end
# (optional) Gets called when invalid enum is given
def handle_invalid_order ( scope , invalid_value )
scope
end
end使用ActiveModel擴充您的搜尋對象，以便您可以在 Rails 表單中使用它。
class ProductSearch
include SearchObject . module ( :model )
scope { Product . all }
option :name
option :category_name
end <%# in some view: %>
<%= form_for ProductSearch.new do |form| %>
<% form.label :name %>
<% form.text_field :name %>
<% form.label :category_name %>
<% form.text_field :category_name %>
<% end %> 它作為單獨的 gem 安裝，旨在與 GraphQL 一起使用：
gem 'search_object_graphql'
class PostResolver
include SearchObject . module ( :graphql )
type PostType
scope { Post . all }
option ( :name , type : types . String ) { | scope , value | scope . where name : value }
option ( :published , type : types . Boolean ) { | scope , value | value ? scope . published : scope . unpublished }
end解決處理排序屬性和方向的痛苦。
class ProductSearch
include SearchObject . module ( :sorting )
scope { Product . all }
sort_by :name , :price
end
search = ProductSearch . new ( filters : { sort : 'price desc' } )
search . results # => Product sorted my price DESC
search . sort_attribute # => 'price'
search . sort_direction # => 'desc'
# Smart sort checking
search . sort? ( 'price' ) # => true
search . sort? ( 'price desc' ) # => true
search . sort? ( 'price asc' ) # => false
# Helpers for dealing with reversing sort direction
search . reverted_sort_direction # => 'asc'
search . sort_direction_for ( 'price' ) # => 'asc'
search . sort_direction_for ( 'name' ) # => 'desc'
# Params for sorting links
search . sort_params_for ( 'name' ) 很多時候你只需要搜尋結果：
ProductSearch . new ( params ) . results == ProductSearch . results ( params ) class ProductSearch
include SearchObject . module
end
# first arguments is treated as scope (if no scope option is provided)
search = ProductSearch . new ( scope : Product . visible , filters : params [ :f ] )
search . results # => includes only visible products class ProductSearch
include SearchObject . module
scope { Product . all }
# nil values returned from option blocks are ignored
option ( :sold ) { | scope , value | scope . sold if value }
end class ProductSearch
include SearchObject . module
scope { Product . all }
option :name # automaticly applies => { |scope, value| scope.where name: value unless value.blank? }
end class ProductSearch
include SearchObject . module
scope { Product . all }
option ( :date ) { | scope , value | scope . by_date parse_dates ( value ) }
private
def parse_dates ( date_string )
# some "magic" method to parse dates
end
end class ProductSearch
include SearchObject . module
scope { Product . all }
option :date , with : :parse_dates
private
def parse_dates ( scope , value )
# some "magic" method to parse dates
end
end class ProductSearch
include SearchObject . module
scope { RemoteEndpoint . fetch_product_as_hashes }
option ( :name ) { | scope , value | scope . select { | product | product [ :name ] == value } }
option ( :category ) { | scope , value | scope . select { | product | product [ :category ] == value } }
end您可以透過覆蓋initialize方法來獲得細粒度的範圍：
class ProductSearch
include SearchObject . module
option :name
option :category_name
def initialize ( user , options = { } )
super options . merge ( scope : Product . visible_to ( user ) )
end
end或者您可以透過覆寫initialize和fetch_results （用於取得結果）來新增簡單的分頁：
class ProductSearch
include SearchObject . module
scope { Product . all }
option :name
option :category_name
attr_reader :page
def initialize ( filters = { } , page = 0 )
super filters
@page = page . to_i . abs
end
def fetch_results
super . paginate page : @page
end
end您可以為您的應用程式提取基本搜尋類別。
class BaseSearch
include SearchObject . module
# ... options and configuration
end然後像這樣使用它：
class ProductSearch < BaseSearch
scope { Product }
end git checkout -b my-new-feature ）git commit -am 'Add some feature' ）git push origin my-new-feature ）rake ）另請參閱參與專案的貢獻者清單。
麻省理工學院許可證
