架构之第三方框架pinyin4j与hutool搭配使用原理

胡斌附体2024-03-30 15:08

一、工作原理

Hutool工具将包括pinyin4j等翻译工具插件绑定。实现通过spi接口的方式实现调用，底层实现可自由切换
注：Hutool绑定的pinyin插件有如下图几种。也就是没有添加maven依赖如pinyin4j等拼音插件。

注：若没有依赖pinyin插件。使用时会报如下错误。但是通过接下来要说的通过SPI即可不是用插件也能自己制作pinyin实现类，并通过Hutool工具类调用

二、SPI接口实现（自定义实现类对接Hutool pinyin工具）

1. 什么是SPI

注：是一种服务发现机制，为很多框架拓展提供了可能。
注：此处是重点 源码中链接阅读文章SPI机制》》深入理解SPI机制》》

2. 链接来源

注：链接从源码类的注释中获取

三、编码实现和测试

注：操作内容包括。添加依赖，main，打印数据

1. maven依赖

xml 复制代码

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

2. 自定义实现

注：通过理解学习如何使用SPI机制，创建自己的pinyin翻译类

java 复制代码

package org.home;

import cn.hutool.extra.pinyin.PinyinEngine;

public class LocalPinYin implements PinyinEngine {
    public String getPinyin(char c) {
        return "getPinyin 济南 c";
    }

    public String getPinyin(String str, String separator) {
        return "getpinyin 济南 str";
    }
}

3. 执行输出

注：通过main方法输出自定义pinyin实现类返回的内容

# 输出加载到的实现类。可以在main方法中通过执行Hutool工具类加载SPI接口实现类的方式检查创建SPI实现类是否可以成功调阅。
PinyinEngine engine = ServiceLoaderUtil.loadFirstAvailable(PinyinEngine.class);
System.out.println(engine);

4. ServiceLoad.load类加载

注：Hutool内部使用jdk的Service.load加载类。

总结

1. 勤于思考，还能发现更多问题。

注：从Hutool中知道了SPI, 但是pinyin4j中并没有查看到META-INF/services的存在，反想查看，他却在Hutool的肚子里

2. 使用SPI的框架的优点

注：能够灵活的使用相同功能的不同插件。 通俗讲 想用的插件通过更换mvn依赖即可 精髓在这，特别方便