cn.binarywang.wx.miniapp.api

接口 WxMaService

所有已知实现类:

WxMaServiceImpl

public interface WxMaService

作者:

Binary Wang

字段概要

字段

限定符和类型	字段和说明
static String	GET_ACCESS_TOKEN_URL 获取access_token

方法概要

限定符和类型	方法和说明
boolean	checkSignature(String timestamp, String nonce, String signature) 验证消息的确来自微信服务器 详情请见: http://mp.weixin.qq.com/wiki?
<T,E> T	execute(RequestExecutor<T,E> executor, String uri, E data) Service没有实现某个API的时候，可以用这个， 比get(java.lang.String, java.lang.String)和post(java.lang.String, java.lang.String)方法更灵活，可以自己构造RequestExecutor用来处理不同的参数和不同的返回类型。
String	get(String url, String queryParam) 当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的GET请求
String	getAccessToken() 获取access_token, 不强制刷新access_token
String	getAccessToken(boolean forceRefresh) 获取access_token，本方法线程安全 且在多线程同时刷新时只刷新一次，避免超出2000次/日的调用次数上限 另：本service的所有方法都会在access_token过期是调用此方法 程序员在非必要情况下尽量不要主动调用此方法 详情请见: http://mp.weixin.qq.com/wiki?
WxMaMediaService	getMediaService() 返回素材相关接口方法的实现类对象，以方便调用其各个接口
WxMaMsgService	getMsgService() 返回消息（客服消息和模版消息）发送接口方法实现类，以方便调用其各个接口
WxMaQrcodeService	getQrcodeService() 返回二维码相关接口方法的实现类对象，以方便调用其各个接口
RequestHttp	getRequestHttp() 请求http请求相关信息
WxMaUserService	getUserService() 返回用户相关接口方法的实现类对象，以方便调用其各个接口
WxMaConfig	getWxMaConfig() 获取WxMaConfig 对象
void	initHttp() 初始化http请求对象
String	post(String url, String postData) 当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的POST请求
void	setMaxRetryTimes(int maxRetryTimes) 设置当微信系统响应系统繁忙时，最大重试次数 默认：5次
void	setRetrySleepMillis(int retrySleepMillis) 设置当微信系统响应系统繁忙时，要等待多少 retrySleepMillis(ms) * 2^(重试次数 - 1) 再发起重试 默认：1000ms
void	setWxMaConfig(WxMaConfig wxConfigProvider) 注入 WxMaConfig 的实现

字段详细资料

GET_ACCESS_TOKEN_URL

static final String GET_ACCESS_TOKEN_URL

获取access_token

另请参阅:

常量字段值

方法详细资料

checkSignature

boolean checkSignature(String timestamp,
                       String nonce,
                       String signature)

 验证消息的确来自微信服务器
 详情请见: http://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421135319&token=&lang=zh_CN
 

getAccessToken

String getAccessToken()
               throws WxErrorException

获取access_token, 不强制刷新access_token

抛出:

WxErrorException

另请参阅:

getAccessToken(boolean)

getAccessToken

String getAccessToken(boolean forceRefresh)
               throws WxErrorException

 获取access_token，本方法线程安全
 且在多线程同时刷新时只刷新一次，避免超出2000次/日的调用次数上限

 另：本service的所有方法都会在access_token过期是调用此方法

 程序员在非必要情况下尽量不要主动调用此方法

 详情请见: http://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140183&token=&lang=zh_CN
 

参数:

forceRefresh - 强制刷新

抛出:

WxErrorException

get

String get(String url,
           String queryParam)
    throws WxErrorException

当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的GET请求

抛出:

WxErrorException

post

String post(String url,
            String postData)
     throws WxErrorException

当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的POST请求

抛出:

WxErrorException

execute

<T,E> T execute(RequestExecutor<T,E> executor,
                String uri,
                E data)
         throws WxErrorException

 Service没有实现某个API的时候，可以用这个，
 比get(java.lang.String, java.lang.String)和post(java.lang.String, java.lang.String)方法更灵活，可以自己构造RequestExecutor用来处理不同的参数和不同的返回类型。
 可以参考，MediaUploadRequestExecutor的实现方法
 

抛出:

WxErrorException

setRetrySleepMillis

void setRetrySleepMillis(int retrySleepMillis)

 设置当微信系统响应系统繁忙时，要等待多少 retrySleepMillis(ms) * 2^(重试次数 - 1) 再发起重试
 默认：1000ms
 

setMaxRetryTimes

void setMaxRetryTimes(int maxRetryTimes)

 设置当微信系统响应系统繁忙时，最大重试次数
 默认：5次
 

getWxMaConfig

WxMaConfig getWxMaConfig()

获取WxMaConfig 对象

返回:

WxMaConfig

setWxMaConfig

void setWxMaConfig(WxMaConfig wxConfigProvider)

注入 WxMaConfig 的实现

getMsgService

WxMaMsgService getMsgService()

返回消息（客服消息和模版消息）发送接口方法实现类，以方便调用其各个接口

返回:

WxMaMsgService

getMediaService

WxMaMediaService getMediaService()

返回素材相关接口方法的实现类对象，以方便调用其各个接口

返回:

WxMaMediaService

getUserService

WxMaUserService getUserService()

返回用户相关接口方法的实现类对象，以方便调用其各个接口

返回:

WxMaUserService

getQrcodeService

WxMaQrcodeService getQrcodeService()

返回二维码相关接口方法的实现类对象，以方便调用其各个接口

返回:

WxMaQrcodeService

initHttp

void initHttp()

初始化http请求对象

getRequestHttp

RequestHttp getRequestHttp()

请求http请求相关信息