model

app/src/main/java/com/monke/monkeybook/model/IEasouBookModel.java

@@ -8,24 +8,47 @@ import com.monke.monkeybook.listener.OnGetChapterListListener;
 import java.util.List;
 import io.reactivex.Observable;
 
+// 定义了一个名为IEasouBookModel的接口，用于规范与书籍相关的各种数据获取操作的方法签名
+// 该接口可能会有不同的实现类来具体处理对应的业务逻辑，例如与不同数据源交互获取书籍信息等
 public interface IEasouBookModel {
+
     /**
-     * 搜索书籍
+     * 搜索书籍的方法
+     *
+     * @param content 搜索的内容，通常是书籍的名称、作者等相关关键字，用于筛选符合条件的书籍
+     * @param page 页码，用于分页获取搜索结果，指定要获取第几页的搜索数据
+     * @param rankKind 排序类型相关的参数，可能用于指定按照何种规则对搜索结果进行排序，例如按照热度、发布时间等
+     * @return 返回一个Observable对象，其泛型类型为List<SearchBookBean>，用于异步地获取搜索到的书籍信息列表，
+     *         外部可以通过订阅这个Observable来处理返回的搜索结果数据
      */
     Observable<List<SearchBookBean>> searchBook(String content, int page, int rankKind);
 
     /**
-     * 网络请求并解析书籍信息
+     * 网络请求并解析书籍信息的方法
+     *
+     * @param bookShelfBean 传入的BookShelfBean对象，可能包含了书籍的部分初始信息（比如书籍的唯一标识等），
+     *                      基于这些信息去网络请求获取更详细完整的书籍信息，并进行解析
+     * @return 返回一个Observable对象，其泛型类型为BookShelfBean，用于异步地获取经过网络请求和解析后的完整书籍信息，
+     *         外部通过订阅这个Observable来获取最终的书籍详情数据
      */
     Observable<BookShelfBean> getBookInfo(final BookShelfBean bookShelfBean);
 
     /**
-     * 网络解析图书目录
+     * 网络解析图书目录的方法
+     *
+     * @param bookShelfBean 传入的BookShelfBean对象，同样可能包含了书籍的相关标识等必要信息，基于这些信息去网络获取对应的图书目录数据
+     * @param getChapterListListener 一个监听器对象，用于在获取图书目录的过程中或者获取完成后进行回调通知，
+     *                                外部可以通过实现这个监听器的相关方法来处理获取目录过程中的进度、成功或失败等情况
      */
     void getChapterList(final BookShelfBean bookShelfBean, OnGetChapterListListener getChapterListListener);
 
     /**
-     * 章节缓存
+     * 章节缓存相关的方法
+     *
+     * @param durChapterUrl 章节对应的URL地址，通过这个URL可以定位到具体要获取缓存内容的章节资源
+     * @param durChapterIndex 章节的索引值，用于更准确地标识章节顺序等信息，方便在缓存操作中定位具体章节
+     * @return 返回一个Observable对象，其泛型类型为BookContentBean，用于异步地获取章节缓存内容对应的Bean对象，
+     *         外部通过订阅这个Observable来获取章节的缓存数据（比如章节的文本内容等）
      */
     Observable<BookContentBean> getBookContent(final String durChapterUrl, final int durChapterIndex);
-}
+}

app/src/main/java/com/monke/monkeybook/model/IGxwztvBookModel.java

@@ -3,21 +3,42 @@ package com.monke.monkeybook.model;
 
 import com.monke.monkeybook.bean.LibraryBean;
 import com.monke.monkeybook.bean.SearchBookBean;
-import com.monke.monkeybook.cache.ACache;
+import // 导入缓存相关的类，可能用于缓存一些数据，提高数据获取效率等操作
+        com.monke.monkeybook.cache.ACache;
 import java.util.List;
 import io.reactivex.Observable;
 
