全部产品
云市场

系统要求

更新时间:2019-12-24 15:55:17

SOFABoot 基于 Spring Boot 框架开发,并依赖 Apache Maven 进行构建。SOFABoot 和 Spring Boot 版本对应关系,以及 JDK 版本要求如下:

SOFABoot 版本 Spring Boot 版本 JDK 版本
3.x 2.0.3.RELEASE JDK 8+

在开始进行 SOFABoot 开发前,确认您已经完成必要环境的安装和配置:

  1. 安装 JDK
  2. 安装 Apache Maven 3.2.5 或更高版本
  3. 配置蚂蚁金服金融科技 Maven 仓库地址

在 SOFAStack 平台上发布 SOFABoot 应用时的系统要求,参见 云服务器框架共存

SOFABoot 内嵌 Servlet 容器版本详情,参见 Servlet 容器

安装 Java

安装步骤:

  1. 前往 Oracle 官网下载与您的操作系统相符的 Java SE 安装包
  2. 安装 JDK。详情参考 Oracle 官方文档 > 如何安装 JDKInstallation Guide(英文)
  3. 配置系统环境变量。 详情参考 Oracle 官方文档 变量 PATH 和 CLASSPATH 介绍与配置(英文)

    • Windows 系统:
      • JAVA_HOME:配置为 JDK 的安装路径,如 C:\Program Files\Java\jdk1.8.0_181
      • PATH:增加 %JAVA_HOME%\bin 文件夹路径。多个路径间使用英文分号(;)分隔。
    • MacOS 及 Linux 系统:示例如下。如果使用 binary 安装包 (dmg 或 RPM),您可能无需手动配置环境变量。可直接跳至下一步检查 Java 是否可用。

      1. export JAVA_HOME=/${path_to_jdk_dir}/jdk1.8.0_181
      2. export PATH=/${path_to_jdk_dir}/jdk1.8.0_181/bin:$PATH
  4. 检查 Java 是否安装成功:
    1. $ java -version

安装 Apache Maven

SOFABoot 工程的构建依赖 Apache Maven。安装步骤如下:

  1. 前往 Apache Maven 官网 下载安装包
  2. 解压安装包文件至安装目录:
    1. $ unzip apache-maven-3.6.1-bin.zip
    1. $ tar xzvf apache-maven-3.6.1-bin.tar.gz
  3. 配置环境变量:
    • Windows 系统
      • M2_HOME:配置为 Maven 的安装路径。
      • PATH:增加 %M2_HOME%\bin 路径。多个路径间使用英文分号(;)分隔。
    • MacOS 及 Linux 系统: 示例如下。
      1. export M2_HOME=/${path_to_maven_dir}/apache-maven-3.6.1
      2. export PATH=/${path_to_maven_dir}/apache-maven-3.6.1/bin:$PATH
  4. 在新的 shell 终端中检查 Maven 是否安装成功:
    1. $ mvn -v

更多信息,请参考 Apache Maven 官方文档

修改 Maven 本地配置文件

修改步骤

SOFABoot 的 JAR 包并未上传到 Maven 的中央仓库。为便于在构建工程时能够正常下载所依赖的 JAR 包,您需要:

  1. 找到本地 Maven 路径下的 settings.xml 文件。在不同操作系统中,您可参考下述路径,进行查找。

    • Windows 系统:${maven 在本机的安装路径}\conf\settings.xml
    • Linux or MacOs: ${maven 在本机的安装路径}/conf/settings.xml
  2. 在脚手架中,下载 Maven 的 settings.xml 文件,覆盖步骤 1 找到的settings.xml 文件。

配置说明

完成上述步骤 2 的覆盖操作后,settings.xml 中已经配置好的信息主要包括 server 标签,mirror 标签,以及 profile 标签。

  • server 标签:username 和 password 会通过脚手架自动实现配置,主要用于和服务器连接时的信息校验,示例如下:
    1. <server>
    2. <id>nexus-server@public</id>
    3. <username>${username}</username>
    4. <password>${password}</password>
    5. </server>
  • mirror 标签:用来从镜像仓库中,快速下载所需要的 JAR 包。
  • profile 标签:用来配置一些全局信息及其激活条件,主要包括一些仓库标签和插件仓库标签。

Servlet 容器

SOFABoot 内嵌以下容器,开箱即用:

容器名称 Servlet 版本 Java 版本
Tomcat 8 3.1 Java 7+
Tomcat 7 3.0 Java 6+
Jetty 9.3 3.1 Java 8+
Jetty 9.2 3.1 Java 7+
Jetty 8 3.0 Java 6+
Undertow 1.3 3.1 Java 7+

云服务器

如果要将应用发布至 SOFAStack 平台,必须在资源管理中创建云服务器实例。购买该资源时只能选择 CentOS 6.5CentOS 7.2 的实例镜像。

框架共存

在同一租户内,支持基于 SOFABoot 或 SOFALite 的应用共存,各应用之间可以互相调用,但需要添加额外的配置。具体操作可 提交工单 咨询技术支持。