WxMpService (WxJava - MP Java SDK 4.8.2.B API)

所有超级接口:

WxService

所有已知实现类:

BaseWxMpServiceImpl, WxMpServiceHttpClientImpl, WxMpServiceHttpComponentsImpl, WxMpServiceImpl, WxMpServiceJoddHttpImpl, WxMpServiceOkHttpImpl
```
public interface WxMpService
extends WxService
```
微信公众号API的Service.

作者:

chanjarster

方法概要

所有方法实例方法抽象方法已过时的方法
限定符和类型	方法和说明
`void`	`addConfigStorage(String mpId, WxMpConfigStorage configStorage)` Map里加入新的 `WxMpConfigStorage`，适用于动态添加新的微信公众号配置.
`String`	`buildQrConnectUrl(String redirectUri, String scope, String state)` 构造第三方使用网站应用授权登录的url.
`boolean`	`checkSignature(String timestamp, String nonce, String signature)` 验证消息的确来自微信服务器.
`void`	`clearQuota(String appid)` 公众号调用或第三方平台帮公众号调用对公众号的所有api调用（包括第三方帮其调用）次数进行清零.
`WxJsapiSignature`	`createJsapiSignature(String url)` 创建调用jsapi时所需要的签名.
`<T,E> T`	`execute(RequestExecutor<T,E> executor, String url, E data)` Service没有实现某个API的时候，可以用这个，比`get(me.chanjar.weixin.mp.enums.WxMpApiUrl, java.lang.String)`和`post(me.chanjar.weixin.mp.enums.WxMpApiUrl, java.lang.String)`方法更灵活，可以自己构造RequestExecutor用来处理不同的参数和不同的返回类型。
`<T,E> T`	`execute(RequestExecutor<T,E> executor, WxMpApiUrl url, E data)` Service没有实现某个API的时候，可以用这个，比`get(me.chanjar.weixin.mp.enums.WxMpApiUrl, java.lang.String)`和`post(me.chanjar.weixin.mp.enums.WxMpApiUrl, java.lang.String)`方法更灵活，可以自己构造RequestExecutor用来处理不同的参数和不同的返回类型。
`WxMpShortKeyResult`	`fetchShorten(String shortKey)` 短key解析将短key还原为长信息。
`String`	`genShorten(String longData, Integer expireSeconds)` 短key托管类似于短链API.
`String`	`get(WxMpApiUrl url, String queryParam)` 当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的GET请求.
`String`	`getAccessToken()` 获取access_token, 不强制刷新access_token.
`String`	`getAccessToken(boolean forceRefresh)` 获取access_token，本方法线程安全.
`WxMpAiOpenService`	`getAiOpenService()` 返回AI开放接口方法的实现类对象，以方便调用其各个接口.
`WxMpUserBlacklistService`	`getBlackListService()` 返回用户黑名单管理相关接口方法的实现类对象，以方便调用其各个接口.
`String[]`	`getCallbackIP()` 获取微信服务器IP地址
`WxMpCardService`	`getCardService()` 返回卡券相关接口方法的实现类对象，以方便调用其各个接口.
`WxMpCommentService`	`getCommentService()` 返回评论数据管理接口方法的实现类对象，以方便调用其各个接口.
`WxMpCurrentAutoReplyInfo`	`getCurrentAutoReplyInfo()` 获取公众号的自动回复规则.
`WxMpDataCubeService`	`getDataCubeService()` 返回数据分析统计相关接口方法的实现类对象，以方便调用其各个接口.
`WxMpDeviceService`	`getDeviceService()` 返回硬件平台相关接口方法的实现类对象，以方便调用其各个接口.
`WxMpDraftService`	`getDraftService()` 返回草稿箱相关接口
`WxMpFreePublishService`	`getFreePublishService()` 返回发布能力接口
`WxMpGuideBuyerService`	`getGuideBuyerService()` 获取微信导购买家服务接口
`WxMpGuideMassedJobService`	`getGuideMassedJobService()` 获取微信导购批量任务服务接口
`WxMpGuideMaterialService`	`getGuideMaterialService()` 获取微信导购素材服务接口
`WxMpGuideService`	`getGuideService()` 获取微信导购服务接口
`WxMpGuideTagService`	`getGuideTagService()` 获取微信导购标签服务接口
`WxImgProcService`	`getImgProcService()` 返回图像处理接口的实现类对象，以方便调用其各个接口.
`String`	`getJsapiTicket()` 获得jsapi_ticket,不强制刷新jsapi_ticket.
`String`	`getJsapiTicket(boolean forceRefresh)` 获得jsapi_ticket.
`WxMpKefuService`	`getKefuService()` 返回客服接口方法实现类，以方便调用其各个接口.
`WxMpMarketingService`	`getMarketingService()` 返回营销相关接口方法的实现类对象，以方便调用其各个接口.
`WxMpMassMessageService`	`getMassMessageService()` 返回群发消息相关接口方法的实现类对象，以方便调用其各个接口.
`WxMpMaterialService`	`getMaterialService()` 返回素材相关接口方法的实现类对象，以方便调用其各个接口.
`WxMpMemberCardService`	`getMemberCardService()` 返回会员卡相关接口方法的实现类对象，以方便调用其各个接口.
`WxMpMenuService`	`getMenuService()` 返回菜单相关接口方法的实现类对象，以方便调用其各个接口.
`WxMpMerchantInvoiceService`	`getMerchantInvoiceService()` 获取微信商户发票服务接口
`WxOAuth2Service`	`getOAuth2Service()` 获取OAuth2服务接口
`WxOcrService`	`getOcrService()` 返回OCR接口方法的实现类对象，以方便调用其各个接口.
`WxMpQrcodeService`	`getQrcodeService()` 返回二维码相关接口方法的实现类对象，以方便调用其各个接口.
`WxMpReimburseInvoiceService`	`getReimburseInvoiceService()` 返回电子发票报销方相关接口
`RequestHttp<?,?>`	`getRequestHttp()` 获取RequestHttp对象.
`WxMpShakeService`	`getShakeService()` 返回摇一摇周边相关接口方法的实现类对象，以方便调用其各个接口.
`WxMpStoreService`	`getStoreService()` 返回门店管理相关接口方法的实现类对象，以方便调用其各个接口.
`WxMpSubscribeMsgService`	`getSubscribeMsgService()` 返回一次性订阅消息相关接口方法的实现类对象，以方便调用其各个接口.
`WxMpTemplateMsgService`	`getTemplateMsgService()` 返回模板消息相关接口方法的实现类对象，以方便调用其各个接口.
`String`	`getTicket(TicketType ticketType)` 获得ticket,不强制刷新ticket.
`String`	`getTicket(TicketType ticketType, boolean forceRefresh)` 获得ticket.
`WxMpUserService`	`getUserService()` 返回用户相关接口方法的实现类对象，以方便调用其各个接口.
`WxMpUserTagService`	`getUserTagService()` 返回用户标签相关接口方法的实现类对象，以方便调用其各个接口.
`WxMpWifiService`	`getWifiService()` 返回WIFI接口方法的实现类对象，以方便调用其各个接口.
`WxMpConfigStorage`	`getWxMpConfigStorage()` 获取WxMpConfigStorage 对象.
`void`	`initHttp()` 初始化http请求对象.
`WxNetCheckResult`	`netCheck(String action, String operator)` 网络检测为了帮助开发者排查回调连接失败的问题，提供这个网络检测的API。
`String`	`post(WxMpApiUrl url, com.google.gson.JsonObject jsonObject)` 当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的POST请求.
`String`	`post(WxMpApiUrl url, Object obj)` 当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的POST请求.
`String`	`post(WxMpApiUrl url, String postData)` 当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的POST请求.
`void`	`removeConfigStorage(String mpId)` 从 Map中移除 `mpId` 所对应的 `WxMpConfigStorage`，适用于动态移除微信公众号配置.
`WxMpSemanticQueryResult`	`semanticQuery(WxMpSemanticQuery semanticQuery)` 语义查询接口.
`void`	`setAiOpenService(WxMpAiOpenService aiOpenService)` 设置AI开放服务接口
`void`	`setBlackListService(WxMpUserBlacklistService blackListService)` 设置用户黑名单服务接口
`void`	`setCardService(WxMpCardService cardService)` 设置卡券服务接口
`void`	`setCommentService(WxMpCommentService commentService)` 设置评论数据管理服务接口
`void`	`setDataCubeService(WxMpDataCubeService dataCubeService)` 设置数据分析服务接口
`void`	`setDeviceService(WxMpDeviceService deviceService)` 设置硬件平台服务接口
`void`	`setDraftService(WxMpDraftService draftService)` 设置草稿箱服务接口
`void`	`setFreePublishService(WxMpFreePublishService freePublishService)` 设置发布能力服务接口
`void`	`setGuideBuyerService(WxMpGuideBuyerService guideBuyerService)` 设置微信导购买家服务接口
`void`	`setGuideMassedJobService(WxMpGuideMassedJobService guideMassedJobService)` 设置微信导购批量任务服务接口
`void`	`setGuideMaterialService(WxMpGuideMaterialService guideMaterialService)` 设置微信导购素材服务接口
`void`	`setGuideService(WxMpGuideService guideService)` 设置微信导购服务接口
`void`	`setGuideTagService(WxMpGuideTagService guideTagService)` 设置微信导购标签服务接口
`void`	`setImgProcService(WxImgProcService imgProcService)` 设置图像处理服务接口
`void`	`setKefuService(WxMpKefuService kefuService)` 设置客服服务接口
`void`	`setMarketingService(WxMpMarketingService marketingService)` 设置营销服务接口
`void`	`setMassMessageService(WxMpMassMessageService massMessageService)` 设置群发消息服务接口
`void`	`setMaterialService(WxMpMaterialService materialService)` 设置素材服务接口
`void`	`setMaxRetryTimes(int maxRetryTimes)` 设置当微信系统响应系统繁忙时，最大重试次数.
`void`	`setMemberCardService(WxMpMemberCardService memberCardService)` 设置会员卡服务接口
`void`	`setMenuService(WxMpMenuService menuService)` 设置菜单服务接口
`void`	`setMerchantInvoiceService(WxMpMerchantInvoiceService merchantInvoiceService)` 设置微信商户发票服务接口
`void`	`setMultiConfigStorages(Map<String,WxMpConfigStorage> configStorages)` 注入多个 `WxMpConfigStorage` 的实现.
`void`	`setMultiConfigStorages(Map<String,WxMpConfigStorage> configStorages, String defaultMpId)` 注入多个 `WxMpConfigStorage` 的实现.
`void`	`setOAuth2Service(WxOAuth2Service oAuth2Service)` 设置OAuth2服务接口
`void`	`setOcrService(WxOcrService ocrService)` 设置OCR服务接口
`void`	`setQrcodeService(WxMpQrcodeService qrcodeService)` 设置二维码服务接口
`void`	`setReimburseInvoiceService(WxMpReimburseInvoiceService reimburseInvoiceService)` 设置电子发票报销方服务接口
`void`	`setRetrySleepMillis(int retrySleepMillis)` 设置当微信系统响应系统繁忙时，要等待多少 retrySleepMillis(ms) * 2^(重试次数 - 1) 再发起重试.
`void`	`setShakeService(WxMpShakeService shakeService)` 设置摇一摇周边服务接口
`void`	`setStoreService(WxMpStoreService storeService)` 设置门店服务接口
`void`	`setTemplateMsgService(WxMpTemplateMsgService templateMsgService)` 设置模板消息服务接口
`void`	`setUserService(WxMpUserService userService)` 设置用户服务接口
`void`	`setUserTagService(WxMpUserTagService userTagService)` 设置用户标签服务接口
`void`	`setWxMpConfigStorage(WxMpConfigStorage wxConfigProvider)` 设置 `WxMpConfigStorage` 的实现.
`String`	`shortUrl(String longUrl)` 已过时。请使用 `genShorten(String, Integer)` 方法
`boolean`	`switchover(String mpId)` 进行相应的公众号切换.
`boolean`	`switchover(String mpId, java.util.function.Function<String,WxMpConfigStorage> func)` 进行相应的公众号切换，支持自定义配置获取函数.
`WxMpService`	`switchoverTo(String mpId)` 进行相应的公众号切换.
`WxMpService`	`switchoverTo(String mpId, java.util.function.Function<String,WxMpConfigStorage> func)` 进行相应的公众号切换，支持自定义配置获取函数.

