Java汉字转拼音类库Pinyin4j详细使用方法与实例

 更新时间:2020年02月20日 15:18:34   转载 作者:小a玖拾柒  
这篇文章主要介绍了Java汉字转拼音类库Pinyin4j详细使用方法与实例,需要的朋友可以参考下

汉字转拼音类库Pinyin4j一般用法

pinyin4j的使用很方便,一般转换只需要使用PinyinHelper类的静态工具方法即可:

String[] pinyin = PinyinHelper.toHanyuPinyinStringArray(‘刘');
//该类还有其他的拼音转换形式,但是基本上用不到,就不介绍了

返回的数组即是该字符的拼音,如上例就是pinyin[0]=liu2,后面的数字代表声调,声调为5表示轻读,无声调。之所谓返回数组,是因为被判定的汉字有可能有多个读音。如果输入的参数不是汉字,则返回null。

拼音格式化

如果对于拼音转换后的结果有一些特定的格式要求目前pinyin4j支持:

声调格式化。例如:“刘”字的格式化后为“liu2”或“liu”或“liú”

对特殊拼音ü的的显示格式。例如“u:”或“v”或“ü”

大小写的转换。例如:“liu2”或“LIU2”

以上这些格式可以混合使用,下面就来介绍具体的使用方法,首先需要创建格式化对象HanyuPinyinOutputFormat,例如:

HanyuPinyinOutputFormat outputFormat = new HanyuPinyinOutputFormat();

然后分别调用outputFormat的set方法设置上述一些格式要求:

设置声调格式:

outputFormat.setToneType(HanyuPinyinToneType);

方法参数HanyuPinyinToneType有以下常量对象:

HanyuPinyinToneType.WITH_TONE_NUMBER 用数字表示声调,例如:liu2

HanyuPinyinToneType.WITHOUT_TONE 无声调表示,例如:liu

HanyuPinyinToneType.WITH_TONE_MARK 用声调符号表示,例如:liú

设置特殊拼音ü的显示格式:

outputFormat.setVCharType(HanyuPinyinVCharType);

方法参数HanyuPinyinVCharType有以下常量对象:

HanyuPinyinVCharType.WITH_U_AND_COLON 以U和一个冒号表示该拼音,例如:lu:

HanyuPinyinVCharType.WITH_V 以V表示该字符,例如:lv

HanyuPinyinVCharType.WITH_U_UNICODE 以ü表示

设置大小写格式

outputFormat.setCaseType(HanyuPinyinCaseType);

HanyuPinyinCaseType.LOWERCASE 转换后以全小写方式输出

HanyuPinyinCaseType.UPPERCASE 转换后以全大写方式输出

设置好格式对象后还是利用上述的工具类方法进行拼音转换,只不过需要将格式化对象当成方法参数传入转换方法,告知要转换的格式要求:

String[] pinyin = PinyinHelper.toHanyuPinyinStringArray(‘刘', outputFormat);

但该方法会有异常抛出,注意处理。

示例

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;
public class Test {
  public static void main(String[] args) {
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;
public class Test {
  public static void main(String[] args) {
    HanyuPinyinOutputFormat outputFormat = new HanyuPinyinOutputFormat();
    outputFormat.setToneType(HanyuPinyinToneType.WITH_TONE_MARK);
    outputFormat.setVCharType(HanyuPinyinVCharType.WITH_U_UNICODE);
    outputFormat.setCaseType(HanyuPinyinCaseType.UPPERCASE);
    try {
      System.out.println(concatPinyinStringArray(PinyinHelper.toHanyuPinyinStringArray('刘',outputFormat)));
    } catch (BadHanyuPinyinOutputFormatCombination e) {
      // TODO Auto-generated catch block
      e.printStackTrace();
    }
  }
  
  private static String concatPinyinStringArray(String[] pinyinArray)
  {
    StringBuffer pinyinStrBuf = new StringBuffer();
    if ((null != pinyinArray) && (pinyinArray.length > 0))
    {
      for (int i = 0; i < pinyinArray.length; i++)
      {
        pinyinStrBuf.append(pinyinArray[i]);
        pinyinStrBuf.append(System.getProperty("line.separator"));
      }
    }
    String outputString = pinyinStrBuf.toString();
    return outputString;
  }
}

输出结果为:LIú

其他

PinyinHelper还有其他的静态方法,但示例和讲解中使用的方法是常见的拼音格式,因此其他静态方法我没有调研其含义。

貌似支持生僻字,我试过很怪异的字,都可以将其读音拼写出来,因此这个工具包还是很强的。

拼音工具

package cn.itcast.bos.utils;

import java.util.Arrays;

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.exception.BadHanyuPinyinOutputFormatCombination;

public class PinYin4jUtils {
  /**
   * 将字符串转换成拼音数组
   * 
   * @param src
   * @return
   */
  public static String[] stringToPinyin(String src) {
    return stringToPinyin(src, false, null);
  }

  /**
   * 将字符串转换成拼音数组
   * 
   * @param src
   * @return
   */
  public static String[] stringToPinyin(String src, String separator) {

    return stringToPinyin(src, true, separator);
  }

  /**
   * 将字符串转换成拼音数组
   * 
   * @param src
   * @param isPolyphone
   *      是否查出多音字的所有拼音
   * @param separator
   *      多音字拼音之间的分隔符
   * @return
   */
  public static String[] stringToPinyin(String src, boolean isPolyphone,
      String separator) {
    // 判断字符串是否为空
    if ("".equals(src) || null == src) {
      return null;
    }
    char[] srcChar = src.toCharArray();
    int srcCount = srcChar.length;
    String[] srcStr = new String[srcCount];

    for (int i = 0; i < srcCount; i++) {
      srcStr[i] = charToPinyin(srcChar[i], isPolyphone, separator);
    }
    return srcStr;
  }

  /**
   * 将单个字符转换成拼音
   * 
   * @param src
   * @return
   */
  public static String charToPinyin(char src, boolean isPolyphone,
      String separator) {
    // 创建汉语拼音处理类
    HanyuPinyinOutputFormat defaultFormat = new HanyuPinyinOutputFormat();
    // 输出设置,大小写,音标方式
    defaultFormat.setCaseType(HanyuPinyinCaseType.LOWERCASE);
    defaultFormat.setToneType(HanyuPinyinToneType.WITHOUT_TONE);

    StringBuffer tempPinying = new StringBuffer();

    // 如果是中文
    if (src > 128) {
      try {
        // 转换得出结果
        String[] strs = PinyinHelper.toHanyuPinyinStringArray(src,
            defaultFormat);

        // 是否查出多音字,默认是查出多音字的第一个字符
        if (isPolyphone && null != separator) {
          for (int i = 0; i < strs.length; i++) {
            tempPinying.append(strs[i]);
            if (strs.length != (i + 1)) {
              // 多音字之间用特殊符号间隔起来
              tempPinying.append(separator);
            }
          }
        } else {
          tempPinying.append(strs[0]);
        }

      } catch (BadHanyuPinyinOutputFormatCombination e) {
        e.printStackTrace();
      }
    } else {
      tempPinying.append(src);
    }

    return tempPinying.toString();

  }

  public static String hanziToPinyin(String hanzi) {
    return hanziToPinyin(hanzi, " ");
  }

  /**
   * 将汉字转换成拼音
   * 
   * @param hanzi
   * @param separator
   * @return
   */
  public static String hanziToPinyin(String hanzi, String separator) {

    // 创建汉语拼音处理类
    HanyuPinyinOutputFormat defaultFormat = new HanyuPinyinOutputFormat();
    // 输出设置,大小写,音标方式
    defaultFormat.setCaseType(HanyuPinyinCaseType.LOWERCASE);
    defaultFormat.setToneType(HanyuPinyinToneType.WITHOUT_TONE);

    String pinyingStr = "";
    try {
      pinyingStr = PinyinHelper.toHanyuPinyinString(hanzi, defaultFormat,
          separator);
    } catch (BadHanyuPinyinOutputFormatCombination e) {
      // TODO Auto-generated catch block
      e.printStackTrace();
    }
    return pinyingStr;
  }

  /**
   * 将字符串数组转换成字符串
   * 
   * @param str
   * @param separator
   *      各个字符串之间的分隔符
   * @return
   */
  public static String stringArrayToString(String[] str, String separator) {
    StringBuffer sb = new StringBuffer();
    for (int i = 0; i < str.length; i++) {
      sb.append(str[i]);
      if (str.length != (i + 1)) {
        sb.append(separator);
      }
    }
    return sb.toString();
  }

  /**
   * 简单的将各个字符数组之间连接起来
   * 
   * @param str
   * @return
   */
  public static String stringArrayToString(String[] str) {
    return stringArrayToString(str, "");
  }

  /**
   * 将字符数组转换成字符串
   * 
   * @param str
   * @param separator
   *      各个字符串之间的分隔符
   * @return
   */
  public static String charArrayToString(char[] ch, String separator) {
    StringBuffer sb = new StringBuffer();
    for (int i = 0; i < ch.length; i++) {
      sb.append(ch[i]);
      if (ch.length != (i + 1)) {
        sb.append(separator);
      }
    }
    return sb.toString();
  }

  /**
   * 将字符数组转换成字符串
   * 
   * @param str
   * @return
   */
  public static String charArrayToString(char[] ch) {
    return charArrayToString(ch, " ");
  }

  /**
   * 取汉字的首字母
   * 
   * @param src
   * @param isCapital
   *      是否是大写
   * @return
   */
  public static char[] getHeadByChar(char src, boolean isCapital) {
    // 如果不是汉字直接返回
    if (src <= 128) {
      return new char[] { src };
    }
    // 获取所有的拼音
    String[] pinyingStr = PinyinHelper.toHanyuPinyinStringArray(src);

    // 创建返回对象
    int polyphoneSize = pinyingStr.length;
    char[] headChars = new char[polyphoneSize];
    int i = 0;
    // 截取首字符
    for (String s : pinyingStr) {
      char headChar = s.charAt(0);
      // 首字母是否大写,默认是小写
      if (isCapital) {
        headChars[i] = Character.toUpperCase(headChar);
      } else {
        headChars[i] = headChar;
      }
      i++;
    }

    return headChars;
  }

  /**
   * 取汉字的首字母(默认是大写)
   * 
   * @param src
   * @return
   */
  public static char[] getHeadByChar(char src) {
    return getHeadByChar(src, true);
  }

  /**
   * 查找字符串首字母
   * 
   * @param src
   * @return
   */
  public static String[] getHeadByString(String src) {
    return getHeadByString(src, true);
  }

  /**
   * 查找字符串首字母
   * 
   * @param src
   * @param isCapital
   *      是否大写
   * @return
   */
  public static String[] getHeadByString(String src, boolean isCapital) {
    return getHeadByString(src, isCapital, null);
  }

  /**
   * 查找字符串首字母
   * 
   * @param src
   * @param isCapital
   *      是否大写
   * @param separator
   *      分隔符
   * @return
   */
  public static String[] getHeadByString(String src, boolean isCapital,
      String separator) {
    char[] chars = src.toCharArray();
    String[] headString = new String[chars.length];
    int i = 0;
    for (char ch : chars) {

      char[] chs = getHeadByChar(ch, isCapital);
      StringBuffer sb = new StringBuffer();
      if (null != separator) {
        int j = 1;

        for (char ch1 : chs) {
          sb.append(ch1);
          if (j != chs.length) {
            sb.append(separator);
          }
          j++;
        }
      } else {
        sb.append(chs[0]);
      }
      headString[i] = sb.toString();
      i++;
    }
    return headString;
  }
  
  public static void main(String[] args) {
    // pin4j 简码 和 城市编码 
    String s1 = "中华人民共和国"; 
    String[] headArray = getHeadByString(s1); // 获得每个汉字拼音首字母
    System.out.println(Arrays.toString(headArray));
    
    String s2 ="长城" ; 
    System.out.println(Arrays.toString(stringToPinyin(s2,true,",")));
    
    String s3 ="长";
    System.out.println(Arrays.toString(stringToPinyin(s3,true,",")));
  }
}

更多关于Java汉字转拼音类库Pinyin4j详细使用方法与实例请查看下面的相关链接

相关文章

  • Java实现链表中元素的获取、查询和修改方法详解

    Java实现链表中元素的获取、查询和修改方法详解

    这篇文章主要介绍了Java实现链表中元素的获取、查询和修改方法,结合实例形式详细分析了Java针对链表中元素的获取、查询和修改相关原理、实现方法及操作注意事项,需要的朋友可以参考下
    2020-03-03
  • SpringBoot实现发送短信的示例代码

    SpringBoot实现发送短信的示例代码

    这篇文章主要介绍了SpringBoot实现发送短信的示例代码,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-04-04
  • Java中Array List与Linked List的实现分析

    Java中Array List与Linked List的实现分析

    这篇文章主要给大家介绍了关于Array List与Linked List实现的相关资料,文中通过示例代码介绍的非常详细,对大家学习或者使用java具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
    2019-09-09
  • 不了解这12个语法糖,别说你会Java

    不了解这12个语法糖,别说你会Java

    这篇文章主要介绍了不了解这12个语法糖,别说你会Java,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-08-08
  • 深入理解java中this关键字的使用

    深入理解java中this关键字的使用

    这篇文章主要介绍了this关键字的使用,通过调用构造方法,使用this关键字调用当前对象等详细介绍了this的特点和使用,需要的朋友可以参考下
    2017-08-08
  • Java中switch判断语句典型使用实例

    Java中switch判断语句典型使用实例

    这篇文章主要介绍了Java中switch判断语句典型使用实例,本文直接给出代码实例,在忘记switch语法时特别有用,复制修改即可使用,需要的朋友可以参考下
    2015-06-06
  • Java实现解析dcm医学影像文件并提取文件信息的方法示例

    Java实现解析dcm医学影像文件并提取文件信息的方法示例

    这篇文章主要介绍了Java实现解析dcm医学影像文件并提取文件信息的方法,结合实例形式分析了java基于第三方库文件针对dcm医学影像文件的解析操作相关实现技巧,需要的朋友可以参考下
    2018-04-04
  • Java编程中字节流与字符流IO操作示例

    Java编程中字节流与字符流IO操作示例

    这篇文章主要介绍了Java编程中字节流与字符流IO操作示例,并且简单总结了IO流操作的基本规律,需要的朋友可以参考下
    2016-02-02
  • 深入理解Java中的弱引用

    深入理解Java中的弱引用

    这篇文章主要介绍了深入理解Java中的弱引用,本文讲解了强引用、弱引用、引用队列、四种引用、软引用、虚引用等内容,需要的朋友可以参考下
    2015-01-01
  • Java JVM原理与调优_动力节点Java学院整理

    Java JVM原理与调优_动力节点Java学院整理

    JVM是Java Virtual Machine(Java虚拟机)的缩写,JVM是一种用于计算设备的规范,它是一个虚构出来的计算机,是通过在实际的计算机上仿真模拟各种计算机功能来实现的。下面通过本文给大家介绍jvm原理与调优相关知识,感兴趣的朋友一起学习吧
    2017-04-04

最新评论