+// IGxwztvBookModel接口继承自IStationBookModel接口，意味着它会继承IStationBookModel中定义的方法，
+// 同时在此接口中又额外定义了一些与特定业务（可能和gxwztv相关）相关的书籍数据获取等操作的方法规范
 public interface IGxwztvBookModel extends IStationBookModel {
 
+    /**
+     * 获取分类书籍信息的方法
+     *
+     * @param url 对应获取分类书籍数据的请求地址，通过这个URL可以向相应的服务器端发起请求，获取指定分类下的书籍信息
+     * @param page 页码参数，用于指定要获取第几页的分类书籍数据，实现分页获取，方便展示大量数据时进行分批加载
+     * @return 返回一个Observable对象，其泛型类型为List<SearchBookBean>，用于异步地获取指定分类下对应页面的书籍信息列表，
+     *         外部可通过订阅该Observable来处理获取到的书籍数据，例如展示在界面上或者进行进一步的筛选、排序等操作
+     */
     Observable<List<SearchBookBean>> getKindBook(String url, int page);
 
     /**
-     * 获取主页信息
+     * 获取主页信息的方法
+     *
+     * @param aCache 传入的ACache对象，用于缓存相关操作，可能会先从缓存中尝试获取主页信息，若缓存不存在或已过期等情况，
+     *              再去进行网络请求等操作来获取最新的主页信息，并可以将新获取到的主页信息存入缓存，方便下次快速获取
+     * @return 返回一个Observable对象，其泛型类型为LibraryBean，用于异步地获取主页相关的数据，以LibraryBean对象的形式返回，
+     *         外部通过订阅这个Observable来获取主页信息并进行后续处理，比如将主页数据展示在对应的页面上
      */
     Observable<LibraryBean> getLibraryData(ACache aCache);
 
     /**
-     * 解析主页数据
+     * 解析主页数据的方法
+     *
+     * @param data 传入的需要解析的数据字符串，通常可能是从网络请求获取到的原始主页数据内容，该方法会按照一定的规则和逻辑，
+     *             对传入的字符串数据进行解析，提取出有用的信息，并封装成LibraryBean对象返回
+     * @return 返回一个Observable对象，其泛型类型为LibraryBean，用于异步地返回解析后得到的主页数据对应的LibraryBean对象，
+     *         外部订阅此Observable来获取解析好的主页数据，以便后续进行展示、处理等操作
      */
     Observable<LibraryBean> analyLibraryData(String data);
-}
+}

app/src/main/java/com/monke/monkeybook/model/IImportBookModel.java

@@ -2,10 +2,21 @@
 package com.monke.monkeybook.model;
 
 import com.monke.monkeybook.bean.LocBookShelfBean;
+// 导入Java中用于操作文件的类，意味着该接口相关操作可能涉及对本地文件的处理，比如导入本地书籍文件等
 import java.io.File;
 import io.reactivex.Observable;
 
+// 定义了IImportBookModel接口，该接口主要规范了导入书籍相关操作的方法签名，
+// 具体的导入书籍逻辑可由实现该接口的类来完成
 public interface IImportBookModel {
 
+    /**
+     * 导入书籍的方法
+     *
+     * @param book 传入的File对象，表示要导入的书籍文件，这个文件可以是本地存储的各种格式的书籍文件（例如txt、epub等），
+     *             通过该方法会对传入的书籍文件进行相应处理，比如解析文件内容、提取书籍相关信息等，最终生成对应的书籍信息对象
+     * @return 返回一个Observable对象，其泛型类型为LocBookShelfBean，用于异步地返回导入书籍操作后生成的书籍信息对象，
+     *         外部可以通过订阅这个Observable来获取导入书籍后的结果信息，比如将书籍信息添加到书架等后续操作
+     */
     Observable<LocBookShelfBean> importBook(File book);
-}
+}

app/src/main/java/com/monke/monkeybook/model/IStationBookModel.java

@@ -8,25 +8,53 @@ import com.monke.monkeybook.listener.OnGetChapterListListener;
 import java.util.List;
 import io.reactivex.Observable;
 
