一个汉字转拼音的工具类，用于快速模糊查询的匹配

本文链接：https://blog.csdn.net/m0_68568763/article/details/135073318

汉字转拼音的应用场景

搜索引擎和网站搜索： 在搜索引擎或网站中，用户可以使用汉字输入查询关键词，而系统通过将汉字转换为拼音来实现模糊查询。这样，用户即使输入的是汉字，系统也能找到相关的拼音匹配结果，提高搜索的灵活性和准确性。
通讯录和联系人管理： 在手机通讯录或其他联系人管理应用中，用户可以通过输入汉字的首字母或拼音的一部分来查找联系人。这简化了查找过程，特别是在通讯录中包含大量联系人的情况下。
商品搜索和电子商务平台： 电子商务平台通常需要处理大量商品信息。用户可以通过输入商品名称的汉字或拼音来查找目标商品，提高了用户对商品的检索便捷性。
拼音输入法： 在拼音输入法中，用户可以通过输入汉字的拼音首字母或全拼来选择和输入文字。这种方式使得用户能够更快速地找到并输入想要的文字。

好处：

用户友好性： 汉字转拼音的用户模糊查询提供了更为灵活和便捷的搜索方式，让用户可以按照熟悉的汉字方式进行输入，同时享受拼音搜索的方便性。
提高搜索准确性： 汉字转拼音查询可以帮助纠正用户的输入错误，例如拼写错误或输入法错误。这样能够提高搜索引擎、应用或平台的查询准确性。
适应不同用户： 对于不同地区和使用习惯的用户，提供汉字转拼音的查询方式是一种通用的解决方案，使得应用更容易被广泛接受。
数据展示的一致性： 在数据库中使用拼音作为索引，可以使得数据的检索和展示更为一致，无论用户使用汉字还是拼音，都能得到相似的结果，提高了用户体验。

总的来说，汉字转拼音用户模糊查询的应用场景涵盖了各个领域，它不仅提高了用户体验，还为系统提供了更智能、更灵活的搜索和数据管理方式。

汉字转拼音的工具类代码

话不多说，我们来看以下汉字转拼音工具类的具体实现代码吧！

引入pinyin4j依赖

<dependency>
    <groupId>com.belerweb</groupId>
    <artifactId>pinyin4j</artifactId>
    <version>2.5.0</version>
</dependency>

具体实现代码

import net.sourceforge.pinyin4j.PinyinHelper;
import net.sourceforge.pinyin4j.format.HanyuPinyinCaseType;
import net.sourceforge.pinyin4j.format.HanyuPinyinOutputFormat;
import net.sourceforge.pinyin4j.format.HanyuPinyinToneType;
import net.sourceforge.pinyin4j.format.HanyuPinyinVCharType;
import net.sourceforge.pinyin4j.format.exception.BadHanyuPinyinOutputFormatCombination;

import java.util.*;

/**
 * @Author: Liu
 * @Date: 2023/12/18 19: 39
 * @Description: 依赖于Pinyin4j的第三方库，用于将汉字转化为拼音的组合以便进行拼音的模糊查询的工具类
 */
