2020-12-25 14:41:13

Java Spring Boot 项目与 Discuz! 论坛同步登录登出 会员打通 discuz-ucenter-api-for-java


Java Spring Boot 项目与 Discuz! 论坛同步登录登出 会员打通 discuz-ucenter-api-for-java

我的主站 Spring Boot 与 Discuz! 论坛进行了打通,实现了同步的登录登出,并可以将 Discuz! 论坛中会员的数据回显到我的主站中,并且我对之前开源的 discuz-ucenter-api-for-java 进行了部分修改,以适应当下 Spring Boot 的风格。

首先鸣谢开源

与 Discuz! 打通一般分为通过 API 通讯和数据库通讯,这次介绍的是通过 API 通讯,这就不得不提一下 discuz-ucenter-api-for-java,首先要感谢原作者:梁平 (no_ten@163.com)将他的代码开源,这让我们节省了很多时间。

重新修改开源代码

在我下载源码后我发现这个还是2009年的代码,满满的复古风,而且原作者是根据PHP的代码翻译过去的,所以里面很多习惯并不是Java的习惯,关键还要配置 servlet,也不支持Maven构建。这在现在的 Spring Boot 项目中是格格不入,所以我对源码进行了修改并二次发布。

为了适应 Maven 构建的 Spring Boot 风格,项目地址:https://github.com/renfei/discuz-ucenter-api-for-java,我做了以下修改:

  • 将项目包发布到 Maven 中央仓库
  • 基于现在Java的JDK8,移除了原作者的Base64实现,使用JDK8提供的java.util.Base64,所以最低需要JDK8来运行。
  • 将方法名下划线的风格改为驼峰命名风格,例如将「uc_user_delete()」改为「ucUserDelete()」。
  • 将PHP风格的变量名改为普通Java用的变量名,例如将「String $module」改为「String $module」。
  • 将使用配置文件的方式改为实例化时构造方法传参的方式
  • 将配置 servlet 改为自行定义 Controller 并处理 HttpServletRequest 和 HttpServletResponse
  • 部分中文乱码的问题进行了修复

Discuz的UCenter配置

在开始集成前,我们先要对Discuz的UCenter进行配置,拿到接口地址、通讯Key、APPID。先到Discuz的后台UCenter这里,新增一个应用:

新增UCenter应用

然后填写配置,应用类型选择“其他”,再个应用起个名字,应用主的URL地址就填你的地址,通信秘钥自己随便设置个密码,最下方选择开启同步登录和接受通知:

配置UCenter应用

Spring Boot 集成 discuz-ucenter-api-for-java

我使用的是 Maven 构建的 Spring Boot 项目,所以需要先修改 pom.xml 将 discuz-ucenter-api-for-java 引入项目中:

<dependency>
  <groupId>net.renfei</groupId>
  <artifactId>discuz-ucenter-api-for-java</artifactId>
  <version>1.0.6</version>
</dependency>

然后我个人认为分为两大部分,一部分是作为客户端进行接收来自Discuz的UCenter的消息;一部分是主动向Discuz的UCenter发送消息,我们分开来说。

接收来自Discuz的UCenter的消息

先创建一个Controller,然后创建一个处理HttpServletRequest和HttpServletResponse的方法,给一个UCenter请求的地址@RequestMapping("/api/uc.php"),实例化一个客户端net.renfei.discuz.ucenter.api.UCClient和net.renfei.discuz.ucenter.client.Client,然后把HttpServletRequest交给net.renfei.discuz.ucenter.api.UCClient.doAnswer()去处理,最后将结果写入HttpServletResponse,如果UCenter配置正确,就应该可以在UCenter看到通讯正常了。具体使用如下案例:

@Controller
public class UCenterController {
    @ResponseBody
    @RequestMapping("/api/uc.php")
    public void uc(HttpServletRequest request, HttpServletResponse response) throws IOException {
        UCClient ucClient = new UCClient();
        Client client = new Client("http://localhost:8080/uc_server", null, "123456789", "3","");
        String result = ucClient.doAnswer(client, request, response);
        response.getWriter().print(result);
    }
}

主动向Discuz的UCenter发送消息

注册

Client client = new Client("http://localhost/uc_server", null, "key", "2","");
String string = client.ucUserRegister("username","password","email");

先登陆再同步登陆

