首页 > 代码库 > [pinyin4j] java版汉字转换拼音(大小写)
[pinyin4j] java版汉字转换拼音(大小写)
pinyin4J 是一个可以将汉字转换成拼音的lib,非常实用,其maven地址为:http://mvnrepository.com/artifact/com.belerweb/pinyin4j/2.5.0
pinyin4J 提供PinyinHelper这个静态类对外提供拼音转换的服务,主要有一下方法:
static public String[] toHanyuPinyinStringArray(char ch)
将char(必须为汉字单字)转化为拼音,实用的是通用的格式,如果ch为非汉字,返回null。
输入:重 输出:[zhong4, chong2]说明重字有两个读音,拼音后面的1,2,3,4 代表的是读音
static public String[] toHanyuPinyinStringArray(char ch,HanyuPinyinOutputFormat outputFormat)
同上,但是这个方法可以设置输出的格式。HanyuPinyinOutputFormat 可以设置拼音大小写、是否后面加读音数字、特殊读音的显示方式,定义如下:
/** * The option indicates that the output of 'ü' is "u:" */ public static final HanyuPinyinVCharType WITH_U_AND_COLON = new HanyuPinyinVCharType("WITH_U_AND_COLON"); /** * The option indicates that the output of 'ü' is "v" */ public static final HanyuPinyinVCharType WITH_V = new HanyuPinyinVCharType("WITH_V") /** * The option indicates that the output of 'ü' is "ü" in Unicode form */ public static final HanyuPinyinVCharType WITH_U_UNICODE = new HanyuPinyinVCharType("WITH_U_UNICODE");
转换为通用拼音。通用拼音的介绍见:http://zh.wikipedia.org/zh-cn/%E9%80%9A%E7%94%A8%E6%8B%BC%E9%9F%B3
static public String[] toWadeGilesPinyinStringArray(char ch)
转换为威妥玛拼音:http://zh.wikipedia.org/wiki/%E5%A8%81%E5%A6%A5%E7%91%AA%E6%8B%BC%E9%9F%B3
static public String[] toMPS2PinyinStringArray(char ch)
转换为注音符号拼音:http://zh.wikipedia.org/zh-cn/%E6%B3%A8%E9%9F%B3%E7%AC%A6%E8%99%9F
static public String[] toYalePinyinStringArray(char ch)
转换为耶魯拼音:http://zh.wikipedia.org/zh-cn/%E8%80%B6%E9%AD%AF%E6%8B%BC%E9%9F%B3
static public String[] toGwoyeuRomatzyhStringArray(char ch)
转换为国语罗马字:http://zh.wikipedia.org/wiki/%E5%9C%8B%E8%AA%9E%E7%BE%85%E9%A6%AC%E5%AD%97
对于”重“的拼音转换,以上方法分别得到的结果是:
汉语拼音:[zhong4, chong2] 通用拼音:[jhong4, chong2] 威妥玛拼音:[chung4, ch`ung2] 注音符号拼音:[jung4, chung2] 耶魯拼音:[jung4, chung2] 国语罗马字:[jonq, chorng]
好了,有了上面的基础,我们可以封装一个工具类,用来将汉字转换成拼音,这里只使用了汉字拼音。
首先要将pinyin4j加入项目中,如果是maven项目,可以添加引用:
<span style="white-space:pre"> </span><!-- 增加pinyin4j --> <dependency> <groupId>com.belerweb</groupId> <artifactId>pinyin4j</artifactId> <version>2.5.0</version> </dependency>非maven的可以直接将下载好的jar包放入classpath。
然后编写工具类 PinyinTool.java:
package org.nerve.d3lesson.common.tools; 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; import java.util.Arrays; /** * * Created by zengxm on 2014/12/4. */ public class PinyinTool { HanyuPinyinOutputFormat format = null; public static enum Type { UPPERCASE, //全部大写 LOWERCASE, //全部小写 FIRSTUPPER //首字母大写 } public PinyinTool(){ format = new HanyuPinyinOutputFormat(); format.setCaseType(HanyuPinyinCaseType.UPPERCASE); format.setToneType(HanyuPinyinToneType.WITHOUT_TONE); } public String toPinYin(String str) throws BadHanyuPinyinOutputFormatCombination{ return toPinYin(str, "", Type.UPPERCASE); } public String toPinYin(String str,String spera) throws BadHanyuPinyinOutputFormatCombination{ return toPinYin(str, spera, Type.UPPERCASE); } /** * 将str转换成拼音,如果不是汉字或者没有对应的拼音,则不作转换 * 如: 明天 转换成 MINGTIAN * @param str * @param spera * @return * @throws BadHanyuPinyinOutputFormatCombination */ public String toPinYin(String str, String spera, Type type) throws BadHanyuPinyinOutputFormatCombination { if(str == null || str.trim().length()==0) return ""; if(type == Type.UPPERCASE) format.setCaseType(HanyuPinyinCaseType.UPPERCASE); else format.setCaseType(HanyuPinyinCaseType.LOWERCASE); String py = ""; String temp = ""; String[] t; for(int i=0;i<str.length();i++){ char c = str.charAt(i); if((int)c <= 128) py += c; else{ t = PinyinHelper.toHanyuPinyinStringArray(c, format); if(t == null) py += c; else{ temp = t[0]; if(type == Type.FIRSTUPPER) temp = t[0].toUpperCase().charAt(0)+temp.substring(1); py += temp+(i==str.length()-1?"":spera); } } } return py.trim(); } }
写个测试用例看看结果:
[pinyin4j] java版汉字转换拼音(大小写)