汉字转拼音工具JPinyin的介绍和使用示例
汉字转拼音的开源工具类包，已经出现过好几个，比如：Pinyin4J、Jpinyin等。本文主要结合JPinyin汉字转拼音的Java开源类库，给出相关的介绍和使用示例。
Jpinyin介绍
JPinyin是一个汉字转拼音的Java开源类库，在PinYin4j的功能基础上做了一些改进。
JPinyin主要特性
1、准确、完善的字库； Unicode编码从4E00-9FA5范围及3007（〇）的20903个汉字中，JPinyin能转换除46个异体字（异体字不存在标准拼音）之外的所有汉字； 2、拼音转换速度快； 经测试，转换Unicode编码从4E00-9FA5范围的20902个汉字，JPinyin耗时约100毫秒。 3、多拼音格式输出支持； JPinyin支持多种拼音输出格式：带音标、不带音标、数字表示音标以及拼音首字母输出格式； 4、常见多音字识别； JPinyin支持常见多音字的识别，其中包括词组、成语、地名等； 5、简繁体中文转换； 6、支持添加用户自定义字典；
上述主要特性摘自Jpinyin的Github页面。
JPinyin原理
JPinyin对汉字转拼音的支持，主要是通过预定的字典文件实现的。Jpinyin预定义了三个字典文件，如下图所示：
其中，pinyin.dict文件定义了汉字和对应拼音的键值对。部分内容如下：
multi_pinyin.dict定义了多音字、词语等，部分内容如下：
chinese.dict则定义了繁体字和简体字对应的键值对，用于繁体字和简体字的转换，部分内容如下：
有了上述的字典库，读取相关的字典资源文件，就可以完成繁体字到简体字、汉字到拼音的转换等功能。
Jpinyin主要类介绍
Jpinyin就包含如下图所示的6个Java类：
其中，
- PinyinHelper.java是汉字转拼音类，其主要有如下几个功能：
- 判断一个汉字是否为多音字
- 获取字符串对应拼音的首字母
- 将字符串转换成带声调格式的拼音
- 将字符串转换成相应格式的拼音
- 将单个汉字转换为相应格式的拼音
- 等等
- ChineseHelper.java是汉字简繁体转换类，其主要有如下几个功能：
- 将单个繁体字转换为简体字
- 将单个简体字转换为繁体字
- 判断某个字符是否为汉字
- 判断字符串中是否包含中文
- 等等
- PinyinFormat.java是拼音格式类，主要提供了三种拼音格式类：
- WITH_TONE_MARK
- WITHOUT_TONE
- WITH_TONE_NUMBER
- PinyinResource.java是资源文件加载类，主要提供对预定义的字典文件进行加载。
Jpinyin使用示例
汉字简繁体互转
判断是否为中文字符
判断是否为繁体字
判断是否包含中文字符
/**
* 判断是否包含中文字符
*/
System.out.println(ChineseHelper.containsChinese("ABC")); // false
System.out.println(ChineseHelper.containsChinese("A东C")); // true
System.out.println(ChineseHelper.containsChinese("A東C")); // true
}汉字简繁转换类的完整示例
import com.github.stuxuhai.jpinyin.ChineseHelper;/**
*
* @author wangmengjun
*
*/public class ChineseHelperExample { public static void main(String[] args) { /**
* 简体字和繁体字互转
*/
// 义 --> 義
System.out.println(ChineseHelper.convertToTraditionalChinese('义')); // 義 --> 义
System.out.println(ChineseHelper.convertToSimplifiedChinese('義')); // 东无敌 --> 東無敵
System.out.println(ChineseHelper.convertToTraditionalChinese("东无敌")); // 東無敵 --> 东无敌
System.out.println(ChineseHelper.convertToSimplifiedChinese("東無敵")); /**
* 判断是否为中文字符
*/
System.out.println(ChineseHelper.isChinese('A')); // false
System.out.println(ChineseHelper.isChinese('东')); // true
System.out.println(ChineseHelper.isChinese('東')); // true/**
* 是否为繁体字
*/
System.out.println(ChineseHelper.isTraditionalChinese('东')); // false
System.out.println(ChineseHelper.isTraditionalChinese('東')); // true/**
* 判断是否包含中文字符
*/
System.out.println(ChineseHelper.containsChinese("ABC")); // false
System.out.println(ChineseHelper.containsChinese("A东C")); // true
System.out.println(ChineseHelper.containsChinese("A東C")); // true
}
}获取某个中文字符可能的发音
/**
* 获取某个中文字符可能的发音，如 为可以有两种发音[wèi, wéi]
*/
String[] weiArray = PinyinHelper.convertToPinyinArray('为'); // [wèi, wéi]
System.out.println(Arrays.toString(weiArray)); /**
* 沒有音调
*/
String[] weiArrayWithoutTone = PinyinHelper.convertToPinyinArray('为',
PinyinFormat.WITHOUT_TONE); //[wei]
System.out.println(Arrays.toString(weiArrayWithoutTone));
/**
* 有音调，使用数字表示音调
*/
String[] weiArrayWithoutToneNum= PinyinHelper.convertToPinyinArray('为',
PinyinFormat.WITH_TONE_NUMBER); //[wei4, wei2]
System.out.println(Arrays.toString(weiArrayWithoutToneNum));获取字符串对应拼音的首字母
/**
* 获取字符串对应拼音的首字母
*/
try { String shortPinyin = PinyinHelper.getShortPinyin("我爱杭州"); //wahz
System.out.println(shortPinyin);
} catch (PinyinException e) { // TODO Auto-generated catch block
e.printStackTrace();
}将字符串转换成相应格式的拼音
/**
* 将字符串转换成相应格式的拼音
*/
try { String pinyinString = PinyinHelper.convertToPinyinString("杭州西湖", ",", PinyinFormat.WITH_TONE_MARK); //háng,zhōu,xī,hú
System.out.println(pinyinString);
} catch (PinyinException e) { // TODO Auto-generated catch block
e.printStackTrace();
}
try { String pinyinString = PinyinHelper.convertToPinyinString("杭州西湖", ",", PinyinFormat.WITHOUT_TONE); //hang,zhou,xi,hu
System.out.println(pinyinString);
} catch (PinyinException e) { // TODO Auto-generated catch block
e.printStackTrace();
}
try { String pinyinString = PinyinHelper.convertToPinyinString("杭州西湖", ",", PinyinFormat.WITH_TONE_NUMBER); //hang2,zhou1,xi1,hu2
System.out.println(pinyinString);
} catch (PinyinException e) { // TODO Auto-generated catch block
e.printStackTrace();
}汉字转拼音类完整示例
import java.util.Arrays;import com.github.stuxuhai.jpinyin.PinyinException;import com.github.stuxuhai.jpinyin.PinyinFormat;import com.github.stuxuhai.jpinyin.PinyinHelper;/**
* @author wangmengjun
*
*/public class PinyinHelperExample { public static void main(String[] args) { /**
* 获取某个中文字符可能的发音，如 为可以有两种发音[wèi, wéi]
*/
String[] weiArray = PinyinHelper.convertToPinyinArray('为'); // [wèi, wéi]
System.out.println(Arrays.toString(weiArray)); /**
* 沒有音调
*/
String[] weiArrayWithoutTone = PinyinHelper.convertToPinyinArray('为', PinyinFormat.WITHOUT_TONE); //[wei]
System.out.println(Arrays.toString(weiArrayWithoutTone));
/**
* 有音调，使用数字表示音调
*/
String[] weiArrayWithoutToneNum= PinyinHelper.convertToPinyinArray('为', PinyinFormat.WITH_TONE_NUMBER); //[wei4, wei2]
System.out.println(Arrays.toString(weiArrayWithoutToneNum));
/**
* 获取字符串对应拼音的首字母
*/
try { String shortPinyin = PinyinHelper.getShortPinyin("我爱杭州"); //wahz
System.out.println(shortPinyin);
} catch (PinyinException e) { // TODO Auto-generated catch block
e.printStackTrace();
}
/**
* 将字符串转换成相应格式的拼音
*/
try { String pinyinString = PinyinHelper.convertToPinyinString("杭州西湖", ",", PinyinFormat.WITH_TONE_MARK); //háng,zhōu,xī,hú
System.out.println(pinyinString);
} catch (PinyinException e) { // TODO Auto-generated catch block
e.printStackTrace();
}
try { String pinyinString = PinyinHelper.convertToPinyinString("杭州西湖", ",", PinyinFormat.WITHOUT_TONE); //hang,zhou,xi,hu
System.out.println(pinyinString);
} catch (PinyinException e) { // TODO Auto-generated catch block
e.printStackTrace();
}
try { String pinyinString = PinyinHelper.convertToPinyinString("杭州西湖", ",", PinyinFormat.WITH_TONE_NUMBER); //hang2,zhou1,xi1,hu2
System.out.println(pinyinString);
} catch (PinyinException e) { // TODO Auto-generated catch block
e.printStackTrace();
}
}}
小结
本文对汉字转拼音开源工具Jpinyin进行了简单的介绍，并给出了几个例子。
从使用上来看，Jpinyin的使用还算便利，而且Jpinyin还预留了支持添加用户自定义字典的接口，可以让用户根据自身特点来自定义字典，从而去满足自身业务特点或者功能，如：
PinyinHelper.addPinyinDict("user.dict"); // 添加用户自定义字典本文参与 腾讯云自媒体分享计划，分享自微信公众号。
原始发表：2016-12-14，如有侵权请联系 cloudcommunity@tencent.com 删除
评论
登录后参与评论
推荐阅读
目录