操作步驟

1. 登錄AHAS控制臺。
2. 在AHAS控制臺左上角，選擇應(yīng)用接入的地域。
3. 在控制臺左側(cè)導(dǎo)航欄中選擇流量防護(hù) > 應(yīng)用防護(hù)。

4. 在應(yīng)用防護(hù)頁面右上角單擊新應(yīng)用接入，然后在JAVA語言頁簽，單擊SDK接入，然后單擊Spring應(yīng)用接入。

5. 通過以下任意一種方式，為應(yīng)用添加依賴。

   • 方式一：在Pom文件中添加依賴。

     <dependency>
       <groupId>com.alibaba.csp</groupId>
       <artifactId>ahas-sentinel-client</artifactId>
       <version>x.y.x</version>
     </dependency>

     在Spring應(yīng)用接入頁面第一步：添加Pom依賴中查看Pom依賴最新版本，將x.y.z替換為新版本的版本號。

     

   • 方式二：添加JAR包依賴。

     在Spring應(yīng)用接入頁面單擊請點(diǎn)擊此鏈接下載下載壓縮包，并將壓縮包中的所有JAR包解壓后放置在classpath目錄下。

6. 在應(yīng)用工程中添加埋點(diǎn)。

   • 添加HTTP埋點(diǎn)。

     @Configuration
     public class SentinelWebConfig implements WebMvcConfigurer {
     @Override
     public void addInterceptors(InterceptorRegistry registry) {
     registry.addInterceptor(new SentinelWebInterceptor());
     }
     }

   • 普通接口埋點(diǎn)。

     1. 將SentinelResourceAspect注冊為一個(gè)Spring Bean。

        @Configuration
        public class SentinelAspectConfiguration {
          @Bean
          public SentinelResourceAspect sentinelResourceAspect() {
            return new SentinelResourceAspect();
          }
        }

     2. 在業(yè)務(wù)方法上添加@SentinelResource注解。

        // 原本的業(yè)務(wù)方法
        @SentinelResource(value = "getUserById")
        public User getUserById(String id) {
          return new User(id);
        }

7. 通過以下任意一種方式，配置應(yīng)用的啟動(dòng)參數(shù)。

   類別	參數(shù)示例
   非公網(wǎng)	-Dproject.name=AppName -Dahas.namespace=default -Dahas.regionId=<RegionId> 說明 將AppName替換為自定義的應(yīng)用名稱。 將<RegionId>替換應(yīng)用所在地域，地域與RegionId對應(yīng)表請參見下文地域與RegionId對應(yīng)表。
   公網(wǎng)	-Dproject.name=AppName -Dahas.license=<license> -Dahas.namespace=default -Dahas.regionId=cn-public 說明 將AppName替換為自定義的應(yīng)用名稱，將<license>替換為真實(shí)值。

   若在公網(wǎng)地域，需要查看License信息。請?jiān)?b data-tag="uicontrol" id="wintitle-rxn-ff1-e4b" class="uicontrol">第三步：配置啟動(dòng)參數(shù)區(qū)域查看（非公網(wǎng)地域不需要），具體請參見查看License。

   

8. 重啟應(yīng)用。

9. 可選：使用注解方式配置應(yīng)用觸發(fā)限流、降級或系統(tǒng)保護(hù)規(guī)則時(shí)的處理邏輯。 請參見注解方式。

   說明

   若未執(zhí)行此步驟，當(dāng)應(yīng)用觸發(fā)流控降級規(guī)則時(shí)，默認(rèn)拋出BlockException異常類的子類（觸發(fā)流控規(guī)則，則拋出流控異常FlowException；觸發(fā)降級規(guī)則，則拋出降級異常DegradeException）。

結(jié)果驗(yàn)證

登錄AHAS控制臺，在左側(cè)導(dǎo)航欄選擇流量防護(hù) > 應(yīng)用防護(hù)，若在應(yīng)用防護(hù)頁面出現(xiàn)該應(yīng)用的資源卡片且有數(shù)據(jù)上報(bào)，則說明接入成功。

地域與RegionId對應(yīng)表