XAPIAN学习1--倒排数据(库)建立,工厂模式应用
选择xapian是因为xapian的代码可读性更强,更接近现代C++风格,用户端代码很少需要直接和指针打交道而看了下lemur示例代码到处都是指针不太爽,呵呵,还是了解不多吧,总之从xapian开始吧。
xapian的索引建立
xapian提供多种不同的索引方式比如in memory, flnt格式的等待(具体没有仔细看)。
在xapian中提供一个基类DataBase表示索引数据库,WriteableDataBase继承自DataBase.
XAPIAN为了能生成多种不同格式的数据库,采用了工厂模式类似
Base* data_base = new FlntDataBase()
Base* data_base = new InMemroyBase()
基类指针指向不同的子类对象。但是在XAPIAN的客户端代码中无需和指针打交道(否则你还需要用智能指针或者需要手动delete)看下客户端代码示例。
Xapian::WritableDatabase m_database(Xapian::InMemory::open());
这样就生成了一个基于内存的数据库。使用的时候 m_database.add_document 就是采用内存数据库的添加文档实现。
那么xapian如何内部实现这些的呢,方法就是xapian代码中大量采用了effective c++中提到的piml设计方法达到接口实现分离。不清楚的的可以参考这篇文章http://www.gamedev.net/reference/articles/article1794.asp (The C++ Pimpl)
看一下WriteableDataBase的源码大概如下(注意做了简化只为示意)
class Database {
public:
class Internal;
std::vector<Xapian::Internal::RefCntPtr<Internal> > internal; //实现被隐藏由internal实现
//xapian自己写了个引用计数的指针类,其实用boost shared_ptr或者c++0x的即可
Xapian::docid add_document(const Xapian::Document & document);
//…
}
//注意对应下面inmemory::open代码,这里有一个基于 Internal*输入的的构造函数
Database::Database(Database::Internal *internal_)
{
Xapian::Internal::RefCntPtr<Database::Internal> newi(internal_);
internal.push_back(newi);
}
//拷贝构造函数只是拷贝指针。。 资源共享而不是复制
Database::Database(const Database &other)
{
internal = other.internal;
}
//这里继承RefCntBase是一种典型的引用计数实现方式,和more effective c++中介绍的完全一样
//如果我们用boost shared_ptr 应该就不需要这种继承了。。。关于智能指针感觉最好的一个介绍http://www.codeproject.com/KB/stl/boostsmartptr.aspx
//关于智能指针实现的介绍http://www.mpi-inf.mpg.de/~kettner/courses/lib_design_03/notes/advanced.html
//xapian 采用自己写的这种是侵入式的实现方式代价小一点,可复用性差一点
class Database::Internal : public Xapian::Internal::RefCntBase {
private:
/// Copies are not allowed.
Internal(const Internal &);
/// Assignment is not allowed.
void operator=(const Internal &);
public:
virtual Xapian::docid add_document(const Xapian::Document & document) = 0;
};
Xapian::docid
WritableDatabase::add_document(const Document & document)
{
//具体都由internal 完成,可以看出其实vector它要求size为1其实一个shared_ptr就够用了可能是为了以后可能的扩展
if (internal.size() != 1) only_one_subdatabase_allowed();
RETURN(internal[0]->add_document(document));
}
class WritableDatabase : public Database {
}
WritableDatabase::WritableDatabase(Database::Internal *internal_)
: Database(internal_)
{
}
WritableDatabase::WritableDatabase(const WritableDatabase &other)
: Database(other)
{
}
WritableDatabase open();
}
它的 实现
WritableDatabase
InMemory::open() {
return WritableDatabase(new InMemoryDatabase);
//Database::Database(Database::Internal *internal_)
}
OK这个就是生成代码,其实就是加了一层的包装,我们所有的操作都由internal来负责完成,不同的internal实现比如in memory类型或者其它类型都是继承Xapian::Database::Internal
class InMemoryDatabase : public Xapian::Database::Internal {
Xapian::docid add_document(const Xapian::Document & document); //inmemory类型的database具体实现
//.....
private:
// Stop copy / assignment being allowed
InMemoryDatabase& operator=(const InMemoryDatabase &);
InMemoryDatabase(const InMemoryDatabase &);
}
Xapian::docid
InMemoryDatabase::add_document(const Xapian::Document & document)
{
if (closed) InMemoryDatabase::throw_database_closed();
Xapian::docid did = make_doc(document.get_data());
finish_add_doc(did, document);
RETURN(did);
}
选择xapian是因为xapian的代码可读性更强,更接近现代C++风格,用户端代码很少需要直接和指针打交道而看了下lemur示例代码到处都是指针不太爽,呵呵,还是了解不多吧,总之从xapian开始吧。
xapian的索引建立
xapian提供多种不同的索引方式比如in memory, flnt格式的等待(具体没有仔细看)。
在xapian中提供一个基类DataBase表示索引数据库,WriteableDataBase继承自DataBase.
XAPIAN为了能生成多种不同格式的数据库,采用了工厂模式类似
Base* data_base = new FlntDataBase()
Base* data_base = new InMemroyBase()
基类指针指向不同的子类对象。但是在XAPIAN的客户端代码中无需和指针打交道(否则你还需要用智能指针或者需要手动delete)看下客户端代码示例。
Xapian::WritableDatabase m_database(Xapian::InMemory::open());
这样就生成了一个基于内存的数据库。使用的时候 m_database.add_document 就是采用内存数据库的添加文档实现。
那么xapian如何内部实现这些的呢,方法就是xapian代码中大量采用了effective c++中提到的piml设计方法达到接口实现分离。不清楚的的可以参考这篇文章http://www.gamedev.net/reference/articles/article1794.asp (The C++ Pimpl)
看一下WriteableDataBase的源码大概如下(注意做了简化只为示意)
class Database {
public:
class Internal;
std::vector<Xapian::Internal::RefCntPtr<Internal> > internal; //实现被隐藏由internal实现
//xapian自己写了个引用计数的指针类,其实用boost shared_ptr或者c++0x的即可
Xapian::docid add_document(const Xapian::Document & document);
//…
}
//注意对应下面inmemory::open代码,这里有一个基于 Internal*输入的的构造函数
Database::Database(Database::Internal *internal_)
{
Xapian::Internal::RefCntPtr<Database::Internal> newi(internal_);
internal.push_back(newi);
}
//拷贝构造函数只是拷贝指针。。 资源共享而不是复制
Database::Database(const Database &other)
{
internal = other.internal;
}
//这里继承RefCntBase是一种典型的引用计数实现方式,和more effective c++中介绍的完全一样
//如果我们用boost shared_ptr 应该就不需要这种继承了。。。关于智能指针感觉最好的一个介绍http://www.codeproject.com/KB/stl/boostsmartptr.aspx
//关于智能指针实现的介绍http://www.mpi-inf.mpg.de/~kettner/courses/lib_design_03/notes/advanced.html
//xapian 采用自己写的这种是侵入式的实现方式代价小一点,可复用性差一点
class Database::Internal : public Xapian::Internal::RefCntBase {
private:
/// Copies are not allowed.
Internal(const Internal &);
/// Assignment is not allowed.
void operator=(const Internal &);
public:
virtual Xapian::docid add_document(const Xapian::Document & document) = 0;
};
Xapian::docid
WritableDatabase::add_document(const Document & document)
{
//具体都由internal 完成,可以看出其实vector它要求size为1其实一个shared_ptr就够用了可能是为了以后可能的扩展
if (internal.size() != 1) only_one_subdatabase_allowed();
RETURN(internal[0]->add_document(document));
}
class WritableDatabase : public Database {
}
WritableDatabase::WritableDatabase(Database::Internal *internal_)
: Database(internal_)
{
}
WritableDatabase::WritableDatabase(const WritableDatabase &other)
: Database(other)
{
}
在dbfactory.h中声明了inmemory::open 方法,注意返回的是WritebleDatabase
namespace InMemory {
WritableDatabase open();
}
它的 实现
WritableDatabase
InMemory::open() {
return WritableDatabase(new InMemoryDatabase);
//Database::Database(Database::Internal *internal_)
}
OK这个就是生成代码,其实就是加了一层的包装,我们所有的操作都由internal来负责完成,不同的internal实现比如in memory类型或者其它类型都是继承Xapian::Database::Internal
class InMemoryDatabase : public Xapian::Database::Internal {
Xapian::docid add_document(const Xapian::Document & document); //inmemory类型的database具体实现
//.....
private:
// Stop copy / assignment being allowed
InMemoryDatabase& operator=(const InMemoryDatabase &);
InMemoryDatabase(const InMemoryDatabase &);
}
Xapian::docid
InMemoryDatabase::add_document(const Xapian::Document & document)
{
if (closed) InMemoryDatabase::throw_database_closed();
Xapian::docid did = make_doc(document.get_data());
finish_add_doc(did, document);
RETURN(did);
}