# java-web

**Repository Path**: zxz123/java-web

## Basic Information

- **Project Name**: java-web
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 3
- **Created**: 2026-06-23
- **Last Updated**: 2026-06-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# web-app

基于 Spring Boot 的课程信息管理系统，提供课程的查询、新增、编辑、删除与批量删除功能。

## 技术栈

| 类别 | 技术 |
|------|------|
| 语言 | Java 17 |
| 框架 | Spring Boot 4.1.0 |
| 构建 | Gradle 9.5.1（Wrapper） |
| 持久层 | Spring Data JPA + Hibernate |
| 数据库 | MySQL |
| 视图 | Thymeleaf |

## 环境要求

- **JDK 17** 或更高版本
- **MySQL 8.x**（或兼容版本）
- 网络可访问 Maven Central（首次构建需下载依赖）

## 快速开始

### 1. 克隆项目

```bash
git clone <仓库地址>
cd web-app
```

### 2. 创建数据库

在 MySQL 中创建项目使用的数据库：

```sql
CREATE DATABASE IF NOT EXISTS `java-web`
  DEFAULT CHARACTER SET utf8mb4
  DEFAULT COLLATE utf8mb4_unicode_ci;
```

应用启动后，JPA 会根据实体自动创建/更新表结构（`ddl-auto=update`）。

### 3. 配置数据库连接

编辑 `src/main/resources/application.properties`，按本地环境修改数据库连接信息：

```properties
spring.datasource.url=jdbc:mysql://localhost:3306/java-web?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
spring.datasource.username=你的用户名
spring.datasource.password=你的密码
```

> 建议不要将真实密码提交到 Git。本地开发可使用 `application-local.properties`（需自行加入 `.gitignore`）或通过环境变量覆盖配置。

### 4. 构建与运行

**Linux / macOS / WSL：**

```bash
# 构建
./gradlew build

# 启动应用
./gradlew bootRun
$env:JAVA_HOME="C:\Users\Administrator\jdk-17"; .\gradlew.bat bootRun
```

**Windows：**

```cmd
gradlew.bat build
gradlew.bat bootRun
```

启动成功后访问：<http://localhost:8080>

根路径 `/` 会自动跳转到课程列表页 `/courses`。

### 5. 运行测试

```bash
./gradlew test
```

## 功能说明

- **课程列表**：分页展示，支持按学院、课程代码、课程名称、性质等条件搜索
- **新增课程**：填写开课学院、课程代码、课程名称、学分、性质、教学班、人数、授课/实验学时
- **编辑 / 删除**：单条编辑与删除
- **批量删除**：列表页勾选多条记录后批量删除

课程性质可选值：`必修`、`选修`、`公选`。

## 项目结构

```
web-app/
├── build.gradle                 # Gradle 构建配置
├── gradlew / gradlew.bat        # Gradle Wrapper 脚本
├── src/
│   ├── main/
│   │   ├── java/org/example/webapp/
│   │   │   ├── controller/      # Web 控制器
│   │   │   ├── service/         # 业务逻辑
│   │   │   ├── repository/      # 数据访问
│   │   │   ├── entity/          # JPA 实体
│   │   │   └── dto/             # 查询条件等 DTO
│   │   └── resources/
│   │       ├── application.properties
│   │       ├── static/css/      # 静态样式
│   │       └── templates/       # Thymeleaf 模板
│   └── test/                    # 单元测试
└── README.md
```

## 常用命令

| 命令 | 说明 |
|------|------|
| `./gradlew bootRun` | 以开发模式启动应用 |
| `./gradlew build` | 编译并打包 |
| `./gradlew test` | 运行测试 |
| `./gradlew bootJar` | 生成可执行 JAR（位于 `build/libs/`） |

打包后运行：

```bash
java -jar build/libs/web-app-0.0.1-SNAPSHOT.jar
```

## 开发说明

- 默认端口：`8080`（可在 `application.properties` 中修改 `server.port`）
- 开发模式下 Thymeleaf 模板缓存已关闭，修改页面后刷新即可生效
- 已集成 Spring Boot DevTools，代码变更后可自动重启（IDE 需开启自动编译）

## 参考文档

- [Spring Boot 官方文档](https://docs.spring.io/spring-boot/4.1.0/reference/)
- [Spring Boot Gradle 插件](https://docs.spring.io/spring-boot/4.1.0/gradle-plugin)
- 项目内 `HELP.md` 含更多 Spring 官方指南链接