# gobang

**Repository Path**: joyven/gobang

## Basic Information

- **Project Name**: gobang
- **Description**: 一个简单的五子棋项目，用于演示在vscode中如何生成并运行Java web项目。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-25
- **Last Updated**: 2025-12-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 五子棋游戏 - Web版

这是一个基于传统Java Web技术栈开发的五子棋游戏，使用JSP作为前端页面，Java Servlet作为后端逻辑，运行在Tomcat 9服务器上。

## 🎮 项目特色

- **经典玩法**: 传统五子棋规则，先连成五子者获胜
- **智能AI对战**: 玩家对战智能AI电脑，具备攻防策略
- **AI智能特性**: 
  - 进攻策略：寻找获胜机会
  - 防守策略：阻止玩家连成五子
  - 位置评估：优先选择中心区域和有利位置
- **响应式界面**: 美观的Canvas绘制棋盘，支持移动端适配
- **实时交互**: AJAX异步通信，AI自动下棋，流畅的游戏体验
- **状态管理**: Session会话管理，支持游戏状态持久化

## 🛠️ 技术栈

- **前端**: JSP + HTML5 Canvas + CSS3 + JavaScript
- **后端**: Java Servlet 4.0 + JSP
- **服务器**: Tomcat 9.x
- **构建工具**: Maven
- **项目结构**: 标准Maven WAR包结构

## 📁 项目结构

```
src/
├── main/
│   ├── java/com/bishuo/demo/
│   │   ├── ai/GameAI.java                         # AI智能算法
│   │   ├── filter/CharacterEncodingFilter.java    # 字符编码过滤器
│   │   ├── model/
│   │   │   ├── GameBoard.java                     # 棋盘模型
│   │   │   └── Player.java                        # 玩家模型
│   │   ├── service/GameService.java               # 游戏服务
│   │   ├── servlet/
│   │   │   ├── GameServlet.java                   # 游戏管理Servlet
│   │   │   └── BoardServlet.java                  # 棋盘操作Servlet
│   │   └── util/GameUtils.java                    # 工具类
│   ├── webapp/
│   │   ├── css/game.css                           # 游戏样式
│   │   ├── js/game.js                             # 前端逻辑
│   │   ├── index.jsp                              # 主游戏页面
│   │   ├── error.jsp                              # 错误页面
│   │   └── WEB-INF/web.xml                        # Web配置
└── pom.xml                                        # Maven配置
```

## 🚀 快速开始

### 环境要求

- Java 8+
- Maven 3.6+
- Tomcat 9.x

### 编译和部署

1. **克隆项目**
```bash
git clone <repository-url>
cd demo
```

2. **编译项目**
```bash
mvn clean compile
```

3. **构建WAR包**
```bash
mvn clean package
```

4. **部署到Tomcat**
```bash
# 将生成的demo.war复制到Tomcat的webapps目录
cp target/demo.war /path/to/tomcat/webapps/

# 重启Tomcat服务器
cd /path/to/tomcat/bin
./catalina.sh run
```

5. **访问游戏**
打开浏览器访问: `http://localhost:8080/demo/`

## 🎯 游戏玩法

1. **游戏开始**: 点击"开始新游戏"按钮初始化游戏
2. **下棋规则**: 点击棋盘交叉点放置棋子
3. **AI对战**: 玩家下棋后，AI电脑会自动下棋回应
4. **AI策略**: AI具备攻防策略，会寻找获胜机会并阻止玩家连成五子
5. **获胜条件**: 横、竖、斜任意方向连成五子即获胜
6. **游戏状态**: 实时显示当前回合和游戏状态
7. **重新开始**: 点击"重置游戏"开始新一局

## 📋 API接口

### 游戏管理接口

- `GET /demo/game?action=init` - 初始化游戏
- `GET /demo/game?action=status` - 获取游戏状态
- `GET /demo/game?action=reset` - 重置游戏

### 棋盘操作接口

- `GET /demo/board?action=status` - 获取棋盘状态
- `POST /demo/board?action=move&row={row}&col={col}` - 下棋操作

## 🔧 开发说明

### 主要组件

1. **GameBoard**: 管理15x15棋盘状态，实现五子连珠判断算法
2. **GameService**: 单例模式的服务类，管理游戏会话和状态
3. **Servlet层**: 
   - GameServlet: 处理游戏初始化、状态查询、重置等
   - BoardServlet: 处理下棋操作和棋盘状态更新
4. **前端**: Canvas绘制棋盘，AJAX异步通信，响应式设计

### 核心功能

- **状态管理**: 使用HttpSession管理游戏会话
- **并发处理**: GameService使用ConcurrentHashMap确保线程安全
- **胜负判断**: 实现四个方向的连子检测算法
- **错误处理**: 完善的错误处理和用户反馈机制

## 🎨 界面特性

- **现代化设计**: 渐变背景、圆角边框、阴影效果
- **响应式布局**: 支持桌面和移动设备
- **交互反馈**: 悬停效果、点击动画、状态提示
- **视觉层次**: 清晰的信息架构和视觉引导

## 📦 构建产物

- `target/demo.war` - 可部署的Web应用包
- `target/classes/` - 编译后的Java类文件
- `target/demo/` - 解压后的Web应用目录

## 🔍 故障排除

### 常见问题

1. **404错误**: 确保Tomcat服务正常运行，检查端口配置
2. **编译错误**: 检查Java版本和Maven配置
3. **样式问题**: 清除浏览器缓存，检查CSS文件路径
4. **功能异常**: 查看Tomcat日志，确认Servlet正确加载

### 日志查看

```bash
# 查看Tomcat日志
tail -f /path/to/tomcat/logs/catalina.out
```

## 📝 开发者信息

- **技术架构**: 传统Java Web应用
- **兼容性**: 支持Servlet 4.0规范
- **扩展性**: 模块化设计，易于添加新功能

## 🎉 项目完成

这个五子棋Web游戏项目已经完成开发和测试，具备完整的游戏功能和良好的用户体验。项目采用传统的Java Web技术栈，代码结构清晰，功能完整，可以作为学习Java Web开发的参考项目。

**享受游戏时光！** 🎮✨