重學 Java 設計模式:實戰代理模式「模擬mybatis-spring中定義DAO介面,使用代理類方式運算元據庫原理實現場景」

小傅哥發表於2020-06-17

作者:小傅哥
部落格:https://bugstack.cn - 原創系列專題案例

沉澱、分享、成長,讓自己和他人都能有所收穫!?

一、前言

難以跨越的瓶頸期,把你拿捏滴死死的!

程式設計開發學習過程中遇到的瓶頸期,往往是由於看不到前進的方向。這個時候你特別希望能有人告訴你,你還欠缺些什麼朝著哪個方向努力。而導致這一問題的主要原因是由於日常的業務開發太過於複製過去,日復一日的重複。沒有太多的挑戰,也沒參與過較大體量的業務場景,除了這些開發場景因素外,還有缺少組內的技術氛圍和技術分享,沒有人做傳播和佈道者,也缺少自己對各項技術學習的熱情,從而導致一直遊蕩在瓶頸之下,難以提升。

小公司與大公司,選擇哪個?

刨除掉薪資以外你會選擇什麼,是不有人建議小公司,因為可以接觸到各個環境,也有人建議大公司,因為正規體量大可以學習到更多。有些時候你的技術成長緩慢也是因為你的不同選擇而導致的,小公司確實要接觸各個環境,但往往如果你所做的業務體量不高,那麼你會用到的技術棧就會相對較少,同時也會技術棧研究的深度也會較淺。大公司中確實有時候你不需要去關心一個叢集的部署和維護、一箇中介軟體的開發、全套服務監控等等,但如果你願意瞭解這些技術在內部都是公開的,你會擁有無限的技術營養可以補充。而這最主要的是提升視野和事業。

除了業務中的CRUD開發,有些技術你真的很難接觸到!

可能很多小夥伴認為技術開發就是承接下產品需求,寫寫CRUD,不會的百度一下,就完事了,總覺得別人問的東西像再造火箭一樣。但在高體量、高併發的業務場景下,每一次的壓測優化,效能提升,都像在研究一道數學題一樣,反覆的錘鍊,壓榨效能。不斷的深究,找到最合適的設計。除了這些優化提升外,還有那麼廣闊的技術體系棧,都可能因為你只是注重CRUD而被忽略;位元組碼程式設計、領域驅動設計架構、代理模式中介軟體開發、JVM虛擬機器實現原理等等。

二、開發環境

  1. JDK 1.8
  2. Idea + Maven
  3. Spring 4.3.24.RELEASE
  4. 涉及工程三個,可以通過關注公眾號bugstack蟲洞棧,回覆原始碼下載獲取(開啟獲取的連結,找到序號18)
工程 描述
itstack-demo-design-12-00 模擬MyBatis開發中介軟體代理類部分

三、代理模式介紹

代理模式,圖片來自 refactoringguru.cn

代理模式有點像老大和小弟,也有點像分銷商。主要解決的是問題是為某些資源的訪問、物件的類的易用操作上提供方便使用的代理服務。而這種設計思想的模式經常會出現在我們的系統中,或者你用到過的元件中,它們都提供給你一種非常簡單易用的方式控制原本你需要編寫很多程式碼的進行使用的服務類。

類似這樣的場景可以想到;

  1. 你的資料庫訪問層面經常會提供一個較為基礎的應用,以此來減少應用服務擴容時不至於資料庫連線數暴增。
  2. 使用過的一些中介軟體例如;RPC框架,在拿到jar包對介面的描述後,中介軟體會在服務啟動的時候生成對應的代理類,當呼叫介面的時候,實際是通過代理類發出的socket資訊進行通過。
  3. 另外像我們常用的MyBatis,基本是定義介面但是不需要寫實現類,就可以對xml或者自定義註解裡的sql語句進行增刪改查操作。

四、案例場景模擬

場景模擬;實現mybatis-spring中代理類生成部分

在本案例中我們模擬實現mybatis-spring中代理類生成部分

對於Mybatis的使用中只需要定義介面不需要寫實現類就可以完成增刪改查操作,有疑問的小夥伴,在本章節中就可以學習到這部分知識。解析下來我們會通過實現一個這樣的代理類交給spring管理的核心過程,來講述代理類模式。

這樣的案例場景在實際的業務開發中其實不多,因為這是將這種思想運用在中介軟體開發上,而很多小夥伴經常是做業務開發,所以對Spring的bean定義以及註冊和對代理以及反射呼叫的知識瞭解的相對較少。但可以通過本章節作為一個入門學習,逐步瞭解。

