package com.tencent.weibo.api;
import java.util.List;
import org.apache.http.NameValuePair;
import com.tencent.weibo.beans.OAuth;
/**
* 调用Http和Https协议通讯的接口
*/
public interface RequestAPI {
/**
* 使用Get方法发送API请求
*
* @param url 远程API请求地址
* @param paramsList 参数列表
* @param oAuth OAuth鉴权信息
* @return Json 或 XML 格式的资源
* @throws Exception
* @see <a href="">腾讯微博开放平台上关于此条API的文档</a>
*/
public String getResource(String url, List<NameValuePair> paramsList, OAuth oAuth) throws Exception;
/**
* 使用Post方法发送API请求
*
* @param url 远程API请求地址
* @param paramsList 参数列表
* @param oAuth OAuth鉴权信息
* @return Json 或 XML 格式的资源
* @throws Exception
* @see <a href="">腾讯微博开放平台上关于此条API的文档</a>
*/
public String postContent(String url, List<NameValuePair> paramsList, OAuth oAuth) throws Exception;
/**
* 使用Post方法发送API请求,并上传文件
*
* @param url 远程API请求地址
* @param paramsList 参数列表
* @param files 需要上传的文件列表
* @param oAuth OAuth鉴权信息
* @return Json 或 XML 格式的资源
* @throws Exception
* @see <a href="">腾讯微博开放平台上关于此条API的文档</a>
*/
public String postFile(String url, List<NameValuePair> paramsList,
List<NameValuePair> files, OAuth oAuth) throws Exception;
/**
* 关闭连接管理器
*/
public void shutdownConnection();
}