1 简介
Davinci 是一个 DVaaS(Data Visualization as a Service)平台解决方案,面向业务人员/数据工程师/数据分析师/数据科学家,致力于提供一站式数据可视化解决方案。既可作为公有云/私有云独立部署使用,也可作为可视化插件集成到三方系统。用户只需在可视化 UI 上简单配置即可服务多种数据可视化应用,并支持高级交互/行业分析/模式探索/社交智能等可视化功能。
2 环境准备
关于Windows10 如何安装JDK和MySQL环境,请大家自行百度。
3 代码导入及配置
3.1 通过IDEA中的git将代码从GitHub上Clone下来:
也可以直接通过git命令或者下载的方式下载源码,然后解压到指定目录即可。
3.2 代码的目录结构如下:
其中:
- assembly/ 目录是用来设置maven打包的目录结构以及其他一些配置,比如打包成什么类型(jar/zip...)。点这里可看详细介绍。
- bin/ 目录是一些脚本执行文件,包括数据库初始化配置,服务启动停止脚本等
- config/ 目录是一些配置文件
- webapp/ 目录中是前端源代码在
- davinci-ui/ 目录为编译后的前端文件
- server/ 目录为端代码及核心配置
- log/ 为日志目录
注:若根目录没有log/目录,则需手动创建,目录结构如下:
├── log # 日志根目录
├── sys # 系统日志目录
└── user # 用户日志目录
├── opt # 用户操作日志
└── sql # 用户Sql日志
3.3 配置环境变量
配置系统环境变量或 IDE 环境变量 DAVINCI3_HOME,推荐优先使用 IDE 环境变量。
3.4 相关配置修改
A. 自行创建 Davinci 系统数据库,修改 bin/initdb.bat 中的数据库相应信息并执行 或 直接在数据库客户端导入 bin/davinci.sql
B. 进入config
目录,将application.yml.example
重命名为application.yml
后开始配置
- server 配置
server:
protocol: http
address: 127.0.0.1
port: 8028
access:
address: 192.168.1.1
port: 80
- datasource 配置
spring:
datasource:
url: jdbc:mysql://localhost:3306/davinci0.3?useUnicode=true&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull&allowMultiQueries=true
username: root
password: root
driver-class-name: com.mysql.jdbc.Driver
initial-size: 2
min-idle: 1
max-wait: 60000
max-active: 10
根据自己安装MySQL所配置的信息自行修改,修改url前面的配置(地址,端口,数据库名),后面的参数可不做修改,然后修改正确的数据库访问用户和密码即 username
和 password 。
- mail配置
注:Davinci 使用注册–邮件激活添加用户,所以 mail 配置是必不可少的,且 mail 配置出错率较高,请务必注意
spring:
mail:
host: smtp.****.com
port: 25
username: example@***.com
fromAddress:
password: example_password
nickname: Davinci
properties:
smtp:
starttls:
enable: true
required: true
auth: true
mail:
smtp:
ssl:
enable: false
mail 配置并不复杂,以上就是完整的 mail 配置了,username
为邮箱地址,password
邮箱服务密码,需要注意的是常见免费邮箱(如 163 邮箱、QQ 邮箱、gmail 等)这里应填客户端独立密码,可前往对应邮箱账号设置页面开启 SMTP 服务,并申请客户端授权码(或独立密码,各邮箱提供商叫法不同)
fromAddress
为可选项,默认为 username
的值,其存在的意义在于部分邮箱服务可能在认证时 username
和 addresss
不同,这时需要配置 fromAddress
作为邮件真实发送地址,username
为连接邮箱服务认证使用
其余配置可以参考用户手册进行配置。
4 项目启动
配置好相关信息之后,可以直接采用Spring boot启动
首先,在configuration中配置好Spring boot配置:
然后点击启动:
接着在浏览器访问 http://127.0.0.1:8028/ ,其中8028端口为在配置文件配置的端口,请自行修改。
注册登录即可。
后续就可以在Windows10本地对Davinci进行二次开发了。