1. 介紹html
本文對TinyPinyin、Pinyin4j與JPinyin三個漢字轉拼音庫的用法、測試代碼及轉換的結果作一個簡單的總結。android
TinyPinyingit
適用於Java和Android的快速、低內存佔用的漢字轉拼音庫。github
在Android項目中使用時,須要在module app下的build.gradle文件中添加依賴(下同):web
1 compile 'com.github.promeg:tinypinyin:2.0.3' 2 compile 'com.github.promeg:tinypinyin-lexicons-android-cncity:2.0.3'
Pinyin4japp
A copy of http://sourceforge.net/projects/pinyin4j, then deploy it to maven central repository.maven
compile 'com.belerweb:pinyin4j:2.5.0'
JPinyinide
漢字轉拼音的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 in content) { 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 in content) { 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是在三個庫中比較理想的選擇,若是進一步深刻看它們的實現源碼,就能明白爲何速度上有那麼大的差別。
若是你們知道更好的漢字轉拼音庫,請推薦。