WxMpServiceImpl (WeiXin Java Tools

java.lang.Object
- me.chanjar.weixin.mp.api.WxMpServiceImpl

所有已实现的接口:: WxMpService

public class WxMpServiceImpl
extends Object
implements WxMpService

字段概要

字段
限定符和类型	字段和说明
`protected Object`	`globalAccessTokenRefreshLock` 全局的是否正在刷新access token的锁
`protected Object`	`globalCardApiTicketRefreshLock` 全局的是否正在刷新卡券api_ticket的锁
`protected Object`	`globalJsapiTicketRefreshLock` 全局的是否正在刷新jsapi_ticket的锁
`protected org.apache.http.impl.client.CloseableHttpClient`	`httpClient`
`protected org.apache.http.HttpHost`	`httpProxy`
`protected WxMpKefuService`	`kefuService`
`protected org.slf4j.Logger`	`log`
`protected WxSessionManager`	`sessionManager`
`protected WxMpConfigStorage`	`wxMpConfigStorage`

从接口继承的字段 me.chanjar.weixin.mp.api.WxMpService
SIMPLE_DATE_FORMAT

构造器概要

构造器
构造器和说明

WxMpServiceImpl()

构造器
构造器和说明
`WxMpServiceImpl()`

方法概要

方法
限定符和类型	方法和说明
`boolean`	`checkJSSDKCallbackDataSignature(Map<String,String> kvm, String signature)` 计算Map键值对是否和签名相符, 按照字段名的 ASCII 码从小到大排序(字典序)后,使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串
`boolean`	`checkSignature(String timestamp, String nonce, String signature)` 验证推送过来的消息的正确性详情请见: http://mp.weixin.qq.com/wiki/index.php?
`String`	`consumeCardCode(String code)` 卡券Code核销。
`String`	`consumeCardCode(String code, String cardId)` 卡券Code核销。
`WxCardApiSignature`	`createCardApiSignature(String... optionalSignParam)` 创建调用卡券api时所需要的签名详情请见：http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E9.99.84.E5.BD .954-.E5.8D.A1.E5.88.B8.E6.89.A9.E5.B1.95.E5.AD.97.E6.AE.B5.E5.8F.8A.E7.AD.BE.E5.90.8D.E7.94 .9F.E6.88.90.E7.AE.97.E6.B3.95
`WxJsapiSignature`	`createJsapiSignature(String url)` 创建调用jsapi时所需要的签名详情请见：http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E9.99.84.E5.BD.951-JS-SDK.E4.BD.BF.E7.94.A8.E6.9D.83.E9.99.90.E7.AD.BE.E5.90.8D.E7.AE.97.E6.B3.95
`void`	`customMessageSend(WxMpCustomMessage message)` 发送客服消息详情请见: http://mp.weixin.qq.com/wiki/index.php?
`String`	`decryptCardCode(String encryptCode)` 卡券Code解码
`<T,E> T`	`execute(RequestExecutor<T,E> executor, String uri, E data)` 向微信端发送请求，在这里执行的策略是当发生access_token过期时才去刷新，然后重新执行请求，而不是全局定时请求
`protected <T,E> T`	`executeInternal(RequestExecutor<T,E> executor, String uri, E data)`
`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/index.php?
`String[]`	`getCallbackIP()` 获取微信服务器IP地址 http://mp.weixin.qq.com/wiki/0/2ad4b6bfd29f30f71d39616c2a0fcedc.html
`String`	`getCardApiTicket()` 获得卡券api_ticket，不强制刷新卡券api_ticket
`String`	`getCardApiTicket(boolean forceRefresh)` 获得卡券api_ticket 获得时会检查卡券apiToken是否过期，如果过期了，那么就刷新一下，否则就什么都不干详情请见：http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E9.99.84.E5.BD .954-.E5.8D.A1.E5.88.B8.E6.89.A9.E5.B1.95.E5.AD.97.E6.AE.B5.E5.8F.8A.E7.AD.BE.E5.90.8D.E7.94 .9F.E6.88.90.E7.AE.97.E6.B3.95
`String`	`getCardDetail(String cardId)` 查看卡券详情接口详见 https://mp.weixin.qq.com/wiki/14/8dd77aeaee85f922db5f8aa6386d385e.html#.E6.9F.A5.E7.9C.8B.E5.8D.A1.E5.88.B8.E8.AF.A6.E6.83.85
`protected org.apache.http.impl.client.CloseableHttpClient`	`getHttpclient()`
`WxMpIndustry`	`getIndustry()` 获取设置的行业信息详情请见：http://mp.weixin.qq.com/wiki/5/6dde9eaa909f83354e0094dc3ad99e05.html#.E8.AE.BE.E7.BD.AE.E6.89.80.E5.B1.9E.E8.A1.8C.E4.B8.9A
`Map<String,String>`	`getJsapiPayInfo(String openId, String outTradeNo, double amt, String body, String ip, String callbackUrl)` 该接口调用“统一下单”接口，并拼装JSAPI发起支付请求需要的参数详见http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E5.8F.91.E8.B5.B7.E4.B8.80.E4.B8.AA.E5.BE.AE.E4.BF.A1.E6.94.AF.E4.BB.98.E8.AF.B7.E6.B1.82 tradeType 交易类型 JSAPI(其他交易类型NATIVE，APP，WAP)
`String`	`getJsapiTicket()` 获得jsapi_ticket,不强制刷新jsapi_ticket
`String`	`getJsapiTicket(boolean forceRefresh)` 获得jsapi_ticket 获得时会检查jsapiToken是否过期，如果过期了，那么就刷新一下，否则就什么都不干详情请见：http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E9.99.84.E5.BD.951-JS-SDK.E4.BD.BF.E7.94.A8.E6.9D.83.E9.99.90.E7.AD.BE.E5.90.8D.E7.AE.97.E6.B3.95
`WxMpPayCallback`	`getJSSDKCallbackData(String xmlData)` 读取支付结果通知详见http://pay.weixin.qq.com/wiki/doc/api/jsapi.php?
`WxMpPayResult`	`getJSSDKPayResult(String transactionId, String outTradeNo)` 该接口提供所有微信支付订单的查询,当支付通知处理异常戒丢失的情冴,商户可以通过该接口查询订单支付状态。
`WxMpKefuService`	`getKefuService()` 返回客服接口方法实现类，以方便调用个其各种接口
`Map<String,String>`	`getNativePayInfo(String productId, String outTradeNo, double amt, String body, String ip, String callbackUrl)` 该接口调用“统一下单”接口，并拼装NATIVE发起支付请求需要的参数详见http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E5.8F.91.E8.B5.B7.E4.B8.80.E4.B8.AA.E5.BE.AE.E4.BF.A1.E6.94.AF.E4.BB.98.E8.AF.B7.E6.B1.82 tradeType 交易类型 NATIVE （其他交易类型JSAPI，APP，WAP）
`Map<String,String>`	`getPayInfo(Map<String,String> parameters)` 该接口调用“统一下单”接口，并拼装发起支付请求需要的参数详见http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E5.8F.91.E8.B5.B7.E4.B8.80.E4.B8.AA.E5.BE.AE.E4.BF.A1.E6.94.AF.E4.BB.98.E8.AF.B7.E6.B1.82
`WxMpPrepayIdResult`	`getPrepayId(Map<String,String> parameters)` 统一下单(详见http://pay.weixin.qq.com/wiki/doc/api/jsapi.php?
`WxMpPrepayIdResult`	`getPrepayId(String openId, String outTradeNo, double amt, String body, String tradeType, String ip, String callbackUrl)` 统一下单(详见http://pay.weixin.qq.com/wiki/doc/api/jsapi.php?
`List<WxMpUserCumulate>`	`getUserCumulate(Date beginDate, Date endDate)` 获取累计用户数据 http://mp.weixin.qq.com/wiki/3/ecfed6e1a0a03b5f35e5efac98e864b7.html
`List<WxMpUserSummary>`	`getUserSummary(Date beginDate, Date endDate)` 获取用户增减数据 http://mp.weixin.qq.com/wiki/3/ecfed6e1a0a03b5f35e5efac98e864b7.html
`WxMpConfigStorage`	`getWxMpConfigStorage()`
`WxMpGroup`	`groupCreate(String name)` 分组管理接口 - 创建分组最多支持创建500个分组详情请见: http://mp.weixin.qq.com/wiki/index.php?
`List<WxMpGroup>`	`groupGet()` 分组管理接口 - 查询所有分组详情请见: http://mp.weixin.qq.com/wiki/index.php?
`void`	`groupUpdate(WxMpGroup group)` 分组管理接口 - 修改分组名详情请见: http://mp.weixin.qq.com/wiki/index.php?
`void`	`markCardCode(String code, String cardId, String openId, boolean isMark)` 卡券Mark接口。
`WxMpMassSendResult`	`massGroupMessageSend(WxMpMassGroupMessage message)` 分组群发消息如果发送图文消息，必须先使用 `WxMpService.massNewsUpload(me.chanjar.weixin.mp.bean.WxMpMassNews)` 获得media_id，然后再发送如果发送视频消息，必须先使用 `WxMpService.massVideoUpload(me.chanjar.weixin.mp.bean.WxMpMassVideo)` 获得media_id，然后再发送详情请见: http://mp.weixin.qq.com/wiki/index.php?
`WxMpMassSendResult`	`massMessagePreview(WxMpMassPreviewMessage wxMpMassPreviewMessage)` 预览接口详情请见：http://mp.weixin.qq.com/wiki/15/40b6865b893947b764e2de8e4a1fb55f.html#.E9.A2.84.E8.A7.88.E6.8E.A5.E5.8F.A3.E3.80.90.E8.AE.A2.E9.98.85.E5.8F.B7.E4.B8.8E.E6.9C.8D.E5.8A.A1.E5.8F.B7.E8.AE.A4.E8.AF.81.E5.90.8E.E5.9D.87.E5.8F.AF.E7.94.A8.E3.80.91
`WxMpMassUploadResult`	`massNewsUpload(WxMpMassNews news)` 上传群发用的图文消息，上传后才能群发图文消息详情请见: http://mp.weixin.qq.com/wiki/index.php?
`WxMpMassSendResult`	`massOpenIdsMessageSend(WxMpMassOpenIdsMessage message)` 按openId列表群发消息如果发送图文消息，必须先使用 `WxMpService.massNewsUpload(me.chanjar.weixin.mp.bean.WxMpMassNews)` 获得media_id，然后再发送如果发送视频消息，必须先使用 `WxMpService.massVideoUpload(me.chanjar.weixin.mp.bean.WxMpMassVideo)` 获得media_id，然后再发送详情请见: http://mp.weixin.qq.com/wiki/index.php?
`WxMpMassUploadResult`	`massVideoUpload(WxMpMassVideo video)` 上传群发用的视频，上传后才能群发视频消息详情请见: http://mp.weixin.qq.com/wiki/index.php?
`WxMpMaterialCountResult`	`materialCount()` 获取各类素材总数详情请见: http://mp.weixin.qq.com/wiki/16/8cc64f8c189674b421bee3ed403993b8.html
`boolean`	`materialDelete(String media_id)` 删除永久素材详情请见: http://mp.weixin.qq.com/wiki/5/e66f61c303db51a6c0f90f46b15af5f5.html
`WxMpMaterialFileBatchGetResult`	`materialFileBatchGet(String type, int offset, int count)` 分页获取其他媒体素材列表详情请见: http://mp.weixin.qq.com/wiki/12/2108cd7aafff7f388f41f37efa710204.html
`WxMpMaterialUploadResult`	`materialFileUpload(String mediaType, WxMpMaterial material)` 上传非图文永久素材上传的多媒体文件有格式和大小限制，如下：图片（image）: 图片大小不超过2M，支持bmp/png/jpeg/jpg/gif格式语音（voice）：语音大小不超过5M，长度不超过60秒，支持mp3/wma/wav/amr格式视频（video）：在上传视频素材时需要POST另一个表单，id为description，包含素材的描述信息，内容格式为JSON 缩略图（thumb）：文档未说明详情请见: http://mp.weixin.qq.com/wiki/14/7e6c03263063f4813141c3e17dd4350a.html
`InputStream`	`materialImageOrVoiceDownload(String media_id)` 下载声音或者图片永久素材详情请见: http://mp.weixin.qq.com/wiki/4/b3546879f07623cb30df9ca0e420a5d0.html
`WxMpMaterialNewsBatchGetResult`	`materialNewsBatchGet(int offset, int count)` 分页获取图文素材列表详情请见: http://mp.weixin.qq.com/wiki/12/2108cd7aafff7f388f41f37efa710204.html
`WxMpMaterialNews`	`materialNewsInfo(String media_id)` 获取图文永久素材的信息详情请见: http://mp.weixin.qq.com/wiki/4/b3546879f07623cb30df9ca0e420a5d0.html
`boolean`	`materialNewsUpdate(WxMpMaterialArticleUpdate wxMpMaterialArticleUpdate)` 更新图文永久素材详情请见: http://mp.weixin.qq.com/wiki/4/19a59cba020d506e767360ca1be29450.html
`WxMpMaterialUploadResult`	`materialNewsUpload(WxMpMaterialNews news)` 上传永久图文素材详情请见: http://mp.weixin.qq.com/wiki/14/7e6c03263063f4813141c3e17dd4350a.html
`WxMpMaterialVideoInfoResult`	`materialVideoInfo(String media_id)` 获取视频永久素材的信息和下载地址详情请见: http://mp.weixin.qq.com/wiki/4/b3546879f07623cb30df9ca0e420a5d0.html
`File`	`mediaDownload(String media_id)` 获取临时素材本接口即为原“下载多媒体文件”接口。
`WxMediaImgUploadResult`	`mediaImgUpload(File file)` 上传图文消息内的图片获取URL 详情请见：http://mp.weixin.qq.com/wiki/15/40b6865b893947b764e2de8e4a1fb55f.html#.E4.B8.8A.E4.BC.A0.E5.9B.BE.E6.96.87.E6.B6.88.E6.81.AF.E5.86.85.E7.9A.84.E5.9B.BE.E7.89.87.E8.8E.B7.E5.8F.96URL.E3.80.90.E8.AE.A2.E9.98.85.E5.8F.B7.E4.B8.8E.E6.9C.8D.E5.8A.A1.E5.8F.B7.E8.AE.A4.E8.AF.81.E5.90.8E.E5.9D.87.E5.8F.AF.E7.94.A8.E3.80.91
`WxMediaUploadResult`	`mediaUpload(String mediaType, File file)` 新增临时素材
`WxMediaUploadResult`	`mediaUpload(String mediaType, String fileType, InputStream inputStream)` 新增临时素材本接口即为原“上传多媒体文件”接口。
`void`	`menuCreate(WxMenu menu)` 自定义菜单创建接口详情请见: http://mp.weixin.qq.com/wiki/index.php?
`void`	`menuDelete()` 自定义菜单删除接口详情请见: http://mp.weixin.qq.com/wiki/index.php?
`void`	`menuDelete(String menuid)` 删除个性化菜单接口详情请见: http://mp.weixin.qq.com/wiki/0/c48ccd12b69ae023159b4bfaa7c39c20.html
`WxMenu`	`menuGet()` 自定义菜单查询接口详情请见: http://mp.weixin.qq.com/wiki/index.php?
`WxMenu`	`menuTryMatch(String userid)` 测试个性化菜单匹配结果详情请见: http://mp.weixin.qq.com/wiki/0/c48ccd12b69ae023159b4bfaa7c39c20.html
`String`	`oauth2buildAuthorizationUrl(String scope, String state)` 构造oauth2授权的url连接详情请见: http://mp.weixin.qq.com/wiki/index.php?
`String`	`oauth2buildAuthorizationUrl(String redirectURI, String scope, String state)` 构造oauth2授权的url连接详情请见: http://mp.weixin.qq.com/wiki/index.php?
`WxMpOAuth2AccessToken`	`oauth2getAccessToken(String code)` 用code换取oauth2的access token 详情请见: http://mp.weixin.qq.com/wiki/index.php?
`WxMpUser`	`oauth2getUserInfo(WxMpOAuth2AccessToken oAuth2AccessToken, String lang)` 用oauth2获取用户信息, 当前面引导授权时的scope是snsapi_userinfo的时候才可以
`WxMpOAuth2AccessToken`	`oauth2refreshAccessToken(String refreshToken)` 刷新oauth2的access token
`boolean`	`oauth2validateAccessToken(WxMpOAuth2AccessToken oAuth2AccessToken)` 验证oauth2的access token是否有效
`String`	`post(String url, String postData)` 当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的POST请求
`WxMpQrCodeTicket`	`qrCodeCreateLastTicket(int scene_id)` 换取永久二维码ticket 详情请见: 生成带参数的二维码
`WxMpQrCodeTicket`	`qrCodeCreateLastTicket(String scene_str)` 换取永久字符串二维码ticket 详情请见: 生成带参数的二维码
`WxMpQrCodeTicket`	`qrCodeCreateTmpTicket(int scene_id, Integer expire_seconds)` 换取临时二维码ticket 详情请见: 生成带参数的二维码
`File`	`qrCodePicture(WxMpQrCodeTicket ticket)` 换取二维码图片文件，jpg格式详情请见: 生成带参数的二维码
`String`	`qrCodePictureUrl(String ticket)` 换取二维码图片url地址详情请见: 生成带参数的二维码
`String`	`qrCodePictureUrl(String ticket, boolean needShortUrl)` 换取二维码图片url地址（可以选择是否生成压缩的网址）详情请见: 生成带参数的二维码
`WxMpCardResult`	`queryCardCode(String cardId, String code, boolean checkConsume)` 卡券Code查询
`WxMpPayRefundResult`	`refundPay(Map<String,String> parameters)` 微信支付-申请退款详见 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?
`WxMpSemanticQueryResult`	`semanticQuery(WxMpSemanticQuery semanticQuery)` 语义查询接口详情请见：http://mp.weixin.qq.com/wiki/index.php?
`WxRedpackResult`	`sendRedpack(Map<String,String> parameters)` 发送微信红包给个人用户需要传入的必填参数如下: mch_billno//商户订单号 send_name//商户名称 re_openid//用户openid total_amount//红包总额 total_num//红包发放总人数 wishing//红包祝福语 client_ip//服务器Ip地址 act_name//活动名称 remark //备注文档详见:https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?
`String`	`setIndustry(WxMpIndustry wxMpIndustry)` 设置所属行业官方文档中暂未告知响应内容详情请见：http://mp.weixin.qq.com/wiki/5/6dde9eaa909f83354e0094dc3ad99e05.html#.E8.AE.BE.E7.BD.AE.E6.89.80.E5.B1.9E.E8.A1.8C.E4.B8.9A
`void`	`setMaxRetryTimes(int maxRetryTimes)` 设置当微信系统响应系统繁忙时，最大重试次数默认：5次
`void`	`setRetrySleepMillis(int retrySleepMillis)` 设置当微信系统响应系统繁忙时，要等待多少 retrySleepMillis(ms) * 2^(重试次数 - 1) 再发起重试默认：1000ms
`void`	`setWxMpConfigStorage(WxMpConfigStorage wxConfigProvider)` 注入 `WxMpConfigStorage` 的实现
`String`	`shortUrl(String long_url)` 长链接转短链接接口详情请见: http://mp.weixin.qq.com/wiki/index.php?
`String`	`templateSend(WxMpTemplateMessage templateMessage)` 发送模板消息详情请见: http://mp.weixin.qq.com/wiki/index.php?
`long`	`userGetGroup(String openid)` 分组管理接口 - 查询用户所在分组详情请见: http://mp.weixin.qq.com/wiki/index.php?
`WxMpUser`	`userInfo(String openid, String lang)` 获取用户基本信息详情请见: http://mp.weixin.qq.com/wiki/index.php?
`WxMpUserList`	`userList(String next_openid)` 获取关注者列表详情请见: http://mp.weixin.qq.com/wiki/index.php?
`void`	`userUpdateGroup(String openid, long to_groupid)` 分组管理接口 - 移动用户分组详情请见: http://mp.weixin.qq.com/wiki/index.php?
`void`	`userUpdateRemark(String openid, String remark)` 设置用户备注名接口详情请见: http://mp.weixin.qq.com/wiki/index.php?

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

log
```
protected final org.slf4j.Logger log
```

globalAccessTokenRefreshLock
```
protected final Object globalAccessTokenRefreshLock
```
全局的是否正在刷新access token的锁

globalJsapiTicketRefreshLock
```
protected final Object globalJsapiTicketRefreshLock
```
全局的是否正在刷新jsapi_ticket的锁

globalCardApiTicketRefreshLock
```
protected final Object globalCardApiTicketRefreshLock
```
全局的是否正在刷新卡券api_ticket的锁

wxMpConfigStorage

protected WxMpConfigStorage wxMpConfigStorage

kefuService
```
protected WxMpKefuService kefuService
```

httpClient

protected org.apache.http.impl.client.CloseableHttpClient httpClient

httpProxy

protected org.apache.http.HttpHost httpProxy

sessionManager

protected WxSessionManager sessionManager

构造器详细资料
- WxMpServiceImpl
```
public WxMpServiceImpl()
```

方法详细资料

checkSignature

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

从接口复制的说明: WxMpService

 验证推送过来的消息的正确性
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=验证消息真实性

指定者:: checkSignature 在接口中 WxMpService
返回:

getAccessToken
```
public String getAccessToken()
                      throws WxErrorException
```
从接口复制的说明: WxMpService

获取access_token, 不强制刷新access_token

指定者:

getAccessToken 在接口中 WxMpService

返回:

抛出:

WxErrorException
另请参阅:
WxMpService.getAccessToken(boolean)

getAccessToken

public String getAccessToken(boolean forceRefresh)
                      throws WxErrorException

从接口复制的说明: WxMpService

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

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

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

 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=获取access_token

指定者:: getAccessToken 在接口中 WxMpService
参数:: forceRefresh - 强制刷新
返回:
抛出:: WxErrorException

getJsapiTicket
```
public String getJsapiTicket()
                      throws WxErrorException
```
从接口复制的说明: WxMpService

获得jsapi_ticket,不强制刷新jsapi_ticket

指定者:

getJsapiTicket 在接口中 WxMpService

返回:

抛出:

WxErrorException
另请参阅:
WxMpService.getJsapiTicket(boolean)

getJsapiTicket

public String getJsapiTicket(boolean forceRefresh)
                      throws WxErrorException

从接口复制的说明: WxMpService

 获得jsapi_ticket
 获得时会检查jsapiToken是否过期，如果过期了，那么就刷新一下，否则就什么都不干

 详情请见：http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E9.99.84.E5.BD.951-JS-SDK.E4.BD.BF.E7.94.A8.E6.9D.83.E9.99.90.E7.AD.BE.E5.90.8D.E7.AE.97.E6.B3.95

指定者:: getJsapiTicket 在接口中 WxMpService
参数:: forceRefresh - 强制刷新
返回:
抛出:: WxErrorException

createJsapiSignature

public WxJsapiSignature createJsapiSignature(String url)
                                      throws WxErrorException

从接口复制的说明: WxMpService

 创建调用jsapi时所需要的签名

 详情请见：http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E9.99.84.E5.BD.951-JS-SDK.E4.BD.BF.E7.94.A8.E6.9D.83.E9.99.90.E7.AD.BE.E5.90.8D.E7.AE.97.E6.B3.95

指定者:: createJsapiSignature 在接口中 WxMpService
参数:: url - url
返回:
抛出:: WxErrorException

customMessageSend

public void customMessageSend(WxMpCustomMessage message)
                       throws WxErrorException

从接口复制的说明: WxMpService

 发送客服消息
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=发送客服消息

指定者:: customMessageSend 在接口中 WxMpService
抛出:: WxErrorException

menuCreate

public void menuCreate(WxMenu menu)
                throws WxErrorException

从接口复制的说明: WxMpService

 自定义菜单创建接口
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=自定义菜单创建接口
 如果要创建个性化菜单，请设置matchrule属性
 详情请见:http://mp.weixin.qq.com/wiki/0/c48ccd12b69ae023159b4bfaa7c39c20.html

指定者:: menuCreate 在接口中 WxMpService
抛出:: WxErrorException

menuDelete

public void menuDelete()
                throws WxErrorException

从接口复制的说明: WxMpService

 自定义菜单删除接口
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=自定义菜单删除接口

指定者:: menuDelete 在接口中 WxMpService
抛出:: WxErrorException

menuDelete

public void menuDelete(String menuid)
                throws WxErrorException

从接口复制的说明: WxMpService

 删除个性化菜单接口
 详情请见: http://mp.weixin.qq.com/wiki/0/c48ccd12b69ae023159b4bfaa7c39c20.html

指定者:: menuDelete 在接口中 WxMpService
抛出:: WxErrorException

menuGet

public WxMenu menuGet()
               throws WxErrorException

从接口复制的说明: WxMpService

 自定义菜单查询接口
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=自定义菜单查询接口

指定者:: menuGet 在接口中 WxMpService
返回:
抛出:: WxErrorException

menuTryMatch

public WxMenu menuTryMatch(String userid)
                    throws WxErrorException

从接口复制的说明: WxMpService

 测试个性化菜单匹配结果
 详情请见: http://mp.weixin.qq.com/wiki/0/c48ccd12b69ae023159b4bfaa7c39c20.html

指定者:: menuTryMatch 在接口中 WxMpService
参数:: userid - 可以是粉丝的OpenID，也可以是粉丝的微信号。
抛出:: WxErrorException

mediaUpload

public WxMediaUploadResult mediaUpload(String mediaType,
                              String fileType,
                              InputStream inputStream)
                                throws WxErrorException,
                                       IOException

从接口复制的说明: WxMpService

 新增临时素材
 本接口即为原“上传多媒体文件”接口。

 上传的多媒体文件有格式和大小限制，如下：
   图片（image）: 1M，支持JPG格式
   语音（voice）：2M，播放长度不超过60s，支持AMR\MP3格式
   视频（video）：10MB，支持MP4格式
   缩略图（thumb）：64KB，支持JPG格式

 详情请见: 新增临时素材

指定者:: mediaUpload 在接口中 WxMpService
参数:: mediaType - 媒体类型, 请看WxConsts; fileType - 文件类型，请看WxConsts; inputStream - 输入流
抛出:: WxErrorException; IOException

mediaUpload

public WxMediaUploadResult mediaUpload(String mediaType,
                              File file)
                                throws WxErrorException

从接口复制的说明: WxMpService

新增临时素材

指定者:: mediaUpload 在接口中 WxMpService
抛出:: WxErrorException
另请参阅:: WxMpService.mediaUpload(String, String, InputStream)

mediaDownload

public File mediaDownload(String media_id)
                   throws WxErrorException

从接口复制的说明: WxMpService

 获取临时素材
 本接口即为原“下载多媒体文件”接口。
 根据微信文档，视频文件下载不了，会返回null
 详情请见: 获取临时素材

指定者:: mediaDownload 在接口中 WxMpService
返回:: 保存到本地的临时文件
抛出:: WxErrorException

materialFileUpload

public WxMpMaterialUploadResult materialFileUpload(String mediaType,
                                          WxMpMaterial material)
                                            throws WxErrorException

从接口复制的说明: WxMpService

 上传非图文永久素材

 上传的多媒体文件有格式和大小限制，如下：
   图片（image）: 图片大小不超过2M，支持bmp/png/jpeg/jpg/gif格式
   语音（voice）：语音大小不超过5M，长度不超过60秒，支持mp3/wma/wav/amr格式
   视频（video）：在上传视频素材时需要POST另一个表单，id为description，包含素材的描述信息，内容格式为JSON
   缩略图（thumb）：文档未说明

 详情请见: http://mp.weixin.qq.com/wiki/14/7e6c03263063f4813141c3e17dd4350a.html

指定者:: materialFileUpload 在接口中 WxMpService
参数:: mediaType - 媒体类型, 请看WxConsts; material - 上传的素材, 请看WxMpMaterial
返回:
抛出:: WxErrorException

materialNewsUpload

public WxMpMaterialUploadResult materialNewsUpload(WxMpMaterialNews news)
                                            throws WxErrorException

从接口复制的说明: WxMpService

 上传永久图文素材

 详情请见: http://mp.weixin.qq.com/wiki/14/7e6c03263063f4813141c3e17dd4350a.html

指定者:: materialNewsUpload 在接口中 WxMpService
参数:: news - 上传的图文消息, 请看WxMpMaterialNews
返回:
抛出:: WxErrorException

materialImageOrVoiceDownload

public InputStream materialImageOrVoiceDownload(String media_id)
                                         throws WxErrorException

从接口复制的说明: WxMpService

 下载声音或者图片永久素材

 详情请见: http://mp.weixin.qq.com/wiki/4/b3546879f07623cb30df9ca0e420a5d0.html

指定者:: materialImageOrVoiceDownload 在接口中 WxMpService
参数:: media_id - 永久素材的id
返回:
抛出:: WxErrorException

materialVideoInfo

public WxMpMaterialVideoInfoResult materialVideoInfo(String media_id)
                                              throws WxErrorException

从接口复制的说明: WxMpService

 获取视频永久素材的信息和下载地址

 详情请见: http://mp.weixin.qq.com/wiki/4/b3546879f07623cb30df9ca0e420a5d0.html

指定者:: materialVideoInfo 在接口中 WxMpService
参数:: media_id - 永久素材的id
返回:
抛出:: WxErrorException

materialNewsInfo

public WxMpMaterialNews materialNewsInfo(String media_id)
                                  throws WxErrorException

从接口复制的说明: WxMpService

 获取图文永久素材的信息

 详情请见: http://mp.weixin.qq.com/wiki/4/b3546879f07623cb30df9ca0e420a5d0.html

指定者:: materialNewsInfo 在接口中 WxMpService
参数:: media_id - 永久素材的id
返回:
抛出:: WxErrorException

materialNewsUpdate

public boolean materialNewsUpdate(WxMpMaterialArticleUpdate wxMpMaterialArticleUpdate)
                           throws WxErrorException

从接口复制的说明: WxMpService

 更新图文永久素材

 详情请见: http://mp.weixin.qq.com/wiki/4/19a59cba020d506e767360ca1be29450.html

指定者:: materialNewsUpdate 在接口中 WxMpService
参数:: wxMpMaterialArticleUpdate - 用来更新图文素材的bean, 请看WxMpMaterialArticleUpdate
返回:
抛出:: WxErrorException

materialDelete

public boolean materialDelete(String media_id)
                       throws WxErrorException

从接口复制的说明: WxMpService

 删除永久素材

 详情请见: http://mp.weixin.qq.com/wiki/5/e66f61c303db51a6c0f90f46b15af5f5.html

指定者:: materialDelete 在接口中 WxMpService
参数:: media_id - 永久素材的id
返回:
抛出:: WxErrorException

materialCount

public WxMpMaterialCountResult materialCount()
                                      throws WxErrorException

从接口复制的说明: WxMpService

 获取各类素材总数

 详情请见: http://mp.weixin.qq.com/wiki/16/8cc64f8c189674b421bee3ed403993b8.html

指定者:: materialCount 在接口中 WxMpService
返回:
抛出:: WxErrorException

materialNewsBatchGet

public WxMpMaterialNewsBatchGetResult materialNewsBatchGet(int offset,
                                                  int count)
                                                    throws WxErrorException

从接口复制的说明: WxMpService

 分页获取图文素材列表

 详情请见: http://mp.weixin.qq.com/wiki/12/2108cd7aafff7f388f41f37efa710204.html

指定者:: materialNewsBatchGet 在接口中 WxMpService
参数:: offset - 从全部素材的该偏移位置开始返回，0表示从第一个素材返回; count - 返回素材的数量，取值在1到20之间
返回:
抛出:: WxErrorException

materialFileBatchGet

public WxMpMaterialFileBatchGetResult materialFileBatchGet(String type,
                                                  int offset,
                                                  int count)
                                                    throws WxErrorException

从接口复制的说明: WxMpService

 分页获取其他媒体素材列表

 详情请见: http://mp.weixin.qq.com/wiki/12/2108cd7aafff7f388f41f37efa710204.html

指定者:: materialFileBatchGet 在接口中 WxMpService
参数:: type - 媒体类型, 请看WxConsts; offset - 从全部素材的该偏移位置开始返回，0表示从第一个素材返回; count - 返回素材的数量，取值在1到20之间
返回:
抛出:: WxErrorException

massNewsUpload
```
public WxMpMassUploadResult massNewsUpload(WxMpMassNews news)
                                    throws WxErrorException
```
从接口复制的说明: WxMpService
```
 上传群发用的图文消息，上传后才能群发图文消息

 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=高级群发接口
 
```
指定者:

massNewsUpload 在接口中 WxMpService

抛出:

WxErrorException
另请参阅:
WxMpService.massGroupMessageSend(me.chanjar.weixin.mp.bean.WxMpMassGroupMessage), WxMpService.massOpenIdsMessageSend(me.chanjar.weixin.mp.bean.WxMpMassOpenIdsMessage)

massVideoUpload
```
public WxMpMassUploadResult massVideoUpload(WxMpMassVideo video)
                                     throws WxErrorException
```
从接口复制的说明: WxMpService
```
 上传群发用的视频，上传后才能群发视频消息
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=高级群发接口
 
```
指定者:

massVideoUpload 在接口中 WxMpService

返回:

抛出:

WxErrorException
另请参阅:
WxMpService.massGroupMessageSend(me.chanjar.weixin.mp.bean.WxMpMassGroupMessage), WxMpService.massOpenIdsMessageSend(me.chanjar.weixin.mp.bean.WxMpMassOpenIdsMessage)

massGroupMessageSend

public WxMpMassSendResult massGroupMessageSend(WxMpMassGroupMessage message)
                                        throws WxErrorException

从接口复制的说明: WxMpService

 分组群发消息
 如果发送图文消息，必须先使用 WxMpService.massNewsUpload(me.chanjar.weixin.mp.bean.WxMpMassNews) 获得media_id，然后再发送
 如果发送视频消息，必须先使用 WxMpService.massVideoUpload(me.chanjar.weixin.mp.bean.WxMpMassVideo) 获得media_id，然后再发送
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=高级群发接口

指定者:: massGroupMessageSend 在接口中 WxMpService
返回:
抛出:: WxErrorException

massOpenIdsMessageSend

public WxMpMassSendResult massOpenIdsMessageSend(WxMpMassOpenIdsMessage message)
                                          throws WxErrorException

从接口复制的说明: WxMpService

 按openId列表群发消息
 如果发送图文消息，必须先使用 WxMpService.massNewsUpload(me.chanjar.weixin.mp.bean.WxMpMassNews) 获得media_id，然后再发送
 如果发送视频消息，必须先使用 WxMpService.massVideoUpload(me.chanjar.weixin.mp.bean.WxMpMassVideo) 获得media_id，然后再发送
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=高级群发接口

指定者:: massOpenIdsMessageSend 在接口中 WxMpService
返回:
抛出:: WxErrorException

groupCreate

public WxMpGroup groupCreate(String name)
                      throws WxErrorException

从接口复制的说明: WxMpService

 分组管理接口 - 创建分组
 最多支持创建500个分组
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=分组管理接口

指定者:: groupCreate 在接口中 WxMpService
参数:: name - 分组名字（30个字符以内）
抛出:: WxErrorException

groupGet

public List<WxMpGroup> groupGet()
                         throws WxErrorException

从接口复制的说明: WxMpService

 分组管理接口 - 查询所有分组
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=分组管理接口

指定者:: groupGet 在接口中 WxMpService
返回:
抛出:: WxErrorException

userGetGroup

public long userGetGroup(String openid)
                  throws WxErrorException

从接口复制的说明: WxMpService

 分组管理接口 - 查询用户所在分组
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=分组管理接口

指定者:: userGetGroup 在接口中 WxMpService
参数:: openid - 微信用户的openid
抛出:: WxErrorException

groupUpdate

public void groupUpdate(WxMpGroup group)
                 throws WxErrorException

从接口复制的说明: WxMpService

 分组管理接口 - 修改分组名
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=分组管理接口

 如果id为0(未分组),1(黑名单),2(星标组)，或者不存在的id，微信会返回系统繁忙的错误

指定者:: groupUpdate 在接口中 WxMpService
参数:: group - 要更新的group，group的id,name必须设置
抛出:: WxErrorException

userUpdateGroup

public void userUpdateGroup(String openid,
                   long to_groupid)
                     throws WxErrorException

从接口复制的说明: WxMpService

 分组管理接口 - 移动用户分组
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=分组管理接口

 如果to_groupid为0(未分组),1(黑名单),2(星标组)，或者不存在的id，微信会返回系统繁忙的错误

指定者:: userUpdateGroup 在接口中 WxMpService
参数:: openid - 用户openid; to_groupid - 移动到的分组id
抛出:: WxErrorException

userUpdateRemark

public void userUpdateRemark(String openid,
                    String remark)
                      throws WxErrorException

从接口复制的说明: WxMpService

 设置用户备注名接口
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=设置用户备注名接口

指定者:: userUpdateRemark 在接口中 WxMpService
参数:: openid - 用户openid; remark - 备注名
抛出:: WxErrorException

userInfo

public WxMpUser userInfo(String openid,
                String lang)
                  throws WxErrorException

从接口复制的说明: WxMpService

 获取用户基本信息
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=获取用户基本信息

指定者:: userInfo 在接口中 WxMpService
参数:: openid - 用户openid; lang - 语言，zh_CN 简体(默认)，zh_TW 繁体，en 英语
返回:
抛出:: WxErrorException

userList

public WxMpUserList userList(String next_openid)
                      throws WxErrorException

从接口复制的说明: WxMpService

 获取关注者列表
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=获取关注者列表

指定者:: userList 在接口中 WxMpService
参数:: next_openid - 可选，第一个拉取的OPENID，null为从头开始拉取
返回:
抛出:: WxErrorException

qrCodeCreateTmpTicket

public WxMpQrCodeTicket qrCodeCreateTmpTicket(int scene_id,
                                     Integer expire_seconds)
                                       throws WxErrorException

从接口复制的说明: WxMpService

 换取临时二维码ticket
 详情请见: 生成带参数的二维码

指定者:: qrCodeCreateTmpTicket 在接口中 WxMpService
参数:: scene_id - 参数。; expire_seconds - 过期秒数，默认60秒，最小60秒，最大1800秒
返回:
抛出:: WxErrorException

qrCodeCreateLastTicket
```
public WxMpQrCodeTicket qrCodeCreateLastTicket(int scene_id)
                                        throws WxErrorException
```
从接口复制的说明: WxMpService
```
 换取永久二维码ticket
 详情请见: 生成带参数的二维码
 
```
指定者:

qrCodeCreateLastTicket 在接口中 WxMpService

参数:
scene_id - 参数。永久二维码时最大值为100000（目前参数只支持1--100000）

返回:

抛出:

WxErrorException

qrCodeCreateLastTicket

public WxMpQrCodeTicket qrCodeCreateLastTicket(String scene_str)
                                        throws WxErrorException

从接口复制的说明: WxMpService

 换取永久字符串二维码ticket
 详情请见: 生成带参数的二维码

指定者:: qrCodeCreateLastTicket 在接口中 WxMpService
参数:: scene_str - 参数。字符串类型长度现在为1到64
返回:
抛出:: WxErrorException

qrCodePicture

public File qrCodePicture(WxMpQrCodeTicket ticket)
                   throws WxErrorException

从接口复制的说明: WxMpService

 换取二维码图片文件，jpg格式
 详情请见: 生成带参数的二维码

指定者:: qrCodePicture 在接口中 WxMpService
参数:: ticket - 二维码ticket
返回:
抛出:: WxErrorException

qrCodePictureUrl

public String qrCodePictureUrl(String ticket,
                      boolean needShortUrl)
                        throws WxErrorException

从接口复制的说明: WxMpService

 换取二维码图片url地址（可以选择是否生成压缩的网址）
 详情请见: 生成带参数的二维码

指定者:: qrCodePictureUrl 在接口中 WxMpService
参数:: ticket - 二维码ticket; needShortUrl - 是否需要压缩的二维码地址
返回:
抛出:: WxErrorException

qrCodePictureUrl

public String qrCodePictureUrl(String ticket)
                        throws WxErrorException

从接口复制的说明: WxMpService

 换取二维码图片url地址
 详情请见: 生成带参数的二维码

指定者:: qrCodePictureUrl 在接口中 WxMpService
参数:: ticket - 二维码ticket
返回:
抛出:: WxErrorException

shortUrl

public String shortUrl(String long_url)
                throws WxErrorException

从接口复制的说明: WxMpService

 长链接转短链接接口
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=长链接转短链接接口

指定者:: shortUrl 在接口中 WxMpService
返回:
抛出:: WxErrorException

templateSend

public String templateSend(WxMpTemplateMessage templateMessage)
                    throws WxErrorException

从接口复制的说明: WxMpService

 发送模板消息
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=模板消息接口

指定者:: templateSend 在接口中 WxMpService
返回:: msgid
抛出:: WxErrorException

semanticQuery

public WxMpSemanticQueryResult semanticQuery(WxMpSemanticQuery semanticQuery)
                                      throws WxErrorException

从接口复制的说明: WxMpService

 语义查询接口
 详情请见：http://mp.weixin.qq.com/wiki/index.php?title=语义理解

指定者:: semanticQuery 在接口中 WxMpService
返回:
抛出:: WxErrorException

oauth2buildAuthorizationUrl

public String oauth2buildAuthorizationUrl(String scope,
                                 String state)

从接口复制的说明: WxMpService

 构造oauth2授权的url连接
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=网页授权获取用户基本信息

指定者:: oauth2buildAuthorizationUrl 在接口中 WxMpService
返回:: url

oauth2buildAuthorizationUrl

public String oauth2buildAuthorizationUrl(String redirectURI,
                                 String scope,
                                 String state)

从接口复制的说明: WxMpService

 构造oauth2授权的url连接
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=网页授权获取用户基本信息

指定者:: oauth2buildAuthorizationUrl 在接口中 WxMpService
参数:: redirectURI - 用户授权完成后的重定向链接，无需urlencode, 方法内会进行encode
返回:: url

oauth2getAccessToken

public WxMpOAuth2AccessToken oauth2getAccessToken(String code)
                                           throws WxErrorException

从接口复制的说明: WxMpService

 用code换取oauth2的access token
 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=网页授权获取用户基本信息

指定者:: oauth2getAccessToken 在接口中 WxMpService
返回:
抛出:: WxErrorException

oauth2refreshAccessToken

public WxMpOAuth2AccessToken oauth2refreshAccessToken(String refreshToken)
                                               throws WxErrorException

从接口复制的说明: WxMpService

 刷新oauth2的access token

指定者:: oauth2refreshAccessToken 在接口中 WxMpService
返回:
抛出:: WxErrorException

oauth2getUserInfo

public WxMpUser oauth2getUserInfo(WxMpOAuth2AccessToken oAuth2AccessToken,
                         String lang)
                           throws WxErrorException

从接口复制的说明: WxMpService

 用oauth2获取用户信息, 当前面引导授权时的scope是snsapi_userinfo的时候才可以

指定者:: oauth2getUserInfo 在接口中 WxMpService; lang - zh_CN, zh_TW, en
抛出:: WxErrorException

oauth2validateAccessToken

public boolean oauth2validateAccessToken(WxMpOAuth2AccessToken oAuth2AccessToken)

从接口复制的说明: WxMpService

 验证oauth2的access token是否有效

指定者:: oauth2validateAccessToken 在接口中 WxMpService
返回:

getCallbackIP

public String[] getCallbackIP()
                       throws WxErrorException

从接口复制的说明: WxMpService

 获取微信服务器IP地址
 http://mp.weixin.qq.com/wiki/0/2ad4b6bfd29f30f71d39616c2a0fcedc.html

指定者:: getCallbackIP 在接口中 WxMpService
返回:
抛出:: WxErrorException

getUserSummary

public List<WxMpUserSummary> getUserSummary(Date beginDate,
                                   Date endDate)
                                     throws WxErrorException

从接口复制的说明: WxMpService

 获取用户增减数据
 http://mp.weixin.qq.com/wiki/3/ecfed6e1a0a03b5f35e5efac98e864b7.html

指定者:: getUserSummary 在接口中 WxMpService
参数:: beginDate - 最大时间跨度7天; endDate - endDate不能早于begingDate
返回:
抛出:: WxErrorException

getUserCumulate

public List<WxMpUserCumulate> getUserCumulate(Date beginDate,
                                     Date endDate)
                                       throws WxErrorException

从接口复制的说明: WxMpService

 获取累计用户数据
 http://mp.weixin.qq.com/wiki/3/ecfed6e1a0a03b5f35e5efac98e864b7.html

指定者:: getUserCumulate 在接口中 WxMpService
参数:: beginDate - 最大时间跨度7天; endDate - endDate不能早于begingDate
返回:
抛出:: WxErrorException

get
```
public String get(String url,
         String queryParam)
           throws WxErrorException
```
从接口复制的说明: WxMpService

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

指定者:

get 在接口中 WxMpService

返回:

抛出:

WxErrorException

post
```
public String post(String url,
          String postData)
            throws WxErrorException
```
从接口复制的说明: WxMpService

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

指定者:

post 在接口中 WxMpService

返回:

抛出:

WxErrorException

execute
```
public <T,E> T execute(RequestExecutor<T,E> executor,
              String uri,
              E data)
          throws WxErrorException
```
向微信端发送请求，在这里执行的策略是当发生access_token过期时才去刷新，然后重新执行请求，而不是全局定时请求

指定者:

execute 在接口中 WxMpService

参数:
executor -
uri -
data -

返回:

抛出:

WxErrorException

executeInternal

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

抛出:: WxErrorException

getHttpclient

protected org.apache.http.impl.client.CloseableHttpClient getHttpclient()

setWxMpConfigStorage
```
public void setWxMpConfigStorage(WxMpConfigStorage wxConfigProvider)
```
从接口复制的说明: WxMpService

注入 WxMpConfigStorage 的实现

指定者:

setWxMpConfigStorage 在接口中 WxMpService

getWxMpConfigStorage

public WxMpConfigStorage getWxMpConfigStorage()

setRetrySleepMillis

public void setRetrySleepMillis(int retrySleepMillis)

从接口复制的说明: WxMpService

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

指定者:: setRetrySleepMillis 在接口中 WxMpService

setMaxRetryTimes

public void setMaxRetryTimes(int maxRetryTimes)

从接口复制的说明: WxMpService

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

指定者:: setMaxRetryTimes 在接口中 WxMpService

getPrepayId

public WxMpPrepayIdResult getPrepayId(String openId,
                             String outTradeNo,
                             double amt,
                             String body,
                             String tradeType,
                             String ip,
                             String callbackUrl)

从接口复制的说明: WxMpService

统一下单(详见http://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_1) 在发起微信支付前，需要调用统一下单接口，获取"预支付交易会话标识"

指定者:: getPrepayId 在接口中 WxMpService
参数:: openId - 支付人openId; outTradeNo - 商户端对应订单号; amt - 金额(单位元); body - 商品描述; tradeType - 交易类型 JSAPI，NATIVE，APP，WAP; ip - 发起支付的客户端IP; callbackUrl - 通知地址
返回:

getPrepayId
```
public WxMpPrepayIdResult getPrepayId(Map<String,String> parameters)
```
从接口复制的说明: WxMpService

统一下单(详见http://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_1) 在发起微信支付前，需要调用统一下单接口，获取"预支付交易会话标识"

指定者:

getPrepayId 在接口中 WxMpService

参数:
parameters - All required/optional parameters for weixin payment

返回:

getJsapiPayInfo
```
public Map<String,String> getJsapiPayInfo(String openId,
                                 String outTradeNo,
                                 double amt,
                                 String body,
                                 String ip,
                                 String callbackUrl)
                                   throws WxErrorException
```
从接口复制的说明: WxMpService

该接口调用“统一下单”接口，并拼装JSAPI发起支付请求需要的参数详见http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E5.8F.91.E8.B5.B7.E4.B8.80.E4.B8.AA.E5.BE.AE.E4.BF.A1.E6.94.AF.E4.BB.98.E8.AF.B7.E6.B1.82 tradeType 交易类型 JSAPI(其他交易类型NATIVE，APP，WAP)

指定者:

getJsapiPayInfo 在接口中 WxMpService

参数:
openId - 支付人openId
outTradeNo - 商户端对应订单号
amt - 金额(单位元)
body - 商品描述
ip - 发起支付的客户端IP
callbackUrl - 通知地址

返回:

抛出:

WxErrorException

getNativePayInfo
```
public Map<String,String> getNativePayInfo(String productId,
                                  String outTradeNo,
                                  double amt,
                                  String body,
                                  String ip,
                                  String callbackUrl)
                                    throws WxErrorException
```
从接口复制的说明: WxMpService

该接口调用“统一下单”接口，并拼装NATIVE发起支付请求需要的参数详见http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E5.8F.91.E8.B5.B7.E4.B8.80.E4.B8.AA.E5.BE.AE.E4.BF.A1.E6.94.AF.E4.BB.98.E8.AF.B7.E6.B1.82 tradeType 交易类型 NATIVE （其他交易类型JSAPI，APP，WAP）

指定者:

getNativePayInfo 在接口中 WxMpService

参数:
productId - 商户商品ID
outTradeNo - 商户端对应订单号
amt - 金额(单位元)
body - 商品描述
ip - 发起支付的客户端IP
callbackUrl - 通知地址

返回:

抛出:

WxErrorException

getPayInfo
```
public Map<String,String> getPayInfo(Map<String,String> parameters)
                              throws WxErrorException
```
从接口复制的说明: WxMpService

该接口调用“统一下单”接口，并拼装发起支付请求需要的参数详见http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E5.8F.91.E8.B5.B7.E4.B8.80.E4.B8.AA.E5.BE.AE.E4.BF.A1.E6.94.AF.E4.BB.98.E8.AF.B7.E6.B1.82

指定者:

getPayInfo 在接口中 WxMpService

参数:
parameters - the required or optional parameters

返回:

抛出:

WxErrorException

getJSSDKPayResult
```
public WxMpPayResult getJSSDKPayResult(String transactionId,
                              String outTradeNo)
```
从接口复制的说明: WxMpService

该接口提供所有微信支付订单的查询,当支付通知处理异常戒丢失的情冴,商户可以通过该接口查询订单支付状态。详见http://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_2

指定者:

getJSSDKPayResult 在接口中 WxMpService

getJSSDKCallbackData
```
public WxMpPayCallback getJSSDKCallbackData(String xmlData)
```
从接口复制的说明: WxMpService

读取支付结果通知详见http://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_7

指定者:

getJSSDKCallbackData 在接口中 WxMpService

返回:

refundPay
```
public WxMpPayRefundResult refundPay(Map<String,String> parameters)
                              throws WxErrorException
```
从接口复制的说明: WxMpService

微信支付-申请退款详见 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_4

指定者:

refundPay 在接口中 WxMpService

参数:
parameters - 需要传入的退款参数的Map。以下几项为参数的必须项：

transaction_id
out_trade_no （仅在上述transaction_id为空时是必须项）
out_refund_no
total_fee
refund_fee

返回:
退款操作结果

抛出:

WxErrorException

checkJSSDKCallbackDataSignature

public boolean checkJSSDKCallbackDataSignature(Map<String,String> kvm,
                                      String signature)

从接口复制的说明: WxMpService

 计算Map键值对是否和签名相符,
 按照字段名的 ASCII 码从小到大排序(字典序)后,使用 URL 键值对的 格式(即 key1=value1&key2=value2...)拼接成字符串

指定者:: checkJSSDKCallbackDataSignature 在接口中 WxMpService
返回:

sendRedpack
```
public WxRedpackResult sendRedpack(Map<String,String> parameters)
                            throws WxErrorException
```
从接口复制的说明: WxMpService

发送微信红包给个人用户需要传入的必填参数如下: mch_billno//商户订单号 send_name//商户名称 re_openid//用户openid total_amount//红包总额 total_num//红包发放总人数 wishing//红包祝福语 client_ip//服务器Ip地址 act_name//活动名称 remark //备注文档详见:https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_5 使用现金红包功能需要在xml配置文件中额外设置: 微信商户平台ID 商户平台设置的API密钥

指定者:

sendRedpack 在接口中 WxMpService

返回:

抛出:

WxErrorException

getCardApiTicket
```
public String getCardApiTicket()
                        throws WxErrorException
```
获得卡券api_ticket，不强制刷新卡券api_ticket

指定者:

getCardApiTicket 在接口中 WxMpService

返回:
卡券api_ticket

抛出:

WxErrorException
另请参阅:
getCardApiTicket(boolean)

getCardApiTicket

public String getCardApiTicket(boolean forceRefresh)
                        throws WxErrorException

 获得卡券api_ticket
 获得时会检查卡券apiToken是否过期，如果过期了，那么就刷新一下，否则就什么都不干

 详情请见：http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E9.99.84.E5.BD
 .954-.E5.8D.A1.E5.88.B8.E6.89.A9.E5.B1.95.E5.AD.97.E6.AE.B5.E5.8F.8A.E7.AD.BE.E5.90.8D.E7.94
 .9F.E6.88.90.E7.AE.97.E6.B3.95

指定者:: getCardApiTicket 在接口中 WxMpService
参数:: forceRefresh - 强制刷新
返回:: 卡券api_ticket
抛出:: WxErrorException

createCardApiSignature

public WxCardApiSignature createCardApiSignature(String... optionalSignParam)
                                          throws WxErrorException

 创建调用卡券api时所需要的签名

 详情请见：http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E9.99.84.E5.BD
 .954-.E5.8D.A1.E5.88.B8.E6.89.A9.E5.B1.95.E5.AD.97.E6.AE.B5.E5.8F.8A.E7.AD.BE.E5.90.8D.E7.94
 .9F.E6.88.90.E7.AE.97.E6.B3.95

指定者:: createCardApiSignature 在接口中 WxMpService
参数:: optionalSignParam - 参与签名的参数数组。可以为下列字段：app_id, card_id, card_type, code, openid, location_id
注意：当做wx.chooseCard调用时，必须传入app_id参与签名，否则会造成签名失败导致拉取卡券列表为空
返回:: 卡券Api签名对象
抛出:: WxErrorException

decryptCardCode
```
public String decryptCardCode(String encryptCode)
                       throws WxErrorException
```
卡券Code解码

指定者:

decryptCardCode 在接口中 WxMpService

参数:
encryptCode - 加密Code，通过JSSDK的chooseCard接口获得

返回:
解密后的Code

抛出:

WxErrorException

queryCardCode
```
public WxMpCardResult queryCardCode(String cardId,
                           String code,
                           boolean checkConsume)
                             throws WxErrorException
```
卡券Code查询

指定者:

queryCardCode 在接口中 WxMpService

参数:
cardId - 卡券ID代表一类卡券
code - 单张卡券的唯一标准
checkConsume - 是否校验code核销状态，填入true和false时的code异常状态返回数据不同

返回:
WxMpCardResult对象

抛出:

WxErrorException

consumeCardCode
```
public String consumeCardCode(String code)
                       throws WxErrorException
```
卡券Code核销。核销失败会抛出异常

指定者:

consumeCardCode 在接口中 WxMpService

参数:
code - 单张卡券的唯一标准

返回:
调用返回的JSON字符串。
可用 com.google.gson.JsonParser#parse 等方法直接取JSON串中的errcode等信息。

抛出:

WxErrorException

consumeCardCode
```
public String consumeCardCode(String code,
                     String cardId)
                       throws WxErrorException
```
卡券Code核销。核销失败会抛出异常

指定者:

consumeCardCode 在接口中 WxMpService

参数:
code - 单张卡券的唯一标准
cardId - 当自定义Code卡券时需要传入card_id

返回:
调用返回的JSON字符串。
可用 com.google.gson.JsonParser#parse 等方法直接取JSON串中的errcode等信息。

抛出:

WxErrorException

markCardCode
```
public void markCardCode(String code,
                String cardId,
                String openId,
                boolean isMark)
                  throws WxErrorException
```
卡券Mark接口。开发者在帮助消费者核销卡券之前，必须帮助先将此code（卡券串码）与一个openid绑定（即mark住），才能进一步调用核销接口，否则报错。

指定者:

markCardCode 在接口中 WxMpService

参数:
code - 卡券的code码
cardId - 卡券的ID
openId - 用券用户的openid
isMark - 是否要mark（占用）这个code，填写true或者false，表示占用或解除占用

抛出:

WxErrorException

getCardDetail
```
public String getCardDetail(String cardId)
                     throws WxErrorException
```
从接口复制的说明: WxMpService

查看卡券详情接口详见 https://mp.weixin.qq.com/wiki/14/8dd77aeaee85f922db5f8aa6386d385e.html#.E6.9F.A5.E7.9C.8B.E5.8D.A1.E5.88.B8.E8.AF.A6.E6.83.85

指定者:

getCardDetail 在接口中 WxMpService

参数:
cardId - 卡券的ID

返回:
返回的卡券详情JSON字符串
[注] 由于返回的JSON格式过于复杂，难以定义其对应格式的Bean并且难以维护，因此只返回String格式的JSON串。
可由 com.google.gson.JsonParser#parse 等方法直接取JSON串中的某个字段。

抛出:

WxErrorException

massMessagePreview

public WxMpMassSendResult massMessagePreview(WxMpMassPreviewMessage wxMpMassPreviewMessage)
                                      throws Exception

从接口复制的说明: WxMpService

 预览接口
 详情请见：http://mp.weixin.qq.com/wiki/15/40b6865b893947b764e2de8e4a1fb55f.html#.E9.A2.84.E8.A7.88.E6.8E.A5.E5.8F.A3.E3.80.90.E8.AE.A2.E9.98.85.E5.8F.B7.E4.B8.8E.E6.9C.8D.E5.8A.A1.E5.8F.B7.E8.AE.A4.E8.AF.81.E5.90.8E.E5.9D.87.E5.8F.AF.E7.94.A8.E3.80.91

指定者:: massMessagePreview 在接口中 WxMpService
返回:: wxMpMassSendResult
抛出:: WxErrorException; Exception

mediaImgUpload

public WxMediaImgUploadResult mediaImgUpload(File file)
                                      throws WxErrorException

从接口复制的说明: WxMpService

 上传图文消息内的图片获取URL
 详情请见：http://mp.weixin.qq.com/wiki/15/40b6865b893947b764e2de8e4a1fb55f.html#.E4.B8.8A.E4.BC.A0.E5.9B.BE.E6.96.87.E6.B6.88.E6.81.AF.E5.86.85.E7.9A.84.E5.9B.BE.E7.89.87.E8.8E.B7.E5.8F.96URL.E3.80.90.E8.AE.A2.E9.98.85.E5.8F.B7.E4.B8.8E.E6.9C.8D.E5.8A.A1.E5.8F.B7.E8.AE.A4.E8.AF.81.E5.90.8E.E5.9D.87.E5.8F.AF.E7.94.A8.E3.80.91

指定者:: mediaImgUpload 在接口中 WxMpService
返回:: WxMediaImgUploadResult 返回图片url
抛出:: WxErrorException

setIndustry

public String setIndustry(WxMpIndustry wxMpIndustry)
                   throws WxErrorException

从接口复制的说明: WxMpService

 设置所属行业
 官方文档中暂未告知响应内容
 详情请见：http://mp.weixin.qq.com/wiki/5/6dde9eaa909f83354e0094dc3ad99e05.html#.E8.AE.BE.E7.BD.AE.E6.89.80.E5.B1.9E.E8.A1.8C.E4.B8.9A

指定者:: setIndustry 在接口中 WxMpService
返回:: JsonObject
抛出:: WxErrorException

getIndustry

public WxMpIndustry getIndustry()
                         throws WxErrorException

从接口复制的说明: WxMpService

 获取设置的行业信息
 详情请见：http://mp.weixin.qq.com/wiki/5/6dde9eaa909f83354e0094dc3ad99e05.html#.E8.AE.BE.E7.BD.AE.E6.89.80.E5.B1.9E.E8.A1.8C.E4.B8.9A

指定者:: getIndustry 在接口中 WxMpService
返回:: wxMpIndustry
抛出:: WxErrorException

getKefuService
```
public WxMpKefuService getKefuService()
```
从接口复制的说明: WxMpService

返回客服接口方法实现类，以方便调用个其各种接口

指定者:

getKefuService 在接口中 WxMpService

返回:
WxMpKefuService

类 WxMpServiceImpl

字段概要

从接口继承的字段 me.chanjar.weixin.mp.api.WxMpService

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

log

globalAccessTokenRefreshLock

globalJsapiTicketRefreshLock

globalCardApiTicketRefreshLock

wxMpConfigStorage

kefuService

httpClient

httpProxy

sessionManager

构造器详细资料

WxMpServiceImpl

方法详细资料

checkSignature

getAccessToken

getAccessToken

getJsapiTicket

getJsapiTicket

createJsapiSignature

customMessageSend

menuCreate

menuDelete

menuDelete

menuGet

menuTryMatch

mediaUpload

mediaUpload

mediaDownload

materialFileUpload

materialNewsUpload

materialImageOrVoiceDownload

materialVideoInfo

materialNewsInfo

materialNewsUpdate

materialDelete

materialCount

materialNewsBatchGet

materialFileBatchGet

massNewsUpload

massVideoUpload

massGroupMessageSend

massOpenIdsMessageSend

groupCreate

groupGet

userGetGroup

groupUpdate

userUpdateGroup

userUpdateRemark

userInfo

userList

qrCodeCreateTmpTicket

qrCodeCreateLastTicket

qrCodeCreateLastTicket

qrCodePicture

qrCodePictureUrl

qrCodePictureUrl

shortUrl

templateSend

semanticQuery

oauth2buildAuthorizationUrl

oauth2buildAuthorizationUrl

oauth2getAccessToken

oauth2refreshAccessToken

oauth2getUserInfo

oauth2validateAccessToken

getCallbackIP

getUserSummary

getUserCumulate

get

post

execute

executeInternal

getHttpclient

setWxMpConfigStorage