mustangxu/playground 镜像文档

镜像概述

简介

mustangxu/playground 是一个Java编码实践环境，集成了多种Java技术栈和框架的演示示例。该镜像基于Spring Boot构建，提供了丰富的功能模块和技术展示，适合开发者学***和测试各种Java相关技术。

主要用途

• Java新技术特性验证与学***
• 各类Java框架和库的集成演示
• 微服务架构模式实践
• 性能测试与优化实验
• 开发工具链与CI/CD流程示例

核心功能与特性

基础环境

• JDK 21 / 22 / 23 支持
• Spring Boot 3.5.x 框架

JDK新特性演示

• 原生内存访问
• 向量计算
• Record类型
• 虚拟线程
• 未命名变量
• 作用域值(Scoped Value)
• 字符串模板(开发中)

数据访问与处理

• EclipseLink JPA实现
• Sharding Sphere分库分表
• EasyExcel数据导入导出
• 嵌入式数据库支持
• MySQL数据源配置

Web与API开发

• OpenAPI规范与Swagger UI
• WebSocket与SockJS集成(当类路径中存在jakarta.websocket.WebSocketContainer时启用)
• OpenFeign声明式HTTP客户端
• HTTP/2支持
• HTTP/3支持(在http3项目中通过设置http3.enabled=true启用)

服务集成

• Spring Cloud OpenFeign
• 基于JMDNS的服务发现
• SkyWalking分布式追踪与日志
• ()RPC客户端
• Wolfram Alpha API客户端
• Spring Boot Admin客户端(可配合mustangxu/spring-boot-admin-server使用)

任务调度与异步处理

• Quartz任务调度框架
• 虚拟线程应用示例

安全与配置

• Jasypt加密集成(使用jasypt-spring-aws-kms-starter)
• 环境配置与 profiles 管理

性能与测试

• JMH性能测试框架
• 各类性能优化示例

云原生与微服务

• AWS Lambda函数演示
• 服务注册与发现
• 分布式追踪

AI与数据处理

• Spring AI集成
• DeepSeek模型支持
• Milvus向量数据库(Zilliz)集成
• MCP服务/客户端与天气服务(位于mcp项目中)

使用场景与适用范围

适用场景

• Java开发者学***新技术特性
• 框架集成测试与验证
• 快速原型开发
• 技术选型评估
• 培训与教学环境

适用人群

• Java后端开发者
• Spring Boot学***者
• 微服务架构设计者
• 技术探索与研究人员

使用方法与配置说明

环境要求

• JDK 21+
• Maven 3.6+
• Docker 20.10+
• 网络连接(部分功能需要外部服务支持)

快速启动

直接运行

shell
cd java-playground
# 使用MySQL数据源
mvn spring-boot:run -DskipTests

# 或使用嵌入式内存数据库
mvn spring-boot:run -DskipTests -Dspring-boot.run.profiles=embedded

MCP服务启动

shell
# 运行MCP服务/客户端与天气服务
cd java-playground/mcp
mvn spring-boot:run -DskipTests

Docker部署

构建镜像

shell
cd java-playground
mvn clean package docker:build -DskipTests

Docker Run 命令

shell
# 使用默认配置运行
docker run -d -p 8080:8080 --name java-playground mustangxu/playground

# 指定配置文件运行
docker run -d -p 8080:8080 -v /path/to/application.properties:/app/application.properties --name java-playground mustangxu/playground

# 使用环境变量运行
docker run -d -p 8080:8080 -e SPRING_PROFILES_ACTIVE=embedded --name java-playground mustangxu/playground

Docker Compose 配置

yaml
version: '3.8'
services:
  playground:
    image: mustangxu/playground
    container_name: java-playground
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=embedded
      - LOG_LEVEL=INFO
    volumes:
      - playground-data:/app/data
    restart: unless-stopped

volumes:
  playground-data:

配置选项

主要配置参数

• spring.profiles.active: 指定激活的配置文件，默认为空，可选值为embedded
• http3.enabled: 启用HTTP/3支持，仅在http3项目中有效
• spring.datasource.*: 数据源相关配置
• logging.level.*: 日志级别配置

环境变量

• SPRING_PROFILES_ACTIVE: 等同于spring.profiles.active配置
• JASYPT_EN***R_PASSWORD: Jasypt加密密码
• SKYWALKING_OPTS: SkyWalking相关配置

访问应用

应用启动后，可通过以下地址访问:

• 应用首页: http://localhost:8080
• Swagger UI: http://localhost:8080/swagger-ui.html

相关项目

• Spring Boot Admin Server: mustangxu/spring-boot-admin-server
• Jasypt Spring AWS KMS Starter: github.com/mustangxu/jasypt-spring-aws-kms-starter