五、代理類模式實現過程

接下來會使用代理類模式來模擬實現一個Mybatis中對類的代理過程,也就是隻需要定義介面,就可以關聯到方法註解中的sql語句完成對資料庫的操作。

這裡需要注意一些知識點;

  1. BeanDefinitionRegistryPostProcessor,spring的介面類用於處理對bean的定義註冊。
  2. GenericBeanDefinition,定義bean的資訊,在mybatis-spring中使用到的是;ScannedGenericBeanDefinition 略有不同。
  3. FactoryBean,用於處理bean工廠的類,這個類非常見。

1. 工程結構

itstack-demo-design-12-00
└── src
    ├── main
    │   ├── java
    │   │   └── org.itstack.demo.design
    │   │       ├── agent
    │   │       │    ├── MapperFactoryBean.java
    │   │       │    ├── RegisterBeanFactory.java
    │   │       │    └── Select.java
    │   │       └── IUserDao.java
    │   └── resources    
    │       └── spring-config.xml
    └── test
        └── java
            └── org.itstack.demo.test
                └── ApiTest.java

代理模式中介軟體模型結構

代理模式中介軟體模型結構

  • 此模型中涉及的類並不多,但都是抽離出來的核心處理類。主要的事情就是對類的代理和註冊到spring中。
  • 上圖中最上面是關於中介軟體的實現部分,下面對應的是功能的使用。

2. 程式碼實現

2.1 自定義註解

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD})
public @interface Select {

    String value() default "";  // sql語句

}
  • 這裡我們定義了一個模擬mybatis-spring中的自定義註解,用於使用在方法層面。

2.2 Dao層介面

public interface IUserDao {

    @Select("select userName from user where id = #{uId}")
    String queryUserInfo(String uId);

}
  • 這裡定義一個Dao層介面,並把自定義註解新增上。這與你使用的mybatis元件是一樣的。
  • 2.1和2.2是我們的準備工作,後面開始實現中介軟體功能部分。

2.3 代理類定義

public class MapperFactoryBean<T> implements FactoryBean<T> {

    private Logger logger = LoggerFactory.getLogger(MapperFactoryBean.class);

    private Class<T> mapperInterface;

    public MapperFactoryBean(Class<T> mapperInterface) {
        this.mapperInterface = mapperInterface;
    }

    @Override
    public T getObject() throws Exception {
        InvocationHandler handler = (proxy, method, args) -> {
            Select select = method.getAnnotation(Select.class);
            logger.info("SQL:{}", select.value().replace("#{uId}", args[0].toString()));
            return args[0] + ",小傅哥,bugstack.cn - 沉澱、分享、成長,讓自己和他人都能有所收穫!";
        };
        return (T) Proxy.newProxyInstance(this.getClass().getClassLoader(), new Class[]{mapperInterface}, handler);
    }

    @Override
    public Class<?> getObjectType() {
        return mapperInterface;
    }

    @Override
    public boolean isSingleton() {
        return true;
    }

}
  • 如果你有閱讀過mybatis原始碼,是可以看到這樣的一個類;MapperFactoryBean,這裡我們也模擬一個這樣的類,在裡面實現我們對代理類的定義。
  • 通過繼承FactoryBean,提供bean物件,也就是方法;T getObject()
  • 在方法getObject()中提供類的代理以及模擬對sql語句的處理,這裡包含了使用者呼叫dao層方法時候的處理邏輯。
  • 還有最上面我們提供建構函式來透傳需要被代理類,Class<T> mapperInterface,在mybatis中也是使用這樣的方式進行透傳。
  • 另外getObjectType()提供物件型別反饋,以及isSingleton()返回類是單例的。

2.4 將Bean定義註冊到Spring容器

public class RegisterBeanFactory implements BeanDefinitionRegistryPostProcessor {
    
