Build development scaffolding from scratch and use WxJava to quickly access wechat official accounts

Address: mp.weixin.qq.com/debug/cgi-b…

The application and authentication process is slow and tedious. You can experience and test all advanced functions of wechat official account in the test account.

Direct wechat scan can apply for a public test account, very convenient and fast.

• Official website document
• Wechat public platform interface debugging tool
• Web Developer Tools
• Test Account Application
• Official wechat document

The Spring the Boot:

<dependency>
  <groupId>com.github.binarywang</groupId>
  <artifactId>weixin-java-mp</artifactId>
  <version>4.0.0</version>
</dependency>
Copy the code

Spring the Boot:

<dependency>
   <groupId>com.github.binarywang</groupId>
   <artifactId>wx-java-mp-spring-boot-starter</artifactId>
   <version>4.0.0</version>
</dependency>
Copy the code

• Wechat applets:weixin-java-miniapp
• Wechat Pay:weixin-java-pay
• Wechat Open Platform:weixin-java-open
• Public account (including subscription account and service account) :weixin-java-mp
• Enterprise Id/Wechat account:weixin-java-cp

@API (tags = "wechat official account ")
@ApiSupport(order = 4)
@RequestMapping("/wx")
@RestController
@Slf4j
public class WxController {
    @Autowired
    WxMpService wxMpService;

    /** * The url is set to: http://ip:port/wx * If you cannot receive the call from wechat service, open this interface larger, do not limit GET */
    @GetMapping
    @ApiOperationSupport(order = 1)
    @apiOperation (value = "service authentication ")
    public String transfer(String signature, String timestamp, String nonce, String echostr) {
        log.info(Received authentication message from wechat server: signature: {}, TIMESTAMP: {}, nonce: {}, echostr: {}", signature, timestamp, nonce
                , echostr);
        if(! wxMpService.checkSignature(timestamp, nonce, signature)) { log.error("Message is illegal.");
            return "error";
        }
        return echostr;
    }
Copy the code

Note that the interface address here corresponds to the URL configured on the wechat platform above.

Service Access Authentication Flowchart:

It’s a good connection at this point.

String nextOpenid = null;// Optional, the first pull OPENID, null is pulled from scratch
WxMpUserList wxMpUserList = wxMpService.getUserService().userList(nextOpenid);
Copy the code

Results:

{
    "total": 1."count": 1."openids": [
      "xxxx"]."nextOpenid": "xxxx"
  }
Copy the code

Realize third-party wechat login function.

If a user accesses a third-party web page in the wechat client, the public account can obtain the user’s basic information through the wechat web page authorization mechanism, so as to realize the business logic.

Address: document developers.weixin.qq.com/doc/offiacc…

1. Set the webpage authorization callback domain name

Before the wechat public account requests the user’s webpage authorization, the developer needs to modify the authorization callback domain name in the configuration option of “development – interface permission – Webpage service – Webpage account – Webpage authorization to obtain the user’s basic information” in the official website of the public platform. Please note that this is the domain name (a string), not the URL, so do not include protocol headers such as http:// (enter: www.laker.com).

Matters needing attention:

• The sandbox (test) callback address supports the domain name and IP address. The official public callback address supports only the domain name and the combination of letters, digits, and hyphens (-). The domain name must be verified by ICP.
• Test number: find web page authorization to get basic user information > Modify > Set domain name
• Service number: Go to Development > Interface Rights > Web page Rights to obtain basic user information >> Click Modify > Set Domain name
• Do not add protocol headers such as http:// to the domain name

2. Wechat webpage authorization – Sequence diagram of process

3. Construct a web page authorization URL

First, construct a web page authorization URL, and then form a hyperlink for users to click, for example, build a custom menu jump URL button type (VIEW).

WxMpService wxMpService = ... ; String url = ... ; wxMpService.getOauth2Service().buildAuthorizationUrl(url, WxConsts.OAuth2Scope.SNSAPI_USERINFO,null)
Copy the code

4. Obtain basic user information

When the user agrees to authorize, the url will be called back and the authorization code will be transmitted. Then, the code will be used to obtain access token, which also contains the user’s OpenID and other information.

WxMpOAuth2AccessToken wxMpOAuth2AccessToken = wxMpService.getOAuth2Service().getAccessToken(code);
WxMpUser wxMpUser = wxMpService.getOAuth2Service().getUserInfo(wxMpOAuth2AccessToken, null);
Copy the code

Including new and modify, modify is equivalent to overwrite the previous menu.

WxMenu wxMenu = new WxMenu();
// Set the menu
wxMpService.getMenuService().menuCreate(wxMenu);
Copy the code

WxMenu wxMenu = wxMpService.getMenuService().menuGet();
Copy the code

🍎QQ group [837324215] 🍎 pay attention to my public number [Java Factory interview officer], learn together 🍎🍎🍎 🍎 personal vx [Lakernote]