将JSONArray数据展示到ListView时遇阻，请求排查问题

Hey there! Nice job getting the JSONArray showing up in your logs—you’re already ahead of the game. Let’s walk through how to get those name fields into your ListView, and check for common missteps that might be tripping you up right now.

Before even touching the ListView, you need to confirm you’re correctly pulling the name values from your JSONArray. Let’s say your API returns something like this:

[
  {"name": "Coffee", "category": "Beverage"},
  {"name": "Croissant", "category": "Pastry"}
]

Option 1: Store names in a simple List #

This works if you only need the name field for now:

List<String> nameList = new ArrayList<>();
JSONArray jsonArray = // Your fetched JSONArray from the API

try {
    for (int i = 0; i < jsonArray.length(); i++) {
        JSONObject itemObj = jsonArray.getJSONObject(i);
        // Always check if the field exists to avoid JSONExceptions!
        if (itemObj.has("name")) {
            nameList.add(itemObj.getString("name"));
        }
    }
} catch (JSONException e) {
    e.printStackTrace();
    // Handle parsing errors here (e.g., show error toast)
}

Option 2: Use a custom Model class (better for future expansion) #

Since you mentioned you’ll add other fields later, this is the smarter approach. Create a simple model:

public class MenuItem {
    private String name;
    // Add other fields (like category, price) later as needed

    public MenuItem(String name) {
        this.name = name;
    }

    public String getName() {
        return name;
    }

    // Add getters for other fields later
}

Then parse into a list of your model:

List<MenuItem> menuItems = new ArrayList<>();
try {
    for (int i = 0; i < jsonArray.length(); i++) {
        JSONObject itemObj = jsonArray.getJSONObject(i);
        if (itemObj.has("name")) {
            menuItems.add(new MenuItem(itemObj.getString("name")));
        }
    }
} catch (JSONException e) {
    e.printStackTrace();
}

ListView relies on an Adapter to connect your data to the UI. Here are two common approaches:

Quick Win: Use ArrayAdapter (for simple text only) #

If you just need to display the name strings, you can use Android’s built-in ArrayAdapter:

// Replace "this" with your Activity/Fragment context
ArrayAdapter<String> adapter = new ArrayAdapter<>(this,
        android.R.layout.simple_list_item_1, // Built-in simple text layout
        nameList);
yourListView.setAdapter(adapter);

Better for Expansion: Custom BaseAdapter #

This gives you full control over the item layout, which will come in handy when you add other fields later.

First, create a layout for your list item (res/layout/list_item_menu.xml):

<TextView xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/tv_item_name"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:padding="16dp"
    android:textSize="18sp"
    android:textColor="@android:color/black"/>

Then create your custom Adapter:

public class MenuItemAdapter extends BaseAdapter {
    private Context mContext;
    private List<MenuItem> mMenuItemList;

    public MenuItemAdapter(Context context, List<MenuItem> menuItemList) {
        mContext = context;
        mMenuItemList = menuItemList;
    }

    @Override
    public int getCount() {
        return mMenuItemList.size();
    }

    @Override
    public Object getItem(int position) {
        return mMenuItemList.get(position);
    }

    @Override
    public long getItemId(int position) {
        return position;
    }

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        ViewHolder holder;

        // Reuse views to save memory
        if (convertView == null) {
            convertView = LayoutInflater.from(mContext).inflate(R.layout.list_item_menu, parent, false);
            holder = new ViewHolder();
            holder.nameTextView = convertView.findViewById(R.id.tv_item_name);
            convertView.setTag(holder);
        } else {
            holder = (ViewHolder) convertView.getTag();
        }

        // Set the name text
        holder.nameTextView.setText(mMenuItemList.get(position).getName());
        return convertView;
    }

    // ViewHolder pattern to avoid repeated findViewById calls
    static class ViewHolder {
        TextView nameTextView;
    }
}

Finally, set the Adapter to your ListView:

MenuItemAdapter adapter = new MenuItemAdapter(this, menuItems);
yourListView.setAdapter(adapter);

If your ListView is still not showing data, run through these checks:

• Threading Issues: Did you make the API call on the main thread? That’s a no-no—you’ll get ANRs, and even if data loads, updating the UI from a background thread will cause problems. Make sure you’re parsing data and setting the Adapter on the main thread (use callbacks from Retrofit, AsyncTask onPostExecute, or Coroutines with Dispatchers.Main).
• Empty Data/Nulls: Is your list empty? Double-check that your JSON parsing loop is running, and that the field name matches exactly (JSON is case-sensitive—Name != name). Also, handle JSONException to catch parsing errors.
• Adapter Not Set or Updated: Did you forget to call yourListView.setAdapter(adapter)? If you load data asynchronously, make sure you initialize the Adapter or call adapter.notifyDataSetChanged() after the data is parsed.
• Layout Problems: Is your ListView visible? Check that its layout_width and layout_height are set to match_parent or a fixed size (not wrap_content if the list is empty initially). Also, make sure the item TextView’s text color isn’t the same as the background (easy mistake that makes text invisible!).

If you can share snippets of your current parsing or Adapter code, I can help pinpoint exactly where things might be going wrong.

内容的提问来源于stack exchange，提问作者user9131141