weibo4j.Suggestion 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
基于微博开放平台官网的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 weibo4j.model.Paging;
import weibo4j.model.PostParameter;
import weibo4j.model.StatusPager;
import weibo4j.model.User;
import weibo4j.model.UserPager;
import weibo4j.model.WeiboException;
import weibo4j.org.json.JSONArray;
import weibo4j.org.json.JSONObject;
import weibo4j.util.WeiboConfig;

public class Suggestion extends Weibo {

    private static final long serialVersionUID = 1861364044145921824L;

    public Suggestion(String access_token) {
        this.accessToken = access_token;
    }

    // ---------------------------------推荐接口---------------------------------------------------
    /**
     * 返回系统推荐的热门用户列表
     * 
     * @return list of the users
     * @throws WeiboException
     *             when Weibo service or network is unavailable
     * @version weibo4j-V2 1.0.1
     * @see http://open.weibo.com/wiki/2/suggestions/users/hot
     * @since JDK 1.5
     */

    public JSONArray suggestionsUsersHot() throws WeiboException {
        return client.get(WeiboConfig.getOpenAPIBaseURL() + "suggestions/users/hot.json", accessToken).asJSONArray();
    }

    public JSONArray suggestionsUsersHot(String category) throws WeiboException {
        return client.get(WeiboConfig.getOpenAPIBaseURL() + "suggestions/users/hot.json",
            new PostParameter[] {new PostParameter("category", category)}, accessToken).asJSONArray();
    }

    /**
     * 获取用户可能感兴趣的人
     * 
     * @return list of the user's id
     * @throws WeiboException
     *             when Weibo service or network is unavailable
     * @version weibo4j-V2 1.0.1
     * @see http://open.weibo.com/wiki/2/suggestions/users/may_interested
     * @since JDK 1.5
     */
    public JSONArray suggestionsUsersMayInterested() throws WeiboException {
        return client.get(WeiboConfig.getOpenAPIBaseURL() + "suggestions/users/may_interested.json", accessToken)
            .asJSONArray();
    }

    public JSONArray suggestionsUsersMayInterested(int count, int page) throws WeiboException {
        return client
            .get(WeiboConfig.getOpenAPIBaseURL() + "suggestions/users/may_interested.json",
                new PostParameter[] {new PostParameter("count", count), new PostParameter("page", page)}, accessToken)
            .asJSONArray();
    }

    /**
     * 根据一段微博正文推荐相关微博用户
     * 
     * @return list of the users
     * @throws WeiboException
     *             when Weibo service or network is unavailable
     * @version weibo4j-V2 1.0.1
     * @see http://open.weibo.com/wiki/2/suggestions/users/by_status
     * @since JDK 1.5
     */
    public UserPager suggestionsUsersByStatus(String content) throws WeiboException {
        return new UserPager(client.get(WeiboConfig.getOpenAPIBaseURL() + "suggestions/users/by_status.json",
            new PostParameter[] {new PostParameter("content", content)}, accessToken));
    }

    public UserPager suggestionsUsersByStatus(String content, int num) throws WeiboException {
        return new UserPager(client.get(WeiboConfig.getOpenAPIBaseURL() + "suggestions/users/by_status.json",
            new PostParameter[] {new PostParameter("content", content), new PostParameter("num", num)}, accessToken));
    }

    /**
     * 当前登录用户的friends_timeline微博按兴趣推荐排序
     * 
     * @param section
     *            排序时间段，距现在n秒内的微博参加排序，最长支持24小时
     * @return
     * @throws WeiboException
     *             when Weibo service or network is unavailable
     * @version weibo4j-V2 1.0.2
     * @see http://open.weibo.com/wiki/2/suggestions/statuses/reorder
     * @since JDK 1.5
     */
    public StatusPager suggestionsStatusesReorder(int section) throws WeiboException {
        return new StatusPager(client.get(WeiboConfig.getOpenAPIBaseURL() + "suggestions/statuses/reorder.json",
            new PostParameter[] {new PostParameter("section", section)}, accessToken));
    }

    public StatusPager suggestionsStatusesReorder(int section, int count, Paging page) throws WeiboException {
        return new StatusPager(client.get(WeiboConfig.getOpenAPIBaseURL() + "suggestions/statuses/reorder.json",
            new PostParameter[] {new PostParameter("section", section), new PostParameter("count", count)}, page,
            accessToken));
    }

    /**
     * 当前登录用户的friends_timeline微博按兴趣推荐排序的微博ID
     * 
     * @param section
     *            排序时间段，距现在n秒内的微博参加排序，最长支持24小时
     * @return
     * @throws WeiboException
     *             when Weibo service or network is unavailable
     * @version weibo4j-V2 1.0.2
     * @see http://open.weibo.com/wiki/2/suggestions/statuses/reorder/ids
     * @since JDK 1.5
     */
    public JSONObject suggestionStatusesReorderIds(int section) throws WeiboException {
        return client.get(WeiboConfig.getOpenAPIBaseURL() + "suggestions/statuses/reorder/ids.json",
            new PostParameter[] {new PostParameter("section", section)}, accessToken).asJSONObject();
    }

    public JSONObject suggestionStatusesReorderIds(int section, int count, Paging page) throws WeiboException {
        return client.get(WeiboConfig.getOpenAPIBaseURL() + "suggestions/statuses/reorder/ids.json",
            new PostParameter[] {new PostParameter("section", section), new PostParameter("count", count)}, page,
            accessToken).asJSONObject();
    }

    /**
     * 返回系统推荐的热门收藏
     * 
     * @return list of the status
     * @throws WeiboException
     *             when Weibo service or network is unavailable
     * @version weibo4j-V2 1.0.1
     * @see http://open.weibo.com/wiki/2/suggestions/favorites/hot
     * @since JDK 1.5
     */
    public JSONArray suggestionsFavoritesHot() throws WeiboException {
        return client.get(WeiboConfig.getOpenAPIBaseURL() + "suggestions/favorites/hot.json", accessToken)
            .asJSONArray();
    }

    public JSONArray suggestionsFavoritesHot(int page, int count) throws WeiboException {
        return client
            .get(WeiboConfig.getOpenAPIBaseURL() + "suggestions/favorites/hot.json",
                new PostParameter[] {new PostParameter("page", page), new PostParameter("count", count)}, accessToken)
            .asJSONArray();
    }

    /**
     * 把某人标识为不感兴趣的人
     * 
     * @return user
     * @throws WeiboException
     *             when Weibo service or network is unavailable
     * @version weibo4j-V2 1.0.1
     * @see http://open.weibo.com/wiki/2/suggestions/users/not_interested
     * @since JDK 1.5
     */
    public User suggestionsUsersNotInterested(String uid) throws WeiboException {
        return new User(client.post(WeiboConfig.getOpenAPIBaseURL() + "suggestions/users/not_interested.json",
            new PostParameter[] {new PostParameter("uid", uid)}, accessToken).asJSONObject());
    }
}