从接口继承的方法 me.chanjar.weixin.common.service.WxService
get, post, post, post, post, upload

- 方法详细资料
  - genShorten
```
String genShorten(String longData,
                  Integer expireSeconds)
           throws WxErrorException
```
```
 短key托管 类似于短链API.
 详情请见: https://developers.weixin.qq.com/doc/offiaccount/Account_Management/KEY_Shortener.html
 
```
    参数:
    
    longData - 需要转换的长信息，不超过4KB
    
    expireSeconds - 短key有效期(单位秒)，最大值为2592000（即30天），默认为2592000(30天)
    
    返回:
    
    shortKey 短key，15字节，base62编码(0-9/a-z/A-Z)
    
    抛出:
    
    WxErrorException - 微信API调用异常
  - fetchShorten
```
WxMpShortKeyResult fetchShorten(String shortKey)
                         throws WxErrorException
```
```
 短key解析 将短key还原为长信息。
 详情请见: https://developers.weixin.qq.com/doc/offiaccount/Account_Management/KEY_Shortener.html
 
```
    参数:
    
    shortKey - 短key，15字节，base62编码(0-9/a-z/A-Z)
    
    返回:
    
    WxMpShortKeyResult 解析结果，包含原始长信息
    
    抛出:
    
    WxErrorException - 微信API调用异常
  - checkSignature
