/lowCodePlatform

低代码开发平台项目

Primary LanguageJava

jnpf-java-cloud

特别说明：源码、JDK、MySQL、Redis、Nacos、Seata、Sentinel等存放路径禁止包含中文、空格、特殊字符等

环境要求

特别说明：JDK 1.8.25 版本无法正常使用，请使用推荐版本

软件 推荐版本 说明
JDK 1.8.151 JAVA环境依赖(需配置环境变量)
Maven 3.6.3 项目构建(需配置环境变量)
Redis 3.2.100(Windows)/6.0.x(Linux、Mac)
MySQL 5.7.x

工具推荐

特别说明：IDEA 2019.1和Maven 3.6.3存在兼容性问题

IDEA 不得低于 2020.1 版本

服务说明

服务名称 默认端口 描述
nacos 30099 服务注册、发现和配置中心
sentinel-server 30098 流量控制、熔断降级、系统负载保护
seata-server 30095 分布式事务
boot-admin 30097 管理和监控SpringBoot应用
skywalking 30096 链路追踪监控
jnpf-gateway 30000 网关
jnpf-oauth 30001 认证服务
jnpf-system 30002 系统基础服务
jnpf-visualdev 30003 可视化开发(在线开发、代码生成、大屏设计、门户设计)
jnpf-workflow 30004 工作流
jnpf-file 30005 文件服务(上传、下载、预览等)
jnpf-tenant 30006 租户服务
jnpf-datareport 30007 报表服务
jnpf-extend 30019 扩展(系统内置示例)
jnpf-third 30020 第三方应用(如微信公众号、微信企业等）
jnpf-example 30100 子系统开发模板

使用说明

创建库并导入数据库脚本

在使用Navicat等工具时，``运行SQL脚本执行`jnpf_init.sql`可能会报错(初始数据含有JSON数据)，建议使用`新建查询`执行初始化脚本

  • jnpf-databae/MySQL/jnpf_init.sql（项目主库）
  • jnpf-databae/java微服务/jnpf_nacos.sql（项目配置库）

开发环境配置

Nacos配置

  • 打开jnpf-registry/nacos/conf/application.properties
  • 修改数据库配置(第39-41行)

Seata配置

  • 打开jnpf-registry/seata/conf/file.conf，修改数据源配置(第27行开始)
  • 打开数据库仓库的jnpf-databae/java微服务/jnpf_seata_config.sql修改seata配置SQL脚本，并在jnpf_nacos(项目配置库)中执行脚本

Sentinel配置

  • 右击jnpf-registry/sentinel-server/pom.xml 选择Add as Maven Project
  • 打开sentinel-server/src/main/resoures/application.properties,修改配置nacos服务地址(第29行)(nacos为本地地址时无需修改)

Skywalking配置

  • 打开skywalking/config/application.yml ,修改下数据源配置(第164-166行)
  • 创建skywalking初始表
    • 运行skywalking/bin/oapServiceInit.bat(windows环境)
    • 运行skywalking/bin/oapServiceInit.sh(Linux、Mac环境)
  • IDEA启动项中的VM options中添加skywalking/agent/run skywalking-agent.txt中的-javaagent:、-Dskywalking.agent.service_name即可，每个启动类都需要添加

其他子系统配置

  • 启动nacos,打开配置管理-配置列表- dev,修改datasource.yaml(Redis,数据库配置)和resources.yaml(静态资源配置)

JVM配置(根据实际情况调整)

启动项 参考配置 描述
JnpfExampleApplication -Xmx100m -Xms100m -Xmn50m -Xss1024k 子系统开发模板
JnpfExtendApplication -Xmx200m -Xms200m -Xmn80m -Xss1024k 扩展服务
JnpfFileAplication -Xmx200m -Xms200m -Xmn100m -Xss1024k 文件服务
JnpfGatewayApplication -Xmx400m -Xms400m -Xmn150m -Xss1024k 网关
JnpfOauthApplication -Xmx500m -Xms500m -Xmn150m -Xss1024k 授权中心
JnpfSystemApplication -Xmx500m -Xms500m -Xmn180m -Xss1024k 系统
JnpfThirdApplication -Xmx200m -Xms200m -Xmn80m -Xss1024k 第三方应用
JnpfVisualdevApplication -Xmx800m -Xms800m -Xmn300m -Xss1024k 可视化开发
JnpfWorkflowApplication -Xmx800m -Xms800m -Xmn300m -Xss1024k 工作流
JnpfDataReportApplication -Xmx800m -Xms800m -Xmn300m -Xss1024k 报表
JnpfTenantApplication -Xmx200m -Xms200m -Xmn80m -Xss1024k 多租户

#### 开发环境配置

在Run/Debug Configurations界面按上述表格配置

测试生成环境配置

在启动命令加上配置-Xmx500m -Xms500m -Xmn180m -Xss1024k，如

nohup java -jar -Xmx500m -Xms500m -Xmn180m -Xss1024k jnpf-system-3.1.0-SNAPSHOT.jar > Log.log & 2>&1 &

项目启动

建议按照如下顺序进行启动，注意监控注册中心，确保每个服务都启动成功

nacos服务(优先启动等级1)

  • 运行jnpf-registry/nacos/bin/startup.cmd(windows环境)
  • 运行jnpf-registry/nacos/bin/startup.sh(Linux、Mac环境)
  • 打开http://localhost:30099/nacos/index.html，默认账号密码为nacos

sentinel服务(优先启动等级2)

  • 运行jnpf-registry/sentinel-server/src/main/java/com/alibaba/csp/sentinel/dashboard/DashboardApplication.java启动类

seata服务(优先启动等级2)

  • 运行jnpf-registry/seata/bin/startup.bat(windows环境)
  • 运行jnpf-registry/seata/bin/startup.sh(Linux、Mac环境)

skywalking服务(非必需)

  • 运行skywalking/bin/startup.bat(windows环境)
  • 运行skywalking/bin/startup.sh(Linux、Mac环境)

boot-admin管理和监控SpringBoot应用(非必需)

  • 运行jnpf-registry/boot-admin/src/main/java/jnpf/JnpfAdminApplication.java启动类

其他服务(不分先后顺序)

  • jnpf-gateway服务(网关)：运行/jnpf-gateway/src/main/java/jnpf/system/base/JnpfGatewayApplication.java启动类

  • jnpf-oauth服务(授权中心)：运行jnpf-oauth/jnpf-oauth-server/src/main/java/jnpf/JnpfOauthApplication.java启动类

  • jnpf-file服务(文件)：运行jnpf-file/jnpf-file-server/src/main/java/jnpf/JnpfFileAplication.java启动类

  • jnpf-system服务(系统基础)：运行jnpf-system/jnpf-system-base/jnpf-system-base-server/src/main/java/jnpf/JnpfSystemApplication.java启动类

  • jnpf-visualdev服务(可视化开发)：运行jnpf-visualdev/jnpf-visualdev-server/src/main/java/jnpf/JnpfVisualdevApplication.java启动类

  • jnpf-workflow服务(工作流)： 运行jnpf-workflow/jnpf-workflow-server/src/main/java/jnpf/JnpfWorkflowApplication.java启动类

  • jnpf-datareport服务(报表)： 运行jnpf-report/jnpf-datareport/report-console/src/main/java/com/bstek/ureport/console/JnpfDataReportApplication.java启动类

  • jnpf-tenant服务(多租户)： 运行jnpf-tenant/jnpf-tenant-server/src/main/java/jnpf/JnpfTenantApplication启动类

  • jnpf-extend服务(扩展)： 运行jnpf-extend/jnpf-extend-server/src/main/java/jnpf/JnpfExtendApplication.java启动类

  • jnpf-third服务(第三方应用)： 运行jnpf-extend/jnpf-third-server/src/main/java/jnpf/JnpfThirdApplication.java启动类

服务组件

  • Nacos

    • 版本：1.4.0
    • 控制台URL: http://localhost:30099/nacos/index.html
    • 用户密码：nacos/nacos

  • Sentinel

    • 版本：1.8.0
    • 控制台URL: http://localhost:30098
    • 用户密码：sentinel/sentinel

  • Spring Boot Admin(可选)

    • 版本：2.3.0
    • 控制台URL: http://localhost:30097
    • 用户密码：admin/admin

  • Skywalking(可选)

    • 版本：8.3.0
    • 控制台URL: http://localhost:30096

全局接口

  • 打开http://localhost:30000/swagger-ui.html