pinyin4j是一个支持将中文转换到拼音的Java开源类库,pinyin4j能够根据中文字符获取其对应的拼音,而且拼音的格式可以定制。pinyin4j的主页:http://pinyin4j.sourceforge.net/
1. 支持简体中文和繁体中文字符;
2. 支持转换到汉语拼音,通用拼音, 威妥玛拼音(威玛拼法), 注音符号第二式, 耶鲁拼法和国语罗马字;
3. 支持多音字,即可以获取一个中文字符的多种发音;
4. 支持多种字符串输出格式,比如支持Unicode格式的字符ü和声调符号(阴平 "ˉ",阳平"ˊ",上声"ˇ",去声"ˋ")的输出。
简单的例子(支持多音字):
import java.util.HashSet;
import java.util.Set;
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;
/*******************************************************************************
* pinyin4j is a plug-in, you can kind of Chinese characters into phonetic.Multi-tone character,Tone
* Detailed view http://pinyin4j.sourceforge.net/
*
* @author Administrator
* @ClassName: Pinyin4jUtil
* @Description: TODO
* @author wang_china@foxmail.com
* @date Jan 13, 2012 9:28:28 AM
*/
public class Pinyin4jUtil {
/***************************************************************************
* 获取中文汉字拼音 默认输出
* @Name: Pinyin4jUtil.java
* @Description: TODO
* @author: wang_chian@foxmail.com
* @version: Jan 13, 2012 9:54:01 AM
* @param chinese
* @return
*/
public static String getPinyin(String chinese) {
return getPinyinZh_CN(makeStringByStringSet(chinese));
}
/***************************************************************************
* 拼音大写输出
*
* @Name: Pinyin4jUtil.java
* @Description: TODO
* @author: wang_chian@foxmail.com
* @version: Jan 13, 2012 9:58:45 AM
* @param chinese
* @return
*/
public static String getPinyinToUpperCase(String chinese) {
return getPinyinZh_CN(makeStringByStringSet(chinese)).toUpperCase();
}
/***************************************************************************
* 拼音小写输出
*
* @Name: Pinyin4jUtil.java
* @Description: TODO
* @author: wang_chian@foxmail.com
* @version: Jan 13, 2012 9:58:45 AM
* @param chinese
* @return
*/
public static String getPinyinToLowerCase(String chinese) {
return getPinyinZh_CN(makeStringByStringSet(chinese)).toLowerCase();
}
/***************************************************************************
* 首字母大写输出
*
* @Name: Pinyin4jUtil.java
* @Description: TODO
* @author: wang_chian@foxmail.com
* @version: Jan 13, 2012 10:00:54 AM
* @param chinese
* @return
*/
public static String getPinyinFirstToUpperCase(String chinese) {
return getPinyin(chinese);
}
/***************************************************************************
* 拼音简拼输出
*
* @Name: Pinyin4jUtil.java
* @Description: TODO
* @author: wang_chian@foxmail.com
* @version: Jan 13, 2012 11:08:15 AM
* @param chinese
* @return
*/
public static String getPinyinJianPin(String chinese) {
return getPinyinConvertJianPin(getPinyin(chinese));
}
/***************************************************************************
* 字符集转换
*
* @Name: Pinyin4jUtil.java
* @Description: TODO
* @author: wang_chian@foxmail.com
* @version: Jan 13, 2012 9:34:11 AM
* @param chinese
* 中文汉字
* @throws BadHanyuPinyinOutputFormatCombination
*/
public static Set<String> makeStringByStringSet(String chinese) {
char[] chars = chinese.toCharArray();
if (chinese != null && !chinese.trim().equalsIgnoreCase("")) {
char[] srcChar = chinese.toCharArray();
String[][] temp = new String[chinese.length()][];
for (int i = 0; i < srcChar.length; i++) {
char c = srcChar[i];
// 是中文或者a-z或者A-Z转换拼音
if (String.valueOf(c).matches("[\\u4E00-\\u9FA5]+")) {
try {
temp[i] = PinyinHelper.toHanyuPinyinStringArray(
chars[i], getDefaultOutputFormat());
} catch (BadHanyuPinyinOutputFormatCombination e) {
e.printStackTrace();
}
} else if (((int) c >= 65 && (int) c <= 90)
|| ((int) c >= 97 && (int) c <= 122)) {
temp[i] = new String[] { String.valueOf(srcChar[i]) };
} else {
temp[i] = new String[] { String.valueOf(srcChar[i]) };
}
}
String[] pingyinArray = Exchange(temp);
Set<String> zhongWenPinYin = new HashSet<String>();
for (int i = 0; i < pingyinArray.length; i++) {
zhongWenPinYin.add(pingyinArray[i]);
}
return zhongWenPinYin;
}
return null;
}
/***************************************************************************
* Default Format 默认输出格式
*
* @Name: Pinyin4jUtil.java
* @Description: TODO
* @author: wang_chian@foxmail.com
* @version: Jan 13, 2012 9:35:51 AM
* @return
*/
public static HanyuPinyinOutputFormat getDefaultOutputFormat() {
HanyuPinyinOutputFormat format = new HanyuPinyinOutputFormat();
format.setCaseType(HanyuPinyinCaseType.LOWERCASE);// 小写
format.setToneType(HanyuPinyinToneType.WITHOUT_TONE);// 没有音调数字
format.setVCharType(HanyuPinyinVCharType.WITH_U_AND_COLON);// u显示
return format;
}
/***************************************************************************
*
* @Name: Pinyin4jUtil.java
* @Description: TODO
* @author: wang_chian@foxmail.com
* @version: Jan 13, 2012 9:39:54 AM
* @param strJaggedArray
* @return
*/
public static String[] Exchange(String[][] strJaggedArray) {
String[][] temp = DoExchange(strJaggedArray);
return temp[0];
}
/***************************************************************************
*
* @Name: Pinyin4jUtil.java
* @Description: TODO
* @author: wang_chian@foxmail.com
* @version: Jan 13, 2012 9:39:47 AM
* @param strJaggedArray
* @return
*/
private static String[][] DoExchange(String[][] strJaggedArray) {
int len = strJaggedArray.length;
if (len >= 2) {
int len1 = strJaggedArray[0].length;
int len2 = strJaggedArray[1].length;
int newlen = len1 * len2;
String[] temp = new String[newlen];
int Index = 0;
for (int i = 0; i < len1; i++) {
for (int j = 0; j < len2; j++) {
temp[Index] = capitalize(strJaggedArray[0][i])
+ capitalize(strJaggedArray[1][j]);
Index++;
}
}
String[][] newArray = new String[len - 1][];
for (int i = 2; i < len; i++) {
newArray[i - 1] = strJaggedArray[i];
}
newArray[0] = temp;
return DoExchange(newArray);
} else {
return strJaggedArray;
}
}
/***************************************************************************
* 首字母大写
*
* @Name: Pinyin4jUtil.java
* @Description: TODO
* @author: wang_chian@foxmail.com
* @version: Jan 13, 2012 9:36:18 AM
* @param s
* @return
*/
public static String capitalize(String s) {
char ch[];
ch = s.toCharArray();
if (ch!= null && ch.length > 0) { //修改[/color]
if (ch[0] >= 'a' && ch[0] <= 'z') {
ch[0] = (char) (ch[0] - 32);
}
}
String newString = new String(ch);
return newString;
}
/***************************************************************************
* 字符串集合转换字符串(逗号分隔)
*
* @Name: Pinyin4jUtil.java
* @Description: TODO
* @author: wang_chian@foxmail.com
* @version: Jan 13, 2012 9:37:57 AM
* @param stringSet
* @return
*/
public static String getPinyinZh_CN(Set<String> stringSet) {
StringBuilder str = new StringBuilder();
int i = 0;
for (String s : stringSet) {
if (i == stringSet.size() - 1) {
str.append(s);
} else {
str.append(s + ",");
}
i++;
}
return str.toString();
}
/***************************************************************************
* 获取每个拼音的简称
*
* @Name: Pinyin4jUtil.java
* @Description: TODO
* @author: wang_chian@foxmail.com
* @version: Jan 13, 2012 11:05:58 AM
* @param chinese
* @return
*/
public static String getPinyinConvertJianPin(String chinese) {
String[] strArray = chinese.split(",");
String strChar = "";
for (String str : strArray) {
char arr[] = str.toCharArray(); // 将字符串转化成char型数组
for (int i = 0; i < arr.length; i++) {
if (arr[i] >= 65 && arr[i] < 91) { // 判断是否是大写字母
strChar += new String(arr[i] + "");
}
}
strChar += ",";
}
return strChar;
}
/***************************************************************************
* Test
*
* @Name: Pinyin4jUtil.java
* @Description: TODO
* @author: wang_chian@foxmail.com
* @version: Jan 13, 2012 9:49:27 AM
* @param args
*/
public static void main(String[] args) {
String str = "单强";
System.out.println("小写输出:" + getPinyinToLowerCase(str));
System.out.println("大写输出:" + getPinyinToUpperCase(str));
System.out.println("首字母大写输出:" + getPinyinFirstToUpperCase(str));
System.out.println("简拼输出:" + getPinyinJianPin(str));
}
}