看似无用的开头

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

最权威的资料

搭建xxl-job-admin服务步骤

源代码下载，毫无疑问必须的
git clone git@github.com:xuxueli/xxl-job.git
选择你需要搭建的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.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 &amp; 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
xxl.job.mail.username=ovono802302@163.com
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插件吧

.......
    <build>
        <plugins>
            <!-- 配置Tomcat插件 -->
            <plugin>
                <groupId>org.apache.tomcat.maven</groupId>
                <artifactId>tomcat7-maven-plugin</artifactId>
                <version>2.2</version>
                <configuration>
                    <!-- 这里配置端口号和访问路径 -->
                    <path>/xxl-job-admin</path>
                    <url>http://localhost</url>
                    <port>18080</port>
                    <!--<username>tomcat</username>-->
                    <!--<password>tomcat</password>-->
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

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

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

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

终于进来啦

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

和开头呼应的结尾

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

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

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

<!-- servlet -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>${javax.servlet-api.version}</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>jsp-api</artifactId>
            <version>${jsp-api.version}</version>
            <scope>provided</scope>
        </dependency>

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封装的。哎，名字就不能取得规矩点嘛，这么调皮）

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