Android 中的 TextWriter 示例

---

介紹

在 Android 開發中，寫入和讀取檔案是開發人員經常遇到的常見任務。`TextWriter` 類屬於 `java.io` 包，是將字元寫入檔案的強大工具。本文深入探討了在 Android 中使用 `TextWriter` 的細節，並提供實際示例作為指導。

理解 Android 中的 TextWriter

`TextWriter` 是 Android 中用於寫入字元流的類。它是一個抽象類，這意味著不能直接例項化它。相反，您可以使用它的子類之一，例如 `FileWriter`、`OutputStreamWriter` 或 `PrintWriter`。

`TextWriter` 的主要優點之一是其靈活性。它允許開發人員不僅將資料寫入檔案，還可以寫入其他型別的字元輸出流。

使用 FileWriter 寫入檔案

`FileWriter` 是 `TextWriter` 的一個子類，用於寫入字元檔案。讓我們看看如何使用 `FileWriter` 將資料寫入檔案：

try {
   FileWriter writer = new FileWriter("example.txt");
   writer.write("Hello, Android Developers!");
   writer.flush();
   writer.close();
} catch (IOException e) {
   e.printStackTrace();
}

在這個例子中，我們為名為“example.txt”的檔案建立一個 `FileWriter` 並向其中寫入一個字串。然後我們重新整理寫入器以確保所有資料都被寫入，最後我們關閉它以釋放系統資源。

使用 OutputStreamWriter 寫入 OutputStream

`OutputStreamWriter` 是字元流到位元組流的橋樑。它允許您將字元寫入任何 `OutputStream`，使用指定的字元集或未指定字元集時的平臺預設字元集將其編碼為位元組。

以下是如何使用 `OutputStreamWriter` 將文字寫入 `OutputStream` 的示例：

try {
   FileOutputStream fos = openFileOutput("example.txt", MODE_PRIVATE);
   OutputStreamWriter writer = new OutputStreamWriter(fos);
   writer.write("Hello, Android Developers!");
   writer.flush();
   writer.close();
} catch (IOException e) {
   e.printStackTrace();
}

在這個例子中，我們使用 `openFileOutput` 為名為“example.txt”的檔案建立一個 `FileOutputStream`，然後建立一個 `OutputStreamWriter` 將字串寫入此流。

處理異常

`FileWriter` 和 `OutputStreamWriter` 都可能丟擲 `IOException`，因此在使用這些類時需要捕獲此異常。

從 API 26 開始，Android 還支援 try-with-resources 語句，當您完成使用資源時，它會自動關閉資源。以下是如何使用它：

try (FileWriter writer = new FileWriter("example.txt")) {
   writer.write("Hello, Android Developers!");
   writer.flush();
} catch (IOException e) {
   e.printStackTrace();
}

在外部儲存中寫入檔案

將檔案寫入外部儲存時，必須透過將以下行新增到您的 AndroidManifest.xml 檔案中來請求 `WRITE_EXTERNAL_STORAGE` 許可權：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />> 

從 Android 6.0 (API 23) 開始，您還需要在執行時請求此許可權。以下是如何操作：

if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)
   != PackageManager.PERMISSION_GRANTED) {
   ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 0);
}

結論

瞭解如何使用 `TextWriter` 及其子類對於 Android 開發人員至關重要。無論您是記錄資料、儲存使用者首選項還是儲存其他型別的資料，能夠寫入檔案都是 Android 開發的一項基本技能。

請記住，`TextWriter` 的不同子類適用於不同的任務——`FileWriter` 可用於寫入檔案，而 `OutputStreamWriter` 提供了寫入任何 `OutputStream` 的靈活性。始終處理 `IOException` 以防止因 IO 失敗而導致崩潰，並且在寫入外部儲存時不要忘記請求必要的許可權。