如何设计外部前置过滤器库

前置过滤器库必须以 C/C++ 实现，而且必须：

包括前置过滤器接口定义头文件 extpfapiv1.h。
实现 a_text_source 接口。
提供发起和返回 a_text_source（前置过滤器）实例的入口点函数以及前置过滤器支持的字符集标签。

前置过滤器的调用序列

对于每个待处理的文档，前置过滤器的用户执行以下调用序列：

begin_document(a_text_source*)
get_next_piece(a_text_source*, buffer**, len*)
get_next_piece(a_text_source*, buffer**, len*)
...
end_document(a_text_source*)

注意

end_document 可以调用多次而不干预 begin_document 调用。例如，如果要索引的其中一个文档为空，数据库服务器可能为该文档调用 end_document，而不再调用 begin_document。

get_next_piece 函数应该从传入字节流中过滤掉不需要的数据（例如格式信息和图像），并将下一块已过滤的数据返回到自分配的缓冲区中。

外部前置过滤器库工作流

另请参见

使用DocCommentXchange讨论此页。