```
boolean checkSignature(String timestamp,
                       String nonce,
                       String signature)
```
    验证消息的确来自微信服务器.
    详情请见: <a href="http://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421135319&token=&lang=zh_CN">接入指南</a>
    
    参数:
    
    timestamp - 时间戳，字符串格式
    
    nonce - 随机串，字符串格式
    
    signature - 签名，字符串格式
    
    返回:
    
    是否验证通过，true表示验证通过，false表示验证失败
  - getAccessToken
```
String getAccessToken()
               throws WxErrorException
```
    获取access_token, 不强制刷新access_token.
    
    返回:
    
    token access token，字符串格式
    
    抛出:
    
    WxErrorException - 微信API调用异常
    
    另请参阅:
    
    获取access_token，可选择是否强制刷新
  - getAccessToken
```
String getAccessToken(boolean forceRefresh)
               throws WxErrorException
```
    获取access_token，本方法线程安全.
    且在多线程同时刷新时只刷新一次，避免超出2000次/日的调用次数上限
    
    另：本service的所有方法都会在access_token过期时调用此方法
    
    程序员在非必要情况下尽量不要主动调用此方法
    
    详情请见: <a href="http://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140183&token=&lang=zh_CN">获取access_token</a>
    
    参数:
    
    forceRefresh - 是否强制刷新，true表示强制刷新，false表示使用缓存
    
    返回:
    
    token access token，字符串格式
    
    抛出:
    
    WxErrorException - 微信API调用异常
  - getTicket
```
String getTicket(TicketType ticketType)
          throws WxErrorException
```
    获得ticket,不强制刷新ticket.
    
    参数:
    
    ticketType - ticket 类型，通过TicketType枚举指定
    
    返回:
    
    ticket ticket，字符串格式
    
    抛出:
    
    WxErrorException - 微信API调用异常
    
    另请参阅:
    
    获得ticket，可选择是否强制刷新
  - getTicket
```
String getTicket(TicketType ticketType,
                 boolean forceRefresh)
          throws WxErrorException
```
```
 获得ticket.
 获得时会检查 Token是否过期，如果过期了，那么就刷新一下，否则就什么都不干
 
```
    参数:
    
    ticketType - ticket类型，通过TicketType枚举指定
    
    forceRefresh - 强制刷新，true表示强制刷新，false表示使用缓存
    
    返回:
    
    ticket ticket，字符串格式
    
    抛出:
    
    WxErrorException - 微信API调用异常
  - getJsapiTicket
