连接池管理
默认情况下,所有通过Retrofit
发送的http请求都会使用max-idle-connections=5 keep-alive-second=300
的默认连接池。当然,我们也可以在配置文件中配置多个自定义的连接池,然后通过@RetrofitClient
的poolName
属性来指定使用。比如我们要让某个接口下的请求全部使用poolName=test1
的连接池,代码实现如下:
- 配置连接池。
retrofit: # 连接池配置 pool: test1: max-idle-connections: 3 keep-alive-second: 100 test2: max-idle-connections: 5 keep-alive-second: 50
2.通过@RetrofitClient
的poolName
属性来指定使用的连接池。
@RetrofitClient(baseUrl = "${test.baseUrl}", poolName="test1") public interface HttpApi { @GET("person") Result<Person> getPerson(@Query("id") Long id); }
日志打印
很多情况下,我们希望将http请求日志记录下来。通过retrofit.enableLog
配置可以全局控制日志是否开启。针对每个接口,可以通过@RetrofitClient
的enableLog
控制是否开启,通过logLevel
和logStrategy
,可以指定每个接口的日志打印级别以及日志打印策略。retrofit-spring-boot-starter
支持了5种日志打印级别(ERROR
, WARN
, INFO
, DEBUG
, TRACE
),默认INFO
;支持了4种日志打印策略(NONE
, BASIC
, HEADERS
, BODY
),默认BASIC
。4种日志打印策略含义如下:
NONE
:No logs.BASIC
:Logs request and response lines.HEADERS
:Logs request and response lines and their respective headers.BODY
:Logs request and response lines and their respective headers and bodies (if present).
retrofit-spring-boot-starter
默认使用了DefaultLoggingInterceptor
执行真正的日志打印功能,其底层就是okhttp
原生的HttpLoggingInterceptor
。当然,你也可以自定义实现自己的日志打印拦截器,只需要继承BaseLoggingInterceptor
(具体可以参考DefaultLoggingInterceptor
的实现),然后在配置文件中进行相关配置即可。
retrofit: # 日志打印拦截器 logging-interceptor: com.github.lianjiatech.retrofit.spring.boot.interceptor.DefaultLoggingInterceptor
请求重试
retrofit-spring-boot-starter
支持请求重试功能,只需要在接口或者方法上加上@Retry
注解即可。@Retry
支持重试次数maxRetries
、重试时间间隔intervalMs
以及重试规则retryRules
配置。重试规则支持三种配置:
RESPONSE_STATUS_NOT_2XX
:响应状态码不是2xx
时执行重试;OCCUR_IO_EXCEPTION
:发生IO异常时执行重试;OCCUR_EXCEPTION
:发生任意异常时执行重试;
默认响应状态码不是2xx
或者发生IO异常时自动进行重试。需要的话,你也可以继承BaseRetryInterceptor
实现自己的请求重试拦截器,然后将其配置上去。
retrofit: # 请求重试拦截器 retry-interceptor: com.github.lianjiatech.retrofit.spring.boot.retry.DefaultRetryInterceptor
错误解码器
在HTTP
发生请求错误(包括发生异常或者响应数据不符合预期)的时候,错误解码器可将HTTP
相关信息解码到自定义异常中。你可以在@RetrofitClient
注解的errorDecoder()
指定当前接口的错误解码器,自定义错误解码器需要实现ErrorDecoder
接口:
/** * 错误解码器。ErrorDecoder. * 当请求发生异常或者收到无效响应结果的时候,将HTTP相关信息解码到异常中,无效响应由业务自己判断 * * When an exception occurs in the request or an invalid response result is received, the HTTP related information is decoded into the exception, * and the invalid response is determined by the business itself. * * @author 陈添明 */ public interface ErrorDecoder { /** * 当无效响应的时候,将HTTP信息解码到异常中,无效响应由业务自行判断。 * When the response is invalid, decode the HTTP information into the exception, invalid response is determined by business. * * @param request request * @param response response * @return If it returns null, the processing is ignored and the processing continues with the original response. */ default RuntimeException invalidRespDecode(Request request, Response response) { if (!response.isSuccessful()) { throw RetrofitException.errorStatus(request, response); } return null; } /** * 当请求发生IO异常时,将HTTP信息解码到异常中。 * When an IO exception occurs in the request, the HTTP information is decoded into the exception. * * @param request request * @param cause IOException * @return RuntimeException */ default RuntimeException ioExceptionDecode(Request request, IOException cause) { return RetrofitException.errorExecuting(request, cause); } /** * 当请求发生除IO异常之外的其它异常时,将HTTP信息解码到异常中。 * When the request has an exception other than the IO exception, the HTTP information is decoded into the exception. * * @param request request * @param cause Exception * @return RuntimeException */ default RuntimeException exceptionDecode(Request request, Exception cause) { return RetrofitException.errorUnknown(request, cause); } }
全局拦截器
全局应用拦截器
如果我们需要对整个系统的的http请求执行统一的拦截处理,可以自定义实现全局拦截器BaseGlobalInterceptor
, 并配置成spring
容器中的bean
!例如我们需要在整个系统发起的http请求,都带上来源信息。
@Component public class SourceInterceptor extends BaseGlobalInterceptor { @Override public Response doIntercept(Chain chain) throws IOException { Request request = chain.request(); Request newReq = request.newBuilder() .addHeader("source", "test") .build(); return chain.proceed(newReq); } }
全局网络拦截器
只需要实现NetworkInterceptor
接口 并配置成spring
容器中的bean
就支持自动织入全局网络拦截器。
熔断降级
在分布式服务架构中,对不稳定的外部服务进行熔断降级是保证服务高可用的重要措施之一。由于外部服务的稳定性是不能保证的,当外部服务不稳定时,响应时间会变长。相应地,调用方的响应时间也会变长,线程会产生堆积,最终可能耗尽调用方的线程池,导致整个服务不可用。因此我们需要对不稳定的弱依赖服务调用进行熔断降级,暂时切断不稳定调用,避免局部不稳定导致整体服务雪崩。
retrofit-spring-boot-starter
支持熔断降级功能,底层基于[Sentinel]
1. 开启熔断降级功能
默认情况下,熔断降级功能是关闭的,需要设置相应的配置项来开启熔断降级功能:
retrofit: # 是否启用熔断降级 enable-degrade: true # 熔断降级实现方式(目前仅支持Sentinel) degrade-type: sentinel # 资源名称解析器 resource-name-parser: com.github.lianjiatech.retrofit.spring.boot.degrade.DefaultResourceNameParser
资源名称解析器用于实现用户自定义资源名称,默认配置是DefaultResourceNameParser
,对应的资源名称格式为`HTTP_OUT:GET:
另外,由于熔断降级功能是可选的,因此启用熔断降级需要用户自行引入Sentinel依赖:
<dependency> <groupId>com.alibaba.csp</groupId> <artifactId>sentinel-core</artifactId> <version>1.6.3</version> </dependency>
2. 配置降级规则(可选)
retrofit-spring-boot-starter
支持注解式配置降级规则,通过@Degrade
注解来配置降级规则。@Degrade
注解可以配置在接口或者方法上,配置在方法上的优先级更高。
@Retention(RetentionPolicy.RUNTIME) @Target({ElementType.METHOD, ElementType.TYPE}) @Documented public @interface Degrade { /** * RT threshold or exception ratio threshold count. */ double count(); /** * Degrade recover timeout (in seconds) when degradation occurs. */ int timeWindow() default 5; /** * Degrade strategy (0: average RT, 1: exception ratio). */ DegradeStrategy degradeStrategy() default DegradeStrategy.AVERAGE_RT; }
如果应用项目已支持通过配置中心配置降级规则,可忽略注解式配置方式。
3. @RetrofitClient设置fallback或者fallbackFactory (可选)
如果@RetrofitClient
不设置fallback
或者fallbackFactory
,当触发熔断时,会直接抛出RetrofitBlockException
异常。用户可以通过设置fallback
或者fallbackFactory
来定制熔断时的方法返回值。fallback
类必须是当前接口的实现类,fallbackFactory
必须是FallbackFactory
实现类,泛型参数类型为当前接口类型。另外,fallback
和fallbackFactory
实例必须配置成Spring
容器的Bean
。
fallbackFactory
相对于fallback
,主要差别在于能够感知每次熔断的异常原因(cause)。参考示例如下:
@Slf4j @Service public class HttpDegradeFallback implements HttpDegradeApi { @Override public Result<Integer> test() { Result<Integer> fallback = new Result<>(); fallback.setCode(100) .setMsg("fallback") .setBody(1000000); return fallback; } } 复制代码 @Slf4j @Service public class HttpDegradeFallbackFactory implements FallbackFactory<HttpDegradeApi> { /** * Returns an instance of the fallback appropriate for the given cause * * @param cause fallback cause * @return 实现了retrofit接口的实例。an instance that implements the retrofit interface. */ @Override public HttpDegradeApi create(Throwable cause) { log.error("触发熔断了! ", cause.getMessage(), cause); return new HttpDegradeApi() { @Override public Result<Integer> test() { Result<Integer> fallback = new Result<>(); fallback.setCode(100) .setMsg("fallback") .setBody(1000000); return fallback; } } } 复制代码
微服务之间的HTTP调用
为了能够使用微服务调用,需要进行如下配置:
配置ServiceInstanceChooser
为Spring
容器Bean
用户可以自行实现ServiceInstanceChooser
接口,完成服务实例的选取逻辑,并将其配置成Spring
容器的Bean
。对于Spring Cloud
应用,retrofit-spring-boot-starter
提供了SpringCloudServiceInstanceChooser
实现,用户只需将其配置成Spring
的Bean
即可。
@Bean @Autowired public ServiceInstanceChooser serviceInstanceChooser(LoadBalancerClient loadBalancerClient) { return new SpringCloudServiceInstanceChooser(loadBalancerClient); }
使用@Retrofit
的serviceId
和path
属性,可以实现微服务之间的HTTP调用
@RetrofitClient(serviceId = "${jy-helicarrier-api.serviceId}", path = "/m/count", errorDecoder = HelicarrierErrorDecoder.class) @Retry public interface ApiCountService { }