java開(kāi)發(fā)者一行代碼搞定微信小程序用戶(hù)認(rèn)證
|
微信小程序開(kāi)發(fā)最基礎(chǔ)的功能就是用戶(hù)的認(rèn)證過(guò)程，在使用spring cloud微服務(wù)架構(gòu)進(jìn)行開(kāi)發(fā)時(shí)為了簡(jiǎn)化開(kāi)發(fā)周期，我們參考Wafer的架構(gòu)，實(shí)現(xiàn)了java版本的會(huì)話(huà)服務(wù)器，由于目前wafer1官方已經(jīng)停止更新，Wafer2服務(wù)器端完全托管在騰訊云，不對(duì)外公開(kāi)會(huì)話(huà)服務(wù)器的實(shí)現(xiàn)，因此我們開(kāi)發(fā)了wxss-spring-boot-starter項(xiàng)目，項(xiàng)目實(shí)現(xiàn)的會(huì)話(huà)服務(wù)器接口參考了Wafer2的小程序客戶(hù)端wafer2-client-sdk的代碼，目前與其完全兼容(僅登錄接口)。
使用方法目前只支持Spring Boot 2.0以上版本。 在您的spring boot項(xiàng)目中引入本項(xiàng)目依賴(lài)，然后增加相應(yīng)功能注解和配置即可。
maven: <dependency> <groupId>com.venusource.ms.base</groupId> <artifactId>wxss-spring-boot-starter</artifactId> <version>1.0.0</version> </dependency>
gradle:
compile('com.venusource.ms.base:wxss-spring-boot-starter:1.0.0')
會(huì)話(huà)服務(wù)器
實(shí)現(xiàn)參考php版本 wafer-session-server ，使用前請(qǐng)?jiān)敿?xì)閱讀。
package com.venusource.ms.base.wxssdemo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import com.venusource.ms.base.wxss.EnableWeChatSessionServer;
@SpringBootApplication
@EnableWeChatSessionServer //啟用會(huì)話(huà)服務(wù)器
public class WxssSpringBootStarterDemoApplication {
public static void main(String[] args) {
SpringApplication.run(WxssSpringBootStarterDemoApplication.class, args);
}
}
在spring的配置文件application.properties中配置小程序的appid和secret，如下所示： weixin.app.appid= yourappid weixin.app.secret= yoursecret
啟動(dòng)服務(wù)后，會(huì)自動(dòng)在服務(wù)內(nèi)對(duì)外暴露/mina_auth 會(huì)話(huà)服務(wù)接口。 接口與php版本完全相同，見(jiàn)wafer-session-server。 注：會(huì)話(huà)服務(wù)會(huì)和微信的服務(wù)器進(jìn)行通信，獲取session_key，需要能訪(fǎng)問(wèn)外網(wǎng)，同時(shí)為了安全性會(huì)話(huà)服務(wù)一般只對(duì)內(nèi)部服務(wù)提供服務(wù)，不對(duì)外暴露接口，因此如果使用Spring Cloud的服務(wù)網(wǎng)關(guān)，需要把它忽略。
Session數(shù)據(jù)的存儲(chǔ) 默認(rèn)情況下，所有的用戶(hù)數(shù)據(jù)存儲(chǔ)在內(nèi)存內(nèi)（不推薦），您需要實(shí)現(xiàn)如下接口來(lái)存儲(chǔ)自己的數(shù)據(jù)：
package com.venusource.ms.base.wxss.service;
import com.venusource.ms.base.wxss.domain.CSessionInfo;
public interface SessionInfoStoreService {
CSessionInfo add(CSessionInfo sessionInfo);
void remove(CSessionInfo sessionInfo);
CSessionInfo update(CSessionInfo sessionInfo);
CSessionInfo get(String skey);
}
在實(shí)現(xiàn)類(lèi)內(nèi)注解@Service即可，系統(tǒng)會(huì)自動(dòng)替換session存儲(chǔ)類(lèi)型。
登錄入口登錄入口是為wafer2客戶(hù)端提供的用戶(hù)授權(quán)登錄地址，您可以自己基于上面的會(huì)話(huà)服務(wù)器單獨(dú)開(kāi)發(fā)，也可以在服務(wù)內(nèi)增加注解@EnableWeChatWaferLoginEndpoint，自動(dòng)提供登錄入口/login，如下所示：
package com.venusource.ms.base.wxssdemo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import com.venusource.ms.base.wxss.EnableWeChatWaferLoginEndpoint;
@SpringBootApplication
@EnableWeChatWaferLoginEndpoint //啟用wafer2登錄入口
public class WxssSpringBootStarterDemoApplication {
public static void main(String[] args) {
SpringApplication.run(WxssSpringBootStarterDemoApplication.class, args);
}
}
在spring的配置文件application.properties中配置會(huì)話(huà)服務(wù)器地址，如下所示： weixin.wafer.authServerUrl = http://ms-session-server/mina_auth/
ms-session-server為在Eureka中注冊(cè)的服務(wù)名，因?yàn)槲覀兪褂胷ibbon作客戶(hù)端負(fù)載，可以部署多個(gè)ms-session-server服務(wù)。
業(yè)務(wù)服務(wù)用戶(hù)信息 基于Spring Cloud微服務(wù)架構(gòu)開(kāi)發(fā)時(shí)，業(yè)務(wù)服務(wù)需要獲取用戶(hù)信息時(shí)，starter可提供自動(dòng)的參數(shù)注入功能，只需要在業(yè)務(wù)服務(wù)內(nèi)增加注解@EnableWeChatUserInfoArgumentInjection即可，如下所示：
package com.venusource.app.oa.microserviceprovideruser;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import com.venusource.ms.base.wxss.EnableWeChatUserInfoArgumentInjection;
@SpringBootApplication
@EnableDiscoveryClient
@EnableWeChatUserInfoArgumentInjection //啟用微信用戶(hù)信息注入。
public class MicroserviceProviderUserApplication {
public static void main(String[] args) {
SpringApplication.run(MicroserviceProviderUserApplication.class, args);
}
}
在spring的配置文件application.properties中配置會(huì)話(huà)服務(wù)器地址，如下所示： weixin.wafer.authServerUrl = http://ms-session-server/mina_auth/
ms-session-server為在Eureka中注冊(cè)的服務(wù)名，因?yàn)槲覀兪褂胷ibbon作客戶(hù)端負(fù)載，可以部署多個(gè)ms-session-server服務(wù)。
在controller的方法參數(shù)中，會(huì)自動(dòng)注入U(xiǎn)serInfo類(lèi)，可以直接獲取登錄用戶(hù)的信息，如下所示：
@GetMapping("/product/{id}")
public Product showInfo(@PathParam Long id, UserInfo userInfo) {
String uid = userInfo.getOpenId();
...
}
項(xiàng)目目前代碼還很丑陋，測(cè)試還不全面，如您在使用中發(fā)現(xiàn)問(wèn)題，請(qǐng)及時(shí)告訴我們，或直接pull request。 |