    @Override
    public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) throws BeansException {
        
        GenericBeanDefinition beanDefinition = new GenericBeanDefinition();
        beanDefinition.setBeanClass(MapperFactoryBean.class);
        beanDefinition.setScope("singleton");
        beanDefinition.getConstructorArgumentValues().addGenericArgumentValue(IUserDao.class);

        BeanDefinitionHolder definitionHolder = new BeanDefinitionHolder(beanDefinition, "userDao");
        BeanDefinitionReaderUtils.registerBeanDefinition(definitionHolder, registry);
    }

    @Override
    public void postProcessBeanFactory(ConfigurableListableBeanFactory configurableListableBeanFactory) throws BeansException {
        // left intentionally blank
    }

}
  • 這裡我們將代理的bean交給spring容器管理,也就可以非常方便讓我們可以獲取到代理的bean。這部分是spring中關於一個bean註冊過程的原始碼。
  • GenericBeanDefinition,用於定義一個bean的基本資訊setBeanClass(MapperFactoryBean.class);,也包括可以透傳給建構函式資訊addGenericArgumentValue(IUserDao.class);
  • 最後使用 BeanDefinitionReaderUtils.registerBeanDefinition,進行bean的註冊,也就是註冊到DefaultListableBeanFactory中。

2.5 配置檔案spring-config

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd"
       default-autowire="byName">

    <bean id="userDao" class="org.itstack.demo.design.agent.RegisterBeanFactory"/>

</beans>
  • 接下來在配置檔案中新增我們的bean配置,在mybatis的使用中一般會配置掃描的dao層包,這樣就可以減少這部分的配置。

3. 測試驗證

3.1 編寫測試類

@Test
public void test_IUserDao() {
    BeanFactory beanFactory = new ClassPathXmlApplicationContext("spring-config.xml");
    IUserDao userDao = beanFactory.getBean("userDao", IUserDao.class);
    String res = userDao.queryUserInfo("100001");
    logger.info("測試結果:{}", res);
}
  • 測試的過程比較簡單,通過載入Bean工廠獲取我們的代理類的例項物件,之後呼叫方法返回結果。
  • 那麼這個過程你可以看到我們是沒有對介面先一個實現類的,而是使用代理的方式給介面生成一個實現類,並交給spring管理。

3.2 測試結果

23:21:57.551 [main] DEBUG o.s.core.env.StandardEnvironment - Adding PropertySource 'systemProperties' with lowest search precedence
...
23:21:57.858 [main] DEBUG o.s.c.s.ClassPathXmlApplicationContext - Unable to locate LifecycleProcessor with name 'lifecycleProcessor': using default [org.springframework.context.support.DefaultLifecycleProcessor@7bc1a03d]
23:21:57.859 [main] DEBUG o.s.b.f.s.DefaultListableBeanFactory - Returning cached instance of singleton bean 'lifecycleProcessor'
23:21:57.860 [main] DEBUG o.s.c.e.PropertySourcesPropertyResolver - Could not find key 'spring.liveBeansView.mbeanDomain' in any property source
23:21:57.861 [main] DEBUG o.s.b.f.s.DefaultListableBeanFactory - Returning cached instance of singleton bean 'userDao'
23:21:57.915 [main] INFO  o.i.d.design.agent.MapperFactoryBean - SQL:select userName from user where id = 100001
23:21:57.915 [main] INFO  org.itstack.demo.design.test.ApiTest - 測試結果:100001,小傅哥,bugstack.cn - 沉澱、分享、成長,讓自己和他人都能有所收穫!

Process finished with exit code 0
  • 從測試結果可以看到,我們列印了SQL語句,這部分語句是從自定義註解中獲取的;select userName from user where id = 100001,我們做了簡單的適配。在mybatis框架中會交給SqlSession的實現類進行邏輯處理返回運算元據庫資料
  • 而這裡我們的測試結果是一個固定的,如果你願意更加深入的研究可以嘗試與資料庫操作層進行關聯,讓這個框架可以更加完善。

六、總結

  • 關於這部分代理模式的講解我們採用了開發一個關於mybatis-spring中介軟體中部分核心功能來體現代理模式的強大之處,所以涉及到了一些關於代理類的建立以及spring中bean的註冊這些知識點,可能在平常的業務開發中都是很少用到的,但是在中介軟體開發中確實非常常見的操作。
  • 代理模式除了開發中介軟體外還可以是對服務的包裝,物聯網元件等等,讓複雜的各項服務變為輕量級呼叫、快取使用。你可以理解為你家裡的電燈開關,我們不能操作220v電線的人肉連線,但是可以使用開關,避免觸電。
  • 代理模式的設計方式可以讓程式碼更加整潔、乾淨易於維護,雖然在這部分開發中額外增加了很多類也包括了自己處理bean的註冊等,但是這樣的中介軟體複用性極高也更加智慧,可以非常方便的擴充套件到各個服務應用中。

七、推薦閱讀

相關文章