編譯運行 Web 工程

下載示例 Demo

請單擊下載示例工程：websofademo.7z。

本地 IDE 運行

主要操作步驟如下：

1. 開啟 IDE 的依賴自動導入功能，或者在工程根目錄下執行 mvn clean install 命令，完成相應依賴的下載。

2. 運行 web 模塊下的 main 函數，即可啟動 SOFABoot Web 工程。

mvn spring-boot:run 方式運行

主要操作步驟如下：

1. 通過 cd 命令，進入工程根目錄，示例如下：

   C:\Users\user_Name\SOFABootWebProject

2. 執行 mvn clean install 命令，完成相應依賴的下載。

3. 通過 cd 命令，進入 web 模塊所在根目錄，示例如下：

   C:\Users\user_Name\SOFABootWebProject\app\web

4. 執行 mvn spring-boot:run 命令。

SOFABoot Web 工程的 main 函數默認在 web 模塊中，且默認在 web 模塊中配置了 Spring Boot 的 Maven 插件，所以需要切換至 web 模塊所在的目錄并執行上述第 4 條命令以編譯、運行該工程。

在上述命令執行過程中，默認的 spring-boot-maven-plugin 插件會對工程原型進行自動配置，如無特殊需求可以不用修改。

java -jar 方式運行

主要操作步驟如下：

1. 通過 cd 命令，進入工程根目錄，示例如下：

   C:\Users\user_Name\SOFABootWebProject

2. 執行 mvn package 或者 mvn clean install 命令，SOFABoot 工程會被打包為 {XXX}-executable.jar 文件，并存放于工程根目錄的 target 目錄中。

3. 通過 cd 命令，進入工程的 target 目錄。

4. 運行命令 java -jar XXX-executable.jar，編譯運行該工程。

如需在私有服務器（已安裝相應版本 JDK）上進行測試，可將上述第 2 步生成的 {XXX}-executable.jar 文件拷貝到服務器，然后使用 java -jar XXX-executable.jar 命令行執行該文件。

編譯結果驗證

通過以上任意一種方式運行工程后，您可以通過瀏覽器訪問以下任一地址來運行并驗證結果。

• http://localhost:8080

• http://localhost:8341/webapi/users/aliBaby

  
  說明

  URL 中的 aliBaby 部分，可自定義添加。

編譯運行 Core 工程

下載示例 Demo

請單擊下載示例工程：coresofademo.zip。

本地 IDE 運行

主要操作步驟如下：

1. 在工程根目錄下執行 mvn clean install 命令，完成相應依賴的下載。

2. 運行 service 模塊下的 main 函數，即可啟動 SOFABoot Core 工程。

mvn spring-boot:run 方式運行

主要操作步驟如下：

1. 通過 cd 命令，進入工程根目錄，示例如下：

   C:\Users\user_Name\SOFABootCoreProject

2. 執行 mvn clean install 命令，完成相應依賴的下載。

3. 通過 cd 命令，進入 service 模塊所在根目錄，示例如下：C:\Users\user_Name\SOFABootWebProject\SOFABootWebProject-service

4. 執行 mvn spring-boot:run 命令。

SOFABoot Web 工程的 main 函數默認在 service 模塊中，且默認在 service 模塊中配置了 Spring Boot 的 Maven 插件，所以需要切換至 service 模塊所在的目錄并執行上述第 4 條命令以編譯、運行該工程。

在上述命令執行過程中，默認的 spring-boot-maven-plugin 插件會對工程原型進行自動配置，如無特殊需求可以不用修改，具體配置可以參考 spring-boot-maven-plugin 使用說明。

java -jar 方式運行

主要操作步驟如下：

1. 通過 cd 命令，進入工程根目錄，示例如下：

   C:\Users\user_Name\SOFABootCoreProject

2. 執行 mvn package 或者 mvn clean install 命令，SOFABoot 工程會被打包為 {XXX}-executable.jar 文件，并存放于工程根目錄的 target 目錄中。

3. 通過 cd 命令，進入工程的 target 目錄。

4. 運行命令 java -jar XXX-executable.jar，編譯運行該工程。

如需在私有服務器（已安裝相應版本 JDK）上進行測試，可將上述第 2 步生成的 {XXX}-executable.jar 文件拷貝到服務器，然后使用 java -jar XXX-executable.jar 命令行執行該文件。

編譯結果驗證

SOFABoot Core 工程是沒有頁面的工程，因此無法在本地進行效果預覽。但可以通過訪問 http://localhost:8080/actuator/readiness 地址進行健康檢查。如果 status 為 UP，表示創建成功。

更多參考

測試完成后，您可以將工程部署至 SOFAStack 平臺運行，為更多的用戶提供應用服務。請參見 SOFABoot 云端發布。