轻量级分布式任务组件xxl-job-admin服务本地搭建过程记录

看似无用的开头

自2019年新年元旦以来，一直想在本地搭建一个高大上的xxl-job-admin服务，供自己本地测试玩玩。趁今天空闲，赶紧安安心心地写点博客文章梳理下搭建过程。不然又不知何时才愿意提手码字了。

最权威的资料

源码地址
文档

搭建xxl-job-admin服务步骤

1. 源代码下载，毫无疑问必须的
   git clone [email protected]:xuxueli/xxl-job.git
2. 选择你需要搭建的xxl-job-admin版本，因为公司xxl-job-core客户端依赖的是1.9.1版本，所以我这里就以1.9.1版本源码搭建服务啦
   git checkout -b jc/local_server_for_v1.9.1 origin v1.9.1

3. 微调源码以适应我们自己的需求(必须得修改)
   3.1 全局替换版本号1.9.1->1.9.1.jun,便于后续二次开发
   3.2 进去到xxl-job-admin子项目下调整它的配置文件 xxl-job-admin.properties

   
   
   

   xxl-job-admin.properties文件路径.png
   
   

   这里调整下mysql数据源和邮件服务配置就好了

### xxl-job db  (use & replace & in xml)
xxl.job.db.driverClass=com.mysql.jdbc.Driver
xxl.job.db.url=jdbc:mysql://localhost:3306/xxl-job-1-9-1?useUnicode=true&characterEncoding=UTF-8
xxl.job.db.user=root
xxl.job.db.password=root

### xxl-job email
xxl.job.mail.host=smtp.qq.com
xxl.job.mail.port=25
[email protected]
xxl.job.mail.password=asdfzxcv
xxl.job.mail.sendNick=《任务调度平台XXL-JOB》

### xxl-job login
xxl.job.login.username=admin
xxl.job.login.password=123456

### xxl-job, access token
xxl.job.accessToken=

### xxl-job, i18n (default empty as chinese, "en" as english)
xxl.job.i18n=

我调整了默认数据库名，是为了搭建多个版本的服务，所以就需要调整同步调整下初始化数据库脚本文件tables_xxl_job.sql中的数据库名（不需要的同学就不用多此一举了）

tables_xxl_job.sql文件路径.png

3.3 接下来就是执行初始化数据库脚本tables_xxl_job.sql就好了

1.9.1版本数据库表列表

3.4 因为前面3.1调整了原有的版本号，而xxl-job-admin依赖xxl-job-core，所以还需要安装部署自己的jar。我就直接安装在本地(如有必要可以部署到私有仓库中去),直接在根目录下面执行mvn安装命令即可。
mvn clean install

3.5 2.0.0版本以后xxl-job-admin基于spring-boot，就不需要一个单独的web容器了。
然后2.0.0版本以下xxl-job-admin项目还是一个web项目，就需要一个web容器.（习惯了没有外置tomcat服务器的日子，实在不想单独搭建一个tomcat容器了，就用mvn的tomcat插件吧）
在xxl-job-admin项目的pom.xml中添加tomcat插件吧

.......
    
        
            
            
                org.apache.tomcat.maven
                tomcat7-maven-plugin
                2.2
                
                    
                    /xxl-job-admin
                    http://localhost
                    18080
                    
                    
                
            
        
    

这儿偷偷调整了下默认的8080端口，因为我本地的其他系统默认都是用的8080端口，好的端口资源就是这么紧张。

3.6 最后就是在xxl-job-admin项目下开始开心得运行xxl-job-admin项目即可了
mvn tomcat7:run

访问路径
http://localhost:18080/xxl-job-admin
用户名/密码在配置文件里面，默认：admin/123456

终于进来啦

其他介绍参考官网文档资料就好了，很详细，就不多啰嗦了。

和开头呼应的结尾

终于可以元气满满地迎接周末啦(都盼太阳了好几个星期了，赶紧出来吧)。再也不用担心测试过来找我问他的执行任务去哪儿了。(不对啊，我就不盼望着心中的测试妹子过来嘛，不行，我得赶紧卸载了这个服务)

最后的最后当然得致敬那些跳进去的坑们啦

1. 使用的tomcat得要tomcat7+。tomcat6插件支持的servlet版本小于3.0.0，而xxl-job-admin服务依赖了servlet 3.0.0以上版本的api，所有不能用tomcat6以下了。(不然登录的时候相信我，会给你惊喜的,你不要试试嘛）。
2. 再提一个有关servlet的坑。作者依赖的javax.servlet-api jar没有加上编译器范围(难不成作者大佬忘记了)，服务启动起来后就会提示一系列奇怪的错误，我还是老老实实加上吧。

        
            javax.servlet
            javax.servlet-api
            ${javax.servlet-api.version}
            provided
        
        
            javax.servlet.jsp
            jsp-api
            ${jsp-api.version}
            provided
        

3. 1.9.1版本依赖的底层RPC序列化协议调整为hessian1，而1.9.2以后就变成hessian2了。因本人公司的xxl-job-core是1.9.1版本二次封装的，而我开始搭建的都是1.9.2版本以后的xxl-job-admin服务，然后你就会发现各种例如"unknown code for readObject at 0x43 (C)"这种不识别的code错误了（吐槽下：公司客户端基于1.9.1封装的xxl-job-core，然后jar版本名称确是1.9.3，看了下github源码上是没有1.9.3这个版本号的，导致我还一直以为是基于1.9.2封装的。哎，名字就不能取得规矩点嘛，这么调皮）