```
String getJsapiTicket()
               throws WxErrorException
```
    获得jsapi_ticket,不强制刷新jsapi_ticket.
    
    返回:
    
    jsapi ticket，字符串格式
    
    抛出:
    
    WxErrorException - 微信API调用异常
    
    另请参阅:
    
    获得jsapi_ticket，可选择是否强制刷新
  - getJsapiTicket
```
String getJsapiTicket(boolean forceRefresh)
               throws WxErrorException
```
    获得jsapi_ticket.
    获得时会检查jsapiToken是否过期，如果过期了，那么就刷新一下，否则就什么都不干
    
    详情请见：<a href="http://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421141115&token=&lang=zh_CN">JS-SDK使用权限签名算法</a>
    
    参数:
    
    forceRefresh - 强制刷新，true表示强制刷新，false表示使用缓存
    
    返回:
    
    jsapi ticket，字符串格式
    
    抛出:
    
    WxErrorException - 微信API调用异常
  - createJsapiSignature
```
WxJsapiSignature createJsapiSignature(String url)
                               throws WxErrorException
```
    创建调用jsapi时所需要的签名.
    详情请见：<a href="http://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421141115&token=&lang=zh_CN">JS-SDK使用权限签名算法</a>
    
    参数:
    
    url - 当前网页的URL，不包括#及其后面部分
    
    返回:
    
    生成的签名对象，包含签名、时间戳、随机串等信息
    
    抛出:
    
    WxErrorException - 微信API调用异常
  - shortUrl
```
@Deprecated
String shortUrl(String longUrl)
                     throws WxErrorException
```
    已过时。请使用 genShorten(String, Integer) 方法
    
    长链接转短链接接口.
    详情请见: 长链接转短链接接口
    
    参数:
    
    longUrl - 长url，需要转换的原始URL
    
    返回:
    
    生成的短地址，字符串格式
    
    抛出:
    
    WxErrorException - 微信API调用异常
  - semanticQuery
```
WxMpSemanticQueryResult semanticQuery(WxMpSemanticQuery semanticQuery)
                               throws WxErrorException
```
    语义查询接口.
    详情请见：语义理解
    
    参数:
    
    semanticQuery - 查询条件，包含查询内容、类型等信息
    
    返回:
    
    查询结果，包含语义理解的结果和建议回复
    
    抛出:
    
    WxErrorException - 微信API调用异常
  - buildQrConnectUrl
```
String buildQrConnectUrl(String redirectUri,
                         String scope,
                         String state)
```
    构造第三方使用网站应用授权登录的url.
    详情请见: <a href="https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419316505&token=&lang=zh_CN">网站应用微信登录开发指南</a>
    
    URL格式为：https://open.weixin.qq.com/connect/qrconnect?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect
    
    参数:
    
    redirectUri - 用户授权完成后的重定向链接，无需urlencode, 方法内会进行encode
    
    scope - 应用授权作用域，拥有多个作用域用逗号（,）分隔，网页应用目前仅填写snsapi_login即可
    
    state - 非必填，用于保持请求和回调的状态，授权请求后原样带回给第三方。该参数可用于防止csrf攻击（跨站请求伪造攻击），建议第三方带上该参数，可设置为简单的随机数加session进行校验
    
    返回:
    
    url 构造好的授权登录URL，字符串格式
  - getCallbackIP
```
String[] getCallbackIP()
                throws WxErrorException
```
    获取微信服务器IP地址
    
    返回:
    
    微信服务器ip地址数组，包含所有微信服务器IP地址
    
    抛出:
    
    WxErrorException - 微信API调用异常
  - netCheck
```
WxNetCheckResult netCheck(String action,
                          String operator)
                   throws WxErrorException
```
    网络检测
    为了帮助开发者排查回调连接失败的问题，提供这个网络检测的API。它可以对开发者URL做域名解析，然后对所有IP进行一次ping操作，得到丢包率和耗时。
    
    参数:
    
    action - 执行的检测动作，可选值：all（全部检测）、dns（仅域名解析）、ping（仅网络连通性检测）
    
    operator - 指定平台从某个运营商进行检测，可选值：CHINANET（中国电信）、UNICOM（中国联通）、CAP（中国联通）、CUCC（中国联通）
    
    返回:
    
    检测结果，包含丢包率和耗时等信息
    
    抛出:
    
    WxErrorException - 微信API调用异常
  - getCurrentAutoReplyInfo
```
WxMpCurrentAutoReplyInfo getCurrentAutoReplyInfo()
                                          throws WxErrorException
```
```
 获取公众号的自动回复规则.
 https://developers.weixin.qq.com/doc/offiaccount/Message_Management/Getting_Rules_for_Auto_Replies.html
 开发者可以通过该接口，获取公众号当前使用的自动回复规则，包括关注后自动回复、消息自动回复（60分钟内触发一次）、关键词自动回复。
 请注意：
 1、第三方平台开发者可以通过本接口，在旗下公众号将业务授权给你后，立即通过本接口检测公众号的自动回复配置，并通过接口再次给公众号设置好自动回复规则，以提升公众号运营者的业务体验。
 2、本接口仅能获取公众号在公众平台官网的自动回复功能中设置的自动回复规则，若公众号自行开发实现自动回复，或通过第三方平台开发者来实现，则无法获取。
 3、认证/未认证的服务号/订阅号，以及接口测试号，均拥有该接口权限。
 4、从第三方平台的公众号登录授权机制上来说，该接口从属于消息与菜单权限集。
 5、本接口中返回的图片/语音/视频为临时素材（临时素材每次获取都不同，3天内有效，通过素材管理-获取临时素材接口来获取这些素材），本接口返回的图文消息为永久素材素材（通过素材管理-获取永久素材接口来获取这些素材）。
 接口调用请求说明
 http请求方式: GET（请使用https协议）
 https://api.weixin.qq.com/cgi-bin/get_current_autoreply_info?access_token=ACCESS_TOKEN
 
```
    返回:
    
    公众号的自动回复规则，包含关注后自动回复、消息自动回复、关键词自动回复等信息
    
    抛出:
    
    WxErrorException - 微信API调用异常
  - clearQuota
