項目集成OpenFegin

集成OpenFegin依賴

首先，我先跟大家說下項目的配置，整體項目使用的SpringBoot版本為2.2.6，原生的OpenFegin使用的是11.0，我們通過如下方式在pom.xml中引入OpenFegin。

    UTF-8
    false
    1.8
    11.0


    
        io.github.openfeign
        feign-core
        ${openfegin.version}
    

    
        io.github.openfeign
        feign-jackson
        ${openfegin.version}
    

這里，我省略了一些其他的配置項。

接下來，我就開始在我的項目中使用OpenFegin調(diào)用遠程服務(wù)了。具體步驟如下。

實現(xiàn)遠程調(diào)用

首先，創(chuàng)建OpenFeignConfig類，配置OpenFegin默認使用的Contract。

@Configuration
public class OpenFeignConfig {
 @Bean
 public Contract useFeignAnnotations() {
  return new Contract.Default();
 }
}

接下來，我們寫一個通用的獲取OpenFeign客戶端的工廠類，這個類也比較簡單，本質(zhì)上就是以一個HashMap來緩存所有的FeginClient，這個的FeginClient本質(zhì)上就是我們自定義的Fegin接口，緩存中的Key為請求連接的基礎(chǔ)URL，緩存的Value就是我們定義的FeginClient接口。

public class FeginClientFactory {
 
 /**
  * 緩存所有的Fegin客戶端
  */
 private volatile static Map feginClientCache = new HashMap<>();
 
 /**
  * 緩存FeginFegin客戶端到Map并從Map中獲取數(shù)據(jù)
  * @return 
  */
 @SuppressWarnings("unchecked")
 public static  T getFeginClient(Class clazz, String baseUrl){
  if(!feginClientCache.containsKey(baseUrl)) {
   synchronized (FeginClientFactory.class) {
    if(!feginClientCache.containsKey(baseUrl)) {
     T feginClient = Feign.builder().decoder(new JacksonDecoder()).encoder(new JacksonEncoder()).target(clazz, baseUrl);
     feginClientCache.put(baseUrl, feginClient);
    }
   }
  }
  return (T)feginClientCache.get(baseUrl);
 }
}

接下來，我們就定義一個FeginClient接口。

public interface FeginClientProxy {
 @Headers("Content-Type:application/json;charset=UTF-8")
 @RequestLine("POST /user/login")
 UserLoginVo login(UserLoginVo loginVo);
}

接下來，我們創(chuàng)建SpringBoot的測試類。

@RunWith(SpringRunner.class)
@SpringBootTest
public class BingheStarterTest {
 @Test
 public void testUserLogin() {
  ResponseMessage result = FeginClientFactory.getFeginClient(FeginClientProxy.class, "http://127.0.0.1").login(new UserLoginVo("zhangsan", "123456"));
  System.out.println(JsonUtils.bean2Json(result));
 }
}

一切準備就緒，運行測試。麻蛋，出問題了。主要的問題就是通過OpenFeign請求返回值LocalDateTime字段會發(fā)生異常?。?！

注：此時異常時，我們在LocalDateTime字段上添加的注解如下所示。

import java.time.LocalDateTime;
import com.baomidou.mybatisplus.annotation.FieldFill;
import com.baomidou.mybatisplus.annotation.TableField;
import com.fasterxml.jackson.annotation.JsonFormat;


@TableField(value = "CREATE_TIME", fill = FieldFill.INSERT)
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", locale = "zh", timezone = "GMT+8")
private LocalDateTime createTime;

解決問題

問題描述

SpringBoot通過原生OpenFeign客戶端調(diào)用HTTP接口，如果返回值中包含LocalDateTime類型（包括其他JSR-310中java.time包的時間類），在客戶端可能會出現(xiàn)反序列化失敗的錯誤。錯誤信息如下：

 Caused by:com.fasterxml.jackson.databind.exc.InvalidDefinitionException: Cannot construct instance of `java.time.LocalDateTime` (no Creators, like default construct, exist): no String-argument constructor/factory method to deserialize from String value ('2020-10-07T11:04:32')

問題分析

從客戶端調(diào)用fegin，也是相當(dāng)于URL傳參就相當(dāng)于經(jīng)過一次JSON轉(zhuǎn)換，數(shù)據(jù)庫取出‘2020-10-07T11:04:32’數(shù)據(jù)這時是時間類型，進過JSON之后就變成了String類型，T就變成了字符不再是一個特殊字符，因此String的字符串“2020-10-07T11:04:32”反序列化就會失敗。

問題解決

在項目中增加依賴。

    com.fasterxml.jackson.datatype
    jackson-datatype-jsr310
    2.9.9

注：如果是用的是SpringBoot，并且明確指定了SpringBoot版本，引入jackson-datatype-jsr310時，可以不用指定版本號。

接下來，在POJO類的LocalDateTime類型字段增加如下注解。

import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import com.fasterxml.jackson.datatype.jsr310.deser.LocalDateTimeDeserializer;

添加后的效果如下所示。

import java.time.LocalDateTime;
import com.baomidou.mybatisplus.annotation.FieldFill;
import com.baomidou.mybatisplus.annotation.TableField;
import com.fasterxml.jackson.annotation.JsonFormat;

import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import com.fasterxml.jackson.datatype.jsr310.deser.LocalDateTimeDeserializer;


@TableField(value = "CREATE_TIME", fill = FieldFill.INSERT)
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", locale = "zh", timezone = "GMT+8")
@JsonDeserialize(using = LocalDateTimeDeserializer.class)
private LocalDateTime createTime;

此時，再次調(diào)用遠程接口，問題解決。