wenote 项目
基于 JSP + Servlet 的 Web 应用项目
技术栈
- JDK: 17
- Web 服务器: Tomcat 11
- 数据库: MySQL 8
- Web 框架: JSP + Servlet (Jakarta EE)
- 前端框架: Layui
项目结构
wenote/
├── src/
│ ├── main/
│ │ ├── java/
│ │ │ └── cn/edu/lyu/fxfx/wenote/
│ │ │ ├── bean/ # 实体类
│ │ │ ├── controller/ # 控制器
│ │ │ ├── dao/ # 数据访问层
│ │ │ ├── filter/ # 过滤器
│ │ │ ├── service/ # 业务逻辑层
│ │ │ └── util/ # 工具类
│ │ ├── resources/ # 资源文件
│ │ │ └── db.properties # 数据库配置
│ │ └── webapp/ # Web 应用根目录
│ │ ├── index.jsp # 首页
│ │ ├── resources/ # 静态资源
│ │ │ ├── ckeditor/ # 富文本编辑器
│ │ │ ├── css/ # 样式文件
│ │ │ ├── js/ # JavaScript 文件
│ │ │ └── layui/ # Layui 框架
│ │ └── WEB-INF/
│ │ ├── web.xml # Web 应用配置
│ │ ├── lib/ # 第三方 JAR 包
│ │ ├── error/ # 错误页面
│ │ └── view/ # JSP 视图文件
└── doc/ # 文档目录
环境配置
1. JDK 17
确保已安装 JDK 17 并配置环境变量。
2. Tomcat 11
- 下载并解压 Tomcat 11
- 配置
CATALINA_HOME环境变量 - 在 Eclipse 中配置 Tomcat 11 服务器
3. MySQL 8
- 安装 MySQL 8
- 创建数据库:
wenote - 修改
src/main/resources/db.properties中的数据库连接信息
4. 依赖库
将以下 JAR 包放入 src/main/webapp/WEB-INF/lib/ 目录:
mysql-connector-j-8.0.33.jar(MySQL 驱动)jakarta.servlet.jsp.jstl-3.0.1.jar(JSTL 实现)jakarta.servlet.jsp.jstl-api-3.0.2.jar(JSTL API)
数据库配置
编辑 src/main/resources/db.properties 文件,修改数据库连接信息:
db.url=jdbc:mysql://localhost:3306/wenote?useUnicode=true&characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
db.username=your_username
db.password=your_password
数据库初始化
执行数据库脚本创建表结构和测试数据:
src/main/resources/sql/wenote.sql或src/main/webapp/wenote.sql
测试账号(密码均为:123456):
- 管理员:
admin - 普通用户:
editor
部署说明
- 在 Eclipse 中导入项目
- 配置 Tomcat 11 服务器
- 执行数据库脚本初始化数据库
- 将项目部署到 Tomcat
- 启动 Tomcat 服务器
- 访问
http://localhost:8080/wenote
注意事项
-
提交要求:
- 文件上传时生成或创建的目录、文件等不要打包压缩
- 提交的文件中不需要
.class字节码文件 - 每个项目会进行指纹验证,重复超过 60% 视为抄袭
-
字符编码:
- 所有文件使用 UTF-8 编码
- 已配置字符编码过滤器,统一处理请求和响应编码
-
Jakarta EE:
- Tomcat 11 使用 Jakarta EE 规范
- 包名使用
jakarta.*而不是javax.*
开发规范
- 包命名:
cn.edu.lyu.fxfx.wenote - 编码规范:遵循 Java 编码规范
- 注释:关键类和方法需要添加 JavaDoc 注释