# SpringDemo3

**Repository Path**: zwg/spring-demo3

## Basic Information

- **Project Name**: SpringDemo3
- **Description**: SpringDemo3 是一个基于 Spring Boot 3 的多模块示例项目，集成了多种技术栈和功能演示，包括 AI 集成、Docker 部署、嵌入式数据库引擎、股票数据处理等功能。该项目旨在提供各种 Spring Boot 应用场景的最佳实践和示例代码。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-17
- **Last Updated**: 2025-11-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: SpringBoot, SpringAI

## README

# SpringDemo3

#### 介绍
SpringDemo3 是一个基于 Spring Boot 3.4.2 的多模块示例项目，集成了多种技术栈和功能演示，包括 AI 集成、Docker 部署、嵌入式数据库引擎、股票数据处理等功能。该项目旨在提供各种 Spring Boot 应用场景的最佳实践和示例代码。

#### 软件架构
项目采用 Maven 多模块架构，主要包含以下模块：

```
spring-demo3/
├── demo-ai/                  # AI 相关功能模块
│   ├── demo-springai-openai     # OpenAI 集成示例
│   ├── demo-springai-deepseek   # DeepSeek 模型集成示例
│   ├── demo-springai-all        # 多 AI 模型集成示例
│   ├── demo-springai-mcp-webserver # MCP 服务器示例
│   └── demo-springai-mcp-webclient # MCP 客户端示例
├── demo-docker/              # Docker 部署相关模块
│   └── demo-docker-console      # Docker 控制台应用示例
├── demo-embed/               # 嵌入式技术模块
│   └── demo-embed-calcite       # Apache Calcite 嵌入式 SQL 引擎示例
├── demo-stock/               # 股票数据处理模块
└── demo-scanner/             # 扫描相关功能模块
    └── demo-scanner-zxing       # ZXing 条形码/二维码扫描示例
```

#### 技术栈
- Spring Boot 3.4.2
- Java 17
- Spring AI
- Apache Calcite
- Docker
- OpenAPI 3.0 (SpringDoc + Knife4j)
- Lombok

#### 安装教程

1. 确保环境中已安装 JDK 17 或更高版本
2. 确保已安装 Maven 3.6+ 和 Git
3. 克隆代码仓库：
   ```bash
   git clone <仓库地址>
   cd spring-demo3
   ```
4. 构建项目：
   ```bash
   mvn clean install
   ```

#### 模块说明

1. **demo-ai**：演示 Spring AI 与各种大语言模型的集成，包括 OpenAI、DeepSeek 等，提供了 Web 服务接口。

2. **demo-docker**：演示 Spring Boot 应用的 Docker 容器化部署，包含 Dockerfile 和 Docker Compose 配置示例。

3. **demo-embed**：演示嵌入式技术应用，特别是 Apache Calcite 嵌入式 SQL 引擎的使用，支持在内存中进行 SQL 查询。

4. **demo-stock**：演示股票数据的获取、处理和分析功能，集成 HTTP 客户端进行数据抓取。

5. **demo-scanner**：演示使用 ZXing 库进行条形码和二维码的生成与识别。

#### 使用说明

1. **运行特定模块**：
   ```bash
   cd <模块路径>
   mvn spring-boot:run
   ```

2. **API 文档访问**：
   启动模块后，可以通过以下地址访问 Swagger UI 文档：
   ```
   http://localhost:8080/swagger-ui.html
   ```
   或者 Knife4j 增强文档：
   ```
   http://localhost:8080/doc.html
   ```

#### 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

#### 许可证

#### 联系方式