# collaborative

**Repository Path**: feicuang/collaborative

## Basic Information

- **Project Name**: collaborative
- **Description**: 合作项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-22
- **Last Updated**: 2025-10-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Collaborative Spring Boot Project

这是一个使用Spring Boot 3.x、JDK 17、Maven和MySQL构建的协作项目。

## 技术栈

- **Java**: JDK 17
- **Spring Boot**: 3.2.0
- **Maven**: 构建工具
- **MySQL**: 数据库
- **Spring Data JPA**: 数据访问层
- **Lombok**: 减少样板代码
- **Spring Boot DevTools**: 开发工具

## 项目结构

```
src/
├── main/
│   ├── java/
│   │   └── com/example/collaborative/
│   │       ├── CollaborativeApplication.java
│   │       ├── controller/
│   │       │   └── UserController.java
│   │       ├── entity/
│   │       │   └── User.java
│   │       ├── repository/
│   │       │   └── UserRepository.java
│   │       └── service/
│   │           └── UserService.java
│   └── resources/
│       └── application.yml
└── test/
    └── java/
        └── com/example/collaborative/
            └── CollaborativeApplicationTests.java
```

## 环境要求

- JDK 17 或更高版本
- Maven 3.6 或更高版本
- MySQL 8.0 或更高版本

## 数据库配置

1. 创建MySQL数据库：
```sql
CREATE DATABASE collaborative CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

2. 修改 `src/main/resources/application.yml` 中的数据库连接信息：
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/collaborative?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
    username: your_username
    password: your_password
```

## 运行项目

1. 克隆项目到本地
2. 确保MySQL服务已启动并创建数据库
3. 修改数据库连接配置
4. 运行以下命令：

```bash
# 编译项目
mvn clean compile

# 运行项目
mvn spring-boot:run
```

或者使用IDE直接运行 `CollaborativeApplication.java` 的main方法。

## API接口

项目启动后，可以通过以下接口访问：

- **获取所有用户**: `GET http://localhost:8080/api/users`
- **根据ID获取用户**: `GET http://localhost:8080/api/users/{id}`
- **根据用户名获取用户**: `GET http://localhost:8080/api/users/username/{username}`
- **创建用户**: `POST http://localhost:8080/api/users`
- **更新用户**: `PUT http://localhost:8080/api/users/{id}`
- **删除用户**: `DELETE http://localhost:8080/api/users/{id}`

### 创建用户示例

```bash
curl -X POST http://localhost:8080/api/users \
  -H "Content-Type: application/json" \
  -d '{
    "username": "testuser",
    "email": "test@example.com",
    "password": "password123",
    "fullName": "Test User"
  }'
```

## 开发说明

- 项目使用JPA自动创建数据库表结构
- 实体类使用Lombok注解减少样板代码
- 控制器支持跨域请求
- 包含基本的异常处理
- 使用Spring Boot DevTools支持热重载

## 测试

运行测试：
```bash
mvn test
```

## 构建

构建可执行JAR文件：
```bash
mvn clean package
```

构建完成后，可以通过以下命令运行：
```bash
java -jar target/collaborative-1.0.0.jar
```