weibo4j.Comments Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of weibo-openapi-4java Show documentation
Show all versions of weibo-openapi-4java Show documentation
基于微博开放平台官网的weibo4j-oauth2-beta3.1.1包及新版接口做二次开发
The newest version!
/*
* Copyright © 2021 pengjianqiang
* All rights reserved.
* 项目名称：微博开放平台API-JAVA SDK
* 项目描述：基于微博开放平台官网的weibo4j-oauth2-beta3.1.1包及新版接口做二次开发
* 项目地址：https://github.com/qqxadyy/weibo-openapi-4java
* 许可证信息：见下文
*
* ======================================================================
*
* src/main/java/weibo4j下的文件是从weibo4j-oauth2-beta3.1.1.zip中复制出来的
* 本项目对这个目录下的部分源码做了重新改造
* 但是许可信息和"https://github.com/sunxiaowei2014/weibo4j-oauth2-beta3.1.1"或源码中已存在的保持一致
*/
package weibo4j;
import java.util.List;
import java.util.Map;
import pjq.weibo.openapi.constant.WeiboConfigs;
import weibo4j.model.Comment;
import weibo4j.model.CommentPager;
import weibo4j.model.Paging;
import weibo4j.model.PostParameter;
import weibo4j.model.WeiboException;
import weibo4j.model.WeiboResponse;
import weibo4j.util.ArrayUtils;
public class Comments extends Weibo {
private static final long serialVersionUID = 3321231200237418256L;
public Comments(String access_token) {
this.accessToken = access_token;
}
/**
* 根据微博ID返回某条微博的评论列表
*
* @param id
* 需要查询的微博ID
* @return list of Comment
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.1
* @see http://open.weibo.com/wiki/2/comments/show
* @since JDK 1.5
*/
public CommentPager getCommentById(String id) throws WeiboException {
return new CommentPager((client.get(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_SHOW),
new PostParameter[] {new PostParameter("id", id)}, accessToken)));
}
/**
* 根据微博ID返回某条微博的评论列表
*
* @param id
* 需要查询的微博ID
* @param count
* 单页返回的记录条数，默认为50。
* @param page
* 返回结果的页码，默认为1。
* @param filter_by_author
* 作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0。
* @return list of Comment
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.1
* @see http://open.weibo.com/wiki/2/comments/show
* @since JDK 1.5
*/
public CommentPager getCommentById(String id, Paging page, Integer filter_by_author) throws WeiboException {
return new CommentPager((client.get(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_SHOW), new PostParameter[] {
new PostParameter("id", id), new PostParameter("filter_by_author", filter_by_author.toString())}, page,
accessToken)));
}
/**
* 根据微博ID返回某条微博的评论列表
*
* @param map
* 参数列表
* @return
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.2
* @see http://open.weibo.com/wiki/2/comments/show
* @since JDK 1.5
*/
public CommentPager getCommentById(Map map) throws WeiboException {
PostParameter[] parList = ArrayUtils.mapToArray(map);
return new CommentPager((client.get(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_SHOW), parList, accessToken)));
}
/**
* 获取当前登录用户所发出的评论列表
*
* @return list of Comment
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.1
* @see http://open.weibo.com/wiki/2/comments/by_me
* @since JDK 1.5
*/
public CommentPager getCommentByMe() throws WeiboException {
return new CommentPager((client.get(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_BY_ME), accessToken)));
}
/**
* 获取当前登录用户所发出的评论列表
*
* @param count
* 单页返回的记录条数，默认为50
* @param page
* 返回结果的页码，默认为1
* @param filter_by_source
* 来源筛选类型，0：全部、1：来自微博的评论、2：来自微群的评论，默认为0
* @return list of Comment
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.1
* @see http://open.weibo.com/wiki/2/comments/by_me
* @since JDK 1.5
*/
public CommentPager getCommentByMe(Paging page, Integer filter_by_source) throws WeiboException {
return new CommentPager((client.get(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_BY_ME),
new PostParameter[] {new PostParameter("filter_by_author", filter_by_source.toString())}, page,
accessToken)));
}
/**
* 获取当前登录用户所发出的评论列表
*
* @param map
* 参数列表
* @return
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.2
* @see http://open.weibo.com/wiki/2/comments/by_me
* @since JDK 1.5
*/
public CommentPager getCommentByMe(Map map) throws WeiboException {
PostParameter[] parList = ArrayUtils.mapToArray(map);
return new CommentPager(
(client.get(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_BY_ME), parList, accessToken)));
}
/**
* 获取当前登录用户所接收到的评论列表
*
* @return list of Comment
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.1
* @see http://open.weibo.com/wiki/2/comments/to_me
* @since JDK 1.5
*/
public CommentPager getCommentToMe() throws WeiboException {
return new CommentPager((client.get(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_TO_ME), accessToken)));
}
/**
* 获取当前登录用户所接收到的评论列表
*
* @param count
* 单页返回的记录条数，默认为50。
* @param page
* 返回结果的页码，默认为1。
* @param filter_by_author
* 作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0。
* @param filter_by_source
* 来源筛选类型，0：全部、1：来自微博的评论、2：来自微群的评论，默认为0。
* @return list of Comment
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.1
* @see http://open.weibo.com/wiki/2/comments/to_me
* @since JDK 1.5
*/
public CommentPager getCommentToMe(Paging page, Integer filter_by_source, Integer filter_by_author)
throws WeiboException {
return new CommentPager((client.get(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_TO_ME),
new PostParameter[] {new PostParameter("filter_by_source", filter_by_source.toString()),
new PostParameter("filter_by_author", filter_by_author.toString())},
page, accessToken)));
}
/**
* 获取当前登录用户所接收到的评论列表
*
* @param map
* 参数列表
* @return
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.2
* @see http://open.weibo.com/wiki/2/comments/to_me
* @since JDK 1.5
*/
public CommentPager getCommentToMe(Map map) throws WeiboException {
PostParameter[] parList = ArrayUtils.mapToArray(map);
return new CommentPager(
(client.get(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_TO_ME), parList, accessToken)));
}
/**
* 获取当前登录用户的最新评论包括接收到的与发出的
*
* @return list of Comment
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.1
* @see http://open.weibo.com/wiki/2/comments/timeline
* @since JDK 1.5
*/
public CommentPager getCommentTimeline() throws WeiboException {
return new CommentPager((client.get(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_TIMELINE), accessToken)));
}
/**
* 获取当前登录用户的最新评论包括接收到的与发出的
*
* @param count
* 单页返回的记录条数，默认为50。
* @param page
* 返回结果的页码，默认为1。
* @return list of Comment
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.1
* @see http://open.weibo.com/wiki/2/comments/timeline
* @since JDK 1.5
*/
public CommentPager getCommentTimeline(Paging page) throws WeiboException {
return new CommentPager(
(client.get(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_TIMELINE), null, page, accessToken)));
}
/**
* 获取当前登录用户的最新评论包括接收到的与发出的
*
* @param map
* 参数列表
* @return
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.2
* @see http://open.weibo.com/wiki/2/comments/timeline
* @since JDK 1.5
*/
public CommentPager getCommentTimeline(Map map) throws WeiboException {
PostParameter[] parList = ArrayUtils.mapToArray(map);
return new CommentPager(
(client.get(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_TIMELINE), parList, accessToken)));
}
/**
* 获取最新的提到当前登录用户的评论，即@我的评论
*
* @return list of Comment
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.1
* @see http://open.weibo.com/wiki/2/comments/mentions
* @since JDK 1.5
*/
public CommentPager getCommentMentions() throws WeiboException {
return new CommentPager((client.get(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_MENTIONS), accessToken)));
}
/**
* 获取最新的提到当前登录用户的评论，即@我的评论
*
* @param count
* 单页返回的记录条数，默认为50。
* @param page
* 返回结果的页码，默认为1。
* @param filter_by_author
* 作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0。
* @param filter_by_source
* 来源筛选类型，0：全部、1：来自微博的评论、2：来自微群的评论，默认为0。
* @return list of Comment
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.1
* @see http://open.weibo.com/wiki/2/comments/mentions
* @since JDK 1.5
*/
public CommentPager getCommentMentions(Paging page, Integer filter_by_source, Integer filter_by_author)
throws WeiboException {
return new CommentPager((client.get(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_MENTIONS),
new PostParameter[] {new PostParameter("filter_by_source", filter_by_source.toString()),
new PostParameter("filter_by_author", filter_by_author.toString())},
page, accessToken)));
}
/**
* 获取最新的提到当前登录用户的评论，即@我的评论
*
* @param map
* 参数列表
* @return
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.2
* @see http://open.weibo.com/wiki/2/comments/mentions
* @since JDK 1.5
*/
public CommentPager getCommentMentions(Map map) throws WeiboException {
PostParameter[] parList = ArrayUtils.mapToArray(map);
return new CommentPager(
(client.get(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_MENTIONS), parList, accessToken)));
}
/**
* 根据评论ID批量返回评论信息
*
* @param cids
* 需要查询的批量评论ID，用半角逗号分隔，最大50
* @return list of Comment
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.1
* @see http://open.weibo.com/wiki/2/comments/show_batch
* @since JDK 1.5
*/
public List getCommentShowBatch(String cids) throws WeiboException {
return WeiboResponse.buildList(client.get(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_SHOW_BATCH),
new PostParameter[] {new PostParameter("cids", cids)}, accessToken), Comment.class);
}
/**
* 对一条微博进行评论
*
* @param comment
* 评论内容，必须做URLencode，内容不超过140个汉字
* @param id
* 需要评论的微博ID
* @return Comment
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.1
* @see http://open.weibo.com/wiki/2/comments/create
* @since JDK 1.5
*/
public Comment createComment(String comment, String id) throws WeiboException {
return new Comment(client.post(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_CREATE),
new PostParameter[] {new PostParameter("comment", comment), new PostParameter("id", id)}, accessToken));
}
/**
* 对一条微博进行评论
*
* @param comment
* 评论内容，必须做URLencode，内容不超过140个汉字
* @param id
* 需要评论的微博ID
* @param comment_ori
* 当评论转发微博时，是否评论给原微博，0：否、1：是，默认为0。
* @return Comment
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.1
* @see http://open.weibo.com/wiki/2/comments/create
* @since JDK 1.5
*/
public Comment createComment(String comment, String id, Integer comment_ori) throws WeiboException {
return new Comment(client.post(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_CREATE),
new PostParameter[] {new PostParameter("comment", comment), new PostParameter("id", id),
new PostParameter("comment_ori", comment_ori.toString())},
accessToken));
}
/**
* 对一条微博进行评论
*
* @param map
* 参数列表
* @return
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.2
* @see http://open.weibo.com/wiki/2/comments/create
* @since JDK 1.5
*/
public Comment createComment(Map map) throws WeiboException {
PostParameter[] parList = ArrayUtils.mapToArray(map);
return new Comment(client.post(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_CREATE), parList, accessToken));
}
/**
* 回复一条评论
*
* @param comment
* 评论内容，必须做URLencode，内容不超过140个汉字
*
* @param cid
* 需要回复的评论ID
* @param id
* 需要评论的微博ID
* @return Comment
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.1
* @see http://open.weibo.com/wiki/2/comments/reply
* @since JDK 1.5
*/
public Comment replyComment(String cid, String id, String comment) throws WeiboException {
return new Comment(client.post(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_REPLY), new PostParameter[] {
new PostParameter("cid", cid), new PostParameter("id", id), new PostParameter("comment", comment)},
accessToken));
}
/**
* 回复一条评论
*
* @param comment
* 评论内容，必须做URLencode，内容不超过140个汉字
* @param cid
* 需要回复的评论ID
* @param id
* 需要评论的微博ID
* @param without_mention
* 回复中是否自动加入“回复@用户名”，0：是、1：否，默认为0。
* @param comment_ori
* 当评论转发微博时，是否评论给原微博，0：否、1：是，默认为0。
* @return Comment
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.1
* @see http://open.weibo.com/wiki/2/comments/reply
* @since JDK 1.5
*/
public Comment replyComment(String cid, String id, String comment, Integer without_mention, Integer comment_ori)
throws WeiboException {
return new Comment(client.post(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_REPLY),
new PostParameter[] {new PostParameter("comment", comment), new PostParameter("id", id),
new PostParameter("cid", cid), new PostParameter("without_mention", without_mention.toString()),
new PostParameter("comment_ori", comment_ori.toString())},
accessToken));
}
/**
* 回复一条评论
*
* @param map
* 参数列表
* @return
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.2
* @see http://open.weibo.com/wiki/2/comments/reply
* @since JDK 1.5
*/
public Comment replyComment(Map map) throws WeiboException {
PostParameter[] parList = ArrayUtils.mapToArray(map);
return new Comment(client.post(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_REPLY), parList, accessToken));
}
/**
* 删除一条评论
*
* @param cid
* 要删除的评论ID，只能删除登录用户自己发布的评论
* @return Comment
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.1
* @see http://open.weibo.com/wiki/2/comments/destroy
* @since JDK 1.5
*/
public Comment destroyComment(String cid) throws WeiboException {
return new Comment(client.post(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_DESTROY),
new PostParameter[] {new PostParameter("cid", cid)}, accessToken));
}
/**
* 根据评论ID批量删除评论
*
* @param ids
* 需要删除的评论ID，用半角逗号隔开，最多20个
* @return list of Comment
* @throws WeiboException
* when Weibo service or network is unavailable
* @version weibo4j-V2 1.0.1
* @see http://open.weibo.com/wiki/2/comments/destroy_batch
* @since JDK 1.5
*/
public List destoryCommentBatch(String cids) throws WeiboException {
return WeiboResponse.buildList(client.post(WeiboConfigs.getApiUrl(WeiboConfigs.COMMENTS_DESTROY_BATCH),
new PostParameter[] {new PostParameter("cids", cids)}, accessToken), Comment.class);
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy