这些代码有点臭,重构大法带你秀(SPI接口化)

如果说 正常的重构 是为了消除 代码 的坏味道, 那么 高层次的重构 就是消除 架构 的坏味道

最近由于需要将公司基础架构的组件进行各种 兼容,适配以及二开 ,所以很多时候就需要对组件进行 重构 ,大家是不是在拿到公司老项目老代码,又需要 二开或者重构 的时候,会 头很大,无从下手,我之前也一直是这样的状态,不过在慢慢熟悉了一些 重构 的思想和方法之后,就能稍微的得心应手一些,下面我就开始讲下 重构 ,然后会着重讲下 重构 中的 SPI接口化 。

先给大家看看最近通过使用 SPI接口化 , 重构 的一个组件- 分布式存储 。

重构前的代码结构

这些代码有点臭,重构大法带你秀(SPI接口化)

好家伙,所有的第三方存储都是写在一个模块中的,各种 阿里云,腾讯云,华为云 等等,这样的代码架构在前期可能在 不需要经常扩展,二开 的时候,还是能用的。

但是当某个新需求来的时候,比如我遇到的: 需要支持多个云的多个账号上传下载功能,这个是因为在不同的云上,不同账号的 权限,安全认证 等都是不太一样的,所以在某一刻,这个需求就被提出来了,也就是你想上传到哪个云的哪个账号都可以。

然后拿到这个代码,看了下这样的架构,可能在这样的基础上完成需求也是没有问题的,但是扩展很麻烦,而且代码会越来越 繁重 ,架构会越来越 复杂,不清晰 。

所以我索性趁着这个机会,就重构一把,和其他同事也商量了下,决定 分模块,SPI化 ,好处就是根据你想使用的 引入对应的依赖 ,让代码架构更加清晰,后续更加容易扩展了!下面就是重构后的大体架构:

这些代码有点臭,重构大法带你秀(SPI接口化)

是不是清楚多了,之后哪怕某个云存储需要增加新功能,或者需要兼容更多的云也是比较容易的了。

好了,下面就让我们开始讲讲 重构大法 ~

重构

重构是什么?

重构(Refactoring) 就是通过调整程序代码改善软件的质量、性能,使其程序的设计模式和架构更趋合理,提高软件的扩展性和维护性。

重构 最重要的思想就是让普通程序员也能写出优秀的程序。

把优化代码质量的过程拆解成一个个小的步骤,这样重构一个项目的巨大工作量就变成比如 修改变量名、提取函数、抽取接口 等等简单的工作目标。

作为一个普通的程序员就可以通过实现这些易完成的工作目标来提升自己的编码能力,加深自己的项目认识,从而为最高层次的 重构 打下基础。

而且高层次的 重构 依然是由无数个小目标构成,而不是长时间、大规模地去实现。

重构 本质是 极限编程 的一部分,完整地实现 极限编程 才能最大化地发挥 重构 的价值。而极限编程 本身就提倡拥抱变化,增强适应性,因此分解极限编程中的功能去适应项目的需求、适应团队的现状才是最好的 操作模式 。

重构的重点

重复代码,过长函数,过大的类,过长参数列,发散式变化,霰弹式修改,依恋情结,数据泥团,基本类型偏执,平行继承体系,冗余类等

下面举一些常用的或者比较基础的例子:

一些 基本的原则 我觉得还是需要了解的

  1. 尽量避免过多过长的创建Java对象
  2. 尽量使用局部变量
  3. 尽量使用StringBuilder和StringBuffer进行字符串连接
  4. 尽量减少对变量的重复计算
  5. 尽量在finally块中释放资源
  6. 尽量缓存经常使用的对象
  7. 不使用的对象及时设置为null
  8. 尽量考虑使用静态方法
  9. 尽量在合适的场合使用单例
  10. 尽量使用final修饰符

下面是关于类和方法优化:

  1. 重复代码的提取
  2. 冗长方法的分割
  3. 嵌套条件分支或者循环递归的优化
  4. 提取类或继承体系中的常量
  5. 提取继承体系中重复的属性与方法到父类

这里先简单介绍这些比较常规的 重构思想和原则,方法 ,毕竟今天的主角是 SPI ,下面有请 SPI 登场!

SPI

什么是SPI?

SPI全称Service Provider Interface ,是Java提供的一套用来被第三方实现或者扩展的API,它可以用来启用框架扩展和替换组件。

它是一种服务发现机制,它通过在ClassPath路径下的META-INF/services文件夹查找文件,自动加载文件里所定义的类。

这一机制为很多框架扩展提供了可能,比如在 Dubbo、JDBC 中都使用到了 SPI机制 。

下面就是 SPI 的机制过程

image.png

SPI 实际上是基于 接口的编程+策略模式+配置文件 组合实现的 动态加载机制 。

系统设计的各个抽象,往往有很多不同的实现方案,在面向的对象的设计里,一般推荐模块之间基于接口编程,模块之间不对实现类进行硬编码。

一旦代码里涉及具体的实现类,就违反了可拔插的原则,如果需要替换一种实现,就需要修改代码。为了实现在模块装配的时候能不在程序里动态指明,这就需要一种服务发现机制。

SPI 就是提供这样的一个机制:为某个接口寻找服务实现的机制。有点类似 IOC的思想 ,就是将装配的控制权移到程序之外,在模块化设计中这个机制尤其重要。所以SPI的核心思想就是解耦。

