android保存json文件怎么打开

Android中保存的JSON文件如何打开？一篇详解指南

在Android开发中,JSON作为一种轻量级的数据交换格式，常用于存储配置信息、缓存数据或跨平台传输数据，开发者经常需要将JSON数据保存到本地文件中，但后续如何正确打开、读取和解析这些文件，却是不少开发者（尤其是新手）容易遇到的问题，本文将详细介绍Android中保存的JSON文件的打开方法，涵盖文件存储位置、读取权限、不同场景下的操作步骤及常见问题解决，助你轻松应对JSON文件的处理需求。

先搞清楚：Android中JSON文件存在哪里？

要打开JSON文件,首先得知道它被保存在设备的哪个位置，Android的文件存储主要分为内部存储和外部存储（如SD卡），两者的访问方式和权限有所不同。

内部存储（Internal Storage）

内部存储是设备自带的存储空间,数据仅当前应用可访问（卸载应用后文件会被自动删除），适合存储敏感数据或临时文件，路径通常为：
/data/data/<包名>/files/
若应用的包名为com.example.app，则内部存储路径为/data/data/com.example.app/files/。

通过代码保存到内部存储的JSON文件,默认位于应用的私有目录下，无需特殊权限即可读写。

外部存储（External Storage）

外部存储指可扩展的SD卡或设备共享存储空间（如/storage/emulated/0/），适合存储需要多应用共享或长期保留的数据（如下载的文件、缓存数据）。

根据Android版本,外部存储的权限分为：

Android 10（API 29）及以上：通过Environment.getExternalFilesDir()获取应用私有目录（如/storage/emulated/0/Android/data/<包名>/files/），无需权限即可读写；
Android 9（API 28）及以下：若要访问公共目录（如/storage/emulated/0/Download/），需在AndroidManifest.xml中声明READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE权限（且需动态申请）。

打开JSON文件的通用步骤

无论是内部存储还是外部存储,打开JSON文件的核心步骤可概括为：获取文件路径 → 检查文件是否存在 → 读取文件内容 → 解析JSON数据，下面结合代码示例，分场景详细说明。

场景1：打开应用内部存储的JSON文件

内部存储的文件访问权限简单,无需额外声明权限，适合应用私有数据（如用户配置、缓存）。

示例：从内部存储读取JSON文件并解析为对象

假设我们在内部存储中保存了一个名为user_config.json的文件，内容如下：

{
  "username": "张三",
  "age": 25,
  "isVip": true
}

步骤1：保存JSON文件到内部存储（回顾保存逻辑，便于理解）
通过openFileOutput()方法保存文件：

// 1. 准备JSON数据
JSONObject jsonObject = new JSONObject();
try {
    jsonObject.put("username", "张三");
    jsonObject.put("age", 25);
    jsonObject.put("isVip", true);
} catch (JSONException e) {
    e.printStackTrace();
}
// 2. 保存到内部存储
try (FileOutputStream fos = openFileOutput("user_config.json", Context.MODE_PRIVATE)) {
    fos.write(jsonObject.toString().getBytes());
} catch (IOException e) {
    e.printStackTrace();
}

步骤2：从内部存储打开并读取JSON文件
通过openFileInput()方法读取文件：

try (FileInputStream fis = openFileInput("user_config.json");
     InputStreamReader isr = new InputStreamReader(fis);
     BufferedReader br = new BufferedReader(isr)) {
    // 读取文件内容
    StringBuilder stringBuilder = new StringBuilder();
    String line;
    while ((line = br.readLine()) != null) {
        stringBuilder.append(line);
    }
    String jsonContent = stringBuilder.toString();
    // 解析JSON
    JSONObject jsonObject = new JSONObject(jsonContent);
    String username = jsonObject.getString("username");
    int age = jsonObject.getInt("age");
    boolean isVip = jsonObject.getBoolean("isVip");
    Log.d("JSON解析结果", "用户名：" + username + "，年龄：" + age + "，是否VIP：" + isVip);
} catch (IOException | JSONException e) {
    e.printStackTrace();
}

