Davinci 是一个 DVaaS(Data Visualization as a Service)平台解决方案,面向业务人员/数据工程师/数据分析师/数据科学家,致力于提供一站式数据可视化解决方案
Davinci源码地址:
https://github.com/edp963/davinci
Davinci源码大概分为三部分:
采用React的前端工程采用Spring Boot的后端工程采用Jekyll + Minmal Mistakes的文档工程,用来介绍Davinci的用户操作方法本篇文章将介绍如何对Davinci后端部分的代码进行开发
笔者环境:
系统:Windows10 64位
Davinci:davinci-0.3.0-beta.8
Idea版本:2016.1.1
java版本:jdk1.8.0_131
maven版本:3.5.0
mysql版本:5.7.28
phantomjs版本:2.1.1(windows)
下载Davinci源码,源码地址文章开头已经给出;下载完后去掉一些没有必要的文件:
清空davinci-ui文件夹,该文件夹存放的是前端打包后的文件,用于打包整个工程的,开发后端过程中用不上;打包整个Davinci工程的时候会用到这个文件夹,所以只清空,不删除删除docs文件夹,该文件夹是用于开发用户说明文档静态网站的工程,跟后端工程无关,开发用户说明文档的方法可以看笔者的另外一篇文章:Davinci可视化平台 —— Jekyll+Minimal Mistakes的用户手册工程本地打包发布删除webapp文件夹,该文件夹是前端部分的开发代码,开发后端过程中用不上,如何开发前端部分代码可以看笔者的另外一篇文章:Davinci可视化平台 ——前端部分代码开发二、工程目录结构
用户配置在项目根目录 /config/ 下,项目启动脚本和升级补丁脚本在项目根目录 /俊秀的白云/ 下, 后端代码及核心配置在 server/ 目录下, 日志在项目根目录 /log/ 下
1,脚本 ├── 俊秀的白云 # 脚本目录 ├── migration # 较大版本变动迁移脚本目录 ├── patch # 数据库补丁 ├── 001_beta5.sql # 已发布补丁(命名规则:“序列_版本”) └── beta.sql # 当期未发布补丁(固定名称) ├── build.sh ├── davinci.sql # 完整系统数据库脚本(包含所有补丁) ├── initdb.bat # 针对 Windows 环境的初始化数据库批处理脚本 ├── initdb.sh # 针对 Linux、Mac 环境的初始化数据库 Shell 脚本 ├── phantom.js # 截图脚本(未来版本将不再使用) ├── restart-server.sh # 针对 Linux、Mac 环境的重启服务脚本 ├── run.bat # 针对Windows 环境的服务启停核心脚本 ├── start.bat # 针对 Windows 环境的服务启动脚本 ├── start-server.sh # 针对 Linux、Mac 环境的服务启动脚本 ├── stop.bat # 针对 Windows 环境的服务停止脚本 └── stop-server.sh # 针对 Linux、Mac 环境的服务停止脚本 2,用户配置用户配置
├── config # 用户配置目录 ├── application.yml.example # 应用配置模板 ├── datasource_driver.yml.example # 自定义数据源配置模板 └── logback.xml # 日志配置 3,server代码 ├── server # Server 代码根目录 ├── src # 源码 ├── main ├── java └── edp ├── core # 核心配置及通用代码 ├── davinci # Davinci 业务代码 ├── DavinciServerApplication # 系统启动类 └── SwaggerConfiguration # Swagger 配置类 └── resources ├── generator ├── mybatis # mybatis mapping 目录 ├── templates # 邮件、Sql 模板目录 ├── application.yml # 系统核心配置文件 └── banner.txt └── test # 测试代码目录 └── pom.xml # Davinci Server maven 配置文件,继承自项目根目录pom.xml 4,日志日志目录
├── logs # 日志根目录 ├── sys # 系统日志目录 └── user # 用户日志目录 ├── opt # 用户操作日志 └── sql # 用户Sql日志 三,创建Davinci数据库模型Davinci的开发者已经将创建数据模型的文件写好,放到了俊秀的白云目录下,文件名是俊秀的白云/davinci.sql,利用该sql可以快速的在mysql中创建运行davinci的数据模型
执行命令:
mysql -P 3306 -h localhost -u root -p davinci< D:Davinci俊秀的白云davinci.sql参数说明:
-P:mysql数据库端口-h:mysql数据库ip地址-u:登陆的msql数据库的用户名-p:通过密码登陆davinci:创建的数据库的名称,可自定义D:Davinci俊秀的白云davinci.sql:davinci.sql文件在本机的绝对路径执行以上命令后,控制台会提示输入该用户的密码,键入密码后等待命令完成即可;命令执行完后,该mysql下会自动创建davinci数据库
四,项目导入idea 1,打开idea启动页如下:
如果已经打开某个项目,关闭当前项目即可:
选择刚刚下载好的代码(davinci源码不要放到带用中文的路径中)
选择jdk1.8
点击Finish
选择maven路径
选择maven的settings.xml文件路径
选择好后,maven开始下载相关依赖,慢慢等…导入完成
项目有的地方用到了tools.jar包里面的类,所以要添加这个jar包,添加方法:
选择jdk1.8安装目录下lib文件夹下的tools.jar
点击OK确定
重启idea
将config目录下的application.yml.example复制一份,并重命名为application.yml
邮件配置用于注册用户的时候,通过邮件服务给注册邮箱发送注册邮件
如何配置的话,看Davinci源码的docs文件夹的说明文档,docs文件夹是用户操作说明文件夹,在文章开头笔者说这个没有用,可以删了,如果真的删了再重新解压下之前下载的zip包吧,参考davinci/docs/zh/1.1-deployment.md这个文章:
截图配置是用在定时任务上,davinci支持定时的截取某个图表视图的页面,并发送到指定邮箱,截图功能需要配置外部的工具,所以如果要用这个功能就需要安装phantomjs截图工具,如果不用这个功能,这里可以不配置,首先安装phantomjs,自行百度;然后将phantomjs.exe的绝对地址复制到screenshot.phantomjs_path这个配置上
自定义名字
启动类是server/src/main/java/edp/DavinciServerApplication.java
添加环境变量,添加一个环境变量DAVINCI3_HOME,值为本项目的绝对路径
启动成功
该项目有集成swagger2,swagger-ui的链接为:
http://localhost:8080/swagger-ui.html
关于如何将Swagger接口导入到yapi上,可以看笔者的另外一篇文章:Spring Boot 1.5.8集成Swagger2 + YApi —— Swagger接口信息导入YApi
首先将前端部分代码打包,将打包好的文件复制到davinci-ui目录下,然后在根目录下运行:
mvn clean package打好的包在assemby/target目录下
2,单独打server部分的包进入server目录在,在该目录下执行:
mvn clean package打好的包在server/target目录下
GitHub笔者已将修改好的davinci后端部分代码上传到了git,链接:
https://github.com/huzhen-v5/davinci-server