Java项目实战基础管理系统：从零搭建企业级应用的完整流程

在当今软件开发领域，Java凭借其跨平台性、稳定性和丰富的生态体系，依然是构建企业级应用的首选语言。一个基础管理系统（如用户管理、权限控制、数据维护等）是大多数业务系统的起点。本文将带你一步步从零开始，使用Java技术栈（Spring Boot + MyBatis + MySQL + Vue.js）完成一个完整的Java项目实战基础管理系统的设计与实现。

一、项目背景与目标

许多初学者或刚进入职场的开发者常面临“学了很多理论，却不知道如何落地”的困境。本项目旨在通过实际操作，帮助你掌握：

前后端分离架构设计
Spring Boot快速搭建RESTful API
MyBatis进行数据库交互
JWT实现无状态认证
Vue.js前端页面开发与组件化思维

最终产出一个可运行、可扩展、符合企业规范的基础管理系统原型。

二、技术选型与环境准备

后端技术栈

Java版本：JDK 17（推荐长期支持版本）
框架：Spring Boot 3.x（自动配置+内嵌Tomcat）
ORM工具：MyBatis Plus（简化CRUD操作）
数据库：MySQL 8.0（支持JSON字段和事务）
安全框架：Spring Security + JWT（Token鉴权）
日志：Logback（结构化日志输出）

前端技术栈

框架：Vue 3 + Element Plus（UI组件库）
状态管理：Pinia（替代Vuex，更轻量易用）
HTTP客户端：Axios（封装请求拦截器）

开发工具

IDEA / VS Code（代码编辑）
Postman（API测试）
Docker（容器化部署准备）

三、项目结构设计与模块划分

采用MVC分层架构，确保代码清晰可维护：

src/main/java/com/example/basemanagement/
├── controller/       # 控制器层（接收请求）
├── service/          # 服务层（业务逻辑）
├── mapper/           # 数据访问层（SQL映射）
├── entity/           # 实体类（对应数据库表）
├── config/           # 配置类（Security、Swagger等）
└── exception/        # 自定义异常处理

核心功能模块

用户管理：增删改查、角色分配、密码加密存储（BCrypt）
角色权限：RBAC模型设计，菜单权限控制
日志记录：操作日志入库（便于审计）
接口文档：集成Swagger UI自动生成API文档

四、数据库设计与初始化

表结构设计

以用户为例，创建基础表：

CREATE TABLE user (
  id BIGINT PRIMARY KEY AUTO_INCREMENT,
  username VARCHAR(50) UNIQUE NOT NULL,
  password VARCHAR(255) NOT NULL,
  role ENUM('ADMIN', 'USER') DEFAULT 'USER',
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);

MyBatis映射文件示例

<mapper namespace="com.example.basemanagement.mapper.UserMapper">
  <select id="selectUserByUsername" resultType="com.example.basemanagement.entity.User">
    SELECT * FROM user WHERE username = #{username}
  </select>
  <insert id="insertUser" parameterType="com.example.basemanagement.entity.User">
    INSERT INTO user(username, password, role) VALUES (#{user.username}, #{user.password}, #{user.role})
  </insert>
</mapper>

五、后端核心实现详解

1. 用户登录接口（JWT生成）

@PostMapping("/login")
public ResponseEntity<Map<String, Object>> login(@RequestBody LoginRequest request) {
    User user = userService.findByUsername(request.getUsername());
    if (user == null || !passwordEncoder.matches(request.getPassword(), user.getPassword())) {
        return ResponseEntity.status(HttpStatus.UNAUTHORIZED).body(Map.of("message", "用户名或密码错误"));
    }

    String token = jwtUtil.generateToken(user);
    return ResponseEntity.ok(Map.of(
        "token", token,
        "role", user.getRole()
    ));
}

2. 权限校验过滤器

public class JwtAuthenticationFilter extends OncePerRequestFilter {
    @Override
    protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain chain) {
        String token = getTokenFromHeader(request);
        if (token != null && jwtUtil.validateToken(token)) {
            String username = jwtUtil.getUsernameFromToken(token);
            Authentication auth = new UsernamePasswordAuthenticationToken(username, null, Collections.emptyList());
            SecurityContextHolder.getContext().setAuthentication(auth);
        }
        chain.doFilter(request, response);
    }
}

3. 异常全局处理

@ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handleException(Exception e) {
        log.error("系统异常: {}", e.getMessage(), e);
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(new ErrorResponse("服务器内部错误"));
    }
}

六、前端页面开发与交互

1. 登录页（Vue + Element Plus）

<template>
  <el-form :model="form" @submit.prevent="onSubmit">
    <el-input v-model="form.username" placeholder="用户名" />
    <el-input v-model="form.password" type="password" placeholder="密码" />
    <el-button type="primary" @click="onSubmit">登录</el-button>
  </el-form>
</template>

Java项目实战基础管理系统：从零搭建企业级应用的完整流程 | 蓝燕云资讯