当前位置: 代码迷 >> Android >> 腾讯微博java(android)sdk时间线api详细引见
  详细解决方案

腾讯微博java(android)sdk时间线api详细引见

热度:96   发布时间:2016-05-01 19:31:30.0
腾讯微博java(android)sdk时间线api详细介绍

本文主要介绍腾讯微博android sdk中时间线有关的20个接口,以及正常获取及翻页的使用的示例代码部分特例

注意:以下所有的api示例代码都需要先新建QqTSdkService类对象qqTSdkService并初始化,见sdk使用总介绍


1、20个接口介绍

这20个接口包含了腾讯微博四部分api

1.1、时间线中的除statuses/ht_timeline_ext(话题时间线)以外的15个api

1.2、私信相关中的收件箱、发件箱两个api

1.3、数据收藏中的收藏的微博列表和获取已订阅话题列表两个api

1.4、微博相关中的获取单条微博的转发或点评列表api

对应函数图如下(其中getTimeLineCommon为公用函数):

2、示例代码

由于这20个接口类似,仅以主页时间线(getHomeTL)为例,对于特殊接口再加以补充

2.1 ?函数形式

这20个接口同样都有三种返回结果即字符串、List<QqTStatus>QqTResponse,可根据需要调用

以主页时间线为例

public String getHomeTLStr(QqTTimelinePara qqTTimelinePara);public List<QqTStatus> getHomeTL(QqTTimelinePara qqTTimelinePara);public QqTResponse getHomeTLRes(QqTTimelinePara qqTTimelinePara);

getHomeTLStr返回整个结果的字符串,可以通过qqTTimelinePara.setFormat定义以xml还是json形式返回

getHomeTL将返回的json结果串中微博列表转换为QqTStatus list

getHomeTLRes返回QqTResponse,QqTResponse是先得到json串的结果,然后转换为QqTResponse对象

其中包含返回结果中各个字段含义。data字段为getHomeTL返回的微博list。

其他时间线api类似,参考腾讯微博api wiki对应api的参数,设置qqTTimelinePara即可

?

2.2 参数意义

对于各参数意义同腾讯微博时间线api参数,通过QqTTimelinePara传入,QqTTimelinePara各参数意义如下

?

2.3、不同返回结果调用示例

2.3.1 字符串形式返回

    public void testGetHomeTLStr() {        QqTTimelinePara qqTTimelinePara = new QqTTimelinePara();        /** 设置返回结果格式 **/        qqTTimelinePara.setFormat(QqTConstant.VALUE_FORMAT_XML);        /** 设置分页标识 **/        qqTTimelinePara.setPageFlag(0);        /** 设置起始时间 **/        qqTTimelinePara.setPageTime(0);        /** 每次请求记录的条数 **/        qqTTimelinePara.setPageReqNum(QqTConstant.VALUE_PAGE_REQ_NUM);        /** 可以设置拉取类型,可取值QqTConstant中VALUE_STATUS_TYPE_TL_…,这里取原创发表 **/        qqTTimelinePara.setStatusType(QqTConstant.VALUE_STATUS_TYPE_TL_ORIGINAL);        /** 可以设置微博内容类型,可取值QqTConstant中VALUE_CONTENT_TYPE_TL…,这里取音乐 **/        qqTTimelinePara.setContentType(QqTConstant.VALUE_CONTENT_TYPE_TL_MUSIC);        String homeStr = qqTSdkService.getHomeTLStr(qqTTimelinePara);        assertTrue(homeStr != null);    }
?

2.3.2?List<QqTStatus>形式返回

    public void testGetHomeTL() {        QqTTimelinePara qqTTimelinePara = new QqTTimelinePara();        /** 设置分页标识 **/        qqTTimelinePara.setPageFlag(0);        /** 设置起始时间 **/        qqTTimelinePara.setPageTime(0);        /** 每次请求记录的条数 **/        qqTTimelinePara.setPageReqNum(QqTConstant.VALUE_PAGE_REQ_NUM);        /** 可以设置拉取类型,可取值QqTConstant中VALUE_STATUS_TYPE_TL_… **/        qqTTimelinePara.setStatusType(QqTConstant.VALUE_STATUS_TYPE_TL_ALL);        /** 可以设置微博内容类型,可取值QqTConstant中VALUE_CONTENT_TYPE_TL… **/        qqTTimelinePara.setContentType(QqTConstant.VALUE_CONTENT_TYPE_TL_ALL);        List<QqTStatus> qqTStatusList = qqTSdkService.getHomeTL(qqTTimelinePara);        assertTrue(qqTStatusList != null);    }

