1. 项目背景与核心需求
骑射文化作为传统体育项目的重要组成部分，近年来在文化传承和体育教育领域受到越来越多的关注。这个毕业设计项目旨在通过现代化技术手段构建一个专业的骑射文化宣传平台，满足以下核心需求：
- 文化传播：系统展示骑射运动的历史渊源、技术要点和发展现状
- 活动推广：提供赛事信息发布、在线报名和成绩查询功能
- 教学资源：整合教学视频、技术图解等多媒体学习资料
- 社区互动：建立爱好者交流论坛和作品分享空间
2. 技术架构设计
2.1 整体技术选型
采用SSM（Spring+SpringMVC+MyBatis）框架组合作为后端基础架构，主要基于以下考虑：
- Spring框架：提供完善的IoC容器和AOP支持，便于实现模块化开发
- SpringMVC：轻量级的Web框架，适合构建RESTful风格的API接口
- MyBatis：灵活的ORM框架，便于复杂查询的优化和SQL调优
前端技术栈选择：
- 基础框架：Bootstrap 5 + jQuery
- 图表展示：ECharts
- 富文本编辑：WangEditor
- 文件上传：WebUploader
2.2 系统模块划分
code复制├── 文化展示模块
│ ├── 历史沿革
│ ├── 技术解析
│ └── 现代发展
├── 赛事管理模块
│ ├── 赛事发布
│ ├── 在线报名
│ └── 成绩查询
├── 教学资源模块
│ ├── 视频课程
│ ├── 技术图解
│ └── 训练计划
└── 社区互动模块
├── 论坛交流
└── 作品分享
3. 数据库设计关键点
3.1 核心表结构
用户表(t_user)
sql复制CREATE TABLE `t_user` (
`user_id` int(11) NOT NULL AUTO_INCREMENT,
`username` varchar(50) NOT NULL,
`password` varchar(100) NOT NULL,
`real_name` varchar(50) DEFAULT NULL,
`avatar` varchar(255) DEFAULT NULL,
`user_type` tinyint(4) DEFAULT '0' COMMENT '0-普通用户 1-管理员',
`create_time` datetime DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (`user_id`),
UNIQUE KEY `idx_username` (`username`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
赛事表(t_competition)
sql复制CREATE TABLE `t_competition` (
`comp_id` int(11) NOT NULL AUTO_INCREMENT,
`title` varchar(100) NOT NULL,
`cover_img` varchar(255) DEFAULT NULL,
`start_time` datetime NOT NULL,
`end_time` datetime NOT NULL,
`location` varchar(255) NOT NULL,
`content` text,
`max_players` int(11) DEFAULT NULL,
`status` tinyint(4) DEFAULT '0' COMMENT '0-未开始 1-进行中 2-已结束',
`create_time` datetime DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (`comp_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
3.2 性能优化设计
- 读写分离：配置主从数据库，查询操作走从库
- 缓存策略：使用Redis缓存热点数据
- 赛事信息缓存：expire 1小时
- 用户会话缓存：expire 30分钟
- 索引优化：为常用查询字段建立复合索引
4. 核心功能实现
4.1 多级分类内容管理
采用树形结构存储分类数据：
java复制public class Category {
private Integer id;
private String name;
private Integer parentId;
private Integer level;
private List<Category> children;
// getters & setters
}
递归查询实现：
java复制public List<Category> getCategoryTree(Integer parentId) {
List<Category> categories = categoryMapper.selectByParentId(parentId);
for (Category category : categories) {
category.setChildren(getCategoryTree(category.getId()));
}
return categories;
}
4.2 文件上传服务
配置Spring文件上传：
java复制@Bean
public MultipartResolver multipartResolver() {
CommonsMultipartResolver resolver = new CommonsMultipartResolver();
resolver.setDefaultEncoding("UTF-8");
resolver.setMaxUploadSize(50 * 1024 * 1024); // 50MB
return resolver;
}
文件上传控制器：
java复制@PostMapping("/upload")
public Result upload(@RequestParam("file") MultipartFile file) {
if (file.isEmpty()) {
return Result.error("请选择上传文件");
}
try {
String fileName = FileUtil.generateFileName(file.getOriginalFilename());
String filePath = uploadPath + fileName;
File dest = new File(filePath);
file.transferTo(dest);
return Result.success("上传成功", "/uploads/" + fileName);
} catch (IOException e) {
log.error("文件上传失败", e);
return Result.error("上传失败");
}
}
5. 系统安全设计
5.1 认证与授权
JWT认证实现：
java复制public class JwtUtil {
private static final String SECRET = "your-secret-key";
private static final long EXPIRATION = 86400000L; // 24小时
public static String generateToken(UserDetails userDetails) {
Map<String, Object> claims = new HashMap<>();
claims.put("username", userDetails.getUsername());
claims.put("roles", userDetails.getAuthorities());
return Jwts.builder()
.setClaims(claims)
.setSubject(userDetails.getUsername())
.setIssuedAt(new Date())
.setExpiration(new Date(System.currentTimeMillis() + EXPIRATION))
.signWith(SignatureAlgorithm.HS512, SECRET)
.compact();
}
// 其他工具方法...
}
5.2 敏感数据保护
- 密码加密存储：
java复制public class PasswordEncoder implements org.springframework.security.crypto.password.PasswordEncoder {
@Override
public String encode(CharSequence rawPassword) {
return DigestUtils.md5DigestAsHex(rawPassword.toString().getBytes());
}
@Override
public boolean matches(CharSequence rawPassword, String encodedPassword) {
return encode(rawPassword).equals(encodedPassword);
}
}
- SQL注入防护：
- 使用MyBatis的#{}参数绑定
- 禁止拼接SQL语句
- 配置Druid的WallFilter
6. 前端关键实现
6.1 响应式布局设计
Bootstrap栅格系统配置：
html复制<div class="container">
<div class="row">
<div class="col-md-8">
<!-- 主内容区 -->
</div>
<div class="col-md-4">
<!-- 侧边栏 -->
</div>
</div>
</div>
媒体查询适配：
css复制@media (max-width: 768px) {
.carousel-caption h3 {
font-size: 1.2rem;
}
.news-item {
margin-bottom: 1.5rem;
}
}
6.2 动态数据加载
AJAX请求封装：
javascript复制function apiRequest(url, method, data, callback) {
$.ajax({
url: url,
type: method,
contentType: 'application/json',
data: method === 'GET' ? data : JSON.stringify(data),
beforeSend: function(xhr) {
const token = localStorage.getItem('token');
if (token) {
xhr.setRequestHeader('Authorization', 'Bearer ' + token);
}
},
success: function(res) {
if (res.code === 200) {
callback(res.data);
} else {
alert(res.msg);
}
},
error: function(xhr) {
alert('请求失败: ' + xhr.statusText);
}
});
}
7. 测试与部署
7.1 测试方案
- 单元测试：JUnit + Mockito
java复制@RunWith(SpringRunner.class)
@SpringBootTest
public class UserServiceTest {
@Autowired
private UserService userService;
@Test
public void testRegister() {
User user = new User();
user.setUsername("testuser");
user.setPassword("123456");
Result result = userService.register(user);
assertEquals(200, result.getCode());
}
}
- 接口测试：Postman测试集
- 用户注册/登录测试
- 赛事管理CRUD测试
- 文件上传测试
7.2 部署方案
- 环境要求：
- JDK 1.8+
- MySQL 5.7+
- Redis 5.0+
- Tomcat 8.5+
- 部署步骤：
bash复制# 数据库初始化
mysql -u root -p < schema.sql
# 应用打包
mvn clean package -DskipTests
# 部署war包
cp target/archery.war /usr/local/tomcat/webapps/
8. 项目优化方向
- 性能优化：
- 引入CDN加速静态资源
- 配置Gzip压缩
- 实现懒加载和分页查询
- 功能扩展：
- 微信小程序端开发
- 直播功能集成
- 在线考试系统
- 安全增强：
- 增加短信验证码登录
- 实现操作日志审计
- 配置WAF防护
实际开发中发现，MyBatis的二级缓存在高并发场景下可能引发脏读问题，建议在赛事相关查询中谨慎使用，或采用手动缓存控制策略。另外，文件上传路径最好配置为绝对路径，避免在Tomcat重启后丢失上传文件。