```
void clearQuota(String appid)
         throws WxErrorException
```
    公众号调用或第三方平台帮公众号调用对公众号的所有api调用（包括第三方帮其调用）次数进行清零.
    HTTP调用：https://api.weixin.qq.com/cgi-bin/clear_quota?access_token=ACCESS_TOKEN
    
    接口文档地址：https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1433744592
    
    参数:
    
    appid - 公众号的APPID，需要清零调用的公众号的appid
    
    抛出:
    
    WxErrorException - 微信API调用异常
  - execute
```
<T,E> T execute(RequestExecutor<T,E> executor,
                String url,
                E data)
         throws WxErrorException
```
    Service没有实现某个API的时候，可以用这个，比get(me.chanjar.weixin.mp.enums.WxMpApiUrl, java.lang.String)和post(me.chanjar.weixin.mp.enums.WxMpApiUrl, java.lang.String)方法更灵活，可以自己构造RequestExecutor用来处理不同的参数和不同的返回类型。可以参考，MediaUploadRequestExecutor的实现方法
    
    类型参数:
    
    T - 返回值类型
    
    E - 参数类型
    
    参数:
    
    executor - 执行器，用于处理请求和响应
    
    url - 接口地址，字符串格式
    
    data - 参数数据，根据API不同可能是不同类型
    
    返回:
    
    结果，根据API不同可能是不同类型
    
    抛出:
    
    WxErrorException - 微信API调用异常
  - get
```
String get(WxMpApiUrl url,
           String queryParam)
    throws WxErrorException
```
    当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的GET请求.
    
    参数:
    
    url - 请求接口地址，通过WxMpApiUrl枚举指定
    
    queryParam - 参数，字符串格式，通常是URL查询参数
    
    返回:
    
    接口响应字符串，JSON格式
    
    抛出:
    
    WxErrorException - 微信API调用异常
  - post
```
String post(WxMpApiUrl url,
            String postData)
     throws WxErrorException
```
    当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的POST请求.
    
    参数:
    
    url - 请求接口地址，通过WxMpApiUrl枚举指定
    
    postData - 请求参数json值，字符串格式
    
    返回:
    
    接口响应字符串，JSON格式
    
    抛出:
    
    WxErrorException - 微信API调用异常
  - post
```
String post(WxMpApiUrl url,
            Object obj)
     throws WxErrorException
```
    当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的POST请求.
    
    参数:
    
    url - 请求接口地址，通过WxMpApiUrl枚举指定
    
    obj - 请求参数，对象格式，会被序列化为JSON
    
    返回:
    
    接口响应字符串，JSON格式
    
    抛出:
    
    WxErrorException - 微信API调用异常
  - post
```
String post(WxMpApiUrl url,
            com.google.gson.JsonObject jsonObject)
     throws WxErrorException
```
    当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的POST请求.
    
    参数:
    
    url - 请求接口地址，通过WxMpApiUrl枚举指定
    
    jsonObject - 请求参数json对象，JSON格式
    
    返回:
    
    接口响应字符串，JSON格式
    
    抛出:
    
    WxErrorException - 微信API调用异常
  - execute
```
<T,E> T execute(RequestExecutor<T,E> executor,
                WxMpApiUrl url,
                E data)
         throws WxErrorException
```
```
 Service没有实现某个API的时候，可以用这个，
 比get(me.chanjar.weixin.mp.enums.WxMpApiUrl, java.lang.String)和post(me.chanjar.weixin.mp.enums.WxMpApiUrl, java.lang.String)方法更灵活，可以自己构造RequestExecutor用来处理不同的参数和不同的返回类型。
 可以参考，MediaUploadRequestExecutor的实现方法
 
```
    类型参数:
    
    T - 返回值类型
    
    E - 参数类型
    
    参数:
    
    executor - 执行器，用于处理请求和响应
    
    url - 接口地址，通过WxMpApiUrl枚举指定
    
    data - 参数数据，根据API不同可能是不同类型
    
    返回:
    
    结果，根据API不同可能是不同类型
    
    抛出:
    
    WxErrorException - 微信API调用异常
  - setRetrySleepMillis
```
void setRetrySleepMillis(int retrySleepMillis)
```
    设置当微信系统响应系统繁忙时，要等待多少 retrySleepMillis(ms) * 2^(重试次数 - 1) 再发起重试.
    
    参数:
    
    retrySleepMillis - 重试等待时间，单位毫秒，默认1000ms
  - setMaxRetryTimes
```
void setMaxRetryTimes(int maxRetryTimes)
```
```
 设置当微信系统响应系统繁忙时，最大重试次数.
 默认：5次
 
```
    参数:
    
    maxRetryTimes - 最大重试次数，默认5次
  - getWxMpConfigStorage