2.3.3 QqTResponse形式返回

    public void testGetHomeTLRes() {        QqTTimelinePara qqTTimelinePara = new QqTTimelinePara();        /** 设置分页标识 **/        qqTTimelinePara.setPageFlag(0);        /** 设置起始时间 **/        qqTTimelinePara.setPageTime(0);        /** 每次请求记录的条数 **/        qqTTimelinePara.setPageReqNum(QqTConstant.VALUE_PAGE_REQ_NUM);        /** 可以设置拉取类型,可取值QqTConstant中VALUE_STATUS_TYPE_TL_… **/        qqTTimelinePara.setStatusType(QqTConstant.VALUE_STATUS_TYPE_TL_ALL);        /** 可以设置微博内容类型,可取值QqTConstant中VALUE_CONTENT_TYPE_TL… **/        qqTTimelinePara.setContentType(QqTConstant.VALUE_CONTENT_TYPE_TL_ALL);        QqTResponse qqTResponse = qqTSdkService.getHomeTLRes(qqTTimelinePara);        assertTrue(qqTResponse != null);    }

?

2.4 翻页

需要setPageFlag、setPageTime以及setLastId,代码如下:

        QqTTimelinePara qqTTimelinePara = new QqTTimelinePara();        /** 设置分页标识 **/        qqTTimelinePara.setPageFlag(0);        /** 设置起始时间 **/        qqTTimelinePara.setPageTime(0);        /** 每次请求记录的条数 **/        qqTTimelinePara.setPageReqNum(QqTConstant.VALUE_PAGE_REQ_NUM);        /** 可以设置拉取类型,可取值QqTConstant中VALUE_STATUS_TYPE_TL_… **/        qqTTimelinePara.setStatusType(QqTConstant.VALUE_STATUS_TYPE_TL_ALL);        /** 可以设置微博内容类型,可取值QqTConstant中VALUE_CONTENT_TYPE_TL… **/        qqTTimelinePara.setContentType(QqTConstant.VALUE_CONTENT_TYPE_TL_ALL);        List<QqTStatus> qqTStatusList = qqTSdkService.getHomeTL(qqTTimelinePara);        /** 第二页 **/        if (qqTStatusList.size() >= qqTTimelinePara.getPageReqNum()            && qqTStatusList.get(qqTStatusList.size() - 1) != null) {            qqTTimelinePara.setPageFlag(QqTConstant.VALUE_NEXT_PAGE);            qqTTimelinePara.setPageTime(qqTStatusList.get(qqTStatusList.size() - 1).getTime());            qqTTimelinePara.setLastId(qqTStatusList.get(qqTStatusList.size() - 1).getStatusId());            List<QqTStatus> nextPageQqTStatusList = qqTSdkService.getHomeTL(qqTTimelinePara);        }

对于getHomeTLRes返回的结果QqTResponse,只需要取出其中的data转换为QqTListData类型,再得到info,从中得到上次最后一条微博信息传入即可

?

其他时间线api翻页可能需要传入不同的参数,具体参考腾讯微博api wiki对应api的参数,设置qqTTimelinePara即可

?

3、特例

关于获取单条微博的转发或点评列表的api为getStatusCommentsCommon,该api被三个函数调用,如下:

分别表示得到某条微博的评论、评论和转发、转发信息。以获得某条微博的评论列表(getStatusComments)为例,调用如下:

    public void testGetStatusComments() {        QqTStatusInfoPara status = new QqTStatusInfoPara();        status.setStatusContent("发表一条微博用来查看评论列表啦");        QqTResponse qqTResponse = qqTSdkService.addStatusRes(status);        /** 先评论新增的微博,再获得评论列表 **/        if (qqTResponse.getIsOk() && qqTResponse.getData() != null) {            int commentCount = 2;            for (int i = 1; i <= commentCount; i++) {                /** 设置评论的微博id **/                status.setSourceId(((QqTIdAndTime)qqTResponse.getData()).getId());                status.setStatusContent("评论列表评论微博啦" + i);                qqTSdkService.comment(status);            }            /** 获得评论列表 **/            QqTTimelinePara qqTTimelinePara = new QqTTimelinePara();            qqTTimelinePara.setPageFlag(0);            qqTTimelinePara.setPageTime(0);            qqTTimelinePara.setPageReqNum(QqTConstant.VALUE_PAGE_REQ_NUM);            qqTTimelinePara.setTwitterId(0);            /** 设置微博id,表示获得该微博的评论列表 **/            qqTTimelinePara.setRootId(((QqTIdAndTime)qqTResponse.getData()).getId());            List<QqTStatus> qqTStatusList = qqTSdkService.getStatusComments(qqTTimelinePara);            assertTrue(qqTStatusList.size() == commentCount);        } else {            assertTrue(false);        }    }

上述代码主要完成发表一条微博,然后对其进行评论,最后获得评论列表

其中qqTSdkService.getStatusComments(qqTTimelinePara);为关键代码


整个sdk api使用见:http://trinea.iteye.com/blog/1299505


  相关解决方案