【Java工具类】中文转换成汉语拼音工具-pinyin4j

素颜马尾好姑娘i 2022-10-11 13:46 232阅读 0赞

pinyin4j是一个开源的java库，用来处理中文转换成拼音（汉语拼音，罗马拼音等），功能强大。

*  官网地址：[http://pinyin4j.sourceforge.net/][http_pinyin4j.sourceforge.net]
 *  在线文档：[http://pinyin4j.sourceforge.net/pinyin4j-doc/][http_pinyin4j.sourceforge.net_pinyin4j-doc]

**引入依赖**

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

**有几个常用的类：**

*  net.sourceforge.pinyin4j.PinyinHelper：：为中文转汉语拼音、中文转罗马拼音提供了一些方法  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxODc3NzI4NzE1_size_16_color_FFFFFF_t_70]
 *  net.sourceforge.pinyin4j.format.HanyuPinyinOutputFormat：用于设置汉语拼音字符串的输出格式
 *  net.sourceforge.pinyin4j.format.HanyuPinyinCaseType：如何输出汉语拼音、大写还是小写
 *  net.sourceforge.pinyin4j.format.HanyuPinyinToneType：如何输出拼音音调
 *  net.sourceforge.pinyin4j.format.HanyuPinyinVCharType：如何输出拼音音调为’ü’时的格式

**在JAVA 编程中我们经常免不了需要对中文排序，而往往我们排序的依据就是中文的首字母，当然无论依据什么排序，我们都需要将中文转换成为String,下面的工具类就可以做到这一点**

public class PingYinUtil { 
        /** * 将字符串中的中文转化为拼音,其他字符不变 * * @param chinese * @return */
        public static String getPingYin(String chinese) { 
            HanyuPinyinOutputFormat format = new HanyuPinyinOutputFormat();
           /* 设置转换后拼音的大小写 UPPERCASE：大写 (ZHONG) LOWERCASE：小写 (zhong) */
            format.setCaseType(HanyuPinyinCaseType.LOWERCASE);
          /* 设置转换后拼音是否输出拼接音调 WITHOUT_TONE：无音标 (zhong) WITH_TONE_NUMBER：1-4数字表示英标 (zhong4) WITH_TONE_MARK：直接用音标符（必须WITH_U_UNICODE否则异常） (zhòng) */
            format.setToneType(HanyuPinyinToneType.WITHOUT_TONE);
          /* 设置转换后拼音是否输出韵母 WITH_V：用v表示ü (nv) WITH_U_AND_COLON：用"u:"表示ü (nu:) WITH_U_UNICODE：直接用ü (nü) */
            format.setVCharType(HanyuPinyinVCharType.WITH_V);
    
            StringBuilder sb = new StringBuilder();
            char[] arr = chinese.trim().toCharArray();
            try { 
                for (char c : arr) { 
                    if (Character.toString(c).matches("[\\u4E00-\\u9FA5]+")) { 
                        //toHanyuPinyinStringArray有个容错判断 如果传入的不是汉字，就不能转换成拼音，那么直接返回null可以用正则表达式判断是否是中文,Character.toString(input[i]).matches("[\\u4E00-\\u9FA5]+")
                        String[] temp = PinyinHelper.toHanyuPinyinStringArray(c, format);
                        sb.append(temp[0]);
                        continue;
                    }
    
                    sb.append(c);
                }
            } catch (BadHanyuPinyinOutputFormatCombination e) { 
                e.printStackTrace();
            }
            return sb.toString();
        }
    
        /** * 获取汉字串拼音首字母，英文字符不变 * * @param chinese 汉字串 * @param type 小于等于0：取汉字串拼音首字母；大于0：获取汉字串全拼音 * @return 汉语拼音首字母 */
        public static String getPingYin(String chinese, int type) { 
            HanyuPinyinOutputFormat format = new HanyuPinyinOutputFormat();
           /* 设置转换后拼音的大小写 UPPERCASE：大写 (ZHONG) LOWERCASE：小写 (zhong) */
            format.setCaseType(HanyuPinyinCaseType.LOWERCASE);
          /* 设置转换后拼音是否输出拼接音调 WITHOUT_TONE：无音标 (zhong) WITH_TONE_NUMBER：1-4数字表示英标 (zhong4) WITH_TONE_MARK：直接用音标符（必须WITH_U_UNICODE否则异常） (zhòng) */
            format.setToneType(HanyuPinyinToneType.WITHOUT_TONE);
    
            StringBuilder sb = new StringBuilder();
            char[] arr = chinese.trim().toCharArray();
            try { 
                for (char c : arr) { 
                    //ASCII码表上一个128个字符,对应的索引为0-127,大于128表示非ASCII字符
                    if (c > 128) { 
                        //toHanyuPinyinStringArray有个容错判断 如果传入的不是汉字，就不能转换成拼音，那么直接返回null可以用正则表达式判断是否是中文,Character.toString(input[i]).matches("[\\u4E00-\\u9FA5]+")
                        String[] temp = PinyinHelper.toHanyuPinyinStringArray(c, format);
                        if (temp != null) { 
                            //输出全拼音
                            if (type <= 0) { 
                                sb.append(PinyinHelper.toHanyuPinyinStringArray(c, format)[0]);
                            }
                            //输出拼音首字母
                            else { 
                                sb.append(temp[0].charAt(0));
                            }
                        }
                        continue;
                    }
                    sb.append(c);
                }
            } catch (BadHanyuPinyinOutputFormatCombination e) { 
                e.printStackTrace();
            }
            return sb.toString().replaceAll("\\W", "").trim();
        }
    
        public static void main(String[] args) { 
            System.out.println(PingYinUtil.getPingYin("欧阳剑鹏"));
            System.out.println(PingYinUtil.getPingYin("欧阳剑鹏",0));
            System.out.println(PingYinUtil.getPingYin("欧阳剑鹏",1));
            System.out.println("------------------------");
            System.out.println(PingYinUtil.getPingYin("1欧a阳c剑@@鹏"));
            System.out.println(PingYinUtil.getPingYin("1欧a阳c剑@@鹏",0));
            System.out.println(PingYinUtil.getPingYin("1欧a阳c剑@@鹏",1));
        }
    }

测试结果

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxODc3NzI4NzE1_size_16_color_FFFFFF_t_70 1]

[http_pinyin4j.sourceforge.net]: http://pinyin4j.sourceforge.net/
[http_pinyin4j.sourceforge.net_pinyin4j-doc]: http://pinyin4j.sourceforge.net/pinyin4j-doc/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxODc3NzI4NzE1_size_16_color_FFFFFF_t_70]: /images/20221005/de7aa529acc04ecfa529f3d6d5f8a25d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxODc3NzI4NzE1_size_16_color_FFFFFF_t_70 1]: /images/20221005/5dbd5dbb43a246c7b980544211bf596f.png