SPI使用介绍

要使用Java SPI,一般需要遵循如下约定:

  1. 当服务提供者提供了接口的一种具体实现后,在jar包的 META-INF/services 目录下创建一个以接口全限定名`为命名的文件,内容为实现类的全限定名;
  2. 接口实现类所在的jar包放在主程序的 classpath 中;
  3. 主程序通过 java.util.ServiceLoder 动态装载实现模块,它通过扫描 META-INF/services 目录下的配置文件找到实现类的全限定名,把类加载到JVM;
  4. SPI的实现类必须携带一个不带参数的构造方法;

SPI使用场景

概括地说,适用于:调用者根据实际使用需要,启用、扩展、或者替换框架的实现策略

以下是比较常见的例子:

  1. 数据库驱动加载接口实现类的加载 JDBC加载不同类型数据库的驱动
  2. 日志门面接口实现类加载 SLF4J加载不同提供商的日志实现类
  3. Spring Spring中大量使用了SPI,比如:对servlet3.0规范对ServletContainerInitializer的实现、自动类型转换Type Conversion SPI(Converter SPI、Formatter SPI)等
  4. Dubbo Dubbo中也大量使用SPI的方式实现框架的扩展, 不过它对Java提供的原生SPI做了封装,允许用户扩展实现Filter接口

SPI简单例子

先定义接口类

package com.test.spi.learn;
import java.util.List;

public interface Search {
    public List<String> searchDoc(String keyword);   
}

文件搜索实现

package com.test.spi.learn;
import java.util.List;

public class FileSearch implements Search{
    @Override
    public List<String> searchDoc(String keyword) {
        System.out.println("文件搜索 "+keyword);
        return null;
    }
}

数据库搜索实现

package com.test.spi.learn;
import java.util.List;

public class DBSearch implements Search{
    @Override
    public List<String> searchDoc(String keyword) {
        System.out.println("数据库搜索 "+keyword);
        return null;
    }
}

接下来可以在resources下新建META-INF/services/目录,然后新建接口全限定名的文件: com.test.spi.learn.Search

里面加上我们需要用到的实现类

com.test.spi.learn.FileSearch
com.test.spi.learn.DBSearch

然后写一个测试方法

package com.test.spi.learn;
import java.util.Iterator;
import java.util.ServiceLoader;

public class TestCase {
    public static void main(String[] args) {
        ServiceLoader<Search> s = ServiceLoader.load(Search.class);
        Iterator<Search> iterator = s.iterator();
        while (iterator.hasNext()) {
           Search search =  iterator.next();
           search.searchDoc("hello world");
        }
    }
}

可以看到输出结果:

文件搜索 hello world
数据库搜索 hello world

SPI原理解析

通过查看 ServiceLoader 的源码,梳理了一下,实现的流程如下:

  1. 应用程序调用ServiceLoader.load方法 ServiceLoader.load方法内先创建一个新的ServiceLoader,并实例化该类中的成员变量,包括以下:

loader(ClassLoader类型,类加载器) acc(AccessControlContext类型,访问控制器) providers(LinkedHashMap<String,S>类型,用于缓存加载成功的类) lookupIterator(实现迭代器功能)

  1. 应用程序通过迭代器接口获取对象实例 ServiceLoader先判断成员变量providers对象中(LinkedHashMap<String,S>类型)是否有缓存实例对象,

如果有缓存,直接返回。如果没有缓存,执行类的装载,实现如下:

(1) 读取META-INF/services/下的配置文件,获得所有能被实例化的类的名称,值得注意的是,ServiceLoader可以跨越jar包获取META-INF下的配置文件

(2) 通过反射方法Class.forName()加载类对象,并用instance()方法将类实例化。

(3) 把实例化后的类缓存到providers对象中,(LinkedHashMap<String,S>类型) 然后返回实例对象。

总结

优点

使用 SPI 机制的优势是实现 解耦 ,使得接口的定义与具体业务实现分离,而不是耦合在一起。应用进程可以根据实际业务情况启用或替换具体组件。

缺点

  1. 不能按需加载。虽然 ServiceLoader 做了延迟载入,但是基本只能通过遍历全部获取,也就是接口的实现类得全部载入并实例化一遍。如果你并不想用某些实现类,或者某些类实例化很耗时,它也被载入并实例化了,这就造成了浪费。
  2. 获取某个实现类的方式不够灵活,只能通过 Iterator 形式获取,不能根据某个参数来获取对应的实现类。
  3. 多个并发多线程使用 ServiceLoader 类的实例是不安全的。
  4. 加载不到实现类时抛出并不是真正原因的异常,错误很难定位。

看到上面这么多的缺点,你肯定会想,有这些弊端为什么还要使用呢,没错,在重构的过程中, SPI接口化 是一个非常有用的方式,当你需要 扩展的时候,适配的时候 ,越早地使用你就会受益越早,在一个 合适的时间,恰当的机会 的时候,就鼓起勇气,重构吧!

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,835评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,598评论 1 295
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,569评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,159评论 0 213
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,533评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,710评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,923评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,674评论 0 203
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,421评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,622评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,115评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,428评论 2 254
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,114评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,097评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,875评论 0 197
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,753评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,649评论 2 271

推荐阅读更多精彩内容