apache/causeway-app-demo-jdo

Apache Causeway App demojdo 镜像文档

1. 镜像概述

Apache Causeway App demojdo 是一个基于 Apache Causeway 框架构建的演示应用镜像，展示了如何使用 JDO (Java Data Objects) 作为持久化层实现领域驱动设计(DDD)的业务应用。该镜像包含了完整的示例应用，可用于学习和评估 Apache Causeway 框架的功能特性。

2. 核心功能和特性

• 完整的 Apache Causeway 应用示例，包含领域模型、服务和用户界面
• 使用 JDO 实现对象持久化，支持标准的 CRUD 操作
• 内置 H2 内存数据库，无需额外数据库配置即可运行
• 提供基于 Bootstrap 的现代 Web 用户界面
• 包含示例业务逻辑和领域规则验证
• 支持 REST API 访问应用数据
• 内置安全认证机制

3. 使用场景和适用范围

• Apache Causeway 框架学习和技术评估
• 领域驱动设计(DDD)实践参考
• JDO 持久化技术演示
• 快速原型开发和概念验证
• 企业应用架构设计参考
• 开发团队技术培训环境

4. 使用方法和配置说明

4.1 基本使用方法

使用以下命令即可快速启动 demojdo 应用：

bash
docker run -p 8080:8080 apache/causeway-app-demojdo:latest

应用启动后，访问 http://localhost:8080 即可打开应用界面，默认管理员账号：sven，密码：pass。

4.2 Docker Compose 配置

创建 docker-compose.yml 文件：

yaml
version: '3.8'
services:
  causeway-demojdo:
    image: apache/causeway-app-demojdo:latest
    container_name: causeway-demojdo
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=dev
      - DATABASE_URL=jdbc:h2:mem:demojdo;DB_CLOSE_DELAY=-1
      - DATABASE_USER=sa
      - DATABASE_PASSWORD=
    volumes:
      - causeway-data:/app/data
    restart: unless-stopped

volumes:
  causeway-data:

启动服务：

bash
docker-compose up -d

4.3 环境变量配置

4.4 持久化数据配置

默认情况下，应用使用内存数据库，数据在容器重启后会丢失。如需持久化数据，可修改数据库连接 URL 并挂载数据卷：

bash
docker run -p 8080:8080 \
  -e DATABASE_URL=jdbc:h2:/data/demojdo;DB_CLOSE_DELAY=-1 \
  -v causeway-data:/data \
  apache/causeway-app-demojdo:latest

5. 访问应用

5.1 Web 用户界面

应用启动后，通过浏览器访问：http://<容器IP或主机名>:8080

使用默认账号登录：

• 用户名：sven
• 密码：pass

5.2 REST API 访问

应用提供 REST API 接口，可通过以下 URL 访问：

• API 根地址：http://<容器IP或主机名>:8080/restful/objects
• API 文档：http://<容器IP或主机名>:8080/restful/swagger-ui.html

使用 Basic Authentication 进行 API 认证。

6. 自定义配置

如需自定义应用配置，可通过挂载外部配置文件实现：

bash
docker run -p 8080:8080 \
  -v ./application.properties:/app/config/application.properties \
  apache/causeway-app-demojdo:latest

自定义配置文件可修改应用端口、数据库连接、安全设置等参数。

7. 故障排除

7.1 应用无法启动

• 检查端口是否被占用，可通过 -p 参数映射到不同端口
• 查看容器日志获取详细错误信息：docker logs <容器ID>
• 确保使用最新版本的镜像：docker pull apache/causeway-app-demojdo:latest

7.2 数据库连接问题

• 如使用外部数据库，确保数据库服务可访问
• 检查数据库连接参数是否正确
• 内存不足时可能导致数据库启动失败，可尝试增加容器内存限制

8. 相关资源

• Apache Causeway 官方网站
• Apache Causeway 文档
• JDO 规范
• https://github.com/apache/causeway