001_iBase4J学习之环境搭建

目录

• 序言
• 正文
  • 第一关、拉取项目
  • 第二关、导入数据库
  • 第三关、修改 JDBC 配置文件
  • 第四关、环境搭建，修改 nginx 设置
  • 第五关、添加地址白名单
• 尾声

序言

大家好，我是白墨！

本次的目标是学习 iBase4J 这个框架，先贴一个官方的介绍：

• iBase4J是Java语言的分布式系统架构。 使用Spring整合开源框架。
• 使用Maven对项目进行模块化管理，提高项目的易开发性、扩展性。
• 系统包括4个子系统：系统管理Service、系统管理Web、业务Service、业务Web。
• 系统管理：包括用户管理、权限管理、数据字典、系统参数管理等等。
• 业务相关：您的业务开发。
• 可以无限的扩展子系统，子系统之间使用Dubbo或MQ进行通信。

我先跟着网上找的一篇教程 ^[1] 走了一遍。

但教程过时，有些地方走不通，然后再自行研究修改，所以有了本文，建议读本文前先看看原教程，错了也没关系。

原教程地址： https://blog.csdn.net/u011781521/article/details/79022363

主要是这个项目没有官方的文档，据说官方文档是付费进Q群才能获取，而且现在群又是满的，难受。

来人，给作者续费个年费超会！

正文

第一关、拉取项目

项目源码地址：https://gitee.com/iBase4J/iBase4J ，直接用 Git 拉取就行了。

不会的话进入页面手动下载吧……

当然，我这也有一条龙服务，保您满意： 手把手教你IDEA连接码云(Gitee)。

第二关、导入数据库

使用的数据库版本为 MySQL8.0+。

导入以后结果如下图所示。

那个 ibase4j_biz 的数据库也是 sql 语句生成的，里面啥也没有，也不知道有没有用，暂时没去管它。

第三关、修改 JDBC 配置文件

修改 两个 Service 模块 下的 jdbc.properties 配置文件，开发、生产、测试环境加起来一共有 6 个，一股脑全改了。

其中密码是通过调用方法获得 top.ibase4j.core.util.SecurityUtil.encryptDes(String password,byty[] key) ，

随便找个 main 方法调用后在控制台输出即可获得。

此处与网络上的教程不同，卡了我半天。

具体调用方法如下：

System.err.println(SecurityUtil.encryptDes("root",new byte[]{57,48,49,51,57,49,49,57}));

其中数组 key 是我通过 debug 时观察解密方法传入的参获得的。

我的密码是 root ，加密后为 M1XaoOiy+J7= ，

如果你的也是，可以先试试能不能直接用…

第四关、环境搭建，修改 nginx 设置

环境有一堆，全是 Windows 的，我的版本如下：

apache-activemq-5.13.2
apache-zookeeper-3.6.2-bin
nginx-1.9.12
Redis-x64-3.0.504

打了个包，我这套环境的地址： https://baimoo.lanzouh.com/isNdG036arwj 密码: baimo

开头提到的【原教程】里面也分享了一套环境，在这： https://baimoo.lanzouh.com/iF3cS036atuj 密码: baimo

接下来修改 nginx 设置，配置路径在 nginx-1.9.12\conf\nginx.conf ，如下图，root 后面填静态页面的路径，

网上公开的教程都没有写到 src 这一级目录，应该是当时作者还没有修改文件位置吧。

此处与网络上的教程不同，卡了我一天，一直在报 403！

没学过 nginx ，姑且猜测端口号就是服务器端的端口吧，所以我填了 127.0.0.1:8088 。

其他没什么改动，分别启动即可（最好用管理员模式），路径如下：

apache-activemq-5.13.2\bin\win64\activemq.bat
apache-zookeeper-3.6.2-bin\bin\zkServer.cmd
Redis-x64-3.0.504\redis-server.exe
nginx-1.9.12\nginx.bat（<---需要改一下里面的启动路径）

第五关、添加地址白名单

一切搞好以后，分别启动模块 iBase4J-SYS-Service 和 iBase4J-SYS-Web ，

然后进入 http://127.0.0.1 终于打开了登录页面。

可是登录时又返回了 308 错误，后台报了个跨站请求，可我所有环境都在本机。

账密： admin/111111

通过搜索 ^[2] 、 debug 排查发现有个地址白名单。

在类 top.ibase4j.core.filter.CsrfFilter 里面有个 whiteUrls 数组，

值是通过读取文件 white/csrfWhite.txt 获取的。

那么，找到文件，在 iBase4J-SYS-Web 模块下， iBase4J-SYS-Web/src/main/resources/white/csrfWhite.txt 。

好家伙，一个都没有，难怪 size 为 0，永远也登录不了。

把本机地址加进去，然后重启模块 iBase4J-SYS-Web 。

http://127.0.0.1
http://localhost/

再次进入登录页面 http://127.0.0.1 ，输入 admin/111111 ，登录成功。

一开始没有登录成功，以为是密码错了， debug 找了十几分钟的认证方法，结果啥也没改，突然又登录成功了，莫名其妙的。同事说可能是 Redis 缓存的问题。

图片显示有点 bug，不在本文讨论范围！

尾声

如果用的 UI 是 iBase4J-UI-DataTables ，登录时还会遇到传不了参的问题。

可以先在后台把密码写死，凑合着用以后再去修复 Bug。方法如下：

模块 iBase4J-SYS-Web ，

类 org.ibase4j.web.LoginController ，

方法 login ，在方法内第一行加入以下代码。

user.setAccount("admin");
user.setPassword("96e79218965eb72c92a549dd5a330112");

简单粗暴！

好了，本文到此结束，鼓掌！

最后再吃点瓜： 警惕挂着开源的招牌到处坑蒙拐骗的垃圾项目，比如iBase4J

---

1. 码农致富. 开源项目学习之(二)------iBase4J环境搭建 [Z].CSDN，2018-01-10 ︎

2. 易水. 如何解决iBase4J登录没有反应的问题 [Z].知乎，2021-06-01 ︎