J2ME 漢字轉拼音庫：HGB2PINYIN 高性能實現與用法

前言

J2ME 無系統級拼音輸入/轉換 API。HGB2PINYIN 以 **300 字 175ms (Nokia 5300 實測)** 的性能，提供 GB2312/GBK 漢字轉全拼/首字母功能，單文件、零依賴、含完整拼音映射表。

核心 API

public class HGB2PINYIN {
    // 單字符
    public static String getFirstPY(char ch);      // 首字母 (大寫)
    public static String getAllPY(char ch);        // 全拼 (小寫, 帶聲調數字可選)

    // 字符串
    public static String getFirstPY(String str);   // 每字首字母拼接
    public static String getAllPY(String str);     // 每字全拼空格分隔

    // 批量 (性能最優)
    public static String[] getFirstPYArray(String str);
    public static String[] getAllPYArray(String str);
}

實現原理

1. 編碼判斷： 利用 GB2312/GBK 雙字節高位 ≥ 0x81 判定漢字。
2. 區位碼計算： q = high - 0xA0, w = low - 0xA0 (GB2312 區位)。
3. 映射表查找： 預置 String[] PY_TABLE (6763 字)，索引 = (q-1)*94 + (w-1) 直接定位拼音字符串。
4. 首字母提取： 全拼首字符大寫 (多音字取首個讀音)。

性能優化要點

• 映射表壓縮： 全拼字符串共享前綴、用單字節索引指向聲母/韻母表，總表 < 30KB。
• 無對象創建熱路徑： 字符轉換直接操作 char[]、StringBuilder (J2ME 用 StringBuffer) 復用緩衝區。
• 分支預測友好： 非漢字字符 (ASCII/標點) 直接透傳，無查表開銷。

使用示例

// 聯繫人排序索引
String name = "趙雲";
String index = HGB2PINYIN.getFirstPY(name); // "ZY"
String full = HGB2PINYIN.getAllPY(name);    // "zhao yun"

// 搜索提示
String query = "zg";
String[] pyArray = HGB2PINYIN.getFirstPYArray(contactName);
if (matchesPrefix(pyArray, query)) showContact(contactName);

局限與擴展

• 僅支援 GB2312/GBK 範圍內漢字 (6763 字)：生僻字、繁體字、擴展區字符返回空/原字符。
• 多音字策略： 映射表僅存首個常用讀音，專業場景需引入多音字詞典 (體積 +50KB+)。
• UTF-16 環境 (Java char) 兼容： 輸入字符需為 GBK 解碼後的 char，若源數據為 UTF-8 字節流，先用 new String(bytes, "GBK") 解碼。

獲取完整代碼

HGB2PINYIN.java (含映射表、自測 main) 可從項目倉庫下載。已在 Nokia S40/S60、SonyEricsson、Motorola、Samsung 多款真機驗證正確性與性能。

總結

**拼音轉換是中文 J2ME 應用的基礎設施**。HGB2PINYIN 以極致精簡的映射表 + O(1) 查找，在 200KB Heap 環境下實現毫秒級響應。直接拷入項目，即刻獲得專業級中文索引/搜索/排序能力。