Client client = new Client("http://localhost/uc_server", null, "key", "2","");
// 登陆
String result = client.ucUserLogin(uid);
LinkedList<String> rs = XMLHelper.ucUnserialize(result);
if(rs.size() > 0){
    int uid = Integer.parseInt(rs.get(0));
    String username = rs.get(1);
    String password = rs.get(2);
    String email = rs.get(3);
    if(uid > 0) {
        //同步登陆
        String string = client.ucUserSynlogin(uid);
        //本地登陆代码
        //TODO ... ....
    } else if(uid == -1) {
        System.out.println("用户不存在,或者被删除");
    } else if(uid == -2) {
        System.out.println("密码错");
    } else {
        System.out.println("未定义");
    }
}else{
    System.out.println("Login failed");
    System.out.println(result);
}

登陆

Client client = new Client("http://localhost/uc_server", null, "key", "2","");
String string = client.ucUserLogin("username","password");

同步登陆

Client client = new Client("http://localhost/uc_server", null, "key", "2","");
int UID = 21; //此处是用户的UID
String string = client.ucUserSynlogin(uid);

常见问题

同步登陆接口成功但没有登陆状态

  • 症状表现:调用 net.renfei.discuz.ucenter.client.Client#ucUserSynlogin 成功,拿到了JavaScript代码,请求JS地址也成功,但是访问Discuz就是没有登陆状态。查看请求JS地址的Response头信息,Set-Cookie中没有xxxx_2132_auth的Cookie。
  • 发现场景:首先调用 net.renfei.discuz.ucenter.client.Client#ucUserRegister 进行用户注册,然后调用 net.renfei.discuz.ucenter.client.Client#ucUserLogin 用户登陆获取 uid,再调用 net.renfei.discuz.ucenter.client.Client#ucUserSynlogin 进行同步登陆获取 JavaScript代码,浏览器请求JS地址,全部都是成功状态,但是访问Discuz就是没有登陆状态。
  • 问题根源:当调用 net.renfei.discuz.ucenter.client.Client#ucUserRegister 进行用户注册后,用户信息会在 UCenter 中注册插入 pre_ucenter_members 表中,但不会自动插入 Discuz 论坛的 pre_common_member 表中,所以调用 net.renfei.discuz.ucenter.client.Client#ucUserSynlogin 进行同步登陆成功,访问 Discuz 的时候因为 Discuz 中没有这个用户的信息,所以不会有登陆状态。
  • 解决方案:第一种:注册用户的逻辑直接连接数据库,将用户相关的数据插入 UCenter 和 Discuz 的用户相关表中,涉及到的表需要查文档这里不再赘述。第二种:修改 UCenter 的代码,在插入 UCenter 用户表的同时,向 Discuz 用户表中也同步插入用户的信息。
  • 最后总结:UCenter 只是中间桥梁,打通各个应用的用户账号,但它不会通知各个应用有了新用户,Discuz 自带的登陆页面登陆的时候发现自己没有这个用户就会从 UCenter 拉取这个用户信息插入自己的用户表,所以你通过 UCenter 注册接口注册用户以后,如果这个用户从未登陆过 Discuz,那么 Discuz 中是没有这个用户的信息的,如果你想统一登陆验证,那么就需要你手动到 Discuz 的用户表中插入相关信息,其中涉及到多个表,请查阅官方文档。

更多信息请阅读源代码,此处不再一一演示。您可以提出issues或者到我的社区论坛一起讨论:https://bbs.renfei.net/forum-44-1.html


商业用途请联系作者获得授权。
版权声明:本文为博主「任霏」原创文章,遵循 CC BY-NC-SA 4.0 版权协议,转载请附上原文出处链接及本声明。
原文链接:https://www.renfei.net/posts/1003429
评论与留言
以下内容均由网友提交发布,版权与真实性无法查证,请自行辨别。

本站有缓存策略,时间约2小时后能看到您的评论。本站使用自动审核机制,如果您的内容包含广告/谩骂/恐怖/暴力/涉政等不和谐内容将无法展示!

test 2020-12-29 14:20:43 - Beijing, Beijing, China

test

回复

本站有缓存策略,时间约2小时后能看到您的评论。本站使用自动审核机制,如果您的内容包含广告/谩骂/恐怖/暴力/涉政等不和谐内容将无法展示!

