1. 介绍

本文对TinyPinyin、Pinyin4j与JPinyin三个汉字转拼音库的用法、测试代码及转换的结果做一个简单的总结。

适用于Java和Android的快速、低内存占用的汉字转拼音库。

在Android项目中使用时，需要在module app下的build.gradle文件中添加依赖(下同)：

1 compile 'com.github.promeg:tinypinyin:2.0.3'

2 compile 'com.github.promeg:tinypinyin-lexicons-android-cncity:2.0.3'

A copy of http://sourceforge.net/projects/pinyin4j, then deploy it to maven central repository.

compile 'com.belerweb:pinyin4j:2.5.0'

汉字转拼音的Java开源类库，在PinYin4j的功能基础上做了一些改进。

1 compile 'com.github.stuxuhai:jpinyin:1.1.8'

对于开源库，建议使用之前进入其主页了解当前实现的功能和版本号，毕竟别人的文章作为二手资料，目的在于抛砖引玉。

2. 测试

利用Android Studio建立Android项目PinyinTest来测试，具体的库依赖添加和布局文件可以下载后查看。

代码用Kotlin编写，入门文章：

应用运行初始界面：

界面由一个编辑框(TextInputEditText)和按钮(Button)组成，前者供编辑，后者被点击后开始拼音的转换。

为方便测试，在布局文件中设置编辑框默认文本为"真正的稳定，不是拿着固定不变的工资熬日子，世界每天都在变化，很多时候我们所谓的稳定，其实是自己的异想天开。真正的自由，是内心的自由，明白自己想走的路，明确自己想要的生活。做任何事情都要付出，怕，畏缩不前，什么都干不成。"。可以编辑成别的内容，但这段文字足以测试三个库转换的差异。

2.1 按钮点击事件绑定

"转换"按钮在布局文件中的id为convert_btn，Kotlin代码：

1 convert_btn.setOnClickListener {

2 var content: String =content_tiet.text.toString() 3 if(TextUtils.isEmpty(content)) { 4 Toast.makeText(this, "请输入内容，谢谢", Toast.LENGTH_SHORT).show() 5 } else{ 6 tinypinyin(content) 7 pinyin4j(content) 8 jpinyin(content) 9 } 10 }

不用findViewById和注解，只需关注实现的功能，这就是Kotlin的简洁性。

Android库方法TextUtils.isEmpty()在参数为null或者length为0时会返回true，所以，编辑框如果没有内容则提示用户先输入；否则调用自定义的方法。

2.2 TinyPinyin转换

方法：

1 fun tinypinyin(content: String) {

2 val start_time: Long =System.currentTimeMillis()

3 val stringBuilder =StringBuilder() 4 stringBuilder.setLength(0) 5 for (c incontent) { 6 stringBuilder.append(Pinyin.toPinyin(c)) 7 } 8 val end_time: Long =System.currentTimeMillis() 9 Log.i("pinyintest", "tinypinyin time: " + + (end_time - start_time) + "ms") 10 Log.i("pinyintest", "tinypinyin content: " +stringBuilder.toString().toLowerCase()) 11 }

主要代码Pinyin.toPinyin(c)，如果字符c为汉字，返回对应的拼音；否则返回字符本身。

结果：

tinypinyin time: 9ms

tinypinyin content: zhenzhengdewending，bushinazhegudingbubiandegongziaorizi，shijiemeitiandouzaibianhua，henduoshihouwomensuoweidewending，qishishizijideyixiangtiankai。zhenzhengdeziyou，shineixindeziyou，mingbaizijixiangzoudelu，mingquezijixiangyaodeshenghuo。zuorenheshiqingdouyaofuchu，pa，weisuobuqian，shenmedouganbucheng。

2.3 Pinyin4j转换

方法：

