1. 苍穹外卖项目入门实战：从零搭建企业级Java外卖系统
作为一名刚接触Java企业级开发的新手，我选择了苍穹外卖这个实战项目来巩固JavaWeb知识。这个项目涵盖了从环境搭建到核心功能实现的完整流程，非常适合用来学习现代Java后端开发的技术栈和工程实践。下面我将详细记录第一天的学习成果，包括环境搭建、技术选型分析和核心功能实现。
2. 项目环境搭建与配置
2.1 开发环境准备
企业级Java项目开发需要一套完整的开发环境，我按照以下步骤进行了配置：
-
JDK安装与配置：选择了JDK17作为开发环境，这是目前LTS版本中功能最完善且稳定的版本。安装后需要配置JAVA_HOME环境变量，并确保PATH中包含JDK的bin目录。
-
IDE选择：使用IntelliJ IDEA作为开发工具，这是目前Java开发最强大的IDE，提供了完善的代码提示、调试和版本控制集成功能。
-
构建工具：项目采用Maven进行依赖管理和构建，需要在本地安装Maven并配置settings.xml文件，特别是需要设置国内镜像源以加速依赖下载。
2.2 前端环境配置
苍穹外卖项目采用前后端分离架构，前端部分使用Vue.js开发，需要配置Node.js环境：
- 安装Node.js（建议使用LTS版本）
- 配置npm或yarn作为包管理工具
- 安装Vue CLI脚手架工具
- 启动前端开发服务器
2.3 数据库环境
项目使用MySQL作为主数据库，Redis作为缓存数据库：
- 安装MySQL 8.0并创建项目数据库
- 配置数据库用户权限
- 执行项目提供的SQL脚本初始化数据表
- 安装Redis并配置持久化策略
3. 项目结构与技术选型分析
3.1 项目模块划分
苍穹外卖采用Maven多模块架构，主要分为三个核心模块：
- sky-common：公共模块，包含工具类、常量定义、异常处理等通用组件
- sky-pojo：实体模块，定义数据模型、DTO、VO等数据对象
- sky-server：业务模块，包含控制器、服务、数据访问层等业务实现
这种模块化设计遵循了"高内聚、低耦合"的原则，每个模块职责单一，便于团队协作和代码维护。
3.2 核心技术栈
3.2.1 基础框架
- Spring Boot：作为项目的基础框架，提供了自动配置、依赖注入等核心功能
- Spring MVC：处理HTTP请求和响应的Web框架
- MyBatis：持久层框架，负责数据库访问
- Lombok：通过注解简化JavaBean的编写
3.2.2 中间件与工具
- Redis：用作缓存，提高系统性能
- Nginx：反向代理和负载均衡
- Swagger：接口文档生成与测试工具
- Git：版本控制系统
3.2.3 安全相关
- JWT：用于身份认证
- MD5：密码加密存储
- Spring Security：权限控制（后续会引入）
4. 核心功能实现与问题解决
4.1 三层架构实现
项目严格遵循Controller-Service-Mapper三层架构：
- Controller层：接收HTTP请求，进行参数校验，返回统一格式的响应
- Service层：实现业务逻辑，处理事务
- Mapper层：数据库操作，执行SQL语句
这种分层架构使得代码结构清晰，各层职责明确，便于维护和扩展。
4.2 密码加密实现
用户密码安全是系统的重要保障，我们采用MD5加密存储密码：
java复制// 密码加密工具类
public class PasswordUtil {
public static String encrypt(String password) {
return DigestUtils.md5DigestAsHex(password.getBytes());
}
public static boolean matches(String rawPassword, String encodedPassword) {
return encodedPassword.equals(encrypt(rawPassword));
}
}
在实际使用中，我们需要注意：
- 密码加密应在服务端完成，前端不应处理加密逻辑
- 单纯的MD5加密已经不够安全，后续可以考虑加盐或使用更安全的算法如BCrypt
- 密码重置功能需要特别小心，要有完善的验证机制
4.3 Swagger接口文档集成
为了方便前后端协作，我们集成了Swagger用于生成API文档：
- 添加Knife4j依赖（Swagger的增强版）
- 配置Swagger的Docket Bean
- 设置静态资源映射
- 使用注解完善接口描述
配置示例：
java复制@Configuration
@EnableSwagger2
public class SwaggerConfig {
@Bean
public Docket createRestApi() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
.apis(RequestHandlerSelectors.basePackage("com.sky.controller"))
.paths(PathSelectors.any())
.build();
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("苍穹外卖API文档")
.description("苍穹外卖系统接口说明")
.version("1.0")
.build();
}
}
5. 开发中遇到的问题与解决方案
5.1 "找不到符号"编译错误
在项目编译过程中遇到了"找不到符号"的错误，经过排查发现是以下原因导致：
- Lombok版本不兼容：解决方案是升级到1.18.38版本
- JDK版本问题：项目需要JDK17，而我本地环境是JDK8
解决步骤：
- 在pom.xml中更新Lombok依赖版本
- 下载并安装JDK17
- 在IDEA中配置项目使用JDK17
- 在Maven配置中指定JDK17
5.2 数据库连接问题
初次运行项目时遇到数据库连接失败的问题，原因是：
- 数据库服务未启动
- 连接字符串配置错误
- 用户名密码不正确
解决方案：
- 确保MySQL服务已启动
- 检查application.yml中的数据库配置
- 验证数据库用户权限
- 使用数据库客户端工具测试连接
6. 项目开发经验总结
通过第一天的项目实践，我总结了以下几点经验：
- 环境一致性很重要：开发、测试、生产环境应尽量保持一致，避免因环境差异导致的问题
- 版本管理要严格：所有依赖库的版本需要明确指定，避免自动升级带来的兼容性问题
- 文档不可或缺：无论是接口文档还是开发文档，都要及时更新维护
- 单元测试很有必要：虽然初期会花费更多时间，但能大大减少后期调试的成本
对于Java新手来说，企业级项目开发与个人练习项目有很大不同，需要关注更多工程化方面的考虑，如：
- 代码规范与风格一致性
- 日志记录与监控
- 异常处理与错误码设计
- 性能优化与安全防护
这些都是在后续开发中需要持续学习和实践的方面。