VJSP配置文件说明
vjspai-link.yml 是 VJSP 框架中的核心项目配置文件,用于定义当前项目与 VJSP 插件集成所需的各项参数。插件在启动时会自动加载该文件,并据此初始化数据源、静态资源路径、国际化(i18n)配置等关键运行环境。
✅ 文件位置:项目根目录(与
package.json或pom.xml同级)
⚠️ 前提条件:请确保该文件存在且格式正确,否则 VJSP 插件部分功能将无法正常工作。
🔧 依赖此配置的功能模块
以下 VJSP 功能均依赖 vjspai-link.yml 中的配置信息:
数据库表选择(Select Database Table)
工作流选择(Select Workflow)
数据库可视化编辑器(Database Schema Editor)
工作流编辑器(Workflow Designer)
表单编辑器(Form Logic & Page Builder)
若未正确配置,上述功能将无法使用,加载数据源、找不到流程定义或无法渲染表单字段。
📋 主要配置项说明
配置项 | 说明 |
|---|---|
datasource | 数据源配置 |
driverClassName | 数据库驱动:目前支持MySQL、PostgreSQL两种数据库驱动。 postgrel数据库使用: org.postgresql.Drive mysql数据使用: com.mysql.cj.jdbc.Driver |
url | 数据库连接地址 |
username | 数据库用户名 |
数据库用户名 | 数据库密码 |
staticPath | 静态资源路径,使用默认值,无需修改 |
mappingPath | 逻辑文件 ,使用默认值,无需修改 |
templatePath | 生成html模板路径,使用默认值,无需修改 |
i18n | 国际化 :zh_CN 中文,ja_JP 日文,en_US 英文 |
appUrl | 应用访问地址,如更换ip或端口,请在此处修改 |
配置文件示例
yml
# VJSPAI插件配置文件
vjspai:
# 数据源配置
datasource:
# 数据库驱动:目前支持PostgreSQL 和 MySQL 数据库驱动。
driverClassName: org.postgresql.Driver
# 数据库连接 格式:jdbc:postgresql://主机:端口/数据库名
# 示例:jdbc:postgresql://127.0.0.1:5432/vjsp_form
url: jdbc:postgresql://${DB_HOST}:${DB_PORT}/${database-name}
# 数据库用户名
username: ${DB_USERNAME}
# 数据库密码
password: ${DB_PASSWORD}
# VJSP文件路径
resources:
# 静态资源路径
staticPath: src/main/resources/static/
# 逻辑文件
mappingPath: src/main/resources/vjsp-mapping/
# 生成html模板路径
templatePath: src/main/resources/template/html-template.html
# 国际化
i18n:
list: zh_CN,ja_JP,en_US
default: zh_CN
# 应用访问地址,如更换ip或端口,请在此处修改。
appUrl: http://localhost:8080/🔐 安全提示:建议通过
.gitignore排除敏感信息,或使用环境变量注入凭据。
数据库驱动、连接示例
| 数据库 | 驱动 driverClassName | 连接 url |
|---|---|---|
| postgresql | org.postgresql.Driver | jdbc:postgresql://127.0.0.1:5432/vjsp_form |
| mysql | com.mysql.cj.jdbc.Driver | jdbc:mysql://127.0.0.1:3306/vjsp_form?serverTimezone=Asia/Shanghai&useUnicode=true&characterEncoding=UTF-8&useSSL=false |
