mldong-app模块初始化
众所周之,当前项目包含 mldong-admin 管理端和 mldong-app 移动端两个主要模块。目前 mldong-app 开源版本为空项目,尚未包含任何实际代码。本文档将详细介绍 mldong-app 模块的初始化步骤。
pom.xml配置
- 将
mldong-admin模块的pom.xml文件复制到mldong-app模块中 - 修改
mldong-app模块的pom.xml文件中的<artifactId>标签:<artifactId>mldong-app</artifactId>

复制配置类
- 在
mldong-app模块中新建包com.mldong.config - 将
mldong-admin模块中com.mldong.config包下的所有类复制到mldong-app的com.mldong.config包下

复制配置文件
- 将
mldong-admin模块的resources/*所有文件复制到mldong-app模块的resources文件夹下 - 修改
application.yml文件中的应用名和端口号:

server:
port: 18081
#...略
#spring相关配置
spring:
application:
name: mldong-app
#...略
# 管理配置
management:
server:
port: 50081
#...略
复制控制层类
- 在
mldong-app模块中新建包com.mldong.modules.sys - 将
mldong-admin模块中com.mldong.modules.sys包下的AuthController.java和UserController.java类复制到mldong-app的com.mldong.modules.sys包下
用户中心接口清单
在移动端应用中,通常只需要保留与用户个人中心相关的接口:
| 接口路径 | 请求方式 | 接口说明 |
|---|---|---|
/sys/user/permCode | POST | 获取个人权限标识 |
/sys/user/updateInfo | POST | 修改个人信息 |
/sys/user/info | POST | 获取用户个人信息 |
/sys/user/updatePwd | POST | 修改个人密码 |
/sys/user/updateAvatar | POST | 修改个人头像 |
/sys/user/onlineDevice | POST | 获取在线设备列表 |
操作建议
- 删除所有与用户管理、用户列表等管理功能相关的接口
- 保留的接口主要服务于当前登录用户的个人操作
- 根据实际业务需求,可以适当增减接口
复制启动类
将 mldong-admin 模块的 com.mldong.MldongAdminApplication.java 类复制到 mldong-app 模块包 com.mldong 下,并修改类名为 MldongAppApplication.java:
package com.mldong;
import org.dromara.x.file.storage.spring.EnableFileStorage;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
/**
* @author mldong
* @date 2023/9/20
*/
@SpringBootApplication
@EnableFileStorage
public class MldongAppApplication {
public static void main(String[] args) {
SpringApplication.run(MldongAppApplication.class, args);
}
}
启动项目
启动 mldong-app 模块,访问 http://localhost:18081/doc.html 查看接口文档。


关于登录
管理端和用户端使用同一套用户登录体系,因此登录接口复用管理端接口。为了区分业务逻辑,登录时需要在请求头中增加 appCode 参数:
appCode=PLATFORM:表示默认的管理端appCode=APP:表示移动端
可通过 MenuAppCodeEnum.java 类进行扩展。
应用编码配置
应用编码在管理系统中也有体现:
- 菜单管理:系统设置 -> 菜单管理,包含多个 tab 页,分别对应不同应用编码下的菜单
- 角色管理:系统设置 -> 角色管理,包含多个 tab 页,分别对应不同应用编码下的角色


完整目录

最后
至此,mldong-app 模块的初始化步骤已全部完成,现在可以开始移动端应用的开发工作了。
需要注意的是,管理端和移动端的业务逻辑可以充分复用。如需区分不同端的业务处理,可以在业务逻辑中通过 appCode 参数进行区分判断。可通过 LoginUserHolder.getAppCode() 方法获取当前应用编码,实现差异化业务逻辑处理。
虽然控制层(Controller层)是独立的,各自维护不同的接口,但服务层(Service层)和数据访问层(DAO层)等底层业务逻辑完全可以共享复用,这样既保证了接口的灵活性,又避免了重复开发相同的业务逻辑。
