Solrflux源码分析-Sql Support within Solr-类Sql的solr搜索实现(2)

q29191

　　Solrflux开源codegoogle地址http://code.google.com/p/solrflux/
　　1.Solrflux概述
　　Solrflux主要工作是完成Sql
　　语法到solr语法的转换，并执行查询，保存结果。
　　当前solrflux已经停止更新了，还是2010.Mar
　　antlr3.2.jar、1.4solrj的版本。
　　Solrflux支持
　　select|update|delete|optimze|commit|rollback|其中在select语法上，
　　不支持hl、facet、function等高级用法。就目前solrflux代码，基本满足80%的场景。
　　并且支持直接完整solr原始query
　　语法，此时不做解析，直接视作完整串，弥补了复杂query串的处理，
　　也兼容solr语法。
　　2.Solrflux工作原理、流程
　　solrflux工作原理：对sql语句执行语法分析，对生产的语法树做语句映射，拼接为solr语法，执行查询。
　　solrflux工作流程:
　　(1)将用户输入的sql语法（部分语法带有solr本身query特征，例如commit、optimize），按照自定义的词法、语法、抽象语法定义规则，执行词法分析、语法分析、生成抽象语法树，
　　主要依赖/grammar/Solrq.g
　　net.moraleboost.flux.lang包中的SolrqLexer.java
　　SolrqParser.java
　　(2)然后对抽象语法树进行遍历，根据nodetype
　　生成对应类型的statement，例如selectstatment、updatestatement等模板对象。
　　net.moraleboost.flux.lang包中的StatementListBuilder
　　这是上层管理对象，然后调用
　　net.moraleboost.flux.eval.stmt
　　包中的各种statment。
　　BaseStatement、CommitStatement、DeleteStatement、InsertStatement、OptimizeStatement、RollbackStatement
　　SelectStatementUseStement
　　其中，UseStatement主要任务是server对象的初始化，构建与solrj
　　client端，自然整个solrflux是基于http协议。非embeded方式工作，是solrjclient中http
　　client方式。
　　所有StatementextendsbaseStatement，抽象的baseStatement
　　实现接口Statement
　　(3)对生成的statement集合遍历，调用各自的execute方法，执行查询并保存结果。
　　各statement中保存了各自对应语句的上下文参数，execute方法中执行查询。
　　3.扩展使用方法
　　对于语句类型，select、update、commit、delete、optimize、rollback等已经定型了框架。
　　扩展过程，主要是select过程中，例如hl、facet、function、boost等参数支持。扩展方法
　　(1)扩展Solrq.g语法规则
　　(2)生成Lexer、Parser
　　(3)修改Statement方法
　　具体细节有：
　　在对应的语句类型下，修改Solrq.g的tokens、词法、语法、抽象树规则，使用
　　antlrworks-1.4.3.jar来查看语法结构图、测试语法。
　　下载antlrworks-1.4.3.jarfromhttp://www.antlr.org/download.html
　　windows下双击，弹出窗口，选择语法文件。点击debug选项。
　　input中输入待测试语句、AST中选择语法规则、ParseTree整个语法树构图
　　如果测试并没有出错，基本上语法扩充是ok的。
　　solrflux依赖的是antlr.3.2.runtime.jar，如果下载antlr-3.4-complete-no-antlrv2.jar
　　会出现，那么报错
　　无法找到server问题。
　　StatementListBuilder.buildSelectStatement中在
　　T_FROM中将soucre注入到statment中，对比两个jar
　　发现树形输出不一样，然后没有注入这个souce。具体问题有待进一步分析。
　　当词法、语法、抽象树没有问题后，采取anltrwork
　　字段生成Lexer、Parser代码，将相关代码替换原来的lexerParser,分别是SolrqLexer、SolrqParser
　　至此，再修改对应statement中的新参数的set、get方法，以及excute中的query拼接。
　　难点：扩展词法、语法规则并debug。复杂sql语法规则，可以参考antlr
　　mainlist上的mysql语法规则，基本可以直接引用了。