J2ME 開發核心知識全景指南：從入門到實戰精通

前言：為什麼需要這份 J2ME 知識地圖？

許多開發者從零開始學習 J2ME，卻發現市面上大多數 Java 基礎教材都以 J2SE 為主，導致學習路徑偏離。本文系統梳理 J2ME 開發必備的核心知識、平台限制、跨平台挑戰、職業方向、設計原則、測試策略、SDK 選擇、常用技術實作（IMEI 獲取、網絡優化、字符串分割、長文本顯示、RMS 存儲、加密、音頻播放、3D 開發、CMWAP 代理、時間/隨機數處理、字體色彩應用、手機號獲取、短信發送、MIDlet 生命週期、OTA 發布），助你少走彎路，直擊實戰。

一、J2ME 所需的 Java 基礎精華版

✅ 必須掌握的核心語法

• 基本數據類型、關鍵字、運算符
• 面向對象核心：類、對象、繼承、多態
• 異常處理機制
• 多線程編程

❌ J2ME 中不需要的 J2SE 知識

• javac/java 命令行操作
• J2SE 庞大類庫（J2ME 大幅精簡，需熟悉 javax.microedition.* 等核心包）
• Applet、AWT、Swing 圖形界面體系

建議：直接研讀 J2ME 官方 API 文檔，建立精準知識體系。

二、J2ME 當前無法實現的功能清單

了解邊界，避免無效探索：

1. 不修改代碼實現遊戲跨機型移植
2. 動態修改按鈕文本
3. Canvas 直接接收中文輸入
4. 訪問本地資源（通訊錄、短信等）
5. 製作破壞性手機病毒

三、J2ME 跨平台的「理想與現實」

J2ME 源自 Java，理應具備「一次編寫，到處運行」特性，但現實骨感：

四大核心阻礙

1. 屏幕尺寸碎片化：高級 UI（表單、列表）適應性好；低級 UI（Canvas 遊戲）需手動適配座標。
2. 廠商擴展 API 不統一：如 Nokia UI API 在其他品牌缺失或包名不同。
3. 具體機型 Bug：如 Nokia 7650 雙緩衝 Bug，需針對性繞過。
4. 硬件性能差異：JAR 包大小限制（如 S40 多為 64KB）、堆內存上限不同。

這造就了「支持機型列表」與「遊戲移植工程師」的獨特生態。

四、J2ME 技能對應的三大職業賽道

崗位	核心職責	關鍵技能棧
J2ME 遊戲開發	按策劃文檔在特定機型（多為 S40/S60）開發遊戲	高/低級 UI、線程、網絡編程（聯網遊戲）
J2ME 應用開發	移動定位、移動商務等業務應用	高級 UI、線程、網絡編程
J2ME 遊戲移植	將遊戲從一平台遷移至另一平台（如 S40→S60、索愛 T618）	屏幕座標控制、API 替換、平台差異參數（屏幕尺寸、JAR 上限等）

五、J2ME 程序設計六大黃金原則

1. 堅持面向對象：雖然面向過程能減小體積，但 OO 利於維護與擴展。
2. 採用 MVC 模式：模型、視圖、控制器分離，大型項目必備。
3. 自動保存用戶設定：用 RMS 記住用戶名、密碼、偏好設定，支援自動登入。
4. 系統設置用戶可關閉：背景音樂、背光等交由用戶控制。
5. 低級 UI 繪製獨立線程：避免阻塞事件分發線程。
6. 耗時操作顯示等待界面：進度條或「載入中」提示，提升體驗。

六、從模擬器到真機：不可跳過的驗證閉環

為什麼必須真機測試？

模擬器存在實現 Bug，且無法模擬真機內存、CPU、按鍵手感等物理特性。

四種傳輸方式

• OTA 無線下載
• 數據線
• 紅外
• 藍牙

真機測試四大核心指標

1. 功能正確性
2. 操作易用性
3. 包體大小合規（如 S40 ≤ 64KB）
4. 運行流暢度可接受

七、WTK 到廠商 SDK：跨越式成長

廠商 SDK = WTK + 專屬模擬器 + 擴展 API

下載地址參考：Nokia/三星/索愛等官方 SDK 彙總

關鍵差異