1 fun pinyin4j(content: String) {

2 val start_time: Long =System.currentTimeMillis()

3 val stringBuilder =StringBuilder() 4 stringBuilder.setLength(0) 5 val hanyuPinyinOutputFormat =HanyuPinyinOutputFormat() 6 hanyuPinyinOutputFormat.toneType =HanyuPinyinToneType.WITHOUT_TONE 7 try{ 8 for (c incontent) { 9 val result =PinyinHelper.toHanyuPinyinStringArray(c, hanyuPinyinOutputFormat) 10 if (result != null) { 11 stringBuilder.append(result[0]) 12 } else{ 13 stringBuilder.append(c) 14 } 15 } 16 } catch(badHanyuPinyinOutputFormatCombination: BadHanyuPinyinOutputFormatCombination) { 17 badHanyuPinyinOutputFormatCombination.printStackTrace() 18 } 19 val end_time: Long =System.currentTimeMillis() 20 Log.i("pinyintest", "pinyin4j time: " + + (end_time - start_time) + "ms") 21 Log.i("pinyintest", "pinyin4j content: " +stringBuilder.toString().toLowerCase()) 22 }

相比之下，Pinyin4j的使用要繁琐地多，如代码第5-6行先生成一个HanyuPinyinOutputFormat对象，用来指定是否需要声调等信息；还需为转换过程添加异常处理。

主要代码PinyinHelper.toHanyuPinyinStringArray(c, hanyuPinyinOutputFormat)，如果c为汉字，返回的result非null，取[0]为拼音；否则result为null。因此，必须对结果进行判断，对不同情况做处理。

结果：

pinyin4j time: 209ms

pinyin4j content: zhenzhengdewending，bushinazhegudingbubiandegongziaorizi，shijiemeitiandouzaibianhua，henduoshihouwomensuoweidewending，qishishizijideyixiangtiankai。zhenzhengdeziyou，shineixindeziyou，mingbaizijixiangzoudelu，mingquezijixiangyaodeshenghuo。zuorenheshiqingdouyaofuchu，pa，weisuobuqian，shenmedouganbucheng。

2.4 JPinyin转换

方法：

1 fun jpinyin(content: String) {

2 val start_time: Long =System.currentTimeMillis()

3 val stringBuilder =StringBuilder() 4 stringBuilder.setLength(0) 5 stringBuilder.append(PinyinHelper.convertToPinyinString(content, "", PinyinFormat.WITHOUT_TONE)) 6 val end_time: Long =System.currentTimeMillis() 7 Log.i("pinyintest", "jpinyin time: " + + (end_time - start_time) + "ms") 8 Log.i("pinyintest", "jpinyin content: " +stringBuilder.toString().toLowerCase()) 9 }

主要代码PinyinHelper.convertToPinyinString(content, "", PinyinFormat.WITHOUT_TONE)，从转换过程来看JPinyin是最方便的。因为它是直接对整个字串content进行处理，不用通过迭代操作每个字符。

同样地，第三个参数表示忽略声调，而第二个参数指定各个字符转换结果的分隔符，这里是空字串。

结果：

jpinyin time: 417ms

jpinyin content: zhenzhengdewending，bushinazhuogudingbubiandegongziaorizi，shijiemeitiandouzaibianhua，henduoshihouwomensuoweidewending，qishishizijideyixiangtiankai。zhenzhengdeziyou，shineixindeziyou，mingbaizijixiangzoudelu，mingquezijixiangyaodeshenghuo。zuorenheshiqingdouyaofuchu，pa，weisuobuqian，shenmedouganbucheng。

3. 总结

除了默认文本，还输入过其他字串进行测试，三个库转换所消耗的时间差异类似。JPinyin介绍是说在Pinyin4j的基础上做的改进，虽然调用方法上简单了，但是转换速度方面竟然要差一些。

因此，TinyPinyin是在三个库中比较理想的选择，如果进一步深入看它们的实现源码，就能明白为什么速度上有那么大的差异。

如果大家知道更好的汉字转拼音库，请推荐。