public class PinyinUtils {
    /**
     * generateLookup静态方法：用于将汉字转化为拼音的组合以便进行拼音
     * String参数：等待转化的汉字字符串
     * String返回值：汉字本身和其的拼音组合
     */
    public static String generateLookup(String chinese) {
        String chineseLowerCase = chinese.toLowerCase();
        ArrayList<String> fullPinyinList = toPinyinList(chineseLowerCase);
        ArrayList<String> initialPinyinList = toPinyinFirstLetterList(fullPinyinList);
        HashSet<String> set = new HashSet<>();
        set.add(chineseLowerCase);
        for (String fullPinyin : fullPinyinList) {
            set.add(fullPinyin);
            set.add(fullPinyin.replaceAll("\\s+", ""));
            for (String initialPinyin : initialPinyinList) {
                set.addAll(generatePartLookup(initialPinyin, fullPinyin));
            }
        }
        StringBuilder sb = new StringBuilder();
        for (String s : set) {
            sb.append(s).append(" ");
        }
        for (String s : initialPinyinList) {
            sb.append(s).append(" ");
        }
        return sb.toString();
    }
    /**
     * generatePartLookup静态方法：从完整拼音中生成各种可能的拼音组合，并将它们存储在哈希集合中
     * String参数：initialPinyin，汉字的拼音首字母
     * String参数：fullPinyin，汉字完整的拼音
     * HashSet<String>返回值：汉字完整拼音的不同组合
     */
    private static HashSet<String> generatePartLookup(String initialPinyin, String fullPinyin) {
        HashSet<String> set = new HashSet<>();
        String[] pys = fullPinyin.split("\\s+");
        for (int i = 1; i < pys.length; i++) {
            StringBuilder sb = new StringBuilder();
            sb.append(initialPinyin, 0, i);
            for (int j = i; j < pys.length; j++) {
                sb.append(pys[j]);
            }
            set.add(sb.toString());
        }
        return set;
    }
    /**
     * toPinyinFirstLetterList私有方法：将输入的汉字拼音集合转换为拼音首字母集合
     * ArrayList<String>参数：fullPinyinList，汉字拼音集合
     * ArrayList<String>返回值：汉字拼音首字母集合
     */
    private static ArrayList<String> toPinyinFirstLetterList(ArrayList<String> fullPinyinList) {
        HashSet<String> set = new HashSet<>();
        for (String fullPinyin : fullPinyinList) {
            String initial = fullPinyin2FirstLetter(fullPinyin);
            if (initial.trim().length() != 0) {
                set.add(initial);
            }
        }
        return new ArrayList<>(set);
    }
    /**
     * fullPinyin2FirstLetter：将输入的汉字拼音转换为拼音首字母集合
     * ArrayList<String>参数：fullPinyin，汉字拼音
     * ArrayList<String>返回值：汉字拼音首字母
     */
    private static String fullPinyin2FirstLetter(String fullPinyin) {
        if (Objects.nonNull(fullPinyin) && fullPinyin.trim().length() != 0) {
            StringBuilder sb = new StringBuilder();
            String[] pys = fullPinyin.split("\\s+");
            for (String py : pys) {
                sb.append(py.charAt(0));
            }
            return sb.toString();
        }
        return "";
    }
    /**
     * toPinyinList私有方法：将汉字转化为拼音集合
     * String参数：chinese，等待转换为拼音的汉字
     * ArrayList<String>返回值：汉字对应的拼音集合
     */
    private static ArrayList<String> toPinyinList(String chinese) {
        ArrayList<String[]> splitList = toPinyinSplitList(chinese);
        return Split2String(splitList);
    }
    /**
     * Split2String私有方法：将输入的字符串数组集合进行组合，生成包含所有可能组合的字符串集合，并且保持相对顺序
     * ArrayList<String[]>参数：splitList，汉字对应拼音的集合
     * ArrayList<String>返回值：包含拼音组合情况的字符串集合
     */
    private static ArrayList<String> Split2String(ArrayList<String[]> splitList) {
        ArrayList<String> out = new ArrayList<>();
        if (Objects.isNull(splitList) || splitList.size() == 0) {
            return out;
        }
        Collections.addAll(out, splitList.get(0));
        for (int i = 1; i < splitList.size(); i ++) {
            int size = out.size();
            String[] strings = splitList.get(i);
            if (strings.length > 1) {
                ArrayList<String> temp = new ArrayList<>(out);
                for (int j = 1; j < strings.length; j++) {
                    out.addAll(temp);
                }
            }
            for (int j = 0; j < out.size(); j++) {
                int index = j / out.size();
                out.set(j, out.get(j) + " " + strings[index]);
            }
        }
        return out;
    }
    /**
     * toPinyinSplitList私有方法：将汉字字符串中的每个汉字转化为拼音集合，包含多音字的情况
     * String参数：chinese，等待转换为拼音的汉字
     * ArrayList<String[]>返回值：返回汉字字符串中的每个汉字拼音的多音字集合
     */
    private static ArrayList<String[]> toPinyinSplitList(String chinese) {
        ArrayList<String[]> list = new ArrayList<>();
        HanyuPinyinOutputFormat format = new HanyuPinyinOutputFormat();
        format.setCaseType(HanyuPinyinCaseType.LOWERCASE);
        format.setToneType(HanyuPinyinToneType.WITHOUT_TONE);
        format.setVCharType(HanyuPinyinVCharType.WITH_V);
        for(int i = 0; i < chinese.length(); i ++) {
            char pending = chinese.charAt(i);
            if (pending > 128) {
                try {
                    String[] pys = PinyinHelper.toHanyuPinyinStringArray(pending, format);
                    if (Objects.nonNull(pys)) {
                        list.add(new HashSet<>(Arrays
                                    .asList(pys))
                                .toArray(new String[]{}));
                    }
                } catch (BadHanyuPinyinOutputFormatCombination e) {
                    throw new RuntimeException(e);
                }
            }
        }
        return list;
    }
}

工具类测试

该工具的应用场景主要是将汉字分割为各种可能的拼音组合，以便为项目搜索方面的功能提供灵活性和便利性。以下用城市的例子来测试工具类的具体实现效果：

import org.junit.Test;

/**
 * @Author: Liu
 * @Date: 2023/12/18 22: 53
 * @Description:
 */
public class TestPinyinUtils {
    @Test
    public void testUtils() {
        System.out.println(PinyinUtils.generateLookup("长沙"));
        System.out.println(PinyinUtils.generateLookup("成都"));
        System.out.println(PinyinUtils.generateLookup("北京"));
        System.out.println(PinyinUtils.generateLookup("重庆"));
        System.out.println(PinyinUtils.generateLookup("厦门"));
        System.out.println(PinyinUtils.generateLookup("三亚"));
        System.out.println(PinyinUtils.generateLookup("杭州"));
        System.out.println(PinyinUtils.generateLookup("宁波"));
        System.out.println(PinyinUtils.generateLookup("山东"));
        System.out.println(PinyinUtils.generateLookup("青岛"));
        System.out.println(PinyinUtils.generateLookup("济南"));
        System.out.println(PinyinUtils.generateLookup("哈尔滨"));
        System.out.println(PinyinUtils.generateLookup("西藏"));
        System.out.println(PinyinUtils.generateLookup("乌鲁木齐"));
    }
}