/**
     * 查询前 N个正常状态的版块
     * @param num 查询的个数
     * @return 前N个版块的集合
     */
    List<Board> selectByNum (@Param("num") Integer num);

4. 创建 Service 接口

在 IBoradService 定义方法：

public interface IBoradService {
    /**
     * 查询首页的版块列表
     * @param num 要查询的数据
     * @return List<Board>
     */
    List<Board> selectByNum (Integer num);
}

5. 实现 Service 接口

在 services.impl 包下新建 BoardServiceImpl 类：

@Slf4j
@Service
public class BoardServiceImpl implements IBoradService {
    @Resource
    private BoardMapper boardMapper;
    
    @Override
    public List<Board> selectByNum(Integer num) {
        // 参数校验
        if (num == null || num <= 0) {
            // 打印日志
            log.warn(ResultCode.FAILED_PARAMS_VALIDATE.toString());
            // 抛出异常
            throw new ApplicationException(AppResult.failed(ResultCode.FAILED_PARAMS_VALIDATE));
        }
        // 调⽤DAO层查询
        List<Board> result = boardMapper.selectByNum(num);
        // 返回结果
        return result;
    }
}

6. 生成测试方法

@SpringBootTest
class BoardServiceImplTest {

    @Resource
    private IBoradService boradService;
    @Resource
    private ObjectMapper objectMapper;
    
    @Test
    void selectByNum() throws JsonProcessingException {
        List<Board> boards = boradService.selectByNum(9);
        System.out.println(objectMapper.writeValueAsString(boards));
    }
}

7. 实现 Controller

在 controller 包下新建  BoradController 类：

@Api(tags = "板块接口")
@Slf4j
@RestController
@RequestMapping("/board")
public class BoradController {

    @Resource
    private IBoradService boradService;

    @ApiOperation("获取首页板块列表")
    @GetMapping("/topList")
    public AppResult<List<Board>> topList(){
        // 调用 Service
        List<Board> result = boradService.selectByNum(9);
        // 返回结果
        return AppResult.success(result);
    }
}

9 这个数字，目前是以硬代码的方式固定在程序中，为了方便配置，还是希望把他放在配置文件中。

 继续补充 BoradController 类：

@Slf4j
@SpringBootTest
class BoardServiceImplTest {

    // 从配置文件中获取主页中显⽰的版块个数，默认为9
    @Value("${bit-forum.index.board-num:9}")
    private Integer indexBoardNum;
    @Resource
    private IBoradService boradService;
    @Resource
    private ObjectMapper objectMapper;

    @Test
    void selectByNum() throws JsonProcessingException {
        log.debug("主页中显示的版块个数为：" + indexBoardNum);
        List<Board> boards = boradService.selectByNum(indexBoardNum);
        System.out.println(objectMapper.writeValueAsString(boards));
    }
}

 测试结果如下图所示：

 8. 实现前端页面

    $.ajax({
      type: 'get',
      url: 'board/topList',
      // 成功回调
      success: function(respData){
        if(respData.code == 0){
          // 成功
          buildTopBoard(respData.data);
        }else{
          // 失败
          $.toast({
              heading : '警告',
              text : respData.message,
              icon : 'Warning'
            }); 
          }
        },
        // 失败回调
        error: function(){
          $.toast({
              heading : '错误',
              text : '出错了，请联系管理员',
              icon : 'error'
            });
        }
    });