php——新闻项目改写

1. 主要思路:遵守java开发规范,保持接口一致性

2. 如何保持接口的一致性:

   (1).url的一致性:使用@RequestingMapping注解

   (2).参数的一致性:

   • 使用@ReuqestParam注解进行?传参,对于有初始赋值的参数需要设置request=false,注意该类型必须为对象,这样可以在值为空的情况下进行初始赋值

     @RequestMapping("/getBaoliaoList")
         public String getBaoliaoList(
             @RequestParam(value = "likeType",required = false) Integer likeType,
             @RequestParam(value = "page",required = false) Integer page,
             @RequestParam(value = "keyWord",required = false) String keyWord){
             if(likeType == null){
                 likeType=0;
             }
             if (page == null){
                 page = 1;
             }
             HashMap<String, Object> map = new HashMap<>();
             map.put("likeType",likeType);
             map.put("page",page);
             map.put("keyWord",keyWord);
             return baoliaoService.getBaoliaoList(map);
         }
     

     注:如在本例中,三个传入的参数都可以为空,但likeType和page必须有初始值,所以在为空的情况下进行赋值

   (3).返回值的一致性:(暂定)

   • 参数命名的一致性:手动调整

   • 返回结构的一致性:使用map传参