```
WxMpConfigStorage getWxMpConfigStorage()
```
    获取WxMpConfigStorage 对象.
    
    返回:
    
    WxMpConfigStorage 微信公众号配置存储对象
  - setWxMpConfigStorage
```
void setWxMpConfigStorage(WxMpConfigStorage wxConfigProvider)
```
    设置 WxMpConfigStorage 的实现. 兼容老版本
    
    参数:
    
    wxConfigProvider - 微信公众号配置存储对象
  - addConfigStorage
```
void addConfigStorage(String mpId,
                      WxMpConfigStorage configStorage)
```
    Map里加入新的 WxMpConfigStorage，适用于动态添加新的微信公众号配置.
    
    参数:
    
    mpId - 公众号id，用于标识不同的公众号
    
    configStorage - 新的微信配置，微信公众号配置存储对象
  - removeConfigStorage
```
void removeConfigStorage(String mpId)
```
    从 Map中移除 mpId 所对应的 WxMpConfigStorage，适用于动态移除微信公众号配置.
    
    参数:
    
    mpId - 对应公众号的标识，用于标识不同的公众号
  - setMultiConfigStorages
```
void setMultiConfigStorages(Map<String,WxMpConfigStorage> configStorages)
```
    注入多个 WxMpConfigStorage 的实现. 并为每个 WxMpConfigStorage 赋予不同的 mpId 值随机采用一个mpId进行Http初始化操作
    
    参数:
    
    configStorages - WxMpConfigStorage map，公众号id到配置存储对象的映射
  - setMultiConfigStorages
```
void setMultiConfigStorages(Map<String,WxMpConfigStorage> configStorages,
                            String defaultMpId)
```
    注入多个 WxMpConfigStorage 的实现. 并为每个 WxMpConfigStorage 赋予不同的 label 值
    
    参数:
    
    configStorages - WxMpConfigStorage map，公众号id到配置存储对象的映射
    
    defaultMpId - 设置一个WxMpConfigStorage 所对应的mpId进行Http初始化
  - switchover
```
boolean switchover(String mpId)
```
    进行相应的公众号切换.
    
    参数:
    
    mpId - 公众号标识，用于标识不同的公众号
    
    返回:
    
    切换是否成功，true表示成功，false表示失败
  - switchover
```
boolean switchover(String mpId,
                   java.util.function.Function<String,WxMpConfigStorage> func)
```
    进行相应的公众号切换，支持自定义配置获取函数.
    
    参数:
    
    mpId - 公众号标识，用于标识不同的公众号
    
    func - 自定义配置获取函数，当配置不存在时使用
    
    返回:
    
    切换是否成功，true表示成功，false表示失败
  - switchoverTo
```
WxMpService switchoverTo(String mpId)
```
    进行相应的公众号切换.
    
    参数:
    
    mpId - 公众号标识，用于标识不同的公众号
    
    返回:
    
    切换成功，则返回当前对象，方便链式调用，否则抛出异常
  - switchoverTo
```
WxMpService switchoverTo(String mpId,
                         java.util.function.Function<String,WxMpConfigStorage> func)
```
    进行相应的公众号切换，支持自定义配置获取函数.
    
    参数:
    
    mpId - 公众号标识，用于标识不同的公众号
    
    func - 自定义配置获取函数，当配置不存在时使用
    
    返回:
    
    切换成功，则返回当前对象，方便链式调用，否则抛出异常
  - getKefuService
```
WxMpKefuService getKefuService()
```
    返回客服接口方法实现类，以方便调用其各个接口.
    
    返回:
    
    WxMpKefuService 客服服务接口
  - getMaterialService
```
WxMpMaterialService getMaterialService()
```
    返回素材相关接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpMaterialService 素材服务接口
  - getMenuService
```
WxMpMenuService getMenuService()
```
    返回菜单相关接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpMenuService 菜单服务接口
  - getUserService
```
WxMpUserService getUserService()
```
    返回用户相关接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpUserService 用户服务接口
  - getUserTagService
```
WxMpUserTagService getUserTagService()
```
    返回用户标签相关接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpUserTagService 用户标签服务接口
  - getQrcodeService
```
WxMpQrcodeService getQrcodeService()
```
    返回二维码相关接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpQrcodeService 二维码服务接口
  - getCardService
```
WxMpCardService getCardService()
```
    返回卡券相关接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpCardService 卡券服务接口
  - getDataCubeService
```
WxMpDataCubeService getDataCubeService()
```
    返回数据分析统计相关接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpDataCubeService 数据分析服务接口
  - getBlackListService
```
WxMpUserBlacklistService getBlackListService()
```
    返回用户黑名单管理相关接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpUserBlacklistService 用户黑名单服务接口
  - getStoreService
```
WxMpStoreService getStoreService()
```
    返回门店管理相关接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpStoreService 门店服务接口
  - getTemplateMsgService
```
WxMpTemplateMsgService getTemplateMsgService()
```
    返回模板消息相关接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpTemplateMsgService 模板消息服务接口
  - getSubscribeMsgService
```
WxMpSubscribeMsgService getSubscribeMsgService()
```
    返回一次性订阅消息相关接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpSubscribeMsgService 订阅消息服务接口
  - getDeviceService
```
WxMpDeviceService getDeviceService()
```
    返回硬件平台相关接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpDeviceService 硬件平台服务接口
  - getShakeService