• 三星 SDK 用法與 WTK 一致
• Nokia 提供獨立 IDE（實際開發較少用）
• 廠商 SDK 仍有 Bug，與真機行為不完全一致（如 Nokia 混音播放問題）

八、J2ME 獲取手機 IMEI 的廠商專屬方案

IMEI（國際移動設備識別碼）15 位，全球唯一，適合作用戶標識。

// Moto 系列
String imei = System.getProperty("IMEI");

// Siemens 系列
String imei = System.getProperty("com.siemens.IMEI");

其他品牌需查閱對應技術文檔，無統一標準 API。

九、解決 J2ME 網絡編程「界面先行、數據滯後」顯示亂序

現象：公告頁先顯背景圖，後載文字，體驗極差。

三步同步顯示法

1. 界面構造時發起網絡請求，不調用 Display.setCurrent()。
2. 顯示等待界面（進度條），提示「正在連接...」。
3. 數據回調處理完畢後，再調用 Display.setCurrent() 切換目標界面。

十、J2ME 缺失 String.split()？自造分割工具類

MIDP 2.0 仍無 split()，實戰常需分割字符串。下方提供生產級實現：

private static String[] split(String original, String regex) {
    int startIndex = 0, index = 0;
    Vector v = new Vector();
    startIndex = original.indexOf(regex);
    while (startIndex < original.length() && startIndex != -1) {
        v.addElement(original.substring(index, startIndex));
        index = startIndex + regex.length();
        startIndex = original.indexOf(regex, index);
    }
    v.addElement(original.substring(index));
    String[] result = new String[v.size()];
    for (int i = 0; i < result.length; i++) result[i] = (String) v.elementAt(i);
    return result;
}

十一、Canvas 低級 UI 實現長文本自動換行顯示

場景：遊戲說明、公告、關於頁面，文本長度不固定。

三步可維護方案

1. 將所有顯示內容存為單一字符串（易修改）。
2. 編寫工具方法按指定寬度切割為 String[]。
3. paint() 中循環繪製數組每一行。

優勢：修改內容只改字符串；調整行寬只改切割邏輯；支援動態長度文本。

十二、RMS 記錄存儲系統完整操作指南

MIDP 無文件系統，持久化依賴 RMS。核心操作如下：

1. 打開/創建記錄集

RecordStore rs = RecordStore.openRecordStore("username", true);
// true: 不存在則創建；false: 不創建拋出 RecordStoreNotFoundException

2. 寫入數據

// 新增
byte[] data = {1,2,3};
int id = rs.addRecord(data, 0, data.length); // id 從 1 開始

// 修改
rs.setRecord(1, data, 0, data.length); // 覆蓋 id=1 記錄

3. 讀取數據

byte[] data = rs.getRecord(1);
int count = rs.getNumRecords(); // 總記錄數

4. 刪除記錄

• 邏輯刪除：打標記
• 物理刪除：rs.deleteRecord(id)，ID 不復用（如刪 3，剩 1,2,4,5）

5. 遍歷記錄集

使用 RecordEnumeration，詳見 官方教程。

6. 刪除整個記錄集

RecordStore.deleteRecordStore("username");

十三、J2ME 加密利器：Bouncy Castle 輕量化集成

數據存儲/傳輸需加密，推薦開源 Bouncy Castle：

• 官網：www.bouncycastle.org
• 中文教程：Motorola 開發者文檔
• 英文教程：JavaWorld 實戰

關鍵提示：庫體積較大，發布前必須移除未用類，控制 JAR 體積。

十四、MMAPI 播放音頻完整流程與代碼

支持格式：WAV、MID、MPG（具體以手機文檔為準）。

三步播放法

1. 獲取資源流：InputStream is = getClass().getResourceAsStream("/Autorun.wav");
2. 創建 Player：Player player = Manager.createPlayer(is, "audio/x-wav");
3. 播放：player.start(); 可用 setLoopCount(n) 設置循環次數。

完整 MIDlet 示例（Nokia S60 模擬器驗證）

package sound;
import javax.microedition.midlet.*;
import javax.microedition.lcdui.*;
import javax.microedition.media.*;
import java.io.*;

