快速入门

操作步骤

1. 本地工程开发。

   操作步骤请参见 本地实现 SOFARPC 服务。

2. 引入依赖和本地配置。

   • 引入依赖

     在 SOFABoot Web 工程 endpoint 模块下的 pom.xml 文件中，引入 DRM 和 guardian 依赖，示例如下：

     <dependency>
          <groupId>com.alipay.sofa</groupId>
          <artifactId>ddcs-enterprise-sofa-boot-starter</artifactId>
     </dependency>
     
     <dependency>
          <groupId>com.alipay.sofa</groupId>
          <artifactId>guardian-sofa-boot-starter</artifactId>
     </dependency>

     使用 rest-enterprise-sofa-boot-starter 和 rpc-enterprise-sofa-boot-starter

     时，都需要引入上述依赖。引入 rpc-enterprise-sofa-boot-starter 时，如果需要使用限流功能，还需要引入下述依赖，否则限流不起作用。

     <dependency>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-autoconfigure</artifactId>
     </dependency>
     <dependency>
          <groupId>com.alipay.sofa</groupId>
          <artifactId>tracer-enterprise-sofa-boot-starter</artifactId>
     </dependency>

     定义接口时还需要自定义一个异常和一个异常处理器，用于限流成功后抛出异常，并且把异常处理结果返回给前端。

   • 本地配置

     当您引入 guardian-sofa-boot-starter 依赖时，应用已经可以对 SOFARPC 接口和 Spring MVC 请求进行限流。如果您还需要对内部 Spring Bean 定义的方法进行限流，则需要在 Spring Bean 配置文件中添加配置 AOP 拦截器。示例如下：

     <!-- 引入 guardian 中定义的 bean。 -->
     <import resource="classpath:META-INF/spring/guardian-sofalite.xml"/>
     <!-- 配置 AOP 拦截器。 -->
     <bean class="org.springframework.aop.framework.autoproxy.BeanNameAutoProxyCreator">
         <property name="interceptorNames">
             <list>
                  <value>guardianExtendInterceptor</value>
             </list>
         </property>
         <property name="beanNames">
             <list>
                  <!-- 配置需要被拦截的 bean。 -->
                  <value>*DAO</value>
             </list>
         </property>
         <!-- 如要使用 CGLIB 代理，取消下面这行的注释。 -->
         <!-- <property name="optimize" value="true" /> -->
     </bean>

3. 云端发布。

   请参考下述信息，完成应用的云端发布：

   • 应用整体的发布流程，请参见 技术栈与应用发布流程。

   • 应用的详细发布步骤，请参见 经典应用服务快速入门。

4. 在 SOFAStack 控制台配置限流规则。

   配置步骤，请参见 控制台配置限流规则。