一般用法
pinyin4j的使用很方便，一般转换只需要使用PinyinHelper类的静态工具方法即可：
String[] pinyin = PinyinHelper.toHanyuPinyinStringArray(‘刘’);//该类还有其他的拼音转换形式，但是基本上用不到，就不介绍了返回的数组即是该字符的拼音，如上例就是pinyin[0]=liu2，后面的数字代表声调，声调为5表示轻读，无声调。之所谓返回数组，是因为被判定的汉字有可能有多个读音。如果输入的参数不是汉字，则返回null。
拼音格式化
如果对于拼音转换后的结果有一些特定的格式要求目前pinyin4j支持：
l 声调格式化。例如：“刘”字的格式化后为“liu2”或“liu”或“liú”
l 对特殊拼音ü的的显示格式。例如“u:”或“v”或“ü”
l 大小写的转换。例如：“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);但该方法会有异常抛出，注意处理。
示例
1 import net.sourceforge.pinyin4j.PinyinHelper; 2 import net.sourceforge.pinyin4j.format.HanyuPinyinCaseType; 3 import net.sourceforge.pinyin4j.format.HanyuPinyinOutputFormat; 4 import net.sourceforge.pinyin4j.format.HanyuPinyinToneType; 5 import net.sourceforge.pinyin4j.format.HanyuPinyinVCharType; 6 import net.sourceforge.pinyin4j.format.exception.BadHanyuPinyinOutputFormatCombination; 7 public class Test { 8 public static void main(String[] args) { 9 import net.sourceforge.pinyin4j.PinyinHelper;10 import net.sourceforge.pinyin4j.format.HanyuPinyinCaseType;11 import net.sourceforge.pinyin4j.format.HanyuPinyinOutputFormat;12 import net.sourceforge.pinyin4j.format.HanyuPinyinToneType;13 import net.sourceforge.pinyin4j.format.HanyuPinyinVCharType;14 import net.sourceforge.pinyin4j.format.exception.BadHanyuPinyinOutputFormatCombination;15 public class Test {16 public static void main(String[] args) {17 HanyuPinyinOutputFormat outputFormat = new HanyuPinyinOutputFormat();18 outputFormat.setToneType(HanyuPinyinToneType.WITH_TONE_MARK);19 outputFormat.setVCharType(HanyuPinyinVCharType.WITH_U_UNICODE);20 outputFormat.setCaseType(HanyuPinyinCaseType.UPPERCASE);21 try {22 System.out.println(concatPinyinStringArray(PinyinHelper.toHanyuPinyinStringArray(‘刘‘,outputFormat)));23 } catch (BadHanyuPinyinOutputFormatCombination e) {24 // TODO Auto-generated catch block25 e.printStackTrace();26 }27 }28 29 private static String concatPinyinStringArray(String[] pinyinArray)30 {31 StringBuffer pinyinStrBuf = new StringBuffer();32 if ((null != pinyinArray) i 其他
l PinyinHelper还有其他的静态方法，但示例和讲解中使用的方法是常见的拼音格式，因此其他静态方法我没有调研其含义。
l 貌似支持生僻字，我试过很怪异的字，都可以将其读音拼写出来，因此这个工具包还是很强的。
拼音工具
1 package cn.itcast.bos.utils; 2 3 import java.util.Arrays; 4 5 import net.sourceforge.pinyin4j.PinyinHelper; 6 import net.sourceforge.pinyin4j.format.HanyuPinyinCaseType; 7 import net.sourceforge.pinyin4j.format.HanyuPinyinOutputFormat; 8 import net.sourceforge.pinyin4j.format.HanyuPinyinToneType; 9 import net.sourceforge.pinyin4j.format.exception.BadHanyuPinyinOutputFormatCombination; 10 11 public class PinYin4jUtils { 12 /** 13 * 将字符串转换成拼音数组 14 * 15 * @param src 16 * @return 17 */ 18 public static String[] stringToPinyin(String src) { 19 return stringToPinyin(src, false, null); 20 } 21 22 /** 23 * 将字符串转换成拼音数组 24 * 25 * @param src 26 * @return 27 */ 28 public static String[] stringToPinyin(String src, String separator) { 29 30 return stringToPinyin(src, true, separator); 31 } 32 33 /** 34 * 将字符串转换成拼音数组 35 * 36 * @param src 37 * @param isPolyphone 38 * 是否查出多音字的所有拼音 39 * @param separator 40 * 多音字拼音之间的分隔符 41 * @return 42 */ 43 public static String[] stringToPinyin(String src, boolean isPolyphone, 44 String separator) { 45 // 判断字符串是否为空 46 if ("".equals(src) || null == src) { 47 return null; 48 } 49 char[] srcChar = src.toCharArray(); 50 int srcCount = srcChar.length; 51 String[] srcStr = new String[srcCount]; 52 53 for (int i = 0; i 128) { 77 try { 78 // 转换得出结果 79 String[] strs = PinyinHelper.toHanyuPinyinStringArray(src, 80 defaultFormat); 81 82 // 是否查出多音字，默认是查出多音字的第一个字符 83 if (isPolyphone i