# java-servlet-jsp

**Repository Path**: ahcheng/java-servlet-jsp

## Basic Information

- **Project Name**: java-servlet-jsp
- **Description**: servlet jsp 实现的书籍投票系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-28
- **Last Updated**: 2025-07-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 书籍投票系统

这是一个基于 Java Servlet 和 XML 的简单书籍投票系统，支持用户投票、管理员管理书籍信息和查看投票记录等功能。

---

## 功能特点

- **用户投票**：用户可以对喜欢的书籍进行投票。
- **管理员功能**：
  - 登录验证
  - 添加、更新、删除书籍
  - 查看所有投票记录
- **数据持久化**：使用 XML 文件存储书籍和投票数据。
- **防止重复投票**：通过 IP 地址限制每本书只能投票一次。

---

## 技术栈

- Java Servlet
- JSP 页面
- Jackson XML 序列化/反序列化
- Apache Tomcat 服务器

---

## 目录结构说明

- `src/main/java/org/xiaoxiao/servlet`：包含所有 Servlet，处理用户请求。
- `src/main/java/org/xiaoxiao/dao`：数据访问层，负责 XML 数据的读写。
- `src/main/java/org/xiaoxiao/pojo`：数据模型类，对应书籍、投票记录、管理员账户等。
- `src/main/webapp`：JSP 页面和 Web 配置文件。

---

## 安装与运行

1. 确保已安装 [Apache Tomcat](https://tomcat.apache.org/)。
2. 将项目导入 IDE（如 IntelliJ IDEA 或 Eclipse）。
3. 构建项目并部署到 Tomcat 服务器。
4. 启动服务器，访问 `http://localhost:8080/index` 查看首页。

---

## 使用说明

- **首页**：访问 `/index` 查看书籍列表并进行投票。
- **登录**：访问 `/login` 页面，管理员登录后可进行书籍管理。
- **管理页面**：访问 `/admin` 添加、编辑或删除书籍。
- **投票记录**：访问 `/records` 查看所有投票记录。

---

## 数据存储

所有书籍和投票数据都保存在 XML 文件中，默认路径为 `BookVoteDao.XML_FILE`。

---

## 贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork 本项目。
2. 创建新分支 (`git checkout -b feature/new-feature`)。
3. 提交更改 (`git commit -m 'Add new feature'`)。
4. 推送分支 (`git push origin feature/new-feature`)。
5. 提交 Pull Request。

---

## 许可证

本项目采用 MIT License，请查看 [LICENSE](LICENSE) 文件了解详细信息。