说明
为了简化和统一后续的开发,我们采用多模块的项目结构,引入 BOM 来统一管理依赖。本人并不擅长前端,前端不会过多讲解,主要基于 Sysbean Admin,后续的例子也将以对接 Sysbean Admin的接口作为例子进行讲解。
多模块
多模块的配置,可以参看 https://mp.weixin.qq.com/s/qXaZ7BCL_0-1hkqTGNxFmA。
在 IDEA 中通过 File->New->Modules...
可以创建新的模块。
先创建一个demo01的模块,然后把第一应用的文件移动到 demo01中(第一个应用的玩转例子保留在 start-up 的分支)。
之后再创建demo-parent模块,该模块用于统一管理依赖。
修改settings.gradle
补充说明写在注释中。
// 将demo,修改名称为porpoise-demo
rootProject.name = "porpoise-demo"
// 创建新模版后自动增加的内容可以不用调整
include 'demo01'
include 'demo-parent'
配置 build.gradle
补充说明写在注释中。
plugins {
id 'java'
id "io.freefair.lombok" version "8.11"
}
// 统一 jdk 版本号
def jdkVersion = 17
def demoVersion = "1.0.0"
// processor 的依赖需要指定版本号
def mapstructVersion = "1.6.3"
// processor 的依赖需要指定版本号
def easyQueryVersion = "2.4.14"
group = "com.example.demo"
version "${demoVersion}"
allprojects {
repositories {
mavenLocal()
mavenCentral()
// 增加腾讯云 maven 仓库镜像,提速。
maven { url "https://mirrors.cloud.tencent.com/nexus/repository/maven-public/" }
}
// 版本号传递
ext["jdkVersion"] = "${jdkVersion}"
ext["demoVersion"] = "${demoVersion}"
ext["mapstructVersion"] = "${mapstructVersion}"
ext["easyQueryVersion"] = "${easyQueryVersion}"
tasks.withType(JavaCompile).tap {
configureEach {
options.encoding = "UTF-8"
// 统一指定编译时保留参数名
options.compilerArgs << "-parameters" << "-Xlint:unchecked" << "-Xlint:deprecation"
}
}
}
配置 demo-parant
增加dependencies.gradle
用于统一管理版本号。
ext {
set("solonVersion", "3.0.7")
set("esearchxVersion", "1.0.22")
set("hikaricpVersion", "5.1.0")
set("mysqlVersion", "8.0.28")
set("hutoolVersion", "6.0.0-M18")
set("transmittableThreadLocalVersion", "2.14.2")
}
配置 build.gradle
补充说明写在注释中。
plugins {
// 使用 java-platform 可以统一管理 bom
id 'java-platform'
id 'maven-publish'
}
// 引入版本管理文件
apply from: "dependencies.gradle"
group 'com.example.demo'
version "${demoVersion}"
javaPlatform {
allowDependencies()
}
dependencies {
api platform("org.noear:solon-parent:${solonVersion}")
constraints {
api("com.zaxxer:HikariCP:${hikaricpVersion}")
api("mysql:mysql-connector-java:${mysqlVersion}")
api("com.easy-query:sql-solon-plugin:${easyQueryVersion}")
api("org.noear:esearchx:${esearchxVersion}")
api("org.dromara.hutool:hutool-all:${hutoolVersion}")
api("org.mapstruct:mapstruct:${mapstructVersion}")
api("com.alibaba:transmittable-thread-local:${transmittableThreadLocalVersion}")
}
}
publishing {
publications {
//以下maven并非关键字,可自定义
maven(MavenPublication) {
//通过java-platform生成BOM
from components.javaPlatform
}
}
repositories {
// 根据需要发布到不同的仓库,此处只是发布到本地
mavenLocal()
}
}
配置 demo01
配置 build.gradle
补充说明写在注释中。
plugins {
id 'java'
id "io.freefair.lombok"
}
group = "com.example"
// 统一版本号
version "${demoVersion}"
description = "Demo project for Solon"
java {
toolchain {
languageVersion = JavaLanguageVersion.of("${jdkVersion}")
}
}
dependencies {
// 使用 demo-parent,依赖调整的最主要的位置
implementation platform(project(":demo-parent"))
implementation("org.noear:solon-web")
implementation("org.noear:solon-view-freemarker")
implementation("org.noear:solon-logging-logback")
// 删除,已经用插件的方式引入了
// compileOnly("org.projectlombok:lombok")
testImplementation("org.noear:solon-test")
}
compileJava {
options.encoding = "UTF-8"
options.compilerArgs << "-parameters"
}
jar {
manifest {
attributes "Main-Class": "com.example.demo.App"
}
dependsOn(configurations.runtimeClasspath)
duplicatesStrategy = DuplicatesStrategy.EXCLUDE
from(configurations.runtimeClasspath.collect {
if (it.isDirectory()) it else zipTree(it)
}) {
exclude 'META-INF/MANIFEST.MF'
exclude 'META-INF/*.SF'
exclude 'META-INF/*.DSA'
exclude 'META-INF/*.RSA'
}
def sourcesMain = sourceSets.main
sourcesMain.allSource.forEach { println("add from sources: ${it.name}") }
from(sourcesMain.output)
}
重新运行demo01
日志中出现如下字样,表示项目结构调整成功,可通过浏览器调用进行测试。
App: End loading elapsed=258ms pid=32912 v=3.0.7
技术栈
后端
- JDK 17
- Gradle 8+
- Solon 3.0.7
- Easy-query 2.4.14
- lombok 8.11
- Mapstruct 1.6.3
- Hutool 6.0.0-M18
- MySQL 8+
- Redis 6+
前端
具体参看其官方文档,https://docs.soybeanjs.cn/zh/guide/quick-start 。
- Node 18.19.0+
- pnpm 8.7.0+
- Vue 3
- Vite 4
- TypeScript
小结
将项目调整为多模块结构,增加父BOM,并测试 demo01 可以正常运行,为后续项目的开发做好准备。
完整代码可以从 https://gitee.com/CrazyAirhead/porpoise-demo 获取。