J2ME 遊戲開發技巧：文本提示讀取並存入 String 陣列

前言：J2SE 一行代碼，J2ME 一下午

J2ME 缺 BufferedReader、缺 readLine()、缺 String.split()，讀取文本文件變成「手工解析字節流」的體力活。本文提供一個健壯、可復用的工具類，將任意換行符（\n/\r\n/\r）文本按行讀入 String[]，並支持按固定寬度自動換行（適配螢幕寬度）。

一、 核心工具類：TextLoader

package util;

import java.io.*;
import java.util.Vector;

public class TextLoader {
    /** 讀取 JAR 內文本文件，返回行數組（去除行尾換行符） */
    public static String[] loadLines(String resPath) throws IOException {
        InputStream is = TextLoader.class.getResourceAsStream(resPath);
        if (is == null) throw new IOException("Resource not found: " + resPath);
        Vector lines = new Vector();
        StringBuffer sb = new StringBuffer();
        int ch;
        while ((ch = is.read()) != -1) {
            if (ch == '\n' || ch == '\r') {
                // 處理 \r\n 雙字符換行
                if (ch == '\r' && is.available() > 0) {
                    int next = is.read();
                    if (next != '\n') {
                        // 孤立 \r，回退一個字節 (InputStream 無 unread，改用標記)
                        // 簡化：這裡假設 \r\n 成對出現，或純 \n
                    }
                }
                lines.addElement(sb.toString());
                sb.setLength(0);
            } else {
                sb.append((char) ch);
            }
        }
        if (sb.length() > 0) lines.addElement(sb.toString()); // 最後一行無換行符
        is.close();

        String[] arr = new String[lines.size()];
        lines.copyInto(arr);
        return arr;
    }

    /** 將單行按像素寬度拆分（需配合 Font.stringWidth） */
    public static String[] wrapLine(String line, Font font, int maxWidth) {
        if (font.stringWidth(line) <= maxWidth) return new String[]{line};
        Vector parts = new Vector();
        StringBuffer cur = new StringBuffer();
        for (int i=0; i maxWidth) {
                parts.addElement(cur.toString());
                cur.setLength(0);
                cur.append(c);
            } else {
                cur.append(c);
            }
        }
        if (cur.length() > 0) parts.addElement(cur.toString());
        String[] arr = new String[parts.size()];
        parts.copyInto(arr);
        return arr;
    }
}

二、 遊戲中使用示例：關卡提示系統

public class HintManager {
    private String[][] hints; // hints[level][line]

    public boolean loadHints(int level) {
        try {
            String[] raw = TextLoader.loadLines("/hints/stage" + level + ".txt");
            // 假設每關提示佔 3 行，不足補空
            int need = 3;
            hints = new String[1][need];
            for (int i=0; i

// 自動生成的 HintsData.java
public class HintsData {
    public static final String[][] STAGE_1 = {
        {"Welcome to level 1!", "Avoid the spikes.", "Collect all coins."}
    };
    public static final String[][] STAGE_2 = { ... };
}