Idea使用HttpClient实现微信小程序的微信登录模块
目录
前言
本篇文章主要介绍HttpClient的使用,并用微信小程序的登录模块讲解了HttpClient具体用法,其中也顺带讲述了微信小程序的开发流程,本篇中HttpUtil工具类可为通用模板,可按照我的步骤实现微信小程序的登录模块的开发。希望本篇文章对各位小伙伴有用。
一、导入HttpClient的maven坐标
在项目文件的pom.xml导入HttpClient坐标
<dependency>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpclient</artifactId>
<version>4.5.13</version>
</dependency>
假如你的项目在使用aliyunOss,那么就不需要导这个坐标,因为aliyunOss的maven坐标底层就是HttpClient,所以可以直接使用。
二、HttpClient发送请求的步骤
2.1.HttpClient发送Get请求
//1.创建HttpClient对象
CloseableHttpClient httpClient = HttpClients.createDefault();
//2.创建Http请求对象
HttpGet httpGet = new HttpGet("http://localhost:8080/user/shop/satus");//请求方式和路径根据自己的需求填写
//3.调用HttpClient的execute方法发送请求
CloseableHttpResponse response = httpClient.execute(httpGet);
//4.获取服务端返回的状态码
int statusCode = response.getStatusLine().getStatusCode();
System.out.println(statusCode);
//5.获取服务端返回的数据
HttpEntity entity = response.getEntity();
//6.对数据进行解析
String body = EntityUtils.toString(entity);
System.out.println(body);
//7.使用完毕释放资源
response.close();
httpClient.close();
2.2 HttpClient发送POST请求
//1.创建HttpClient对象
CloseableHttpClient httpClient = HttpClients.createDefault();
//2.创建Http请求对象
HttpPost httpPost = new HttpPost("http://localhost:8080/admin/employee/login");//请求方式和路径根据自己的需求填写
//3.POST请求要求的是json格式的参数,我们利用fastjson包下的JSONObject创建请求参数
JSONObject jsonObject = new JSONObject();
jsonObject.put("username","admin");
jsonObject.put("password","123456");
//4.构造StringEntity对象
StringEntity stringEntity = new StringEntity(jsonObject.toString());
//5.指定请求编码方式
stringEntity.setContentEncoding("utf-8");
//6.指定请求数据方式
stringEntity.setContentType("application/json");
//7.设置请求参数
httpPost.setEntity(stringEntity);
//8.调用HttpClient的execute方法发送请求
CloseableHttpResponse response = httpClient.execute(httpPost);
//9.获取服务端返回的状态码
int statusCode = response.getStatusLine().getStatusCode();
System.out.println(statusCode);
//10.获取服务端返回的数据
HttpEntity entity = response.getEntity();
//11.对数据进行解析
String body = EntityUtils.toString(entity);
System.out.println(body);
//12.使用完毕释放资源
response.close();
httpClient.close();
2.3 封装为HttpUtil工具类
假如要创建微信小程序,建议先创建一样的工具类,方便后面使用。
/**
* Http工具类
*/
public class HttpClientUtil {
static final int TIMEOUT_MSEC = 5 * 1000;
/**
* 发送GET方式请求
* @param url
* @param paramMap
* @return
*/
public static String doGet(String url,Map<String,String> paramMap){
// 创建Httpclient对象
CloseableHttpClient httpClient = HttpClients.createDefault();
String result = "";
CloseableHttpResponse response = null;
//get请求可能也有参数,若有对情况进行处理
try{
URIBuilder builder = new URIBuilder(url);
if(paramMap != null){
for (String key : paramMap.keySet()) {
builder.addParameter(key,paramMap.get(key));
}
}
URI uri = builder.build();
//创建GET请求
HttpGet httpGet = new HttpGet(uri);
//发送请求
response = httpClient.execute(httpGet);
//判断响应状态
if(response.getStatusLine().getStatusCode() == 200){
result = EntityUtils.toString(response.getEntity(),"UTF-8");
}
}catch (Exception e){
e.printStackTrace();
}finally {
try {
response.close();
httpClient.close();
} catch (IOException e) {
e.printStackTrace();
}
}
return result;
}
/**
* 发送POST方式请求
* @param url
* @param paramMap
* @return
* @throws IOException
*/
public static String doPost(String url, Map<String, String> paramMap) throws IOException {
// 创建Httpclient对象
CloseableHttpClient httpClient = HttpClients.createDefault();
CloseableHttpResponse response = null;
String resultString = "";
try {
// 创建Http Post请求
HttpPost httpPost = new HttpPost(url);
// 创建参数列表
if (paramMap != null) {
List<NameValuePair> paramList = new ArrayList();
for (Map.Entry<String, String> param : paramMap.entrySet()) {
paramList.add(new BasicNameValuePair(param.getKey(), param.getValue()));
}
// 模拟表单
UrlEncodedFormEntity entity = new UrlEncodedFormEntity(paramList);
httpPost.setEntity(entity);
}
httpPost.setConfig(builderRequestConfig());
// 执行http请求
response = httpClient.execute(httpPost);
resultString = EntityUtils.toString(response.getEntity(), "UTF-8");
} catch (Exception e) {
throw e;
} finally {
try {
response.close();
} catch (IOException e) {
e.printStackTrace();
}
}
return resultString;
}
/**
* 发送POST方式请求
* @param url
* @param paramMap
* @return
* @throws IOException
*/
public static String doPost4Json(String url, Map<String, String> paramMap) throws IOException {
// 创建Httpclient对象
CloseableHttpClient httpClient = HttpClients.createDefault();
CloseableHttpResponse response = null;
String resultString = "";
try {
// 创建Http Post请求
HttpPost httpPost = new HttpPost(url);
if (paramMap != null) {
//构造json格式数据
JSONObject jsonObject = new JSONObject();
for (Map.Entry<String, String> param : paramMap.entrySet()) {
jsonObject.put(param.getKey(),param.getValue());
}
StringEntity entity = new StringEntity(jsonObject.toString(),"utf-8");
//设置请求编码
entity.setContentEncoding("utf-8");
//设置数据类型
entity.setContentType("application/json");
httpPost.setEntity(entity);
}
httpPost.setConfig(builderRequestConfig());
// 执行http请求
response = httpClient.execute(httpPost);
resultString = EntityUtils.toString(response.getEntity(), "UTF-8");
} catch (Exception e) {
throw e;
} finally {
try {
response.close();
} catch (IOException e) {
e.printStackTrace();
}
}
return resultString;
}
private static RequestConfig builderRequestConfig() {
return RequestConfig.custom()
.setConnectTimeout(TIMEOUT_MSEC)
.setConnectionRequestTimeout(TIMEOUT_MSEC)
.setSocketTimeout(TIMEOUT_MSEC).build();
}
}
三、微信小程序开发步骤
这一模块,只是对微信小程序的开发流程进行简单的说明,有过开发经历的可以直接跳过。
3.1 微信小程序注册
在微信公众号平台注册小程序,完成注册后同步进行信息的完善和开发
注册地址:小程序 (qq.com)
点击进连接后,依次填写信息,即可完成微信小程序注册。
3.2 小程序信息完善
填写小程序的基本信息,包括名称,头像,介绍和服务范围
(1) 完成小程序注册后,点击立即登录,进行小程序信息的完善
(2) 微信扫码登录
(3) 分别将小程序信息和小程序类目根据自己的需求配置即可;
(4) 点击下方开发管理,获取appId和密钥
(5) 点击开发者设置,保存自己的appId和密钥,后面开发微信小程序有用。保存后可进入下一步
3.3 开发小程序
完成小程序开发者的绑定、开发信息配置后,开发者可以下载开发者工具,参考开发文档进行小程序的开发和调试
(1) 完成开发者工具的安装
开发者工具:
链接:https://pan.baidu.com/s/1li9qjcVqcMPGSz5pYIWWDw?pwd=g6ct
提取码:g6ct
(2)开发者工具填写小程序基本信息
(3)开发者工具开发界面介绍
(4)开发者工具配置选项
因为在开发过程中,可能会发送一些请求,如果不勾选,可能请求发送失败!!!!
(5)了解小程序目录结构
(6)编写小程序代码
(7)编译小程序
以上两步,就是按照你的需求进行小程序的开发,这里就不多赘述啦,本文主要讲述HttpClient,如果对于小程序的开发方面有更多的需求,建议去看看相关课程进行学习。
3.4 提交审核与发布
完成小程序开发后,提交代码至微信团队审核,审核通过后即可发布(公测期间不能发布)
四、使用HttpClient实现微信登录模块
4.1 微信小程序登录模块介绍以及HttpClient的作用
微信小程序中微信登录模块的交互流程
- 调用 wx.login() 获取 临时登录凭证code ,并回传到开发者服务器。
- 调用 auth.code2Session 接口,换取 用户唯一标识 OpenID 、 用户在微信开放平台账号下的唯一标识UnionID(若当前小程序已绑定到微信开放平台账号) 和 会话密钥 session_key。
之后开发者服务器可以根据用户标识来生成自定义登录态,用于后续业务逻辑中前后端交互时识别用户身份。
注解:
在此,我就个人理解来讲解下我对这个图的看法,首先小程序其实就是我们的前端,开发者服务器就是我们的后端,微信接口服务就是微信为我们微信登录模块开设的接口,因为用户的信息储存在微信中,而不是小程序中,小程序调用 wx.login() 获取 临时登录凭证code,然后通过wx.request将code发送给后端,后端通过httpClient对微信进行请求,得到身份凭证,然后进行后端的登录模块设计就可以实现微信小程序的登录模块的设计了。
4.2 微信登录代码实现
(1) 创建配置属性类,方便后面调用
@Component
@ConfigurationProperties(prefix = "sky.wechat") //指定配置项
@Data
public class WeChatProperties {
private String appid; //小程序的appid
private String secret; //小程序的秘钥
private String mchid; //商户号
private String mchSerialNo; //商户API证书的证书序列号
private String privateKeyFilePath; //商户私钥文件
private String apiV3Key; //证书解密的密钥
private String weChatPayCertFilePath; //平台证书
private String notifyUrl; //支付成功的回调地址
private String refundNotifyUrl; //退款成功的回调地址
}
(2)在配置项文件中配置appid和secret 文件名以及用户JWT的相关信息:application.yml
sky:
jwt:
#设置用户JWT令牌
user-secret-key:
# 设置jwt过期时间
user-ttl:
# 设置前端传递过来的令牌名称
user-token-name:
wechat:
appid:
secret:
注:如果不知道自己小程序的appid和secret可以看本文章的第三模块。
(3)ServiceImpl 层的代码
@Service
@Slf4j
public class UserServiceImpl implements UserService {
//微信服务接口地址
public static final String WX_LOGIN="https://api.weixin.qq.com/sns/jscode2session";//固定的地址
@Autowired
private WeChatProperties weChatProperties; //wechat的配置项的配置属性类
@Autowired
private UserMapper userMapper;
/**
* 微信登录
* @param userLoginDTO
* @return
*/
public User wxLogin(UserLoginDTO userLoginDTO) {//UserLoginDTO:用来封装用户登录的输入
//1.调用微信接口得到用户openId
Map<String, String> map = new HashMap<>();
map.put("appid",weChatProperties.getAppid());//从配置项中读取
map.put("secret",weChatProperties.getSecret());//从配置项中读取
map.put("js_code",userLoginDTO.getCode());//由小程序提供
map.put("grant_type","authorization_code");//此处为官方指定
String json = HttpClientUtil.doGet(WX_LOGIN, map);
//解析出openId
JSONObject jsonObject = JSON.parseObject(json);
String openid = jsonObject.getString("openid");
//2.判断是否获取到openId
if(openid == null){
throw new LoginFailedException(MessageConstant.LOGIN_FAILED);//MessageConstant.LOGIN_FAILED=登录异常
}
//3.判断用户是否为新用户,即当前系统里的用户表是否有该openId
//根据openId查询User表
User user = userMapper.getByOpenid(openid);
//如果是新用户,自动完成注册
if(user == null){
user = User.builder()
.openid(openid)
.createTime(LocalDateTime.now())
.build();
userMapper.insert(user);
}
//返回这个用户对象
return user;
}
}
本次主要讲解业务层的代码处理,Controller和Service层代码都是老套路,相信各位有能力解决,并实现,但我这里提一下,Controller除了要实现用户登录之外,还需要为用户配置JWT令牌。
结束语
通过本篇文章,应该大致了解了微信小程序登录模块的大致流程,甚至能够自主的创建微信登录模块。同时能体会到HttpClient的作用,希望本篇文章对各位小伙伴有所帮助,能够解决在项目或学习中遇到的问题,最后,你们的一键三连(点赞、关注、收藏)就是我更新的动力,在此先感谢各位铁铁的支持啦!/鲜花/