本文推荐一个拿来即用Gitee标星14.2k的微信开发工具WxJava。WxJava - 微信开发 Java SDK,支持微信支付、开放平台、公众号、企业号/企业微信、小程序等的后端开发。
链接地址:https://gitee.com/binary
引入maven依赖:
<!--微信公众号-->
<dependency>
<groupId>com.github.binarywang</groupId>
<artifactId>weixin-java-mp</artifactId>
<version>${weixin-java-mp.version}</version>
</dependency>
<!--微信支付-->
<dependency>
<groupId>com.github.binarywang</groupId>
<artifactId>weixin-java-pay</artifactId>
<version>${weixin-java-mp.version}</version>
</dependency>
<dependency>
<groupId>com.github.binarywang</groupId>
<artifactId>weixin-java-common</artifactId>
<version>${weixin-java-mp.version}</version>
</dependency>
<!--微信小程序-->
<dependency>
<groupId>com.github.binarywang</groupId>
<artifactId>weixin-java-miniapp</artifactId>
<version>${weixin-java-mp.version}</version>
</dependency>
配置:
yml文件
config类
package com.api.activity.config;
import com.github.binarywang.wxpay.config.WxPayConfig;
import com.github.binarywang.wxpay.service.WxPayService;
import com.github.binarywang.wxpay.service.impl.WxPayServiceImpl;
import lombok.AllArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.lang3.StringUtils;
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
* 微信支付自动配置类
* @author TangChao
* @create 2022/08/11
*/
@Slf4j
@Configuration
@AllArgsConstructor
@EnableConfigurationProperties({WxPayProperties.class})
public class WxAutoConfiguration {
private WxPayProperties payProperties;
@Bean
@ConditionalOnMissingBean
@ConditionalOnClass(WxPayService.class)
public WxPayService wxService() {
WxPayConfig payConfig = new WxPayConfig();
payConfig.setAppId(StringUtils.trimToNull(this.payProperties.getAppId()));
payConfig.setMchId(StringUtils.trimToNull(this.payProperties.getMchId()));
payConfig.setMchKey(StringUtils.trimToNull(this.payProperties.getMchKey()));
payConfig.setSubAppId(StringUtils.trimToNull(this.payProperties.getSubAppId()));
payConfig.setSubMchId(StringUtils.trimToNull(this.payProperties.getSubMchId()));
payConfig.setKeyPath(StringUtils.trimToNull(this.payProperties.getKeyPath()));
// v3
payConfig.setApiV3Key(StringUtils.trimToNull(this.payProperties.getApiV3Key()));
payConfig.setCertSerialNo(StringUtils.trimToNull(this.payProperties.getCertSerialNo()));
payConfig.setPrivateCertPath(StringUtils.trimToNull(this.payProperties.getPrivateCertPath()));
payConfig.setPrivateKeyPath(StringUtils.trimToNull(this.payProperties.getPrivateKeyPath()));
payConfig.setNotifyUrl(StringUtils.trimToNull(this.payProperties.getNotifyURL()));
//不使用沙箱环境
payConfig.setUseSandboxEnv(false);
WxPayService wxPayService = new WxPayServiceImpl();
wxPayService.setConfig(payConfig);
log.info("微信PAY init");
return wxPayService;
}
}
配置实体类
package com.api.activity.config;
import lombok.Data;
import lombok.ToString;
import org.springframework.boot.context.properties.ConfigurationProperties;
@Data
@ToString
@ConfigurationProperties(prefix = "wx.pay")
public class WxPayProperties {
/**
* 设置微信公众号或者小程序等的appid
*/
private String appId;
/**
* 匠要公众号密钥
*/
private String appSecret;
/**
* 微信支付商户号
*/
private String mchId;
/**
* 微信支付商户密钥
*/
private String mchKey;
/**
* 服务商模式下的子商户公众账号ID,普通模式请不要配置,请在配置文件中将对应项删除
*/
private String subAppId;
/**
* 服务商模式下的子商户号,普通模式请不要配置,最好是请在配置文件中将对应项删除
*/
private String subMchId;
/**
* apiclient_cert.p12文件的绝对路径,或者如果放在项目中,请以classpath:开头指定
*/
private String keyPath;
private String apiV3Key;
private String certSerialNo;
private String privateKeyPath;
private String privateCertPath;
/**
* 回调地址
*/
private String notifyURL;
}
微信支付:
相比于原生的微信支付-统一下单接口,该工具中的统一支付接口调用就突显了其简洁性。
微信回调通知接口不需要再去写代码检验,引入的工具中会检验通知的签名。
微信支付-查询订单号的接口调用也很简单
微信小程序:
工具也封装了微信小程序的登录、获取用户信息的接口,这些都是小程序开发当中无法避免的。
另外该工具还有开放平台、公众号、企业号/企业微信等的后端开发。