easy_solr 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8c744f500b1cbe59b2add0bf1b26a6e1c0a7439a
+  data.tar.gz: f2bda1c3ab56b50d9ec333a599654f92c33e6e8d
+SHA512:
+  metadata.gz: 6bfa181cf8ed35aa05ff1676ebacd02a19915ff8dbb60cad11180a05ecb833a9c3c2fd2736a01376500a2f8c6b0fbb282c3e08ed7184c92fa6e74b58b2a7aea1
+  data.tar.gz: 445d26b471ba9bf09f5f5f7257c354a492bcefb2d572fdec7a205f3d6e3d5c7dc5c2293658a2502fe86b1f1806d6c7bba26054d97eae10a7240986a88dfe6b59

data/lib/easy_solr/expressions.rb

@@ -0,0 +1,70 @@
+# encoding: utf-8
+module EasySolr
+  class Expressions
+    attr_accessor :nn_custom_links
+
+    def initialize
+      @nn_solr_query_string = ' '
+      @nn_prefix_expression = []
+      @nn_params_array      = []
+      @nn_query_string      = ''
+    end
+
+    ##
+    # ==== Description
+    #
+    # 拼接用户传递的参数，将其转换为Solr可以识别的
+    # 字符串
+    #
+    def solr_where(prefix, *params)
+      prefix_array = prefix.split("and")
+
+      params.each_with_index do |_key, _index|
+        @nn_prefix_expression << \
+        ::EasySolr::QueryItem.new(nn_custom_links, prefix_array[_index], _key)
+      end
+
+      self
+    end
+
+
+    ##
+    # ==== Description
+    #
+    # 生成 Solr 可以解析的字符串
+    #
+    # ==== Return
+    #
+    # 例如，将
+    # solr_params = expr.solr_where(" title = ? and id = ? ", '奥迪', '620460').
+    #            solr_where(" second_editor_id = ? ", '138')
+    #
+    # 生成
+    #
+    # title: 奥迪 id: 620460 second_editor_id: 138
+    #
+    def query_string_for_solr
+      the_whole_solr_query_string = ' '
+
+      @nn_prefix_expression.each do |_query_item|
+        the_whole_solr_query_string.concat(_query_item.traslate_to_solr_str)
+      end
+
+      the_whole_solr_query_string
+    end
+
+    ##
+    # ==== Description
+    #
+    # 每一次查询之后, 清除全部的 传入参数
+    #
+    def destroy!
+      @nn_solr_query_string = ' '
+      @nn_prefix_expression = []
+      @nn_params_array      = []
+      @nn_query_string      = ''
+    end
+
+  end
+end
+

data/lib/easy_solr/query_item.rb

@@ -0,0 +1,57 @@
+# encoding: utf-8
+module EasySolr
+  class QueryItem
+
+    attr_accessor :nn_custom_links
+
+    def initialize(custom_links, query_string, value)
+      @nn_solr_query_string = query_string
+      @nn_solr_value        = value
+      @nn_custom_links      = custom_links
+    end
+
+    ##
+    # ==== Description
+    #
+    #  最小单元的转化，将MySQL语法转转换成 Solr 可识别的查询字符串
+    #
+    #  第一步，参考 ::EasySolr::Expressions#solr_where
+    #  expr.solr_where(" title = ? and id = ? ", '奥迪', '620460')
+    #  转换成 "title = ?", '奥迪'
+    #
+    #  第二步
+    #  "title = ?", '奥迪'
+    #  转换成 "title : 奥迪"
+    #
+    #  第三步
+    #  "title : 奥迪"
+    #  转换成
+    #  "title_texts : 奥迪"
+    #
+    #  第四步, 参考 ::EasySolr::Expressions#query_string_for_solr
+    #   组装所有QueryItem 生成 Solr 可用字符串
+    #
+    def traslate_to_solr_str
+      @nn_solr_query_string.gsub!("=", ':').gsub!("?", @nn_solr_value)
+      self.replace_with_custom_links
+    end
+
+    ##
+    # ==== Description
+    #
+    # FIXME
+    # 这里使用gsub 还是有点风险的, 会导致 错误的覆盖
+    #
+    def replace_with_custom_links
+      nn_custom_links.each_pair do |_link, _value|
+        if @nn_solr_query_string.include? _link
+          @nn_solr_query_string.gsub!(_link, _value[:solr_name])
+          break
+        end
+      end
+
+      @nn_solr_query_string.concat(" ")
+    end
+  end
+end
+