+// IStationBookModel接口定义了一系列与书籍相关操作的方法规范，这些操作可能是围绕某个站点（Station）展开的，
+// 比如从特定的网络站点获取书籍数据等，具体实现类会按照这些规范来实现对应的业务逻辑
 public interface IStationBookModel {
 
     /**
-     * 搜索书籍
+     * 搜索书籍的方法
+     *
+     * @param content 用于指定搜索的关键字内容，一般来说可以是书籍的名称、作者名或者相关的关键词等，
+     *                通过这些关键字去查找匹配的书籍信息
+     * @param page 表示页码，用于分页获取搜索结果。当搜索结果较多时，通过指定不同的页码可以获取到相应页面的书籍列表，
+     *             便于分批展示和处理搜索到的书籍数据
+     * @return 返回一个Observable对象，其泛型类型为List<SearchBookBean>，用于异步地返回根据关键字和页码搜索到的书籍信息列表，
+     *         外部可以通过订阅这个Observable来接收和处理搜索结果，例如在界面上展示搜索到的书籍列表等操作
      */
     Observable<List<SearchBookBean>> searchBook(String content, int page);
 
     /**
-     * 网络请求并解析书籍信息
+     * 网络请求并解析书籍信息的方法
+     *
+     * @param bookShelfBean 传入的BookShelfBean对象，它可能包含了部分初始的书籍相关信息，例如书籍的唯一标识符等，
+     *                      基于这些已有信息向相应的网络资源（可能是某个书籍站点）发起请求，获取更详细完整的书籍信息，
+     *                      并对获取到的数据进行解析，最终封装成完整的BookShelfBean对象返回
+     * @return 返回一个Observable对象，其泛型类型为BookShelfBean，用于异步地返回经过网络请求和解析后的完整书籍信息对象，
+     *         外部通过订阅这个Observable来获取最终的书籍详情数据，进而可以进行如更新书架等后续操作
      */
     Observable<BookShelfBean> getBookInfo(final BookShelfBean bookShelfBean);
 
     /**
-     * 网络解析图书目录
+     * 网络解析图书目录的方法
+     *
+     * @param bookShelfBean 同样，这里的BookShelfBean对象包含了用于定位特定书籍的相关信息，
+     *                      依据这些信息向网络资源请求该书籍对应的目录数据，
+     *                      然后在获取过程中或者获取完成后通过传入的OnGetChapterListListener监听器来通知外部相关情况
+     * @param getChapterListListener 一个监听器对象，用于监听获取图书目录的进度、成功获取或者获取失败等情况，
+     *                                外部可以通过实现该监听器的相应方法来处理这些不同的事件，例如更新界面展示目录进度等
      */
     void getChapterList(final BookShelfBean bookShelfBean, OnGetChapterListListener getChapterListListener);
 
     /**
-     * 章节缓存
+     * 章节缓存的方法
+     *
+     * @param durChapterUrl 表示具体章节对应的URL地址，通过这个URL可以准确地定位到需要获取缓存内容的章节资源所在位置，
+     *                     一般是从网络上获取该章节原始数据的链接地址
+     * @param durChapterIndex 章节的索引值，用于标识章节在整本书中的顺序位置等信息，方便在缓存操作以及后续使用中准确区分不同章节，
+     *                        比如按照章节顺序来展示章节内容等情况就会用到这个索引
+     * @return 返回一个Observable对象，其泛型类型为BookContentBean，用于异步地返回章节缓存内容对应的Bean对象，
+     *         外部通过订阅这个Observable来获取章节的缓存数据，例如章节的具体文本内容等，方便后续展示或处理章节内容的操作
      */
     Observable<BookContentBean> getBookContent(final String durChapterUrl, final int durChapterIndex);
-}
+}

app/src/main/java/com/monke/monkeybook/model/IWebBookModel.java

@@ -8,28 +8,70 @@ import com.monke.monkeybook.listener.OnGetChapterListListener;
 import java.util.List;
 import io.reactivex.Observable;
 
