IDEA 上 Tigase8.0 源代码编译运行

 Tigase交流群 ：310790965

一些小伙伴们经常问Tigase8 check下来的源代码怎么跑起来，因为我不能及时一 一回答，所以还是写个博文来演示一下吧，一般针对新手而言，老手的话，就跳过吧！

 一、一般第一步是进入tigase的官网，现在官网代码已经转移到github上，选择你想要下载的模块 ： 

如果下图，现在8.0版本已经正式发布了。我们就使用它作为研究学习：

可以先通过git 克隆下来代码：

git clone --branch tigase-server-8.0.0 https://github.com/tigase/tigase-server.git

　　

 

 

 

等待下载成功，再使用IDEA打开代码：

一般下载代码后，第一步就是进行项目配置设置 Tigase8是依赖是JDK8及以上，看到右边第五步那，我们只要留下src/main/java 这源码项就可以，其它的可以点X移除，不需要的暂时不让它参与编译

 

 现在展开代码看下，发现有些类可以由于没有导入 相应的包而出现报错，这时候可能有些同学开始慌了，别担心，如下图只是没有成功导入tigase-utils.jar 才会出现找不到类的错误，那我们就去看看原因，问题就是在maven ，那么我们不防先执行下maven install 

 

在执行maven后如果没能成功下载包时，则不防在pom.xml里为它加入tigase私有仓库如下：

    <repositories>
        <repository>
            <id>tigaseid>
            <name>Tigase repositoryname>
            <url>http://maven-repo.tigase.org/repository/releaseurl>
        repository>
        <repository>
            <id>tigase-snapshotid>
            <name>Tigase repositoryname>
            <url>http://maven-repo.tigase.org/repository/snapshoturl>
            <snapshots>
                <enabled>trueenabled>
            snapshots>
        repository>

      
          tigase
          http://maven-repo.tigase.org/repository/tigase
      

    repositories>

 

 现在再点击 install 进行下载，如果还是下载不下来，再试试去进入你本地的maven库中，删除要下载的对应的版本文件目录

 

 点击install 后，顺利地下载所有依赖的包下来了，如图所示，已经没有再报错了，OK，进展很顺利！

 

二 、不防先试着去运行下源代码吧：快速去找到XMPPServer 主入口类，运行，啊怎么会跑到Groovy的代码，别慌，我这里是故意演示下这样的错误，很多同学之前问到。不用想问题一定在配置里了，我们应该移除Groovy模块，不让他参与编译。

 

 点开配置项，移除不需要的模块，如图X所示：

 

 

 

 

 再次点击运行，wo ?配置文件我都没动怎么就运行成功了，别慌，这可是使用默认的配置项，都没有读取到数据库表信息，所以才会成功跑起来了

 

从提示里可以看出，它默认加载的配置文件是 ： etc/init.properties，如果你不想在JVM启动配置项里加入 对应配置来改变这个默认参数项，最简单的就是拷贝一个配置文件，改个名字放到etc目录下去呗，多省事。如我选择mysql数据库，那么我就拷贝一个init-mysql.properties，改名为init.properties 

 

 

看到新增加的init.properties文件，及里面的配置

 

 

再次运行XMPPServer后，会发现熟悉的错误出现了，就是找不到Mysql 驱动，这就对了，说明还得加入mysql-connector-java.jar ，那就改下pom.xml吧 加入 如下：

 <dependency>
            <groupId>mysqlgroupId>
            <artifactId>mysql-connector-javaartifactId>
            <version>5.1.40version>
            
        dependency>

注意： 如果使用的是MYSQL8.0及以上。会有安全检查及时区检查，在url后加上：  '&useUnicode=true&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=UTC'

uri = 'jdbc:mysql://localhost:3306/tigasedb8?user=root&password=123456&useUnicode=true&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=UTC' 

　　

 

 

 

 有些眼快的同学可能会有疑问？明明加入init.properties，运行过后怎么变成init.properties.old了，这是简单说明下，其实从8开始，Tigase官方推荐的配置文件格式改了，从8.0 起推荐使用DSL领域专用语言来写配置文件，但还是为了兼容老版本，他自动帮你把init.properties里的配置转换到config.tdsl文件里了，所以别慌，要是老用户，你也还可以选择properties配置，让他自动帮你转，不然去官方那看下他8的配置文件指导也是极其简单滴！

 

 

 

如果Tigase的数据库导入了数据成功的话，这里跑起来应该是成功，可能结束了，但也有可以数据导入的问题，出现一些奇怪的问题，演示下：

 

上文的报错提示：系统要求的版本为0.0.0，而我们的是8.0.0， 看到这错误，这不是很矛盾嘛，但别慌，一定是哪里配置少了，或者少操作了哪一步 ！