data/lib/easy_solr/queryer.rb

@@ -0,0 +1,72 @@
+
+# encoding: utf-8
+module EasySolr
+  class Queryer
+    include ::EasySolr::ResultItem
+    include ::EasySolr::Translate
+
+    attr_accessor :solr_settings
+
+    def initialize(links, r_settings)
+      @solr_settings = r_settings
+
+      @expr                 = ::EasySolr::Expressions.new
+      @expr.nn_custom_links = links
+    end
+
+    ##
+    # ==== Description
+    #
+    # 根据所有生成的信息 执行 Solr 模糊查询
+    #
+    def solr_perform
+      solr_str    = @expr.query_string_for_solr
+
+      solr_params = { :q => solr_str, :rows => 10 }
+      result      = current_solr_connection.get 'select', :params => solr_params
+
+      @expr.destroy!
+      result_perform(result).result_items
+    end
+
+    ##
+    # ==== Description
+    #
+    # 获取 Solr 连接
+    #
+    def current_solr_connection
+      if defined? @deal_search_connection
+        @deal_search_connection
+      else
+        solr_url  = "#{solr_settings[:host]}:#{solr_settings[:port]}#{solr_settings[:path]}"
+        @deal_search_connection = RSolr.connect :url => solr_url
+      end
+    end
+
+    ##
+    # ==== Description
+    #
+    # 巧妙运用 where 将
+    #
+    def where(prefix, *values)
+      @expr.solr_where(prefix, *values)
+      self
+    end
+
+    ##
+    # ==== Description
+    #
+    #  根据主键ID 生成scope
+    #
+    def generate_scope(scope)
+      ## 执行顺序
+      ##  1、break_down
+      ##  2、solr_pri_key || mysql_pri_key
+      break_down(@expr.nn_custom_links)
+
+      pri_ids = solr_perform.map{|_item| _item[solr_pri_key].to_i}
+      scope.where(" #{ mysql_pri_key } IN (?) ", pri_ids)
+    end
+
+  end
+end

data/lib/easy_solr/result_item.rb

@@ -0,0 +1,60 @@
+
+module EasySolr
+  module ResultItem
+
+    @nn_num_found = nil
+    @nn_items     = []
+
+    ##
+    # ==== Description
+    #
+    # 解析下面的返回值
+    # {
+    #  "responseHeader"=>
+    #     {
+    #       "status"=>0,
+    #       "QTime"=>62,
+    #       "params"=>{"q"=>"title_texts: 奥迪", "rows"=>"10", "wt"=>"ruby"}
+    #     },
+    #     "response"=>
+    #       { "numFound"=>171, "start"=>0,
+    #           "docs"=>[
+    #             {"deal_id"=>"921384", "tb_sub_tag_id_its"=>74, "begin_date_ls"=>1424448000, "nick_name_texts"=>"金思盈玩具特卖店", "type_texts"=>"Deal", "second_editor_name_texts"=>"折800运营chenfang 素素", "brand_id_its"=>9866, "tb_tag_id_its"=>7, "end_date_ls"=>1425657600, "cancel_status_its"=>1, "wangwang_texts"=>"金思盈玩具专营店", "source_type_its"=>1, "complete_status_its"=>1, "title_texts"=>"金思盈奥迪Q5遥控车  拾美奥迪Q5遥控车", "suspended_status_its"=>1, "second_editor_id_its"=>762, "candidate_deal_type_id_its"=>23, "_version_"=>1499865062339248132},
+    #             {"deal_id"=>"921386", "tb_sub_tag_id_its"=>74, "begin_date_ls"=>1424448000, "nick_name_texts"=>"金思盈玩具特卖店", "type_texts"=>"Deal", "second_editor_name_texts"=>"折800运营chenfang 素素", "brand_id_its"=>9866, "tb_tag_id_its"=>7, "end_date_ls"=>1425657600, "cancel_status_its"=>1, "wangwang_texts"=>"金思盈玩具专营店", "source_type_its"=>1, "complete_status_its"=>1, "title_texts"=>"金思盈奥迪Q7遥控车  拾美奥迪Q7遥控车", "suspended_status_its"=>1, "second_editor_id_its"=>762, "candidate_deal_type_id_its"=>23, "_version_"=>1499865062339248133}
+    #            ]
+    #       }
+    #   }
+    #
+
+    ##
+    # ==== Description
+    #
+    # 获取返回值，该值为所有匹配的记录条数
+    #
+    # ==== Return
+    #
+    # 匹配记录条数
+    #
+    def num_found
+      @nn_num_found
+    end
+
+    ##
+    # ==== Description
+    #
+    # 返回记录
+    #
+    def result_items
+      @nn_items
+    end
+
+    def result_perform(result)
+      @nn_num_found = result["response"]["numFound"]
+      @nn_items     = result["response"]["docs"]
+
+      self
+    end
+
+  end
+end
+

