|
|
@@ -1,65 +1,107 @@
|
|
|
-# SSM_template
|
|
|
+# SSM_template — 甜蜜时光蛋糕坊
|
|
|
|
|
|
-SSM框架快速开发模板，整合 Spring + Spring MVC + MyBatis。
|
|
|
+基于 Spring + Spring MVC + MyBatis 的蛋糕商城系统。
|
|
|
|
|
|
## 技术栈
|
|
|
|
|
|
-- **Spring**: 5.3.31
|
|
|
-- **Spring MVC**: 5.3.31
|
|
|
-- **MyBatis**: 3.5.6
|
|
|
-- **Druid**: 1.2.8
|
|
|
-- **Thymeleaf**: 3.0.12.RELEASE
|
|
|
-- **MySQL**: 8.0.25
|
|
|
+| 层 | 技术 |
|
|
|
+|---|------|
|
|
|
+| 前端 | JSP + JSTL + Bootstrap 4.3.1 CDN + jQuery CDN + Font Awesome |
|
|
|
+| 控制层 | Spring MVC 5.3.31 |
|
|
|
+| 业务层 | Spring 5.3.31 + @Transactional |
|
|
|
+| 持久层 | MyBatis 3.5.6 + MyBatis-Spring 2.0.6 |
|
|
|
+| 连接池 | Druid 1.2.8 |
|
|
|
+| 数据库 | MySQL 8.0 |
|
|
|
+| 构建 | Maven (Java 8, war 打包) |
|
|
|
+| 容器 | Tomcat 7+ |
|
|
|
|
|
|
-## 项目结构
|
|
|
+## 快速开始
|
|
|
|
|
|
-```
|
|
|
-SSM_template
|
|
|
-├── src
|
|
|
-│ └── main
|
|
|
-│ ├── java/space/anyi # Java源码
|
|
|
-│ │ ├── controller/ # 控制层
|
|
|
-│ │ ├── entity/ # 实体类
|
|
|
-│ │ └── mapper/ # Mapper接口
|
|
|
-│ ├── resources/ # 配置文件
|
|
|
-│ │ ├── mapper/ # MyBatis XML映射文件
|
|
|
-│ │ ├── spring-*.xml # Spring配置文件
|
|
|
-│ │ └── jdbc.properties # 数据库配置
|
|
|
-│ └── webapp/ # Web资源
|
|
|
-│ └─��� WEB-INF/
|
|
|
-├── pom.xml
|
|
|
-└── target/ # 编译输出目录
|
|
|
-```
|
|
|
+### 1. 数据库
|
|
|
|
|
|
-## 配置说明
|
|
|
+执行 `sql/init.sql` 创建数据库 `ssm` 及 21 张表，并插入模拟数据。
|
|
|
|
|
|
-### 数据库配置
|
|
|
+默认管理员：`admin` / `123456`
|
|
|
+默认用户：`zhangsan` / `123456`、`lisi` / `123456`、`wangwu` / `123456`
|
|
|
|
|
|
-编辑 `src/main/resources/jdbc.properties`：
|
|
|
+### 2. 配置
|
|
|
|
|
|
-```properties
|
|
|
-jdbc.driver=com.mysql.cj.jdbc.Driver
|
|
|
-jdbc.url=jdbc:mysql://localhost:3306/your_database
|
|
|
-jdbc.username=root
|
|
|
-jdbc.password=your_password
|
|
|
-```
|
|
|
+编辑 `src/main/resources/jdbc.properties`，修改数据库连接信息。
|
|
|
|
|
|
-### 运行
|
|
|
+### 3. 运行
|
|
|
|
|
|
```bash
|
|
|
-# 打包
|
|
|
-mvn clean package
|
|
|
+mvn compile # 编译
|
|
|
+mvn clean package # 打包 war
|
|
|
+mvn tomcat7:run # 开发服务器 → http://localhost:8080/SSM_template
|
|
|
+mvn test # 运行测试
|
|
|
+```
|
|
|
+
|
|
|
+## 项目结构
|
|
|
+
|
|
|
+```
|
|
|
+src/main/java/space/anyi/
|
|
|
+├── controller/
|
|
|
+│ ├── front/ # 用户端控制器 (10)
|
|
|
+│ └── admin/ # 管理端控制器 (8)
|
|
|
+├── entity/ # 实体类 (21) + dto/ (12) + vo/ (12)
|
|
|
+├── mapper/ # MyBatis Mapper 接口 (21)
|
|
|
+├── service/ # 业务接口 (19)
|
|
|
+│ └── impl/ # 业务实现 (18)
|
|
|
+├── interceptor/ # 登录拦截器 (LoginInterceptor, AdminLoginInterceptor)
|
|
|
+├── util/ # 工具类 (MD5Util, OrderNoGenerator, Converter)
|
|
|
+└── constant/ # 常量 (OrderStatus)
|
|
|
+
|
|
|
+src/main/resources/
|
|
|
+├── mapper/ # MyBatis XML 映射文件 (21)
|
|
|
+├── spring-context.xml # Spring 核心配置
|
|
|
+├── spring-mvc.xml # Spring MVC 配置
|
|
|
+├── mybatis-config.xml # MyBatis 配置
|
|
|
+├── logback.xml # 日志配置
|
|
|
+└── jdbc.properties # 数据库连接
|
|
|
|
|
|
-# 部署到Tomcat或直接运行
|
|
|
-mvn tomcat7:run
|
|
|
+src/main/webapp/WEB-INF/views/
|
|
|
+├── index.jsp
|
|
|
+├── common/ # header.jsp, footer.jsp
|
|
|
+├── cake/ # 蛋糕列表、详情、定制
|
|
|
+├── cart/ # 购物车
|
|
|
+├── order/ # 订单结算、列表、详情
|
|
|
+├── user/ # 登录、注册、个人资料、地址管理
|
|
|
+├── favorite/ # 收藏
|
|
|
+├── coupon/ # 优惠券
|
|
|
+├── message/ # 留言
|
|
|
+├── activity/ # 活动
|
|
|
+└── admin/ # 后台管理 (16 个 JSP)
|
|
|
```
|
|
|
|
|
|
-## 主要配置文件
|
|
|
+## 核心配置文件
|
|
|
|
|
|
| 文件 | 用途 |
|
|
|
|------|------|
|
|
|
-| `spring-context.xml` | Spring核心配置 |
|
|
|
-| `spring-mvc.xml` | Spring MVC配置 |
|
|
|
-| `mybatis-config.xml` | MyBatis配置 |
|
|
|
-| `logback.xml` | 日志配置 |
|
|
|
-| `web.xml` | Web应用配置 |
|
|
|
+| `spring-context.xml` | 数据源、MyBatis、事务、AOP |
|
|
|
+| `spring-mvc.xml` | 控制器扫描、拦截器、视图解析、文件上传 |
|
|
|
+| `mybatis-config.xml` | 驼峰映射、SQL 日志、二级缓存关闭 |
|
|
|
+| `logback.xml` | 按级别分离日志 (debug/info/error)，滚动策略 |
|
|
|
+| `web.xml` | DispatcherServlet、编码过滤器 |
|
|
|
+
|
|
|
+## 权限控制
|
|
|
+
|
|
|
+| 拦截器 | Session Key | 保护路径 | 排除 |
|
|
|
+|--------|-------------|----------|------|
|
|
|
+| LoginInterceptor | `user` | `/user/*` `/cart/*` `/order/*` `/favorite/*` `/coupon/*` | `/user/login` `/user/register` |
|
|
|
+| AdminLoginInterceptor | `admin` | `/admin/**` | `/admin/login` |
|
|
|
+
|
|
|
+## 测试
|
|
|
+
|
|
|
+测试位于 `src/test/java/space/anyi/`，包含 6 个 Service 测试和 3 个 Mapper 测试。
|
|
|
+- 基类 `BaseMapperTest` 使用 `spring-test.xml`（独立配置，数据库 `ssm_test`）
|
|
|
+- `@Transactional` 自动回滚
|
|
|
+
|
|
|
+## 注意事项
|
|
|
+
|
|
|
+- Java 8 编译目标，war 打包方式
|
|
|
+- Druid 数据源在 XML 中配置（非 Spring Boot 方式）
|
|
|
+- 文件上传最大 5MB（CommonsMultipartResolver）
|
|
|
+- PageHelper 5.3.3 分页插件已启用
|
|
|
+- MyBatis `mapUnderscoreToCamelCase=true`（数据库下划线 → Java 驼峰）
|
|
|
+- 图片存储于 `./upload` 目录，路径由 `jdbc.properties` 中的 `upload.path` 配置
|
