歡迎訪問我的GitHub
https://github.com/zq2599/blog_demos
內容:所有原創文章分類彙總及配套原始碼,涉及Java、Docker、Kubernetes、DevOPS等;
問題場景
本文是《Kubernetes官方java客戶端》的第二篇,在進入編碼實戰章節之前,有個問題需要大家有足夠的瞭解,避免在後面的實戰中耗費精力處理此類問題,來看看究竟是什麼問題:
-
SpringBoot是常用的應用框架,《Kubernetes官方java客戶端》系列的應用都是基於SpringBoot-2.3.1版本的;
-
下圖是SpringBoot-2.3.1.RELEASE的官方文件,紅框表明預設的JSON處理庫是Jackson:
-
看到這裡您是否有種不祥預感:K8S官方java客戶端是谷歌的,涉及到JSON處理時會不會首選自家的Gson?
-
V1HTTPGetAction.java是java客戶端中常用到的資料結構,用來封裝http請求相關的引數,來看看其原始碼,如下圖,果然用上了Gson的註解:
-
上圖提到的IntOrString類要重點關注,用處廣泛,開啟其原始碼如下圖,請記下紅框2中的程式碼,後面提到的問題就來源於此:
- 小結:SpringBoot預設的JSON處理類是Jackson,K8S官方java客戶端內的Bean在涉及到JSON相關的序列化和反序列化處理時,使用了Gson註解,因此上述Bean例項在SpringBoot中涉及到JSON處理時,可能會有問題(這時只能說可能),例如RestController返回物件,會被Jackson轉為JSON;
復現問題
- 這裡用一個SpringBoot工程來演示此問題(該工程名為OutsideclusterApplication,下一篇文章會詳細說明),如下程式碼是個http介面響應,可見V1PodList例項作為介面返回時,會被SpringBoot用Jackson轉為JSON返回給前端:
@RequestMapping(value = "/hello")
public V1PodList hello() throws Exception {
// 存放K8S的config檔案的全路徑
String kubeConfigPath = "/Users/zhaoqin/temp/202007/05/config";
// 以config作為入參建立的client物件,可以訪問到K8S的API Server
ApiClient client = ClientBuilder
.kubeconfig(KubeConfig.loadKubeConfig(new FileReader(kubeConfigPath)))
.build();
Configuration.setDefaultApiClient(client);
CoreV1Api api = new CoreV1Api();
// 呼叫客戶端API取得所有pod資訊
V1PodList v1PodList = api.listPodForAllNamespaces(null, null, null, null, null, null, null, null, null);
return v1PodList;
}
-
上述程式碼執行起來,在瀏覽器訪問該介面時,控制檯丟擲以下錯誤,IntOrString.getStrValue方法,就是前面我們們看過的那段,IntOrString中實際上儲存的是int資料,但是Jackson執行了其getStrValue方法:
-
至於為什麼Jackson會執行getStrValue方法,篇幅原因就不在此展開了,簡單提一下,在java客戶端的BeanPropertyWriter類中,選擇方法的邏輯如下圖,紅框中展示了判定邏輯,此處getStrValue方法命中了該邏輯,如果您嘗試用在紅框處打上斷點觀察,會發現有很多方法都符合此條件:
解決問題的思路
我這裡,解決問題的思路有兩個:
- 讓Jackson在序列化的時候,能夠呼叫正確的方法,以IntOrString為例,如果此時內部儲存int型資料,就應該執行其getIntValue方法即可;
- Bean中使用了Gson註釋,就是打算用Gson來處理序列化和反序列化操作的,因此序列化和反序列化的地方都改用Gson處理;
- 上述兩個思路,我選擇了第二種,畢竟第一種太難了...
解決問題
-
問題解決起來並不難,先看SpringBoot-2.3.1.RELEASE官方文件:
-
結合官方文件,我們要做兩件事情:
- 首先,classpath中有Gson,這個已經有了,因為K8S官方java客戶端會依賴Gson;
- 其次,classpath中不要出現Jackson,為了達到這個目的我們需要做以下操作,排除spring-boot-starter-web的依賴(為什麼不直接排除jackson的庫呢?您可以執行mvn dependency:tree命令細看依賴樹,會發現對jackson的依賴並非單一關係):
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-json</artifactId>
</exclusion>
</exclusions>
</dependency>
- 建議您執行mvn dependency:tree命令細看整個專案的依賴樹,確保jackson依賴已經全部去掉;
- 再次執行上述專案,如下圖,服務端不再報錯,頁面上返回資料正常:
使用Jackson的場景
-
上述方式雖然可行,但並非所有專案都能堅持使用Gson而放棄Jackson,對於使用Jackson的專案,請避免Jackson參與K8S官方java客戶端bean的序列化和反序列化操作,以上面出現的Controller程式碼為例,不要直接將V1PodList例項返回,您可以選擇先用Gson序列化成JSON字串,再返回字串給前端,也可以自己定義VO物件,將V1PodList例項轉成VO物件再返回;
-
至此,使用K8S官方java客戶端之前要注意的問題已經弄明白了,接下來的進入精彩的實戰章節吧,一起體驗kubernetes官方為java程式設計師精心準備的工具;
你不孤單,欣宸原創一路相伴
歡迎關注公眾號:程式設計師欣宸
微信搜尋「程式設計師欣宸」,我是欣宸,期待與您一同暢遊Java世界...
https://github.com/zq2599/blog_demos