ArticleCommentsController.md 2.55 KB

ArticleCommentsController 文章评论相关服务

1.getArticleCommentsList方法

-请求参数:

参数名称 参数类型 可否为空 备注
article_id int 作者id
page int 页数
limit int 返回条数

-方法解释:获取文章评论列表服务。

-实现逻辑:

1.进入ArticleCommentsController.getArticleCommentsList方法,调用sns.getArticleCommentsList服务
2.对参数article_id进行非空和是否大于0校验
3.根据article_id查询表yh_guang.comments获取该文章的评论信息
4.调用users.getUserProfilesByUids服务获取评论用户的详细信息
5.users.getUserProfilesByUids服务中根据uid查询表yoho_passport.user_profile和表yoho_passport.user_base返回用户详细信息
6.封装数据并返回

-示例:

请求:http://localhost:8080/gateway/guang/api/*/comments/getList?article_id=1&page=1&limit=1&debug=XYZ

返回:

{
    "alg": "SALT_MD5",
    "code": 200,
    "data": {
        "list": [
            {
                "article_id": 1,
                "avator": "http://img10.static.yhbimg.com/headimg/2013/11/28/09/01cae078abe5fe320c88cdf4c220212688.gif",
                "content": "帅",
                "create_time": "05月21日 09:42",
                "id": 1,
                "username": "150****4837"
            }
        ],
        "page": 1,
        "total": 1,
        "total_page": 1
    },
    "md5": "a59b5805865c5052f66e9ceafcdef8ca",
    "message": "Comment List!"
}

2.addArticleComments方法

-请求参数:

参数名称 参数类型 可否为空 备注
article_id int 作者id
uid int 评论用户id
content string 评论内容

-方法解释:增加文章评论

-实现逻辑:

1.进入ArticleCommentsController.addArticleComments方法,调用sns.addArticleComments服务
2.对参数进行非空校验
3.查询表yh_guang.article获取文章详细信息
4.调用users.getUserProfilesByUids服务获取评论用户的详细信息
5.组装评论信息插入到yh_guang.comments表中
6.返回评论成功信息

-示例: 请求:http://localhost:8080/gateway/guang/api/*/comments/add?article_id=3&uid=1&content=sdfasdfas&debug=XYZ 返回:

{
    "alg": "SALT_MD5",
    "code": 200,
    "data": {},
    "md5": "f4a7a490bb6666b005008d795ed14e5d",
    "message": "发表评论成功"
}