前回の研究では、RestTemplateを利用してURLを自分でカプセル化して別のサービスを呼び出すのが面倒でした。feign の使用は比較的簡単で、1 つのアノテーションで実行できます。これは実際には軽量の http サービス クライアントであり、負荷分散機能とサーキット ブレーカー機能も備えています。Feign = RestTemplate+Ribbon+Hystrix
feign の基本的な使い方:
1. 依存関係をコンシューマ サービスにインポートする
<dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-openfeign</artifactId> </dependency>
2.スタートアップ クラスは @EnableFeignClients アノテーションを使用します
注:現時点では、インポートされた依存関係を含めるために、Hystrixサーキット ブレーカーのサポート アノテーション@EnableCircuitBreakerを削除します。これは、Feignがそれらを自動的にインポートするためです。
3. 偽のインターフェースを作成する
// @FeignClient表明当前类是一个Feign客户端,value指定该客户端要请求的服务名称(登记到注册中心上的服务提供者的服务名称) @FeignClient(value = "lagou-service-resume") @RequestMapping("/resume") public interface ResumeServiceFeignClient { // Feign要做的事情就是,拼装url发起请求 // 我们调用该方法就是调用本地接口方法,那么实际上做的是远程请求 @GetMapping("/openstate/{userId}") public Integer findDefaultResumeState(@PathVariable("userId") Long userId); }
上記のように、springmvc の方法で URL を指定するので、非常に便利です。呼び出すサービスとインターフェースを指定し、使用する場合は @Autowire インジェクションを使用します。
feign による負荷分散のサポート:
Feign 自体にはリボンの依存関係と自動構成が統合されているため、追加の依存関係を導入する必要はなく、ribbon.xx (つまり、以前に学習したリボン構成方法) を通じて構成できます。さらに、偽呼び出しの場合、インターフェイス タイムアウト (デフォルトは 1 秒) を指定できますが、リボン構成を使用する場合はリボンが優先されます。
Feign によるヒューズのサポート:
hystrix の融合をサポートするには、依存関係を個別に導入する必要はなく、構成ファイルでサポートを有効にするだけで済みます。
# 开启Feign的熔断功能 feign: hystrix: enabled: true
その他はhystrix以前と同様に使用できます。注意すべき点は、feign 自体にタイムアウト設定があり、この時点で hystrix の融合タイムアウトが設定されている場合、時間の短い方が優先され、この時間の後に融合メカニズムが入ります。前に述べたように、ヒューズが切断された後にダウングレード方法を指定でき、ここで偽インターフェイスも指定できます。
1. フォールバック処理クラスを定義します。
/** * 降级回退逻辑需要定义一个类,实现FeignClient接口,实现接口中的方法 * * */ @Component // 别忘了这个注解,还应该被扫描到 public class ResumeFallback implements ResumeServiceFeignClient { @Override public Integer findDefaultResumeState(Long userId) { return -6; } }
feign インターフェイスを直接実装し、元のメソッドのロジックをすべて書き換えます。
2. feignインターフェースで指定する
@FeignClient(value = "lagou-service-resume",fallback = ResumeFallback.class,path = "/resume") //@RequestMapping("/resume") public interface ResumeServiceFeignClient { // Feign要做的事情就是,拼装url发起请求 // 我们调用该方法就是调用本地接口方法,那么实际上做的是远程请求 @GetMapping("/openstate/{userId}") public Integer findDefaultResumeState(@PathVariable("userId") Long userId); }
上記と同様に、FeignClient アノテーションに fallback 属性を指定するだけです。フォールバックを使用した後は、@RequestMapping("/resume") をコメント アウトし、プレフィックス /resume を FeignClient の path 属性に入れる必要があることに注意してください。そうしないと、エラーが報告される可能性があります。
Feign の圧縮サポート:
feign が呼び出されるとき、リクエストまたはレスポンスの本文が大きすぎる状況が発生する可能性があります。Feign は圧縮をサポートしており、値を直接設定して圧縮を開くことができます。
feign: compression: request: enabled: true # 开启请求压缩 mime-types: text/html,application/xml,application/json # 设置压缩的数据类型,此处也是默认值 min-request-size: 2048 # 设置触发压缩的⼤⼩下限,此处也是默认值 response: enabled: true # 开启响应压缩
Feign のログ レベル:
Feign は、ブラウザと同様のhttpリクエスト クライアントであり、応答を要求および受信するときに、より詳細なログ情報 (応答ヘッダー、ステータス コードなど) を出力できます。Feign が要求したときにログを表示したい場合は、それを設定できますが、デフォルトでは、 Feignのログは有効になっていません。
// Feign的⽇志级别(Feign请求过程信息) // NONE:默认的,不显示任何⽇志----性能最好 // BASIC:仅记录请求⽅法、URL、响应状态码以及执⾏时间----⽣产问题追踪 // HEADERS:在BASIC级别的基础上,记录请求和响应的header // FULL:记录请求和响应的header、body和元数据----适⽤于开发及测试环境定位问题 @Configuration public class FeignConfig { @Bean Logger.Level feignLevel() { return Logger.Level.FULL; } }
偽インターフェイスのログ レベルを変更することもできます。
logging: level: # Feign⽇志只会对⽇志级别为debug的做出响应 com.lagou.edu.controller.service.ResumeServiceFeignClient:debug