分析开始 ：由于我是手动导入数据脚本的，所以我坚信我的数据库现在是完整的，一定没问题。这里插入下怎么导入呢：如下图里的红圈，你点开里面一个个文件都从小版本一直执行完到8.0.0，相信你应该会SQL就不多说了，后面我会附上一份导出的脚本 文件。 

 

 提醒下有些同学可能会按着脚本从头到尾导入，但为什么会遇到出错的导不进去呢，其实有个脚本里面是有个BUG的，如mysql-server-8.0.0-sp.sql 中

 

 基于我的经验，数据库导入没有问题了，那为什么还报版本与期望的不一致的错误呢，这个时候来个大招，直接看下报错的源代码吧：

 

 

 

  原来这里Tigase读取打包的jar包没有添加版本信息，也就是说没有读取到MANIFEST.MF 文件里的描述信息，默认0.0.0，我这里就不管了，直接在下面设置下为8.0.0，与数据库配置的版本号一致就行了，跳过这个版本检查。

注意：如果是在IDEA中启动，那只能注掉，或数据库都配置0.0.0. 默认从this.getClass().getPackage().getImplementationVersion();取值，正常在说是读到MANIFEST.MF中的Implementation-Version: 8.0.0。但是只有打成jar包的时候，this.getClass().getPackage().getImplementationVersion();才有效地读得出来。如果你是在IDEA中，就算你配置了MANIFEST.MF，他还是读不出来null，这是个坑吗？谁清楚给指点下？？？google上也很多类似的，最终在官方也找不到答案。

 

 

拿MUC模块来举个例子，由于muc.jar 中包含了META-INF描述信息，这里就能读出3.0.0版本号来

 

 

其实这里还可以选择一种做法，也就是运行  tigase.db.util.SchemaManager "upgrade-schema" --config-file=etc/config.tdsl  这样系统去执行脚本 ，由于我选择的是手动导入脚本到数据库，所以我不跑这步了，你们可以试试。

但无论怎么样，现在他默认读取运行jar包上的版本号和数据库上的版本进行匹配，出现问题直接定位到这里纠正就行！

 

 

三、再次执行XMPPServer 运行main ,发现版本检查的问题没有出现了，但可能又出现的另一个问题，但别慌，这个看提示就很清晰了，SessionManager 组件中 max-queue-size 配置小了，它让你配置大些，为什么有人可以有人不行，现在这个配置项是动态的，根据你CPU核数来要求配置最小值，简单，就配置下嘛：

 修改config.tdsl文件，如下图：

 

再次运行 ，一切顺利跑起来拉：

 

 

这个时候，开始使用spark去验证下，服务是否可用了对吧，握草，这平时群里问题的最多就这问题了，怎么启动服务就是访问不到呢：

 

 其实呀，问题就在你的　　default-virtual-host　配置项上，这个时候不防先看下　etc\config-dump.properties　如果这个文件中系统使用默认的域名为你的主机名，而你这里的配置又不是主机名，一般就会出现这样的问题了

 

 那就改为主机名吧，这改为了llooper，

 

 这个时候，应该 是没什么问题了吧，再来验证下 ，启动系统，验证一下注册用户test：

 

 登录用户 ：

 

 

 启动服务，登录都成功了，大功告成 ！其实这个没什么难度的，就是出现什么问题，就解决它，要有耐心！

对了，本来想附上一份，tigase-server.sql 这里上传不了附件，那我就上传到群里的文件里去吧，有需要的同学在群文件里找，tigasedb_8.sql

闲的时候，写写文档，一起进步吧。有什么问题在群里问，但是有时候可能没时间回复，见谅！

有时候我非常讨厌那种眼高手低的人，我之所以花时间去分享，不是他吗为了赚你的钱，再说了，我从来不收人家请教问题的一分钱，之所以这么做，是因为当我是小白的时候，我也是看别人的分享过来的，感谢那些人写的博文。现在有空我也想帮助下别人而已，仅此，如果你不懂，请教问题的时候，还像大爷，那请离我远点。我不觉得我有多牛B,但是我在写代码的时候，JAVA，GOLANG,PY随便切换，这些都是因为我付出来心血汗水过来了，我深知没有付出，谈什么牛B,所以新手想一天就练成什么xxx，那就多点耐心慢慢学。现在好多人都心浮气躁，唉，快餐文化.这只是唠叨下，好同学不必看，见凉！

 

附上一些tigase doc地址 ：

 https://docs.tigase.net/tigase-server/snapshot/Administration_Guide/html/

https://docs.tigase.net/

仓库地址

https://maven-repo.tigase.org/repository/release/

http://maven-repo.tigase.org/repository/snapshot

http://maven-repo.tigase.org/repository/tigase