data/lib/easy_solr/translate.rb

@@ -0,0 +1,67 @@
+# encoding: utf-8
+module EasySolr
+  module Translate
+
+    @nn_mysql_primary_key = nil
+    @nn_solr_primary_key  = nil
+    @pri_key              = false
+
+    ##
+    # ==== Description
+    #
+    # 获取用户配置信息中MySQL表主键
+    #
+    def mysql_pri_key
+      @nn_mysql_primary_key
+    end
+
+    ##
+    # ==== Description
+    #
+    # 获取用户配置信息中Solr 主键
+    #
+    def solr_pri_key
+      @nn_solr_primary_key
+    end
+
+    alias solr_primary_key solr_pri_key
+    alias mysql_primary_key mysql_pri_key
+
+    ##
+    # ==== Description
+    #
+    # 用户 MySQL 和 Solr 对应关系中主键是否设置
+    #
+    def pri_key_present?
+      self.break_down
+      @pri_key
+    end
+
+    ##
+    # ==== Description
+    #
+    # 插接配置并
+    #
+    # ==== Attention
+    #
+    # 主键配置以第一次配置为主
+    # 设置
+    #  @nn_solr_primary_key solr主键
+    #  @nn_mysql_primary_key mysql主键
+    #  @pri_key              主键是否存在
+    #
+    def break_down(links)
+      links.each_pair do |_key, _value|
+        if _value[:primary]
+          @nn_solr_primary_key  = _value[:solr_name]
+          @nn_mysql_primary_key = _key
+          @pri_key              = true
+
+          break
+        end
+      end
+    end
+
+  end
+end
+

data/lib/easy_solr.rb

@@ -0,0 +1,8 @@
+# $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+# $LOAD_PATH.unshift(File.dirname(__FILE__))
+require File.dirname(__FILE__) + "/easy_solr/expressions"
+require File.dirname(__FILE__) + "/easy_solr/query_item"
+require File.dirname(__FILE__) + "/easy_solr/result_item"
+require File.dirname(__FILE__) + "/easy_solr/translate"
+require File.dirname(__FILE__) + "/easy_solr/queryer"
+

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification
+name: easy_solr
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Hao Wang
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rsolr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.12
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.12
+description: EasySolr 是一个基于Solr 的检索框架
+email:
+- wanghao293@126.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/easy_solr.rb
+- lib/easy_solr/expressions.rb
+- lib/easy_solr/query_item.rb
+- lib/easy_solr/queryer.rb
+- lib/easy_solr/result_item.rb
+- lib/easy_solr/translate.rb
+homepage: http://yannini.me
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--main"
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: EasySolr 非常棒
+test_files: []