关注任霏博客
扫码关注「任霏博客」微信订阅号
微博:任霏博客网
Twitter:@renfeii
Facebook:任霏
最新留言 优先级低的并不代表一定要等到优先级高的运行完才能运行,只是cpu分配的资源少了而已。 /lib64/ld-linux-x86-64.so.2: No such file or directory 报了这个错误,怎么解决呢 对于一个布道 DevOps 多年的选手来讲,看到这个报告,还是想继续布道布道。虽然是各种对比哈,但是我感觉与 DevOps 太像了(可能是职业病犯了哈)。首先声明本人不是GitLab 用户(因为不免费,没法薅羊毛啊),本人是 GitHub 忠实用户。 首先,你这是田忌赛马的对比,中文对比一事,着实有点可笑 1 土生土长和外来户能立马拉到同一个起跑线上吗? 2 一个真正的开发者应该去提升自己的英语能力,而不是拿全部是中文文档说事。大家都知道现在开源非常热,开发者是开源的主力军,如果要贡献优秀的开源项目(诸如Linux 内核,Kubernetes),英语就是个硬门槛。如果我是你,我倒希望公司内部的系统是英文的,最起码能让我锻炼英语,在看开源项目文档的时候不至于看不懂,提 PR 的时候不至于提交代码的内容描述不清楚而没法被 Merge。 其次,阿里云效、Coding 大家都知道背后站的是谁,很容易造成厂商绑定,现在很多企业都希望不要被厂商绑定。 再者,有一个点需要明白,GitLab 是一个 DevOps 平台,什么叫做 DevOps 平台(DevOps 走到现在,确切的说应该叫做 DevSecOps)?就是覆盖了软件开发生命周期全阶段的,从项目管理到代码托管到安全再到日志监控、甚至包含现在的云原生能力。不仅仅是说一个 CI/CD 就能概括的了的。这一点是 DevOps 布道的真正误区,我见过太多了,我在这儿再布道一哈,CI/CD 不等于 DevOps,他只是 DevOps 落地实践的核心能力。仅凭借一个 CI/CD 能有现成模版就判断出哪个好坏,过于牵强了吧。相信大家真正到项目用的时候,模版是满足不了要求的吧,毕竟大家都很特性化。 最后,还是一个很热的话题,开源,open source。GitLab 是开源的,Coding 和 云效这方面我没看到相关的开源内容(可能是我孤陋寡闻)。大家可以看看国内有多少用 GitLb 的,GitLab 的 CE 版,然后私有化部署,就是很多公司的代码托管 + DevOps 解决方案。 个人愚见,做一些对比报告的时候,还是先需要明白这个产品的定位,去深入挖掘一些真正有意义的对比,这样的对比报告才能有意义。作为一个常年写博客、文章的人来说。你写的每个字、每篇文章,你要想到你的思想会影响到别人。有可能因为你的片面之词,让别人错失一些学习的好机会。 docker run 那一长串后,出来一个字符串,然后去 docker containers 下面看 显示 exited(1);logs 下就一行错误 initdb failed 感谢🙏,第一个问题是空格的问题应该,我逐字敲完后可以构建了.第二个问题是我docker环境的问题,docker更新为最新版后需要重置配置文件.现已经正常使用,再次感谢您的分享和您的细心解答,期待下次相遇😄 还有一个问题可以请教下吗?就是我在容器里建文件夹没有权限,su root后密码不知道是多少,sudo mkdir xxx 提示我,没有sudo命令,请问有好的解决方法吗?谢谢解答 -v 后面可以指定文件吗 我的也是报错,还有。我执行了这个:@localhost kingbase-es-v8-r3-docker % docker run -d --name kingbase -p 54321:54321 -e SYSTEM_PWD=SYSTEM -v /opt/kingbase/data:/opt/kingbase/data -v /opt/kingbase:/opt/kingbase/Server/bin kingbase:v8r3 docker: 'run -d --name kingbase -p 54321:54321 -e SYSTEM_PWD=SYSTEM -v /opt/kingbase/data:/opt/kingbase/data -v /opt/kingbase:/opt/kingbase/Server/bin kingbase:v8r3' is not a docker command. See 'docker --help' 麻烦帮忙看下,是不是我写的命令有问题,还是版本问题,谢谢啦 请问我build的时候一直报错,是资源没了吗?failed to solve with frontend dockerfile.v0: failed to create LLB definition: failed to do request: Head "https://reg-mirror.qiniu.com/v2/library/centos/manifests/7?ns=docker.io": Moved Permanently 能不能在代码那里详细解释一下啊,没完全懂呀 en 按照路径上的来操作的,但是启动时一直报:zsh: no such file or directory: docker run -d --name kingbase -p 54321:54321 -e SYSTEM_PWD=SYSTEM -v /Volumes/installation/opt/kingbase/data:/opt/kingbase/data -v /Volumes/installation/opt/kingbase/bin/license.dat:/opt/kingbase/Server/bin/license.dat kingbase:v8r3 错误