public class SoundMIDlet extends MIDlet {
    private Player player = null;
    public SoundMIDlet() {
        try {
            InputStream is = getClass().getResourceAsStream("/Autorun.wav");
            player = Manager.createPlayer(is, "audio/x-wav");
        } catch (Exception e) { e.printStackTrace(); }
    }
    public void startApp() {
        if (player != null) try { player.start(); } catch (MediaException e) { e.printStackTrace(); }
    }
    public void pauseApp() {}
    public void destroyApp(boolean unconditional) {}
}

十五、J2ME 3D 開發資源導航 (JSR 184)

隨硬件提升，3D 遊戲成主流。核心資源：

1. JSR 184 規範：Nokia 主導，下載地址
2. Nokia 3D 開發專區：教程與案例
3. 開源 3D 引擎：簡易引擎 / 國內合作項目
4. 3D 遊戲產品參考：新浪遊戲評測
5. 開發工具：WTK 2.2 通用；廠商 SDK 需支持 JSR 184。

十六、第一個 J2ME 3D 程序：載入 .m3g 模型渲染動畫

基於 WTK 2.2 Demo 改寫，雙文件結構：

• First3DMIDlet.java：主入口，顯示 Canvas
• First3DCanvas.java：核心渲染邏輯，含 World、Camera、Graphics3D、動畫線程

關鍵構建步驟

1. WTK 2.2 新建項目，主類 first3d.First3DMIDlet
2. 代碼置於 first3d 目錄
3. 複製 WTK 目錄 apps/Demo3D/escom/superscape/m3g/wtk/samples/retainedmode/content/swerve.m3g 到項目 res 目錄
4. 項目設置：目標平台「自定義」、Profile「MIDP 2.0」、Configuration「CLDC 1.1」、勾選「Mobile 3D Graphics (JSR 184)」

核心渲染循環：animate() 更新世界時間 → render() 繪製 → repaint() 觸發下一幀。

十七、CMWAP 代理協議在 J2ME 中的正確姿勢

中國移動兩大 APN：

• CMNET：無限制訪問互聯網，資費高
• CMWAP：HTTP 代理模式，只能訪問 HTTP 應用，資費低但穩定性較差

標準連接代碼

HttpConnection http = (HttpConnection) Connector.open("https://10.0.0.172/" + url);
http.setRequestProperty("X-Online-Host", serverName);

實例

目標：https://www.test.com/login/loginServlet

HttpConnection http = (HttpConnection) Connector.open("https://10.0.0.172/login/loginServlet");
http.setRequestProperty("X-Online-Host", "www.test.com");

通用模板：將域名填入 X-Online-Host，路徑拼接至代理地址後。

十八、J2ME 時間處理全攻略：三類、兩制、互轉換

兩種時間表達

1. 長整型毫秒數（GMT 1970-01-01 起）：適合時間差計算
2. 對象形式（Date/Calendar）：適合日期分量操作

三大核心類

類	獲取方式	返回類型
System	System.currentTimeMillis()	long (毫秒數)
Date	new Date()	Date 對象
Calendar	Calendar.getInstance()	Calendar 對象

互轉換速查

// long → Date
Date d = new Date(System.currentTimeMillis());

// Date → Calendar
Calendar c = Calendar.getInstance();
c.setTime(date);

// 取日期分量（注意：月份 0=1月, 11=12月）
int day = c.get(Calendar.DATE);
int month = c.get(Calendar.MONTH); // 0-based
int year = c.get(Calendar.YEAR);

十九、J2ME 隨機數生成完全手冊

無 Math.random()，唯一依賴 java.util.Random。

創建實例

Random r = new Random(); // 種子 = 當前時間
Random r = new Random(10010010); // 固定種子，可復現序列

生成各類隨機值

int i = r.nextInt();
long l = r.nextLong();

指定區間 [min, max) 通用公式

// 0-9
int n = Math.abs(r.nextInt() % 10);

// 10-19
int n = Math.abs(r.nextInt() % 10) + 10;

// 通用 [min, max)
int n = min + Math.abs(r.nextInt() % (max - min));

二十、低級 UI 字體操作：Font 類實戰

受限於設備，僅能使用系統預置字體組合。

構造字體

Font font = Font.getFont(Font.FACE_SYSTEM, Font.STYLE_BOLD, Font.SIZE_MEDIUM);

三大屬性取值表