场景2：打开应用外部存储的JSON文件

外部存储的文件访问需注意权限和路径获取,尤其区分“应用私有目录”和“公共目录”。

情况1：访问应用私有外部目录（无需权限）

通过Environment.getExternalFilesDir()获取应用在外部存储的私有目录（如/storage/emulated/0/Android/data/<包名>/files/），卸载应用后自动删除，无需声明权限。

示例：保存并读取外部存储的JSON文件

// 1. 获取外部存储私有目录
File externalDir = getExternalFilesDir(Environment.DIRECTORY_DOCUMENTS);
if (externalDir == null) {
    Log.e("外部存储", "无法获取外部存储目录");
    return;
}
// 2. 创建JSON文件
File jsonFile = new File(externalDir, "app_data.json");
try (FileOutputStream fos = new FileOutputStream(jsonFile);
     OutputStreamWriter osw = new OutputStreamWriter(fos)) {
    // 写入JSON数据
    JSONArray jsonArray = new JSONArray();
    JSONObject item1 = new JSONObject();
    item1.put("id", 1).put("name", "商品A");
    JSONObject item2 = new JSONObject();
    item2.put("id", 2).put("name", "商品B");
    jsonArray.put(item1).put(item2);
    osw.write(jsonArray.toString());
    Log.d("保存成功", "文件路径：" + jsonFile.getAbsolutePath());
} catch (IOException | JSONException e) {
    e.printStackTrace();
}
// 3. 读取JSON文件
try (FileInputStream fis = new FileInputStream(jsonFile);
     InputStreamReader isr = new InputStreamReader(fis);
     BufferedReader br = new BufferedReader(isr)) {
    String jsonContent = br.readLine();
    JSONArray jsonArray = new JSONArray(jsonContent);
    for (int i = 0; i < jsonArray.length(); i++) {
        JSONObject item = jsonArray.getJSONObject(i);
        Log.d("商品信息", "ID：" + item.getInt("id") + "，名称：" + item.getString("name"));
    }
} catch (IOException | JSONException e) {
    e.printStackTrace();
}

情况2：访问外部存储公共目录（需申请权限）

若JSON文件保存在公共目录（如Download、Pictures），需在AndroidManifest.xml中声明权限，并在运行时动态申请（针对Android 6.0及以上）。

步骤1：声明权限
在AndroidManifest.xml中添加：

<!-- 读取外部存储权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!-- 写入外部存储权限（Android 9及以下需要） -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- 仅在Android 10以下需要，Android 10+通过分区存储管理 -->

步骤2：动态申请权限（Android 6.0+）

// 检查权限
if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE) 
        != PackageManager.PERMISSION_GRANTED) {
    // 申请权限
    ActivityCompat.requestPermissions(this, 
            new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, 
            1001);
} else {
    // 已有权限，直接读取文件
    readPublicJsonFile();
}
// 处理权限申请结果
@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == 1001 && grantResults.length > 0 
            && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
        readPublicJsonFile();
    }
}
// 读取公共目录的JSON文件（例如Download目录）
private void readPublicJsonFile() {
    File downloadDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOAD);
    File jsonFile = new File(downloadDir, "public_data.json");
    if (!jsonFile.exists()) {
        Log.e("文件不存在", "路径：" + jsonFile.getAbsolutePath());
        return;
    }
    try (FileInputStream fis = new FileInputStream(jsonFile);
         BufferedReader br = new BufferedReader(new InputStreamReader(fis))) {
        StringBuilder sb = new StringBuilder();
        String line;
        while ((line = br.readLine()) != null) {
            sb.append(line);
        }
        JSONObject jsonObject = new JSONObject(sb.toString());
        Log.d("公共目录JSON", "数据：" + jsonObject.toString());
    } catch (IOException | JSONException e) {
        e.printStackTrace();
    }
}