cn.binarywang.wx.miniapp.api

接口 WxMaService

所有已知实现类:

WxMaServiceImpl

public interface WxMaService

作者:

Binary Wang

字段概要

字段

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

方法概要

限定符和类型	方法和说明
boolean	checkSignature(String timestamp, String nonce, String signature) 验证消息的确来自微信服务器.
<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，本方法线程安全.
WxMaAnalysisService	getAnalysisService() 数据分析相关查询服务
WxMaCodeService	getCodeService() 返回代码操作相关的 API
WxMaJsapiService	getJsapiService() 返回jsapi操作相关的 API服务类对象
WxMaMediaService	getMediaService() 返回素材相关接口方法的实现类对象，以方便调用其各个接口.
WxMaMsgService	getMsgService() 返回消息（客服消息和模版消息）发送接口方法实现类，以方便调用其各个接口.
WxMaQrcodeService	getQrcodeService() 返回二维码相关接口方法的实现类对象，以方便调用其各个接口.
RequestHttp	getRequestHttp() 请求http请求相关信息.
WxMaSettingService	getSettingService() 小程序修改服务器地址、成员管理 API
WxMaTemplateService	getTemplateService() 返回模板配置相关接口方法的实现类对象, 以方便调用其各个接口.
WxMaUserService	getUserService() 返回用户相关接口方法的实现类对象，以方便调用其各个接口.
WxMaConfig	getWxMaConfig() 获取WxMaConfig 对象.
boolean	imgSecCheck(File file) 校验一张图片是否含有违法违规内容.
void	initHttp() 初始化http请求对象.
WxMaJscode2SessionResult	jsCode2SessionInfo(String jsCode) 获取登录后的session信息.
String	post(String url, String postData) 当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的POST请求.
void	setMaxRetryTimes(int maxRetryTimes) 设置当微信系统响应系统繁忙时，最大重试次数.
void	setRetrySleepMillis(int retrySleepMillis) 设置当微信系统响应系统繁忙时，要等待多少 retrySleepMillis(ms) * 2^(重试次数 - 1) 再发起重试.
void	setWxMaConfig(WxMaConfig wxConfigProvider) 注入 WxMaConfig 的实现.

字段详细资料

GET_ACCESS_TOKEN_URL

static final String GET_ACCESS_TOKEN_URL

获取access_token.

另请参阅:

常量字段值

JSCODE_TO_SESSION_URL

static final String JSCODE_TO_SESSION_URL

另请参阅:

常量字段值

IMG_SEC_CHECK_URL

static final String IMG_SEC_CHECK_URL

另请参阅:

常量字段值

方法详细资料

imgSecCheck

boolean imgSecCheck(File file)
             throws WxErrorException

 校验一张图片是否含有违法违规内容.
 应用场景举例：1）图片智能鉴黄：涉及拍照的工具类应用(如美拍，识图类应用)用户拍照上传检测；电商类商品上架图片检测；媒体类用户文章里的图片检测等；2）敏感人脸识别：用户头像；媒体类用户文章里的图片检测；社交类用户上传的图片检测等。频率限制：单个 appId 调用上限为 1000 次/分钟，100,000 次/天
 详情请见: https://developers.weixin.qq.com/miniprogram/dev/api/imgSecCheck.html
 

抛出:

WxErrorException

jsCode2SessionInfo

WxMaJscode2SessionResult jsCode2SessionInfo(String jsCode)
                                     throws WxErrorException

获取登录后的session信息.

参数:

jsCode - 登录时获取的 code

抛出:

WxErrorException

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

getTemplateService

WxMaTemplateService getTemplateService()

返回模板配置相关接口方法的实现类对象, 以方便调用其各个接口.

返回:

WxMaTemplateService

getAnalysisService

WxMaAnalysisService getAnalysisService()

数据分析相关查询服务

返回:

WxMaAnalysisService

getCodeService

WxMaCodeService getCodeService()

返回代码操作相关的 API

返回:

WxMaCodeService

getJsapiService

WxMaJsapiService getJsapiService()

返回jsapi操作相关的 API服务类对象

返回:

WxMaJsapiService

getSettingService

WxMaSettingService getSettingService()

小程序修改服务器地址、成员管理 API

返回:

WxMaSettingService

initHttp

void initHttp()

初始化http请求对象.

getRequestHttp

RequestHttp getRequestHttp()

请求http请求相关信息.