```
WxMpShakeService getShakeService()
```
    返回摇一摇周边相关接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpShakeService 摇一摇周边服务接口
  - getMemberCardService
```
WxMpMemberCardService getMemberCardService()
```
    返回会员卡相关接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpMemberCardService 会员卡服务接口
  - getMarketingService
```
WxMpMarketingService getMarketingService()
```
    返回营销相关接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpMarketingService 营销服务接口
  - initHttp
```
void initHttp()
```
    初始化http请求对象.
  - getRequestHttp
```
RequestHttp<?,?> getRequestHttp()
```
    获取RequestHttp对象.
    
    返回:
    
    RequestHttp对象 HTTP请求处理对象
  - getMassMessageService
```
WxMpMassMessageService getMassMessageService()
```
    返回群发消息相关接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpMassMessageService 群发消息服务接口
  - getAiOpenService
```
WxMpAiOpenService getAiOpenService()
```
    返回AI开放接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpAiOpenService AI开放服务接口
  - getWifiService
```
WxMpWifiService getWifiService()
```
    返回WIFI接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpWifiService WIFI服务接口
  - getOcrService
```
WxOcrService getOcrService()
```
    返回OCR接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxOcrService OCR服务接口
  - getImgProcService
```
WxImgProcService getImgProcService()
```
    返回图像处理接口的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxImgProcService 图像处理服务接口
  - getReimburseInvoiceService
```
WxMpReimburseInvoiceService getReimburseInvoiceService()
```
    返回电子发票报销方相关接口
    
    返回:
    
    WxMpReimburseInvoiceService 电子发票报销方服务接口
  - getDraftService
```
WxMpDraftService getDraftService()
```
    返回草稿箱相关接口
    
    返回:
    
    WxMpDraftService 草稿箱服务接口
  - getFreePublishService
```
WxMpFreePublishService getFreePublishService()
```
    返回发布能力接口
    
    返回:
    
    WxMpFreePublishService 发布能力服务接口
  - setReimburseInvoiceService
```
void setReimburseInvoiceService(WxMpReimburseInvoiceService reimburseInvoiceService)
```
    设置电子发票报销方服务接口
    
    参数:
    
    reimburseInvoiceService - 电子发票报销方服务接口
  - setKefuService
```
void setKefuService(WxMpKefuService kefuService)
```
    设置客服服务接口
    
    参数:
    
    kefuService - 客服服务接口
  - setMaterialService
```
void setMaterialService(WxMpMaterialService materialService)
```
    设置素材服务接口
    
    参数:
    
    materialService - 素材服务接口
  - setMenuService
```
void setMenuService(WxMpMenuService menuService)
```
    设置菜单服务接口
    
    参数:
    
    menuService - 菜单服务接口
  - setUserService
```
void setUserService(WxMpUserService userService)
```
    设置用户服务接口
    
    参数:
    
    userService - 用户服务接口
  - setUserTagService
```
void setUserTagService(WxMpUserTagService userTagService)
```
    设置用户标签服务接口
    
    参数:
    
    userTagService - 用户标签服务接口
  - setQrcodeService
```
void setQrcodeService(WxMpQrcodeService qrcodeService)
```
    设置二维码服务接口
    
    参数:
    
    qrcodeService - 二维码服务接口
  - setCardService
```
void setCardService(WxMpCardService cardService)
```
    设置卡券服务接口
    
    参数:
    
    cardService - 卡券服务接口
  - setStoreService
```
void setStoreService(WxMpStoreService storeService)
```
    设置门店服务接口
    
    参数:
    
    storeService - 门店服务接口
  - setDataCubeService
```
void setDataCubeService(WxMpDataCubeService dataCubeService)
```
    设置数据分析服务接口
    
    参数:
    
    dataCubeService - 数据分析服务接口
  - setBlackListService
```
void setBlackListService(WxMpUserBlacklistService blackListService)
```
    设置用户黑名单服务接口
    
    参数:
    
    blackListService - 用户黑名单服务接口
  - setTemplateMsgService
```
void setTemplateMsgService(WxMpTemplateMsgService templateMsgService)
```
    设置模板消息服务接口
    
    参数:
    
    templateMsgService - 模板消息服务接口
  - setDeviceService
```
void setDeviceService(WxMpDeviceService deviceService)
```
    设置硬件平台服务接口
    
    参数:
    
    deviceService - 硬件平台服务接口
  - setShakeService
```
void setShakeService(WxMpShakeService shakeService)
```
    设置摇一摇周边服务接口
    
    参数:
    
    shakeService - 摇一摇周边服务接口
  - setMemberCardService
```
void setMemberCardService(WxMpMemberCardService memberCardService)
```
    设置会员卡服务接口
    
    参数:
    
    memberCardService - 会员卡服务接口
  - setMassMessageService
```
void setMassMessageService(WxMpMassMessageService massMessageService)
```
    设置群发消息服务接口
    
    参数:
    
    massMessageService - 群发消息服务接口
  - setAiOpenService
```
void setAiOpenService(WxMpAiOpenService aiOpenService)
```
    设置AI开放服务接口
    
    参数:
    
    aiOpenService - AI开放服务接口
  - setMarketingService
```
void setMarketingService(WxMpMarketingService marketingService)
```
    设置营销服务接口
    
    参数:
    
    marketingService - 营销服务接口
  - setOcrService
```
void setOcrService(WxOcrService ocrService)
```
    设置OCR服务接口
    
    参数:
    
    ocrService - OCR服务接口
  - setImgProcService
