jbrisbin/spring-petclinic

Spring PetClinic 示例应用（Docker化版本）

镜像概述和主要用途

Spring PetClinic是一个基于Spring Boot和Thymeleaf构建的示例应用，Docker化版本便于快速部署和运行。该应用模拟宠物诊所管理系统，可管理宠物、主人、兽医信息及诊疗记录，主要用于展示Spring生态系统的实际应用，适合开发者学习Spring Boot、数据库配置和Docker容器化部署等技术。

核心功能和特性

• 基于Spring Boot框架，简化应用配置与部署流程
• 使用Thymeleaf模板引擎渲染Web界面，提供直观的用户交互
• 默认集成HSQLDB内存数据库，启动时自动填充测试数据
• 支持MySQL等持久化数据库配置，满足数据持久化需求
• 提供完整的宠物诊所业务功能，包括宠物管理、主人信息维护、兽医列表和诊疗记录管理
• 可通过Docker快速搭建数据库环境，简化开发和测试流程

使用场景和适用范围

• Spring Boot初学者的实践学习案例
• Docker容器化应用部署的示范示例
• 内存数据库与持久化数据库配置对比学习
• Spring生态系统（Spring Data、Bean Validation等）集成应用参考
• Web应用开发的基础模板和架构参考

详细使用方法和配置说明

本地运行（非Docker方式）

1. 克隆代码仓库：

bash
git clone https://github.com/spring-projects/spring-petclinic.git
cd spring-petclinic

2. 启动应用：

bash
./mvnw spring-boot:run

3. 访问应用：http://localhost:8080/

数据库配置

默认配置（内存数据库）

应用默认使用HSQLDB内存数据库，无需额外配置，启动时自动初始化测试数据，适合快速演示和开发。

持久化数据库配置（MySQL）

如需使用MySQL作为持久化数据库，需进行以下配置：

1. 使用Docker启动MySQL容器：

bash
docker run -e MYSQL_ROOT_PASSWORD=petclinic -e MYSQL_DATABASE=petclinic -p 3306:3306 mysql:5.7.8

2. 修改应用配置：
   • 更新data-access.properties文件，调整数据库连接参数
   • 在pom.xml中取消注释mysql-connector-java依赖项

在Eclipse/STS中使用

前置条件

• Maven 3（安装指南：[***]
• Git命令行工具（设置指南：https://help.github.com/articles/set-up-git%EF%BC%89
• Eclipse（推荐使用STS版本，内置m2e插件；如无m2e插件，可从[***]

操作步骤

1. 命令行克隆代码仓库：

bash
git clone https://github.com/spring-projects/spring-petclinic.git

2. 在Eclipse中导入项目：

File -> Import -> Maven -> Existing Maven project

特定配置与类文件查找

相关分支与Forks

Spring Petclinic主分支基于Spring Boot和Thymeleaf，以下是使用不同技术栈的分支和Forks：

与其他开源项目的交互

Spring Petclinic在开发过程中与多个开源项目有直接交互，曾发现并推动修复了以下问题：

贡献方式

优先通过https://github.com/spring-projects/spring-petclinic/issues%E6%8F%90%E4%BA%A4bug%E6%8A%A5%E5%91%8A%E3%80%81%E5%8A%9F%E8%83%BD%E8%AF%B7%E6%B1%82%E5%92%8C%E6%8B%89%E5%8F%96%E8%AF%B7%E6%B1%82%E3%80%82%E6%8F%90%E4%BA%A4%E6%8B%89%E5%8F%96%E8%AF%B7%E6%B1%82%E6%97%B6%EF%BC%8C%E5%8F%AF%E5%8F%82%E8%80%83editor config的编辑器偏好设置。首次贡献需填写并提交Contributor License Agreement。

许可证

Spring PetClinic示例应用基于Apache License 2.0发布。