「Java工具类」汉语转拼音工具类HanyuPinyinHelper.java

介绍语

本号主要是Java常用关键技术点，通用工具类的分享；以及springboot+springcloud+Mybatisplus+druid+mysql+redis+swagger+maven+docker等集成框架的技术分享；datax、kafka、flink等大数据处理框架的技术分享。文章会不断更新，欢迎码友关注点赞收藏转发！

望各位码友点击关注，冲1000粉。后面会录制一些视频教程，图文和视频结合，比如：图书介绍网站系统、抢购系统、大数据中台系统等。技术才是程序猿的最爱，码友们冲啊

如果码友觉得代码太长，可以从头到尾快速扫射一遍，了解大概即可。觉得有用后再转发收藏，以备不时之需。

正文：

拼音转换工具类，用到的场景比较少。

例子1#

 String s = "大师兄师傅被妖怪抓走了";
 System.out.println(HanyuPinyinHelper.toPinyin(s));
 System.out.println(HanyuPinyinHelper.toPinyinOfFirstLetter(s));
 ​
 System.out.println(HanyuPinyinHelper.getFirstLettersUpper(s));
 System.out.println(HanyuPinyinHelper.getFirstLettersLower(s));
 ​
 // 控制台输出
 dashixiongshifubeiyaoguaizhuazoule
 DaShiXiongShiFuBeiYaoGuaiZhuaZouLe
 DSXSFBYGZZL
 dsxsfbygzzl

工具类源码：

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 org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class HanyuPinyinHelper {

    private static final Logger LOGGER = LoggerFactory.getLogger(HanyuPinyinHelper.class);

    /**
     * 将文字转为汉语拼音
     *
     * @param chinese 要转成拼音的中文
     */
    public static String toPinyin(String chinese) {
        char[] cl_chars = chinese.trim().toCharArray();
        StringBuilder hanyupinyin = new StringBuilder();
        HanyuPinyinOutputFormat defaultFormat = format();
        try {
            for (int i = 0; i < cl_chars.length; i++) {
                // 如果字符是中文,则将中文转为汉语拼音
                if (String.valueOf(cl_chars[i]).matches("[\u4e00-\u9fa5]+")) {
                    hanyupinyin.append(PinyinHelper.toHanyuPinyinStringArray(cl_chars[i], defaultFormat)[0]);
                } else {// 如果字符不是中文,则不转换
                    hanyupinyin.append(cl_chars[i]);
                }
            }
        } catch (BadHanyuPinyinOutputFormatCombination e) {
            LOGGER.error("字符不能转成汉语拼音", e);
        }
        return hanyupinyin.toString();
    }

    /**
     * 将文字转为汉语拼音
     *
     * @param chinese 要转成拼音的中文
     */
    public static String toPinyinOfFirstLetter(String chinese) {
        char[] cl_chars = chinese.trim().toCharArray();
        StringBuilder hanyupinyin = new StringBuilder();
        HanyuPinyinOutputFormat defaultFormat = format();
        try {
            for (int i = 0; i < cl_chars.length; i++) {
                String str = String.valueOf(cl_chars[i]);
                // 如果字符是中文,则将中文转为汉语拼音
                if (str.matches("[\u4e00-\u9fa5]+")) {
                    //多音字只取第一个
                    String s = PinyinHelper.toHanyuPinyinStringArray(cl_chars[i], defaultFormat)[0];
                    char firstLetter = s.charAt(0);
                    String pinyin = String.valueOf(firstLetter).toUpperCase().concat(s.substring(1));
                    hanyupinyin.append(pinyin);
                } else {
                    // 如果字符不是中文,则不转换
                    hanyupinyin.append(cl_chars[i]);
                }
            }
        } catch (BadHanyuPinyinOutputFormatCombination e) {
            LOGGER.error("字符不能转成汉语拼音", e);
        }
        return hanyupinyin.toString();
    }

    public static String getFirstLettersUpper(String chinese) {
        return getFirstLetters(chinese, HanyuPinyinCaseType.UPPERCASE);
    }

    public static String getFirstLettersLower(String chinese) {
        return getFirstLetters(chinese, HanyuPinyinCaseType.LOWERCASE);
    }

    private static String getFirstLetters(String chinese, HanyuPinyinCaseType caseType) {
        char[] cl_chars = chinese.trim().toCharArray();
        StringBuilder hanyupinyin = new StringBuilder();
        HanyuPinyinOutputFormat defaultFormat = new HanyuPinyinOutputFormat();
        // 输出拼音全部大写
        defaultFormat.setCaseType(caseType);
        // 不带声调
        defaultFormat.setToneType(HanyuPinyinToneType.WITHOUT_TONE);
        try {
            for (int i = 0; i < cl_chars.length; i++) {
                String str = String.valueOf(cl_chars[i]);

                if (str.matches("[\u4e00-\u9fa5]+")) {
                    // 如果字符是中文,则将中文转为汉语拼音,并取第一个字母
                    hanyupinyin.append(
                            PinyinHelper.toHanyuPinyinStringArray(cl_chars[i], defaultFormat)[0].substring(0, 1));
                } else if (str.matches("[0-9]+")) {
                    // 如果字符是数字,取数字
                    hanyupinyin.append(cl_chars[i]);
                } else if (str.matches("[a-zA-Z]+")) {
                    // 如果字符是字母,取字母
                    hanyupinyin.append(cl_chars[i]);
                } else {// 否则不转换
                    hanyupinyin.append(cl_chars[i]);
                }
            }
        } catch (BadHanyuPinyinOutputFormatCombination e) {
            LOGGER.error("字符不能转成汉语拼音", e);
        }
        return hanyupinyin.toString();
    }

    private static HanyuPinyinOutputFormat format() {
        HanyuPinyinOutputFormat defaultFormat = new HanyuPinyinOutputFormat();
        // 输出拼音全部小写
        defaultFormat.setCaseType(HanyuPinyinCaseType.LOWERCASE);
        // 不带声调
        defaultFormat.setToneType(HanyuPinyinToneType.WITHOUT_TONE);
        defaultFormat.setVCharType(HanyuPinyinVCharType.WITH_V);

        return defaultFormat;
    }


    public static void main(String[] args) {
        String s = "大师兄师傅被妖怪抓走了";
        System.out.println(HanyuPinyinHelper.toPinyin(s));
        System.out.println(HanyuPinyinHelper.toPinyinOfFirstLetter(s));

        System.out.println(HanyuPinyinHelper.getFirstLettersUpper(s));
        System.out.println(HanyuPinyinHelper.getFirstLettersLower(s));

    }
}

maven依赖包

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

鄙人编码十年多，在项目中也积累了一些工具类，很多工具类在每个项目都有在用，很实用。大部分是鄙人封装的，有些工具类是同事封装的，有些工具类已经不记得是ctrl+c的还是自己封装的了，现在有空就会总结项目中大部分的工具类，分享给各位码友。如果文章中涉及的代码有侵权行为请通知鄙人处理。

计划是先把工具类整理出来，正所谓工欲善其事，必先利其器。项目中不管是普通单体项目还是多模块maven项目或是分布式微服务，一部分功能模块都是可以重用的，工具类模块就是其中之一。