Apache Causeway 应用模板项目下载与安装教程

一、项目介绍

Apache Causeway 是一个用于快速开发领域驱动应用的 Java 框架。本教程将介绍如何下载并安装 Apache Causeway 的应用模板项目 —— causeway-app-petclinic。该项目是一个示例应用，旨在作为开发您自己的应用的起点。

二、项目下载位置

项目存储在 GitHub 上，您可以访问以下位置找到项目：

https://github.com/apache/causeway-app-petclinic.git

三、项目安装环境配置

在开始安装之前，请确保您的开发环境已经配置以下要求：

1. Java 11 LTS（例如 Adopt OpenJDK 发行版）
2. Maven 3.6 或更高版本

以下是环境配置的示例图片：

Maven 安装验证

mvn -version

Java 版本验证

java -version

四、项目安装方式

1. 下载项目代码：

   使用 git 命令克隆项目到本地：

   git clone https://github.com/apache/causeway-app-petclinic.git
   

2. 构建项目：

   进入项目目录，使用 Maven 命令构建项目：

   cd causeway-app-petclinic
   mvn clean install
   

3. 下载 Spring Instrument JAR 文件：

   根据项目 pom.xml 中指定的版本，下载 Spring Instrument JAR 文件：

   mvn dependency:get -DgroupId=org.springframework -DartifactId=spring-instrument -Dversion=XXX
   

   将 XXX 替换为 pom.xml 中对应的版本号。

4. 运行项目：

   使用 Maven 命令运行项目：

   mvn -pl webapp spring-boot:run
   

   项目启动后，您可以在浏览器中访问 http://localhost:8080，使用以下任一用户登录：

   • 超级用户：用户名 secman-admin，密码 pass
   • 普通用户：用户名 sven，密码 pass

五、项目处理脚本

项目中的处理脚本包括用于运行单元测试和集成测试的 Maven 目标。以下是一些常用的 Maven 命令：

• 运行单元测试：

  mvn test
  

• 运行集成测试：

  mvn integration-test
  

• 跳过单元测试：

  mvn install -DskipUTs
  

• 跳过集成测试：

  mvn install -DskipITs
  

以上步骤完成后，您就可以开始使用 Apache Causeway 的应用模板项目进行开发了。