+// IWebBookModel接口定义了一系列与网络书籍相关操作的方法规范，
+// 主要涉及从网络获取书籍各种信息（如书籍详情、目录、章节内容等）以及搜索不同类型书籍的功能，
+// 具体的实现类会按照这些方法签名去实现对应的网络交互逻辑
 public interface IWebBookModel {
+
     /**
-     * 网络请求并解析书籍信息
+     * 网络请求并解析书籍信息的方法
+     *
+     * @param bookShelfBean 传入的BookShelfBean对象，它可能包含了部分初始的书籍相关标识信息等，
+     *                      基于这些已有信息向网络发起请求，比如向某个网络书籍平台请求对应书籍的详细信息，
+     *                      然后对获取到的数据进行解析处理，最终封装成完整的BookShelfBean对象返回
+     * @return 返回一个Observable对象，其泛型类型为BookShelfBean，用于异步地返回经过网络请求和解析后完整的书籍信息对象，
+     *         外部通过订阅这个Observable来获取书籍的详细信息，进而可用于展示、更新书架等后续操作
      */
     Observable<BookShelfBean> getBookInfo(final BookShelfBean bookShelfBean);
 
     /**
-     * 网络解析图书目录
+     * 网络解析图书目录的方法
+     *
+     * @param bookShelfBean 传入的BookShelfBean对象包含了用于定位特定书籍的必要信息，
+     *                      依据这些信息向网络资源（比如对应的书籍网站服务器）请求该书籍的目录数据，
+     *                      在获取目录的过程中或者获取完成后，通过传入的OnGetChapterListListener监听器来通知外部相关情况，
+     *                      例如目录获取进度、成功获取目录或者获取失败等信息
+     * @param getChapterListListener 一个监听器对象，用于监听获取图书目录的各种情况，
+     *                                外部可以通过实现该监听器的相应方法来处理这些不同事件，
+     *                                比如在界面上展示目录获取进度条，或者将获取到的目录数据进行展示等操作
      */
     void getChapterList(final BookShelfBean bookShelfBean,OnGetChapterListListener getChapterListListener);
 
     /**
-     * 章节缓存
+     * 章节缓存的方法
+     *
+     * @param durChapterUrl 表示具体章节对应的URL地址，通过这个URL可以准确地定位到需要获取缓存内容的章节资源所在网络位置，
+     *                     它是从网络上获取该章节原始数据的链接地址，用于准确获取相应章节内容
+     * @param durChapterIndex 章节的索引值，用于标识章节在整本书中的顺序位置等信息，方便在缓存操作以及后续展示、使用章节内容时，
+     *                        准确区分不同章节，例如按照章节顺序展示阅读内容时就依赖这个索引值来确定先后顺序
+     * @param tag 额外的标识字符串，可能用于区分不同类型的缓存场景、不同来源的章节数据或者在缓存管理中起其他辅助标识作用等
+     * @return 返回一个Observable对象，其泛型类型为BookContentBean，用于异步地返回章节缓存内容对应的Bean对象，
+     *         外部通过订阅这个Observable来获取章节的缓存数据，比如章节的具体文本内容等，方便后续展示、阅读章节内容的操作
      */
     Observable<BookContentBean> getBookContent(final String durChapterUrl, final int durChapterIndex, String tag);
 
     /**
-     * 获取分类书籍
+     * 获取分类书籍的方法
+     *
+     * @param url 对应获取分类书籍数据的请求地址，通过这个URL向相应的网络资源（可能是某个书籍分类页面所在的网络地址）发起请求，
+     *            以获取指定分类下的书籍信息，比如向小说网站的玄幻分类页面地址发起请求获取玄幻类书籍列表
+     * @param page 页码参数，用于指定要获取第几页的分类书籍数据，实现分页获取，便于在书籍数量较多时进行分批展示和处理，
+     *             例如只获取分类书籍列表中的第2页数据等情况就通过这个参数指定
+     * @return 返回一个Observable对象，其泛型类型为List<SearchBookBean>，用于异步地返回获取到的指定分类下对应页面的书籍信息列表，
+     *         外部可通过订阅该Observable来处理获取到的书籍数据，例如在界面上展示分类书籍列表、进行筛选排序等操作
      */
     Observable<List<SearchBookBean>> getKindBook(String url,int page);
+
     /**
-     * 其他站点资源整合搜索
+     * 其他站点资源整合搜索的方法
+     *
+     * @param content 用于指定搜索的关键字内容，一般可以是书籍的名称、作者名或者相关的关键词等，
+     *                通过这些关键字去多个其他相关的网络书籍站点进行搜索，查找匹配的书籍信息
+     * @param page 页码参数，用于分页获取搜索结果，当搜索到的结果较多时，通过指定不同的页码可以获取到相应页面的书籍列表，
+     *             便于分批展示和处理搜索到的书籍数据，比如获取搜索结果的第3页数据等情况就通过该参数指定
+     * @param tag 额外的标识字符串，可能用于区分不同的搜索场景、不同的站点范围或者在搜索结果整合处理中起其他辅助标识作用等
+     * @return 返回一个Observable对象，其泛型类型为List<SearchBookBean>，用于异步地返回根据关键字和页码在其他站点搜索到的书籍信息列表，
+     *         外部可以通过订阅这个Observable来接收和处理搜索结果，例如在界面上展示整合后的搜索书籍列表等操作
      */
     Observable<List<SearchBookBean>> searchOtherBook(String content,int page,String tag);
-}
+}

app/src/main/java/com/monke/monkeybook/model/IWebContentModel.java

@@ -1,7 +1,22 @@
 //Copyright (c) 2017. 章钦豪. All rights reserved.
 package com.monke.monkeybook.model;
 
+// IWebContentModel接口定义了一个用于分析书籍内容的方法规范，
+// 具体的实现类需要按照此规范来实现对书籍内容相关的解析操作，
+// 可能是从网络获取到的书籍文本内容等进行特定的分析处理。
 public interface IWebContentModel {
 
+    /**
+     * 分析书籍内容的方法
+     *
+     * @param s 传入的字符串参数，通常代表需要分析处理的书籍内容相关的数据，
+     *          比如从网络上获取到的某个章节的原始文本内容，或者经过初步处理的包含书籍内容信息的字符串等
+     * @param realUrl 表示实际的URL地址，这个地址可能与获取书籍内容相关，比如是该书籍内容来源的网络链接地址，
+     *                可以用于验证内容来源、辅助解析内容（例如依据URL对应的网页格式特点来解析内容等情况）等操作
+     * @return 返回一个字符串，该字符串应该是经过分析处理后的结果，例如提取出了书籍内容中的关键信息、对内容进行了格式化后的文本等，
+     *         具体返回内容取决于具体的分析逻辑实现
+     * @throws Exception 此方法声明会抛出异常，意味着在分析书籍内容的过程中，如果出现了诸如网络连接问题（若涉及网络交互）、
+     *                   数据格式错误（不符合预期的书籍内容格式）等情况时，会抛出相应的异常，需要外部调用者进行适当处理
+     */
     String analyBookcontent(String s,String realUrl) throws Exception;
 }