springcommunity/spring-framework-petclinic

Spring Framework PetClinic 镜像文档

镜像概述

Spring Framework PetClinic 是一个基于Spring Framework的经典示例应用，集成了JSP、Spring MVC、Spring Data JPA、Hibernate和JDBC等核心技术组件。该应用旨在展示Spring生态系统的核心功能及各组件间的协作方式，是学习和实践Spring Framework的理想参考案例。

核心功能与特性

• 技术栈整合：采用Spring MVC作为Web层框架，Spring Data JPA与Hibernate实现数据访问层，JDBC提供数据库连接支持
• Web界面：使用JSP作为视图技术，提供直观的用户交互界面，包含宠物管理、主人信息、兽医预约等功能模块
• 数据管理：支持宠物、主人、兽医等实体的完整CRUD操作，展示数据持久化最佳实践
• 嵌入式数据库：默认集成H2嵌入式数据库，无需额外配置即可快速启动和测试
• 分层架构：遵循MVC设计模式，清晰分离控制层、服务层和数据访问层，体现企业级应用架构设计

使用场景与适用范围

• Spring学习实践：帮助开发者理解Spring Framework核心组件（MVC、Data JPA等）的使用方法
• 技术演示：作为Spring生态系统功能展示的标准示例，适合技术分享和培训
• 架构参考：提供Spring MVC+JPA经典架构的实施范例，可作为同类项目的开发模板
• 教学案例：适用于Java Web开发课程中的实战教学，展示企业级应用开发流程

使用方法与配置说明

前提条件

• 已安装Docker Engine（推荐版本19.03及以上）
• 具备基本的Docker命令操作能力

获取镜像

方式1：通过源码构建

1. 克隆项目仓库：

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

2. 使用Maven构建应用：

bash
./mvnw package -DskipTests

3. 创建Dockerfile（项目根目录）：

dockerfile
FROM docker.xuanyuan.run/tomcat:9-jdk11-openjdk-slim
COPY target/*.war /usr/local/tomcat/webapps/ROOT.war
EXPOSE 8080
CMD ["catalina.sh", "run"]

4. 构建Docker镜像：

bash
docker build -t spring-framework-petclinic:latest .

运行容器

基础运行命令

bash
docker run -d -p 8080:8080 --name petclinic-app docker.xuanyuan.run/spring-framework-petclinic:latest

自定义数据库配置

如需连接外部数据库（如MySQL），可通过环境变量配置：

bash
docker run -d -p 8080:8080 \
  -e SPRING_DATASOURCE_URL=jdbc:mysql://mysql-host:3306/petclinic \
  -e SPRING_DATASOURCE_USERNAME=dbuser \
  -e SPRING_DATASOURCE_PASSWORD=dbpass \
  -e SPRING_DATASOURCE_DRIVER_CLASS_NAME=com.mysql.cj.jdbc.Driver \
  --name petclinic-app docker.xuanyuan.run/spring-framework-petclinic:latest

访问应用

容器启动后，通过浏览器访问：http://localhost:8080

配置参数说明