android 电子书阅读器epub解析、全文关键字搜索功能

上半年公司一直很忙也没时间将此功能进行整理我相信大多数人还是需要的先说一下此功能的背景吧之前阅读器是嵌入的H5自然与我们关系不大后来领导说要采用原生的阅读器还要支持epub格式解析、更为重要的是需要全文关键字检索这可把我难住了因为以前从来没有做过类似的功能领导只给了一周时间然后就是各种找三方阅读器、找解析最后终于结束了给自己点个赞！！！

接下来进入正题，首先我找的三方阅读器FBReader 这可以说是目前唯一开源的阅读器没有之一

项目源码：https://github.com/koreader/koreader 开源项目

当时感觉靠谱所以就开始找类似的项目，果然找到了，于是我就参考源码完成了阅读器的功能，而且这个开源项目是支持epub格式解析的哦这是我的效果图：

阅读器就这是这个样子，重点说一下关键字全文搜索功能：

-------------------------- 华丽丽的分割线，修改起因 -----------------------------

FBReader提供了文字搜索功能，但只能通过左右按钮依次进行切换跳转，深感不便，如下图一所示：

本文通过对源码的改进，将搜索功能扩展，搜索结果及其在原文中的位置百分比，以列表的形式展现（并前后添加五个字作为区分），可以通过列表项的点击，轻松跳转到任意一条搜索结果显示页。效果如上图二、图三所示。

-------------------------- 源码分析 -----------------------------

首先，看下源码搜索的调用逻辑，如下图所示：

从上图的调用关系，可以看出，在ZLTextPlainModel里面用private ArrayList<ZLTextMark> myMarks;来保存了ZLTextMark类型的数据，作为搜索结果的存储。

再来看下ZLTextMark类，里面定义了三个参数，来记录搜索结果在文件中的位置，和长度，以此定位跳转

public final int ParagraphIndex;

public final int Offset;

public final int Length；

从上图中，亦可看出，搜索的实际操作，是通过ZLSearchUtil类的find方法来实现的。源码中，以忽略大小写模式为例，

在搜索成功后，会返回文字位置偏移，再以此为基础，循环进行下一次搜索，直至结尾：

if (j >= patternLength) {
return i - offset;
}

---------------------- 分割线又来了，马上修改代码喽 ----------------------

通过前面的介绍，大概了解了搜索的过程，和存储。更详细的信息，请查阅源码，不再赘述。

那么，想达到预期的效果，我做了以下修改：

修改内容示意图如下：

代码部分如下：

一、为ZLTextMark添加内容参数：

既然，我们想列表显示，就不能只显示搜索内容，都是一样的噻。因此，添加了public final String AroundContent;参数，来存储搜索结果。在搜索内容的前面和后面，各加了五个字，以做区分。

二、在搜索过程中，为ZLTextMark新参数，拼接内容：

在ZLSearchUtil的find方法中，搜索成功时，添加了蓝色字体代码，为搜索内容添加前后缀内容：

if (j >= patternLength) {
    int start = i - AROUND_RANGE;
    int end = i + patternLength + AROUND_RANGE;
    // Avoid out of range
    if(start < 0) start = 0;
    if(end > text.length - 1) end = text.length - 1;
    char[] ca = new char[end - start];
    for(int m=start; m<end; m++) {
        ca[m-start] = text[m];
    }
    mAroundContent = String.valueOf(ca);
    return i - offset;
}

当然，为外面提供了获取当前内容的接口方法：

private static String mAroundContent; // current content
    public final static int AROUND_RANGE = 5; // previous and after additional word number
    public static String getCurrentAroundContent() {
        return mAroundContent;
    }

三、在搜索存储变量中添加结果内容：

我们已经为ZLTextMark添加了新参数，就在搜索存储时，为其设置，因此，将下面的代码

myMarks.add(new ZLTextMark(index, offset + pos, pattern.getLength())

添加扩展参数，修改为

myMarks.add(new ZLTextMark(index, offset + pos, pattern.getLength(),
ZLSearchUtil.getCurrentAroundContent()));

经过上述修改，再次获得myMarks内容后，里面存储的ZLTextMark就比原来多出了一项内容，可以供我们在列表中显示了。

---------------------------------- 分割线，再看下列表 ----------------------------------

看过代码的话，可以了解到ZLTextMark的ParagraphIndex参数，是指当前内容所在的段落索引。而我们在打开书籍后，又可以通过myFBReaderApp.Model.getTextModel().getParagraphsNumber();来获取书籍的总段落数量，因此前面显示的百分比，就很容易计算出来了。

ok，添加前后缀的内容有了，百分比也有了。列表的设置，就不用多说了吧。

还可以说一句，点击跳转，需要在FBReaderApp中做一个扩展，源码的ZLTextView提供了gotoMark(ZLTextMark mark)方法的，看下源码就晓得了。

------------------------------- 最后的分割线，可以结束了 --------------------------------

以上，便是修改的全部思路了。希望能对需要的人有所帮助。

后记：内容只是笔者自己的理解，和实践的一个记录，如有不妥和错误之处，也请及时指出，以便及时更正，以免自误误人。可发至邮箱：1070543858@qq.com