```
void setImgProcService(WxImgProcService imgProcService)
```
    设置图像处理服务接口
    
    参数:
    
    imgProcService - 图像处理服务接口
  - getCommentService
```
WxMpCommentService getCommentService()
```
    返回评论数据管理接口方法的实现类对象，以方便调用其各个接口.
    
    返回:
    
    WxMpCommentService 评论数据管理服务接口
  - setCommentService
```
void setCommentService(WxMpCommentService commentService)
```
    设置评论数据管理服务接口
    
    参数:
    
    commentService - 评论数据管理服务接口
  - getOAuth2Service
```
WxOAuth2Service getOAuth2Service()
```
    获取OAuth2服务接口
    
    返回:
    
    WxOAuth2Service OAuth2服务接口
  - setOAuth2Service
```
void setOAuth2Service(WxOAuth2Service oAuth2Service)
```
    设置OAuth2服务接口
    
    参数:
    
    oAuth2Service - OAuth2服务接口
  - getGuideService
```
WxMpGuideService getGuideService()
```
    获取微信导购服务接口
    
    返回:
    
    WxMpGuideService 微信导购服务接口
  - setGuideService
```
void setGuideService(WxMpGuideService guideService)
```
    设置微信导购服务接口
    
    参数:
    
    guideService - 微信导购服务接口
  - getGuideBuyerService
```
WxMpGuideBuyerService getGuideBuyerService()
```
    获取微信导购买家服务接口
    
    返回:
    
    WxMpGuideBuyerService 微信导购买家服务接口
  - setGuideBuyerService
```
void setGuideBuyerService(WxMpGuideBuyerService guideBuyerService)
```
    设置微信导购买家服务接口
    
    参数:
    
    guideBuyerService - 微信导购买家服务接口
  - getGuideTagService
```
WxMpGuideTagService getGuideTagService()
```
    获取微信导购标签服务接口
    
    返回:
    
    WxMpGuideTagService 微信导购标签服务接口
  - setGuideTagService
```
void setGuideTagService(WxMpGuideTagService guideTagService)
```
    设置微信导购标签服务接口
    
    参数:
    
    guideTagService - 微信导购标签服务接口
  - getGuideMaterialService
```
WxMpGuideMaterialService getGuideMaterialService()
```
    获取微信导购素材服务接口
    
    返回:
    
    WxMpGuideMaterialService 微信导购素材服务接口
  - setGuideMaterialService
```
void setGuideMaterialService(WxMpGuideMaterialService guideMaterialService)
```
    设置微信导购素材服务接口
    
    参数:
    
    guideMaterialService - 微信导购素材服务接口
  - getGuideMassedJobService
```
WxMpGuideMassedJobService getGuideMassedJobService()
```
    获取微信导购批量任务服务接口
    
    返回:
    
    WxMpGuideMassedJobService 微信导购批量任务服务接口
  - setGuideMassedJobService
```
void setGuideMassedJobService(WxMpGuideMassedJobService guideMassedJobService)
```
    设置微信导购批量任务服务接口
    
    参数:
    
    guideMassedJobService - 微信导购批量任务服务接口
  - getMerchantInvoiceService
```
WxMpMerchantInvoiceService getMerchantInvoiceService()
```
    获取微信商户发票服务接口
    
    返回:
    
    WxMpMerchantInvoiceService 微信商户发票服务接口
  - setMerchantInvoiceService
```
void setMerchantInvoiceService(WxMpMerchantInvoiceService merchantInvoiceService)
```
    设置微信商户发票服务接口
    
    参数:
    
    merchantInvoiceService - 微信商户发票服务接口
  - setDraftService
```
void setDraftService(WxMpDraftService draftService)
```
    设置草稿箱服务接口
    
    参数:
    
    draftService - 草稿箱服务接口
  - setFreePublishService
```
void setFreePublishService(WxMpFreePublishService freePublishService)
```
    设置发布能力服务接口
    
    参数:
    
    freePublishService - 发布能力服务接口

接口 WxMpService

方法概要

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

方法详细资料

genShorten

fetchShorten

checkSignature

getAccessToken

getAccessToken

getTicket

getTicket

getJsapiTicket

getJsapiTicket

createJsapiSignature

shortUrl

semanticQuery

buildQrConnectUrl

getCallbackIP

netCheck

getCurrentAutoReplyInfo

clearQuota

execute

get

post

post

post

execute

setRetrySleepMillis

setMaxRetryTimes

getWxMpConfigStorage

setWxMpConfigStorage

addConfigStorage

removeConfigStorage

setMultiConfigStorages

setMultiConfigStorages

switchover

switchover

switchoverTo

switchoverTo

getKefuService

getMaterialService

getMenuService

getUserService

getUserTagService

getQrcodeService

getCardService

getDataCubeService

getBlackListService

getStoreService

getTemplateMsgService

getSubscribeMsgService

getDeviceService

getShakeService

getMemberCardService

getMarketingService

initHttp

getRequestHttp

getMassMessageService

getAiOpenService

getWifiService

getOcrService

getImgProcService

getReimburseInvoiceService

getDraftService

getFreePublishService

setReimburseInvoiceService

setKefuService

setMaterialService

setMenuService

setUserService

setUserTagService

setQrcodeService

setCardService

setStoreService

setDataCubeService

setBlackListService

setTemplateMsgService

setDeviceService

setShakeService

setMemberCardService