原文：http://blog.csdn.net/pathuang68/article/details/6692882
1. 简单介绍
有时候，需要将汉字编程对应的拼音，以方便数据的处理。比如在Android手机应用的开发上，要查询联系人的姓名，通常都是用拼音进行查询的。比如要查询“曹孟德”，就可以输入“cmd”，即“曹孟德”三个汉字的拼音“caomengde”各字的首字母。但是怎样才能将“曹孟德”翻译成“caomengde”呢？很简单的办法就是建立一个大的对照表(比如用关联容器Map)，比如<”曹”，”cao”>，<” 孟”，”meng”>，<” 德”，”de”>…但这样的做法，需要维护好一个比较大的对照表，同时一个汉字可能有多个发音，也就是说Map这样的容器时不行的，因为其<key,value>必须是一一对应的。在C++中可以用STL里面的multimap来解决这个问题，但Java中没有类似multimap这样的东西，除非自己实现一个。
Pinyin4j就是为了解决类似这样的问题的。它是sourceforge.net上的一个开源项目，功能非常强大：
+ 支持同一汉字有多个发音
+ 还支持拼音的格式化输出，比如第几声之类的，
+ 同时支持简体中文、繁体中文转换为拼音…使用起来也非常简单。下面是其官方网址，其中提供了下载：
http://pinyin4j.sourceforge.net/
2. 基本用法：
通常情况下，只需要用到其中的PinyinHelper类中的静态方法toHanyuPinyinStringArray就可以了，比如：
1 String[] pinyinArray =PinyinHelper.toHanyuPinyinStringArray('单'); 2 3 for(int i = 0; i < pinyinArray.length; ++i) 4 5 { 6 7 System.out.println(pinyinArray[i]); 8 9 }
就会输出：
dan1
chan2
shan4
这三种发音，后面的数字代表第几声。可以看到静态方法toHanyuPinyinStringArray返回的数据类型是一个String数组，它用来接收一个汉字的多个发音，如果toHanyuPinyinStringArray中的参数不是汉字，那么它会返回null。
3. 格式支持
Pinyin4j支持拼音输出的格式化，比如，“黄”可以输出为“huang”、“huang2”、“huáng”等等，下面的代码就似是输出“huáng”的示例：
1 HanyuPinyinOutputFormat format= new HanyuPinyinOutputFormat(); 2 3 format.setToneType(HanyuPinyinToneType.WITH_TONE_MARK); 4 5 format.setVCharType(HanyuPinyinVCharType.WITH_U_UNICODE); 6 7 8 9 String[] pinyinArray = null; 10 11 try 12 13 { 14 15 pinyinArray = PinyinHelper.toHanyuPinyinStringArray('黄', format); 16 17 } 18 19 catch(BadHanyuPinyinOutputFormatCombination e) 20 21 { 22 23 e.printStackTrace(); 24 25 } 26 27 for(int i = 0; i < pinyinArray.length; ++i) 28 29 { 30 31 System.out.println(pinyinArray[i]); 32 33 }
此外，还支持大小写转换、ü等等。详细情况，可以查看Pinyin4j自带的文档。
4. 实际示例代码
如果我们要将一段文字中的汉字全部转换成不带音调的拼音输出，而这段文字中又可能包含阿拉伯数字、英文、标点符号等等。如果完全靠自己写代码进行转换，那是非常麻烦的，其中一个首先就要区别，这段文字中那些是汉字，那些是非汉字。有了Pinyin4j，这个问题就不再困难了，因为对于非汉字，Pinyin4j会自动输出null。参考下面的示例代码：
1 importnet.sourceforge.pinyin4j.*; 2 3 importnet.sourceforge.pinyin4j.format.HanyuPinyinOutputFormat; 4 5 importnet.sourceforge.pinyin4j.format.HanyuPinyinToneType; 6 7 importnet.sourceforge.pinyin4j.format.exception.BadHanyuPinyinOutputFormatCombination; 8 9 10 11 public class Chinese2PY 12 13 { 14 15 public static void main(String[] args) 16 17 { 18 19 Hanyu hanyu = new Hanyu(); 20 21 // 中英文混合的一段文字 22 23 String str = "荆溪白石出，Hello 天寒红叶稀。Android 山路元无雨，What's up? 空翠湿人衣。"; 24 25 String strPinyin = hanyu.getStringPinYin(str); 26 27 System.out.println(strPinyin); 28 29 } 30 31 } 32 33 34 35 class Hanyu 36 37 { 38 39 private HanyuPinyinOutputFormat format = null; 40 41 private String[] pinyin; 42 43 44 45 public Hanyu() 46 47 { 48 49 format = new HanyuPinyinOutputFormat(); 50 51 format.setToneType(HanyuPinyinToneType.WITHOUT_TONE); 52 53 54 55 pinyin = null; 56 57 } 58 59 60 61 //转换单个字符 62 63 public String getCharacterPinYin(char c) 64 65 { 66 67 try 68 69 { 70 71 pinyin = PinyinHelper.toHanyuPinyinStringArray(c, format); 72 73 } 74 75 catch(BadHanyuPinyinOutputFormatCombination e) 76 77 { 78 79 e.printStackTrace(); 80 81 } 82 83 84 85 // 如果c不是汉字，toHanyuPinyinStringArray会返回null 86 87 if(pinyin == null) return null; 88 89 90 91 // 只取一个发音，如果是多音字，仅取第一个发音 92 93 return pinyin[0]; 94 95 } 96 97 98 99 //转换一个字符串 100 101 public String getStringPinYin(String str) 102 103 { 104 105 StringBuilder sb = new StringBuilder(); 106 107 String tempPinyin = null; 108 109 for(int i = 0; i < str.length(); ++i) 110 111 { 112 113 tempPinyin =getCharacterPinYin(str.charAt(i)); 114 115 if(tempPinyin == null) 116 117 { 118 119 // 如果str.charAt(i)非汉字，则保持原样 120 121 sb.append(str.charAt(i)); 122 123 } 124 125 else 126 127 { 128 129 sb.append(tempPinyin); 130 131 } 132 133 } 134 135 return sb.toString(); 136 137 } 138 139 }
输出结果：
jingxibaishichu，Hellotianhanhongyexi。Android shanluyuanwuyu，What'sup? kongcuishirenyi。