全部产品
云市场

创建 SOFABoot 工程

更新时间:2020-02-13 17:42:18

重要:
  • 目前脚手架仅支持创建 SOFABoot 2.3.4 工程。
  • 要体验 SOFAStack 中间件产品,您需要创建 SOFABoot 3.x.x 工程。
  • 因此,建议您参考 SOFABoot 快速入门SOFABoot 版本说明 完成 SOFABoot 3.x.x 工程的创建与配置。

系统要求

更多详情参见 配置 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

maven

编译运行本地工程

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

  • 在本地 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 应用