当前位置: 首页 > news >正文

Java SPI机制详解-01

1. 概述

SPI(Service Provider Interface),是 Java 6 引入了一个内置功能,实现服务提供发现和加载机制,使之与特定接口的匹配。

SPI 机制的核心思想就是 解耦 ,将装配的控制权移到程序之外,这在企业模块化设计中非常重要。

有的人喜欢拿 SPIAPI 之间做比较,关于二者之间的差异主要在于侧重点不一样。

  • API :侧重 调用 并用于实现目标的类、接口、方法等的描述;
  • SPI :侧重对已实现目标类、接口、方法的 扩展和实现

20230808170610

2. 使用场景

调用者根据实际使用需要,启用、扩展、或者替换框架的实现策略。

  • 数据库驱动加载接口实现类的加载: JDBC 加载不同类型数据库的驱动

  • 日志门面接口实现类加载:SLF4J 加载不同提供商的日志实现类

  • Spring 框架:Spring 中大量使用 SPI ,比如:对 Servlet3.0 规范对 ServletContainerInitializer 的实现、自动类型转换 Type Conversion SPI(Converter SPI、Formatter SPI)

3. 入门使用介绍

在实际使用 SPI 需要遵循以下约定:

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

4. 示例

4.1. 构建接口

此处演示作用,只定义一组接口,接口为 灵长类 动物,它包含一个方法, 叫 动作


package io.github.rothschil.spi.framework;/*** 灵长类动物* @author <a href="mailto:WCNGS@QQ.COM">Sam</a>* @version 1.0.0*/
public interface Primate {void action();
}

4.2. 拓展实现

灵长类 这个接口,我们假定它的实现为人类 、猴子,它们都能有属于自己的动物。

  • 人类

package io.github.rothschil.spi.framework.impl;import io.github.rothschil.spi.framework.Primate;public class Human implements Primate {@Overridepublic void action() {System.out.println("Human");}
}
  • 猴子

package io.github.rothschil.spi.framework.impl;import io.github.rothschil.spi.framework.Primate;public class Monkey implements Primate {@Overridepublic void action() {System.out.println("Monkey");}
}

4.3. 构建META-INF下文件

  • 文件路径: resources/META-INF/services
  • 文件名: io.github.rothschil.spi.framework.Primate
  • 文件内容:

io.github.rothschil.spi.framework.impl.Human
io.github.rothschil.spi.framework.impl.Monkey

4.4. 验证

此处用到 ServiceLoader 类加载器,通过 Primate.class 将它的实现以此加载到 JVM 中。

4.5. 结果

验证结果


package io.github.rothschil.spi.framework;import java.util.ServiceLoader;public class TestSpi {public static void main(String[] args) {ServiceLoader<Primate> primates = ServiceLoader.load(Primate.class);for (Primate pr : primates) {pr.action();}}
}

4.5.1. ServiceLoader

ServiceLoader

属性图

ServiceLoader 本身就是一个迭代器,它的属性并不多,我们以 ServiceLoader.load 为入口,一步一步看下去。

  • 调用 ServiceLoader.load 根据当前线程调用类记载器 ClassLoader 利用 ServiceLoader 构造器,创建一个实例。
    • 类加载器
    • 访问控制器
    • 目标类
    • 迭代器
  • ServiceLoader 先判断成员变量 providers 对象中(LinkedHashMap<String,S>类型)是否有缓存实例对象,如果有缓存,直接返回
    • 读取 META-INF/services/ 下的配置文件,获得所有能被实例化的类的名称,值得注意的是, ServiceLoader 可以跨越 jar 包获取 META-INF 下的配置文件
    • 通过反射方法Class.forName()加载类对象,并用instance()方法将类实例化
    • 把实例化后的类缓存到providers对象中,(LinkedHashMap<String,S>类型)然后返回实例对象
public final class ServiceLoader<S>implements Iterable<S>
{private static final String PREFIX = "META-INF/services/";// The class or interface representing the service being loadedprivate final Class<S> service;// The class loader used to locate, load, and instantiate providersprivate final ClassLoader loader;// The access control context taken when the ServiceLoader is createdprivate final AccessControlContext acc;// Cached providers, in instantiation orderprivate LinkedHashMap<String,S> providers = new LinkedHashMap<>();// The current lazy-lookup iteratorprivate LazyIterator lookupIterator;/*** Clear this loader's provider cache so that all providers will be* reloaded.** <p> After invoking this method, subsequent invocations of the {@link* #iterator() iterator} method will lazily look up and instantiate* providers from scratch, just as is done by a newly-created loader.** <p> This method is intended for use in situations in which new providers* can be installed into a running Java virtual machine.*/public void reload() {providers.clear();lookupIterator = new LazyIterator(service, loader);}private ServiceLoader(Class<S> svc, ClassLoader cl) {service = Objects.requireNonNull(svc, "Service interface cannot be null");loader = (cl == null) ? ClassLoader.getSystemClassLoader() : cl;acc = (System.getSecurityManager() != null) ? AccessController.getContext() : null;reload();}

5. 总结

这是我们第一篇 SPI 描述,主要引入它的几个概念、用途以及与我们 API 的区别,最后我们通过一个手写的样例,虽然通过 ServiceLoader 加载的,在实际生产环境中,这存在注入线程安全以及不够灵活注入从而导致资源开销大等问题,但是这只为我们 SPI 学习加深理解,算开启正式 SPI 之旅。

http://www.lryc.cn/news/122324.html

相关文章:

  • 由浅入深C系列六:C中实现字符串trim的功能
  • 博客网站添加复制转载提醒弹窗Html代码
  • ubuntu下nfs服务安装
  • Unity框架学习--2
  • WebRTC音视频通话-实现GPUImage视频美颜滤镜效果iOS
  • 82. 删除排序链表中的重复元素 II
  • centos 7.x 单用户模式
  • 取证--理论
  • Tik Tok娱乐+电商MCN怎么做?
  • java 自定义xss校验注解实现
  • Selenium图片滑块验证码
  • CAP理论与MongoDB一致性,可用性的一些思考
  • lc2536.子矩阵元素加1
  • C#使用OpenCv(OpenCVSharp)图像全局二值化处理实例
  • Patch SCN一键解决ORA-600 2662故障---惜分飞
  • const、指针、引用的综合
  • gitee linux免密/SSH 方式连接免登录
  • 计网第一章
  • windows升级记
  • 【Windows 常用工具系列 5 -- Selenium IDE的使用方法 】
  • 现代无人机技术
  • 【机器学习 | 数据预处理】 提升模型性能,优化特征表达:数据标准化和归一化的数值处理技巧探析
  • 渐进增强和优雅降级区别
  • 使用provision创建的arxml文件,导入到第三方工具需要注意哪些方面?
  • Node.js的核心模块——path
  • 【MAC】 M2 brew安装 docker 运行失败 解决
  • iPhone苹果手机触屏失灵无法关机,如何强制重启
  • SQL-每日一题【1484. 按日期分组销售产品】
  • java重写与重载的区别
  • Unity 框架学习--1