datart本地开发环境搭建步骤及常见问题

目录

1、概述

2、前端搭建

3、后端搭建

4、常见问题

---

1、概述

跑象的开源数据可视化框架，具体功能参考官方链接：

datart: 新一代数据可视化开放平台，支持报表、仪表板、大屏、分析和可视化数据应用的敏捷构建。原davinci主创团队出品。

本篇文章主要讲解将datart下载到本地之后如何搭建开发环境，非部署手册（官方的部署手册很详细），这边主要针对datart进行二次开发学习，所以本篇主要内容为搭建前后端开发环境的步骤和一些问题，希望能提供给你一些参考。

2、前端搭建

将datart-master下载到本地解压之后，frontend目录即为前端的代码，推荐使用前端IDE直接导入进行构建运行即可，我这里使用HBuilderX。

HBuilderX导入前端项目之后，主要使用 npm install 进行项目构建、安装组件，没有问题之后使用 npm start 进行启动，默认端口为：3000

使用 npm run install / npm run start 也行。

  

3、后端搭建

下载解压的datart-master导入IDE后（IDEA或Eclispe均可），以下以eclipse为例：

由于datart-master的项目中有.jj文件，属于javacc的编译文件，所以在构建的时候会有一些报错，主要在SqlParserUtils.java中找不到SqlParserImpl的实现类，如下图：

这个报错是因为codegen/Parser.jj的文件需要使用javacc编译之后才能生成一堆的跟SqlParser相关的java类，所以到这里应该去安装一下javacc的eclipse插件，去插件市场安装就好。

 javacc插件安装好之后，这个报错是依然没有被解决的，不过不用理会，直接maven clean之后install即可，因为在打包的过程中javacc插件被调起来编译.jj文件，然后生成一堆的java文件。

不出意外会Build Success，如果出了意外那就请看下一章节。

另外，后端默认端口为：8080

4、常见问题

其实主要是后端可能遇到的问题，除了javacc插件的问题之外，可能还会有pom文件的一些报错，这些eclispe中遇到的问题，在idea中是极少遇到的，毕竟idea更智能一点。

如果遇到pom文件里面的一些报错，比如javacc的插件execution之类的报错，鼠标停留一下利用eclispe的修复选项点掉就好；

当然maven install成功之后，意味着调用javacc编译Parser.jj是OK的，将来的构建包里面是正常有SqlParser的一些Java类，但是eclispe项目目录中的报错依然存在，但是后端项目启动是可以的，除了强迫症同学可能看着文件头有个红叉之外，其他都能接受，哈哈。

idea是最理想的，这个项目本身也应该是由idea构建的，但是谁让我太陈旧用不惯idea呢，比如在项目启动的过程中会加载config/*一些配置文件，而项目的主入口是在server下，main类为DatartServerApplication.java，在idea中的话直接运行入口类是没有问题的，但是在eclispe下是会报错的，因为config/*这个文件夹并不在server项目的目录下，而是在datart-parent项目下呢，直接跑是会报错找不到配置文件的。

关于这个问题，其实需要个性化的一些操作，修改配置文件里面读取config/*的代码，或者直接将config/*这个目录拷贝到server项目下即可，总之，eclispe在整合一些项目的时候并不如idea犀利，从智能程度、遇到的奇葩问题的多少上来说，idea无疑是比eclispe棒的。

可是，还是那句话，臣妾用不惯idea呀。