屬性	常量	含義
face (外觀)	FACE_MONOSPACE	等寬
	FACE_PROPORTIONAL	比例
	FACE_SYSTEM	系統默認
style (樣式)	STYLE_PLAIN	普通
	STYLE_BOLD	粗體
	STYLE_ITALIC	斜體
	STYLE_UNDERLINED	下劃線
	STYLE_BOLD | STYLE_ITALIC	粗斜體
	STYLE_UNDERLINED | STYLE_BOLD	下劃線粗體
	STYLE_UNDERLINED | STYLE_ITALIC	下劃線斜體
	STYLE_UNDERLINED | STYLE_ITALIC | STYLE_BOLD	下劃線粗斜體
size (大小)	SIZE_SMALL	小
	SIZE_MEDIUM	中
	SIZE_LARGE	大

常用操作

// 獲取默認字體
Font f = Font.getDefaultFont();

// paint(Graphics g) 中獲取/設置當前字體
Font cur = g.getFont();
g.setFont(myFont);

// MIDP 2.0 List 指定行字體
list.setFont(0, myFont); // 第 0 行

二十一、J2ME 色彩繪製：RGB 模式全解析

無專用 Color 類，直接用 24 位 RGB 整數或三分量。

常見顏色十六進制表示

• 紅：0x00FF0000 / (255,0,0)
• 綠：0x0000FF00 / (0,255,0)
• 藍：0x000000FF / (0,0,255) (原文藍色值有誤，已修正)
• 白：0x00FFFFFF / (255,255,255)
• 黑：0x00000000 / (0,0,0)

Graphics 核心方法

int c = g.getColor();           // 獲取當前色 (0x00RRGGBB)
g.setColor(0x00FF0000);         // 設置色 (十六進制)
g.setColor(255, 0, 0);          // 設置色 (三分量)

設置後後續繪製操作自動應用該顏色。

二十二、CMWAP 環境下獲取用戶手機號

中國移動網關將手機號放入 HTTP 頭 x-up-calling-line-id：

String userPhone = http.getHeader("x-up-calling-line-id");
// http 為 HttpConnection 實例

標準 J2ME 庫無直接 API，此為運營商定制能力。

二十三、WMA 發送短信完整工具類

三種發送方式：網關發送、PC 連手機 AT 指令、手機端程序直發 (WMA)。

MIDP 2.0 內建 WMA；MIDP 1.0 需廠商擴展包。

發送文本短信通用方法

package my.util;
import javax.wireless.messaging.*;
import javax.microedition.io.*;

public class SMSUtil {
    public static boolean send(String content, String phoneNumber) {
        try {
            String addr = "sms://+" + phoneNumber;
            MessageConnection conn = (MessageConnection) Connector.open(addr);
            TextMessage msg = (TextMessage) conn.newMessage(MessageConnection.TEXT_MESSAGE);
            msg.setPayloadText(content);
            conn.send(msg);
            return true;
        } catch (Exception e) {
            return false;
        }
    }
}

二十四、MIDlet 生命週期可視化驗證代碼

生命週期本質：規定各方法被系統調用的時機。在每個方法打印日誌即可驗證順序。

public class LifeCircleMIDlet extends MIDlet {
    public LifeCircleMIDlet() { System.out.println("構造方法"); }
    public void startApp() { System.out.println("startApp"); }
    public void pauseApp() { System.out.println("pauseApp"); }
    public void destroyApp(boolean b) { System.out.println("destroyApp"); }
}

WTK 中用「MIDlet」菜單的「暫停/恢復」模擬生命週期事件。

二十五、OTA 無線發布 J2ME 應用完整步驟

OTA (Over The Air) 是主流發布方式（如各大百寶箱）。

服務器配置 MIME 類型

副檔名	MIME Type
.jad	text/vnd.sun.j2me.app-descriptor
.jar	application/java-archive

最簡 WML 下載頁 (download.wml)

<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.3//EN" "https://www.wapforum.org/DTD/wml13.dtd">
<wml>
  <card id="c1" title="Download Midlet">
    <a href="test.jad">安裝應用</a>
  </card>
</wml>

修改 JAD 文件指定 JAR 絕對路徑

MIDlet-Jar-URL: https://yourdomain.com/path/to/test.jar

用戶在手機瀏覽器輸入 WML 頁面 URL 即可一鍵下載安裝。