# BookService
Date: 2020-05-30

com.java2nb.novel.book.service

## 接口 BookService

所有已知实现类:
  BookServiceImpl

    public interface BookService

小说服务接口

从以下版本开始:
  2020/5/28
版本:
  1.0
作者:
  xiongxiaoyang

### 方法概要

所有方法 实例方法 抽象方法
`void` `addBookComment(java.lang.Long userId, BookComment comment)` 新增评价
`void` `addVisitCount(java.lang.Long bookId, int addCount)` 增加小说点击量
`java.util.List<BookCategory>` `listBookCategory()` 小说分类列表查询
`java.util.List<BookCommentVO>` `listBookCommentByPage(java.lang.Long bookId, int page, int pageSize)` 分页查询书籍评论列表
`java.util.List<BookIndex>` `listNewIndex(java.lang.Long bookId, java.lang.String orderBy, java.lang.Integer limit)` 查询目录列表
`java.util.List<Book>` `listRank(java.lang.Byte type, java.lang.Integer limit)` 小说排行数据查询列表
`java.util.List<Book>` `listRecBookByCatId(java.lang.Integer catId)` 根据分类id查询同类推荐书籍
`java.util.List<BookComment>` `listUserCommentByPage(java.lang.Long userId, int page, int pageSize)` 分页查询用户评论
`java.util.List<Book>` `queryBookByIds(java.util.List<java.lang.Long> ids)` 根据小说ID集合查询书籍列表
`java.util.List<Book>` `queryBookByMinUpdateTime(java.util.Date minDate, int limit)` 根据最小更新时间分页查询书籍列表
`BookContent` `queryBookContent(java.lang.Long bookIndexId)` 查询章节内容
`Book` `queryBookDetail(java.lang.Long id)` 小说详情信息查询
`BookIndex` `queryBookIndex(java.lang.Long bookIndexId)` 查询目录
`java.lang.Long` `queryFirstBookIndexId(java.lang.Long bookId)` 查询首章目录ID
`long` `queryIndexCount(java.lang.Long bookId)` 查询章节数
`java.util.Map<java.lang.String,java.lang.Long>` `queryPreAndNextBookIndexId(java.lang.Long bookId, java.lang.Integer indexNum)` 上一章节和下一章节目录ID查询接口

### 方法详细资料

#### queryBookByMinUpdateTime

    java.util.List<Book> queryBookByMinUpdateTime(java.util.Date minDate,
                                                  int limit)

根据最小更新时间分页查询书籍列表

参数:
  `minDate` - 最小时间，包括该时间
  `limit` - 查询数量
返回:
  书籍数据集合

#### queryBookByIds

    java.util.List<Book> queryBookByIds(java.util.List<java.lang.Long> ids)

根据小说ID集合查询书籍列表

参数:
  `ids` - 小说ID集合
返回:
  书籍数据集合

#### listRank

    java.util.List<Book> listRank(java.lang.Byte type,
                                  java.lang.Integer limit)

小说排行数据查询列表

参数:
  `type` - 排行类型，0:点击排行，1：更新排行，2：新书排行，3评论排行
  `limit` - 查询数量
返回:
  书籍数据集合

#### listBookCategory

    java.util.List<BookCategory> listBookCategory()

小说分类列表查询

返回:
  分类数据集合

#### queryBookDetail

    Book queryBookDetail(java.lang.Long id)

小说详情信息查询

参数:
  `id` - 小说ID
返回:
  小说数据对象

#### addVisitCount

    void addVisitCount(java.lang.Long bookId,
                       int addCount)

增加小说点击量

参数:
  `bookId` - 小说ID
  `addCount` - 新增的数量

#### queryIndexCount

    long queryIndexCount(java.lang.Long bookId)

查询章节数

参数:
  `bookId` - 书籍ID
返回:
  章节数量

#### queryBookContent

    BookContent queryBookContent(java.lang.Long bookIndexId)

查询章节内容

参数:
  `bookIndexId` - 目录ID
返回:
  书籍内容

#### listRecBookByCatId

    java.util.List<Book> listRecBookByCatId(java.lang.Integer catId)

根据分类id查询同类推荐书籍

参数:
  `catId` - 分类id
返回:
  书籍集合

#### listBookCommentByPage

    java.util.List<BookCommentVO> listBookCommentByPage(java.lang.Long bookId,
                                                        int page,
                                                        int pageSize)

分页查询书籍评论列表

参数:
  `bookId` - 书籍ID
  `page` - 页码
  `pageSize` - 分页大小
返回:
  评论集合

#### listNewIndex

    java.util.List<BookIndex> listNewIndex(java.lang.Long bookId,
                                           java.lang.String orderBy,
                                           java.lang.Integer limit)

查询目录列表

参数:
  `bookId` - 书籍ID
  `orderBy` - 排序
  `limit` - 查询条数
返回:
  目录集合

#### queryFirstBookIndexId

    java.lang.Long queryFirstBookIndexId(java.lang.Long bookId)

查询首章目录ID

参数:
  `bookId` - 书籍ID
返回:
  首章目录ID

#### queryBookIndex

    BookIndex queryBookIndex(java.lang.Long bookIndexId)

查询目录

参数:
  `bookIndexId` - 目录ID
返回:
  目录信息

#### queryPreAndNextBookIndexId

    java.util.Map<java.lang.String,java.lang.Long> queryPreAndNextBookIndexId(java.lang.Long bookId,
                                                                              java.lang.Integer indexNum)

上一章节和下一章节目录ID查询接口

参数:
  `bookId` - 书籍ID
  `indexNum` - 目录号
返回:
  上一章节和下一章节目录ID数据

#### addBookComment

    void addBookComment(java.lang.Long userId,
                        BookComment comment)

新增评价

参数:
  `userId` - 用户ID
  `comment` - 评论内容

#### listUserCommentByPage

    java.util.List<BookComment> listUserCommentByPage(java.lang.Long userId,
                                                      int page,
                                                      int pageSize)

分页查询用户评论

参数:
  `userId` - 用户ID
  `page` - 查询页码
  `pageSize` - 分页大小
返回:
  评论数据