快捷導(dǎo)航

Hutool開發(fā)利器MapProxy類使用技巧詳解

更新時(shí)間：2022年10月07日 09:09:13 作者：JAVA旭陽

這篇文章主要為大家介紹了Hutool開發(fā)利器MapProxy類使用技巧詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪

概述

Hutool是一個(gè)小而全的Java工具類庫(kù)，通過靜態(tài)方法封裝，降低相關(guān)API的學(xué)習(xí)成本，提高工作效率，使Java擁有函數(shù)式語言般的優(yōu)雅，讓Java語言也可以“甜甜的”。

目前公司項(xiàng)目中主要采用Hutool作為項(xiàng)目的工具包，相對(duì)于google的guava, hutool的工具類采用中文注釋，更加符合國(guó)人使用。所謂知己知彼，我們需要了解Hutool都具有什么樣的功能，才能夠最大化發(fā)揮它的價(jià)值。

本文主要就hutool 5.8.8版本中MapProxy的使用。

場(chǎng)景引入

其實(shí)Map在get的時(shí)候是比較危險(xiǎn)的，你可能不知道它是什么類型，需要進(jìn)行強(qiáng)制，舉個(gè)例子如下：

@Test
public void testMapProxy1() {
    Map<String, Object> userMap = MapUtil.newHashMap(16);
    userMap.put("username", "alvin");
    userMap.put("age", 20);
    // 使用map的時(shí)候, 需要進(jìn)行強(qiáng)轉(zhuǎn)，一旦類型錯(cuò)誤，會(huì)報(bào)錯(cuò)
    String age = (String)userMap.get("age");
}

運(yùn)行結(jié)果：

那有什么更好的解決方案嗎？Hutool提供了一種解決方案給我們。

MapProxy使用

依賴引入

<dependency>
  <groupId>cn.hutool</groupId>
  <artifactId>hutool-all</artifactId>
  <version>5.8.8</version>
</dependency>

定義一個(gè)可訪問接口

interface MapUser {
    String getUsername();
    Integer getAge();
    MapUser setAge(Integer age);
}

通過MapProxy訪問

@Test
public void testMapProxy2() {
    Map<String, Object> userMap = MapUtil.newHashMap(16);
    userMap.put("username", "alvin");
    userMap.put("age", 20);
    MapProxy mapProxy = MapProxy.create(userMap);
    Integer age = mapProxy.getInt("age", 18);
    Assert.assertTrue(age == 20);
    // 通過代理的方式
    MapUser mapUser = mapProxy.toProxyBean(MapUser.class);
    // 后續(xù)訪問會(huì)變的更加安全
    Assert.assertTrue(mapUser.getAge() == 20);
    mapUser.setAge(30);
    Assert.assertTrue(mapUser.getAge() == 30);
}

MapProxy源碼解析

Map代理，提供各種getXXX方法，并提供默認(rèn)值支持，它的類結(jié)構(gòu)圖如下:

實(shí)現(xiàn)了OptNullBasicTypeFromObjectGetter接口，提供了基本類型的get，在不提供默認(rèn)值的情況下，如果值不存在或獲取錯(cuò)誤，返回null, 比如:mapProxy.getInt("age", 18)。
實(shí)現(xiàn)了InvocationHandler接口，支持jdk的動(dòng)態(tài)代理，生成代理對(duì)象。

public <T> T toProxyBean(Class<T> interfaceClass) {
    return (T) Proxy.newProxyInstance(ClassLoaderUtil.getClassLoader(), new Class<?>[]{interfaceClass}, this);
}

toProxyBean方法就是生成代理對(duì)象，最終會(huì)調(diào)用代理類的invoke方法，這里的代理類就是MapProxy本身。

public Object invoke(Object proxy, Method method, Object[] args) {
    final Class<?>[] parameterTypes = method.getParameterTypes();
    // 如果調(diào)用方法參數(shù)為空
    if (ArrayUtil.isEmpty(parameterTypes)) {
        final Class<?> returnType = method.getReturnType();
        // 方法返回值不是void
        if (void.class != returnType) {
            // 匹配Getter
            final String methodName = method.getName();
            String fieldName = null;
            if (methodName.startsWith("get")) {
                // 匹配getXXX
                fieldName = StrUtil.removePreAndLowerFirst(methodName, 3);
            } else if (BooleanUtil.isBoolean(returnType) && methodName.startsWith("is")) {
                // 匹配isXXX
                fieldName = StrUtil.removePreAndLowerFirst(methodName, 2);
            }else if ("hashCode".equals(methodName)) {
                return this.hashCode();
            } else if ("toString".equals(methodName)) {
                return this.toString();
            }
            if (StrUtil.isNotBlank(fieldName)) {
                if (false == this.containsKey(fieldName)) {
                    // 駝峰不存在轉(zhuǎn)下劃線嘗試
                    fieldName = StrUtil.toUnderlineCase(fieldName);
                }
                return Convert.convert(method.getGenericReturnType(), this.get(fieldName));
            }
        }
        // 如果方法參數(shù)不為空
    } else if (1 == parameterTypes.length) {
        // 匹配Setter
        final String methodName = method.getName();
        if (methodName.startsWith("set")) {
            final String fieldName = StrUtil.removePreAndLowerFirst(methodName, 3);
            if (StrUtil.isNotBlank(fieldName)) {
                this.put(fieldName, args[0]);
                final Class<?> returnType = method.getReturnType();
                // 判斷返回類型是不是代理類的實(shí)例
                if(returnType.isInstance(proxy)){
                    return proxy;
                }
            }
        } else if ("equals".equals(methodName)) {
            return this.equals(args[0]);
        }
    }
    throw new UnsupportedOperationException(method.toGenericString());
}