【API知識】型別轉換工具ConvertUtils引發的思考
前言
在讀取Excel檔案資料,有時候不可避免地需要把獲取到的字串轉型為基本型別的物件。以前都是自己寫轉換,難度也不大。後來聽說,有可以直接用的輪子——Apache 的commons-beanutils這個包,有提供ConvertUtils。以下我的相關記錄。
我要的異常呢?
聽說有可以用的輪子,第一反應,肯定是拿來先跑幾個測試案例。這東西使用起來也很簡單,引數就是源字串和目的型別。我就先測了一下,一個亂碼String轉Boolean,看看會不會丟擲異常。結果出乎意外的是,它居然沒有丟擲異常,還返回了false。認真看了一下,才發現它直接把異常打印出來了,還返回了預設值。
程式碼如下:
public class ConvertTest { public static void main(String[] args) { Object result; result = ConvertUtils.convert("@7##jF*&%#$", Boolean.class); System.out.println(result); } }
輸出結果:
真是夠嗆,你不丟擲異常,我留你何用。我就是要你丟擲異常,然後我再在上層決定怎麼和使用者互動,你倒好,直接打印出來了,還給我個預設值,那怎麼知道原來的值到底是錯誤的還是bool false。
於是我想,這種工具都有一個尿性——可配置。我就想肯定有什麼方法,比如xxxwithException(),或者throwException()這樣的設定。結果翻了一下,還真沒有。哇,上頭。
核心——ConvertUtilsBean
剛好有時間,於是就看它到底怎麼實現的。看了才知道,原來它是把工作委託給ConvertUtilsBean來做的。
public static Object convert(final String value, final Class<?> clazz) { //這裡獲取一個ConvertUtilsBean的例項來執行convert方法return ConvertUtilsBean.getInstance().convert(value, clazz); }
於是順藤摸瓜,我就隨便翻了翻ConvertUtilsBean。我的眼睛就盯著,看看有沒有exception這個關鍵字,果然讓我找到了!!!
public void register(final boolean throwException, final boolean defaultNull, final int defaultArraySize) { registerPrimitives(throwException); registerStandard(throwException, defaultNull); registerOther(throwException); registerArrays(throwException, defaultArraySize); }
這裡可以配置是否要丟擲異常。於是我就用這個bean,測了一下,果然可以。
public class ConvertBeanTest { public static void main(String[] args) { ConvertUtilsBean convertUtilsBean = new ConvertUtilsBean(); convertUtilsBean.register(true, false, 0); Object obj; obj = convertUtilsBean.convert("@7##jF*&%#$", Boolean.class); System.out.println(obj); } }
輸出:
很好,終於丟擲異常了。那麼,我用這個ConvertUtilsBean就可以了。
ConvertUtilsBean為何能夠想轉什麼就轉什麼?
實際上,它也不是想轉什麼就轉什麼。初始條件下,它內部只註冊了基本型別的轉換器。
public ConvertUtilsBean() { converters.setFast(false); //這個方法是關鍵,它清除當前所有轉換器,並重新初始化 deregister(); converters.setFast(true); }
public void deregister() { converters.clear(); //false引數表示,是否丟擲異常。即預設不丟擲異常。 //這裡註冊了基本型別的轉換器 registerPrimitives(false); registerStandard(false, false); registerOther(true); registerArrays(false, 0); register(BigDecimal.class, new BigDecimalConverter()); register(BigInteger.class, new BigIntegerConverter()); }
註冊是什麼概念?
“註冊”這個詞,看上去挺玄乎的,其實一般就是寫到一個登錄檔裡面,然後需要的時候從表中檢索。在這個實現中,登錄檔,不過就是一張HashMap。而註冊操作,就是把Converter物件放到這個雜湊表中。
/** * The set of {@link Converter}s that can be used to convert Strings * into objects of a specified Class, keyed by the destination Class. */ private final WeakFastHashMap<Class<?>, Converter> converters = new WeakFastHashMap<Class<?>, Converter>();
我們可以看到,這個表的Key是型別。也就是說,我們在使用convert方法的時候,已經指定了key,自然就找到了對應的Converter。那我們還能想到什麼呢,那就是“覆蓋”。因為HashMap中,Key是唯一的,所以同種型別的Converter只能存在一個,即新註冊的Converter會覆蓋同類型的Converter。
對了,忘記提了,這個包有一個Converter介面,如果要自定義的話,也可以自己實現相關的類,註冊到這個Bean上,然後統一使用這個Bean。
service provider framework
之所以想到這個,是因為前幾天剛剛開始看《Effective Java》這本書中,而裡面說的service provider framwork的結構,和這個非常類似。
三個要素:
service介面 => Converter介面
register API => register方法
access API => ConverterUtils工具類
體現的思想就是:客戶端和實現類解耦,參照上面的,客戶端只要知道ConvertUtils或者ConvertUtilsBean這個類就好了,不需要去記該用哪個Converter。