me.chanjar.weixin.channel.api

接口 BaseWxChannelService

所有超级接口:

WxService

所有已知子接口:

WxChannelService

所有已知实现类:

BaseWxChannelServiceImpl, WxChannelServiceHttpClientImpl, WxChannelServiceImpl, WxChannelServiceOkHttpImpl

public interface BaseWxChannelService
extends WxService

The interface Wx Channel service

作者:

Zeyes

方法概要

限定符和类型	方法和说明
boolean	checkSignature(String timestamp, String nonce, String signature) 验证消息的确来自微信服务器.
<T,E> T	execute(RequestExecutor<T,E> executor, String uri, E data) Service没有实现某个API的时候，可以用这个， 比WxService.get(java.lang.String, java.lang.String)和WxService.post(java.lang.String, java.lang.String)方法更灵活，可以自己构造RequestExecutor用来处理不同的参数和不同的返回类型。
<T,E> T	executeWithoutLog(RequestExecutor<T,E> executor, String uri, E data) 执行器
String	getAccessToken() 获取access_token, 不强制刷新access_token.
String	getAccessToken(boolean forceRefresh) 获取access_token，本方法线程安全.
WxChannelConfig	getConfig() WxChannelConfig对象
RequestHttp	getRequestHttp() 请求http请求相关信息.
void	initHttp() 初始化http请求对象.
void	setConfig(WxChannelConfig config) 注入 WxChannelConfig 的实现.
void	setMaxRetryTimes(int maxRetryTimes) 设置当微信系统响应系统繁忙时，最大重试次数.
void	setRetrySleepMillis(int retrySleepMillis) 设置当微信系统响应系统繁忙时，要等待多少 retrySleepMillis(ms) * 2^(重试次数 - 1) 再发起重试.

从接口继承的方法 me.chanjar.weixin.common.service.WxService

get, post, post, post, post, upload

方法详细资料

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
 

参数:

timestamp - the timestamp

nonce - the nonce

signature - the signature

返回:

the boolean

getAccessToken

String getAccessToken()
               throws WxErrorException

获取access_token, 不强制刷新access_token.

返回:

the access token

抛出:

WxErrorException - the wx error exception

另请参阅:

#getAccessToken(boolean)

getAccessToken

String getAccessToken(boolean forceRefresh)
               throws WxErrorException

 获取access_token，本方法线程安全.
 且在多线程同时刷新时只刷新一次，避免超出2000次/日的调用次数上限
 使用【稳定版接口】获取access_token时，限制【20次/日】，连续使用该模式时，请保证调用时间隔至少为30s，否则不会刷新

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

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

参数:

forceRefresh - 强制刷新

返回:

the access token

抛出:

WxErrorException - the wx error exception

execute

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

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

类型参数:

T - .

E - .

参数:

executor - 执行器

uri - 接口请求地址

data - 参数或请求数据

返回:

. t

抛出:

WxErrorException - the wx error exception

executeWithoutLog

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

执行器

类型参数:

T - .

E - .

参数:

executor - 执行器

uri - 接口请求地址

data - 参数或请求数据

返回:

T

抛出:

WxErrorException - the wx error exception

setRetrySleepMillis

void setRetrySleepMillis(int retrySleepMillis)

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

参数:

retrySleepMillis - 重试等待毫秒数

setMaxRetryTimes

void setMaxRetryTimes(int maxRetryTimes)

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

参数:

maxRetryTimes - 最大重试次数

getConfig

WxChannelConfig getConfig()

WxChannelConfig对象

返回:

WxMaConfig wx channel config

setConfig

void setConfig(WxChannelConfig config)

注入 WxChannelConfig 的实现.

参数:

config - config

initHttp

void initHttp()

初始化http请求对象.

getRequestHttp

RequestHttp getRequestHttp()

请求http请求相关信息.

返回:

. request http