创建 SOFABoot 工程

系统要求

• Java：Java 8（建议）或 Java 7
• Maven：Apache Maven 3.2.5 或更高版本

更多详情参见 配置 SOFABoot 运行环境。

创建 SOFABoot 工程

1. 在脚手架控制台页面的顶部下拉列表中，选择创建一个 SOFABoot 工程。

2. 选择您要创建的工程的环境配置：

   • Java 版本：Java 1.8（默认）或 Java 1.7
   • SOFABoot 版本：2.3.4（默认）或 2.4.0
   • 工程类型：Web（默认）或 Core

3. 输入应用基本信息，以下所有项目均为必填：

   • 应用名称：应用在工作空间中的唯一标识，对应 application.properties 中的 spring.application.name 键。应用名称在工作空间内必须保持唯一性。
   • Group Id：项目组织的唯一标识，如 com.alipay.sofa。
   • Artifact Id：项目的唯一标识，如 web-app。
   • 实例标识：应用实例在工作空间中的唯一标识，对应 application.properties 中的 com.alipay.instanceid 键。
   • AntVIP：应用通过 AntVIP 指来获取各个组件的服务端地址。每个区域一个地址，对应 application.properties 中的 com.antcloud.antvip.endpoint 键。
   • Access Key ID / Secret：访问中间件的身份验证密钥，详情参见 管理访问控制密钥。

4. 选择要引入的 SOFA 中间件依赖：勾选需要的 SOFA 中间件组件以添加相应的中间件组件 starter，相关配置信息会被自动加入工程的 pom.xml 文件。更多 SOFA 中间件的依赖信息，请参见 引入 SOFA 中间件 > 各中间件服务 starter。

5. 点击 下载工程 并将生成的 SOFABoot 工程 .zip 文件保存至本地。

   

导入 IDE 工具

SOFABoot 工程是标准的 Maven 工程。您可以使用经典的 Java 开发工具（如 IntelliJ IDEA 、Eclipse 等）对其进行开发。

1. 将刚刚下载的 SOFABoot 工程原型导入 IDE。详细导入步骤，参见 SOFABoot 快速开始 > 导入 IDE。

2. 在脚手架 Step 3，下载已配置好的仓库地址及用户名密码 Maven 配置文件，并更新本地 Maven 的 settiing.xml。

编译运行本地工程

工程导入完成后，您可以通过以下任一方式编译并运行本地工程：

• 在本地 IDE 中运行 web 模块下的 main 函数。

• 通过工程内置的 Spring Boot Maven 插件运行：

  • 对于 web 工程，在 web/ 目录下执行 Maven 命令：mvn spring-boot:run。
  • 对于 core 工程，在 service/ 目录下执行 Maven 命令：mvn spring-boot:run。

• 将工程打包为 .jar 文件并通过 java -jar 命令运行。

  1. 执行 Maven 命令 mvn clean install，在工程的 target/ 目录下生成 \${xxx}-executable.jar 文件。
  2. 在工程的 target/ 目录下执行 Java 命令：java -jar ${xxx}-executable.jar。

更多详情参见 本地编译运行 SOFABoot 工程。

如需将应用部署至 SOFAStack，参见 发布 SOFABoot 应用。