EasyNet.Solr架构

在EasyNet.Solr中,有两个接口最重要,一个是编解码器接口ICodec,一个是Solr输出结果解析器接口ISolrResponseParser<ST, DT>。

ICode定义如下;

View Code
 1 /// <summary>
 2     /// 编解码器
 3     /// </summary>
 4     public interface ICodec
 5     {
 6         /// <summary>
 7         /// 对对象进行编码,并输出到流
 8         /// </summary>
 9         /// <param name="obj">要进行编码的对象</param>
10         /// <param name="stream">输出流</param>
11         void Marshal(object obj, Stream stream);
12 
13         /// <summary>
14         /// 对流进行解码
15         /// </summary>
16         /// <param name="stream">要解码的流</param>
17         /// <returns>解码后的对象</returns>
18         object Unmarshal(Stream stream);
19     }

 EasyNet.Solr内置了两个编解码器实现:JavaBinCodec,TextCodec。JavabinCodec对应Solr中基于javabin协议,TextCodec对应Solr中的xml、json等基于文本的协议。相应定义了BinaryCodecFactory,用于创建JavabinCodec,TextCodecFactory用于创建TextCodec。在SolrConnection中有个CodecFactory的属性,这是

ICodecFactory很简单的一个接口,定义如下:

 

View Code
 1     /// <summary>
 2     /// 编解码工厂
 3     /// </summary>
 4     public interface ICodecFactory
 5     {
 6         /// <summary>
 7         /// 创建编解码器
 8         /// </summary>
 9         /// <returns></returns>
10         ICodec CreateCodec();
11     }

 为了更好的分离及扩展,我没有把SolrConnection设计的很复杂,它就是很简单的用ICodecFactory创建编解码器ICodec,然后把javabin协议对应的NamedList,或者基于xml、json等文本协议对应的字符串写入流,用于更新索引等操作,把输出流转换为javabin协议对应的NamedList,或者字符串文本,用于Solr返回结果处理。

 ISolrResponseParser<ST, DT>定义如下;

View Code
1     /// <summary>
2     /// Solr返回解析器泛型接口
3     /// </summary>
4     /// <typeparam name="ST">ST类型返回数据</typeparam>
5     /// <typeparam name="DT">DT类型要解析为的数据</typeparam>
6     public interface ISolrResponseParser<ST, DT>
7     {
8         DT Parser(ST result);
9     }

针对javabin、xml、json,有以下类实现了ISolrResponseParser<ST, DT>接口:

 

BinaryHighlightingParser:用来解析基于javabin协议的高亮结果
BinaryQueryResultsParser:用来解析基于javabin协议的查询对象集合结果
BinaryResponseHeaderParser:用来解析基于javabin协议的输出头结果

 

 

JsonHighlightingParser:用来解析基于json协议的高亮结果
JsonQueryResultsParser:用来解析基于json协议的查询对象集合结果
JsonResponseHeaderParser:用来解析基于json协议的输出头结果

 

 

XmlHighlightingParser:用来解析基于xml协议的高亮结果
XmlQueryResultsParser:用来解析基于xml协议的查询对象集合结果
XmlResponseHeaderParser:用来解析基于xml协议的输出头结果
 

 

 当然将要发布的release版本中肯定会包含Facet查询解析器。

 

接口IUpdateOperationParametersConvert<T> ,用于更新所有操作参数转换,定义如下:

View Code
 1     /// <summary>
 2     /// Solr更新操作参数选项转换器泛型接口
 3     /// </summary>
 4     /// <typeparam name="T">转换为的数据类型</typeparam>
 5     public interface IUpdateOperationParametersConvert<T>
 6     {
 7         /// <summary>
 8         /// 转换提交参数
 9         /// </summary>
10         /// <param name="commitOptions">提交选项</param>
11         /// <returns>T类型数据</returns>
12         T ConvertCommitParameters(CommitOptions? commitOptions);
13 
14         /// <summary>
15         /// 转换优化参数
16         /// </summary>
17         /// <param name="optimizeOptions">优化选项</param>
18         /// <returns>T类型数据</returns>
19         T ConvertOptimizeParamters(OptimizeOptions? optimizeOptions);
20 
21         /// <summary>
22         /// 转换回退参数
23         /// </summary>
24         /// <returns>T类型数据</returns>
25         T ConvertRollbackParameters();
26 
27         /// <summary>
28         /// 转换添加操作参数
29         /// </summary>
30         /// <param name="docs">Solr输入文档</param>
31         /// <param name="addOptions">添加选项</param>
32         /// <param name="commitOptions">提交选项</param>
33         /// <param name="optimizeOptions">优化选项</param>
34         /// <returns>T类型数据</returns>
35         T ConvertAddParameters(IList<SolrInputDocument> docs, AddOptions? addOptions, CommitOptions? commitOptions, OptimizeOptions? optimizeOptions);
36 
37         /// <summary>
38         /// 转换删除参数
39         /// </summary>
40         /// <param name="ids">可迭代的键值</param>
41         /// <param name="queries">可迭代的查询</param>
42         /// <param name="commitOptions">提交选项</param>
43         /// <param name="optimizeOptions">优化选项</param>
44         /// <returns>T类型数据</returns>
45         T ConvertDeleteParameters(IEnumerable<string> ids, IEnumerable<ISolrQuery> queries, CommitOptions? commitOptions, OptimizeOptions? optimizeOptions);
46     }

 

 

针对javabin、xml、json,有以下类实现了IUpdateOperationParametersConvert<T>接口:
BinaryUpdateOperationParametersConvert:对应基于javabin协议的索引更新、提交、优化、回退、删除等操作
JsonUpdateOperationParametersConvert:对应基于json协议的索引更新、提交、优化、回退、删除等操作
XmlUpdateOperationParametersConvert:对应基于xml协议的索引更新、提交、优化、回退、删除等操作

 

 

 对于Solr的更新、提交、优化、回退、删除索引操作,功能完全等同solrj,在索引更新时,可以同时添加提交、优化操作,进行一步处理。

本着简单的原则,对于Solr查询,我没有进行复杂的封装处理,查询接口ISolrQueryOperations<T> 非常简单,定义如下:

View Code
 1     /// <summary>
 2     /// Solr查询操作泛型接口
 3     /// </summary>
 4     /// <typeparam name="T"></typeparam>
 5     public interface ISolrQueryOperations<T>
 6     {
 7         /// <summary>
 8         /// 查询
 9         /// </summary>
10         /// <param name="query">Solr查询</param>
11         /// <param name="options">查询参数</param>
12         /// <returns>T类型数据</returns>
13         T Query(ISolrQuery query, NameValueCollection options);
14     }

 可以参考Solr的wiki(http://wiki.apache.org/solr/),利用EasyNet.Solr.Commons.Params下定义的各种参数,构建查询字符串和查询选项。

 

下一篇将介绍EasyNet.Solr的具体使用和一些原则技巧。

 

 

 

 

 

posted @ 2011-05-03 00:13  TerryLiang  阅读(6038)  评论(6编辑  收藏