Android_适配器(adapter)之SimpleAdapter

概述

SimpleAdapter是一种简单的适配器，将静态数据映射到布局xml对应的视图上。它也是BaseAdapter的子类。

SimpleAdapter数据映射的组件有3类(从官网api或SimpleAdapter源码中的bindView方法中都能看出来)：Checkable(e.g. CheckBox), TextView, ImageView。

下面的例子中就包含了这3类

构造说明

SimpleAdapter只有一个构造方法：

SimpleAdapter(Context context, List<? extends Map<String, ?>> data, int resource, String[] from, int[] to)

context：上下文

data：数据源，一个包含Map的数据集合

resource：item的布局文件

from：数据来源的key的数组，与data的Map里的key对应

to: from中的每一项数据源对应到的 item布局中对应组件的 id。

四个参数的关系及表明了这种数据映射到布局的关系（如下绘制的简单示意图）：data是数据源，包含所有数据，data中的每一项是一个map；from是数据源中map中的key数组；to是item布局要填充的组件id的数组（这里的组件只能是上面提到的3种）。

通过SimpleAdapter，数据被映射到对应的组件中，显示出来。下一项具体示例中有更好的体现

具体示例说明

下面具体示例，很清晰的可以看出SimpleAdapter数据映射过程和效果。

先看下示例的效果图：

下面是具体的代码

activity布局：simple_adapter_act.xml

这里仅定义了一个ListView用于显示

<?xml version="1.0" encoding="utf-8"?>

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"

    android:layout_width="match_parent"

    android:layout_height="match_parent">

    <ListView

        android:id="@+id/simple_adapter_lv"

        android:layout_width="match_parent"

        android:layout_height="match_parent" />

</RelativeLayout>

文本资源：

Strings:

    <array name="anime_name">

        <item>海贼王</item>

        <item>进击的巨人</item>

        <item>火影忍者</item>

        <item>斩赤红之瞳</item>

        <item>秦时明月</item>

        <item>西游记</item>

        <item>葫芦娃</item>

    </array>

    <array name="anime_author">

        <item>尾田荣一郎</item>

        <item>谏山创</item>

        <item>岸本齐史</item>

        <item>タカヒロ</item>

        <item>玄机科技</item>

        <item>央视</item>

        <item>上海美术电影</item>

    </array>

Colors:/赤橙黄绿青蓝紫

    <color name="love_red">#FF0000</color>

    <color name="love_orange">#FF7F00</color>

    <color name="love_yellow">#FFFF00</color>

    <color name="love_green">#00FF00</color>

    <color name="love_blue_green">#00FFFF</color>

    <color name="love_blue">#0000FF</color>

    <color name="love_purple">#8B00FF</color>

SimpleAdapter的resouce布局，及item layout: sasimple_adapter_item.xml

这里定义了5个组件，SimpleAdapter会将这些填充数据，2个TextView 2个ImageView 1个CheckBox.

<?xml version="1.0" encoding="utf-8"?>

<!--android:descendantFocusability 避免CheckBox抢占焦点添加-->

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"

    android:descendantFocusability="blocksDescendants"

    android:layout_width="match_parent"

    android:layout_height="70dp">

    <ImageView android:id="@+id/anime_cover_img"

        android:layout_alignParentLeft="true"

        android:layout_centerVertical="true"

        android:layout_marginLeft="10dp"

        android:layout_width="60dp"

        android:scaleType="fitCenter"

        android:layout_height="60dp" />

    <LinearLayout

        android:layout_toRightOf="@id/anime_cover_img"

        android:layout_width="150dp"

        android:layout_height="match_parent"

        android:layout_marginLeft="10dp"

        android:layout_marginRight="10dp"

        android:orientation="vertical" >

        <TextView

            android:id="@+id/anime_name_txt"

            android:layout_width="match_parent"

            android:layout_height="match_parent"

            android:gravity="center_vertical"

            android:textStyle="bold"

            android:layout_weight="1" />

        <TextView android:id="@+id/anime_author_txt"

            android:layout_width="match_parent"

            android:layout_height="match_parent"

            android:gravity="center_vertical"

            android:textStyle="italic"

            android:layout_weight="1"/>

    </LinearLayout>

    <ImageView

        android:id="@+id/anime_likecolor_img"

        android:layout_toLeftOf="@id/anime_checkbox"

        android:layout_width="60dp"

        android:layout_height="60dp"

        android:layout_centerVertical="true"

        android:layout_marginRight="10dp" />

    <CheckBox android:id="@+id/anime_checkbox"

        android:layout_width="wrap_content"

        android:layout_height="wrap_content"

        android:layout_alignParentRight="true"

        android:layout_centerVertical="true" />

</RelativeLayout>

最终的，SimpleAdapter的使用：SimpleAdapterActivity.java

package com.flx.adaptertest.simpleadapter;

import android.app.Activity;

import android.content.res.Resources;

import android.os.Bundle;

import android.util.Log;

import android.view.View;

import android.widget.AdapterView;

import android.widget.CheckBox;

import android.widget.ListView;

import android.widget.SimpleAdapter;

import com.flx.adaptertest.R;

import java.util.ArrayList;

import java.util.HashMap;

import java.util.List;

import java.util.Map;

public class SimpleAdapterActivity extends Activity {

    private static final String TAG = "SimpleAdapterActivity";

    private static final String ANIME_NAME = "anime_name";

    private static final String ANIME_AUTHOR = "anime_author";

    private static final String ANIME_COVERIMG = "anime_coverimg";

    private static final String ANIME_LIKECOLOR = "anime_likecolor";

    private static final String ANIME_CHECKBOX = "anime_checkbox";

    @Override

    protected void onCreate(Bundle savedInstanceState) {

        super.onCreate( savedInstanceState );

        setContentView( R.layout.simple_adapter_act );

        ListView listView = findViewById( R.id.simple_adapter_lv );

        listView.setOnItemClickListener( new AdapterView.OnItemClickListener() {

            @Override

            public void onItemClick(AdapterView<?> parent, View view, int position, long id) {

                Log.d( TAG, "onItemClick: position="+ position + ";text=" + parent.getItemAtPosition(position).toString()

                    +";CheckBox changed="+((CheckBox)view.findViewById(R.id.anime_checkbox)).isChecked());

            }

        } );

        List<Map<String, Object>> datas = new ArrayList<>();

        Resources resources = this.getResources();

        String[] anime_names = resources.getStringArray( R.array.anime_name );

        String[] anime_authors = resources.getStringArray( R.array.anime_author );

        int[] coverImgs = {R.drawable.hzw1, R.drawable.jjdjr1, R.drawable.hyrz1,

                R.drawable.zchzt1, R.drawable.qsmy1, R.drawable.xyj1, R.drawable.hlw1};

        int[] senvenColors = {R.color.love_red, R.color.love_orange, R.color.love_yellow,R.color.love_green,

                R.color.love_blue_green, R.color.love_blue,R.color.love_purple};

        boolean[] anime_checkbox = {true, true, false, false, true, false, true};

        for (int i = 0; i < anime_names.length; i++) {

            Map<String, Object> map = new HashMap<>();

            map.put(ANIME_COVERIMG, coverImgs[i]);

            map.put(ANIME_NAME, anime_names[i]);

            map.put(ANIME_AUTHOR, anime_authors[i]);

            map.put(ANIME_LIKECOLOR, senvenColors[i]);

            map.put(ANIME_CHECKBOX, anime_checkbox[i]);

            datas.add(map);

        }

        String[] from = {ANIME_COVERIMG, ANIME_NAME, ANIME_AUTHOR, ANIME_LIKECOLOR,ANIME_CHECKBOX};

        int[] to = {R.id.anime_cover_img, R.id.anime_name_txt, R.id.anime_author_txt, R.id.anime_likecolor_img, R.id.anime_checkbox};

        SimpleAdapter simpleAdapter = new SimpleAdapter( this, datas, R.layout.simple_adapter_item, from, to );

        listView.setAdapter(simpleAdapter);

    }

}

看下点击效果：

点击第一项看到log

2019-11-25 14:27:06.254 9363-9363/com.flx.adaptertest D/SimpleAdapterActivity: onItemClick: position=0;text={anime_name=海贼王,

anime_likecolor=2131034168, anime_checkbox=true, anime_author=尾田荣一郎, anime_coverimg=2131165272};CheckBox changed=true

点击第一项中的checkbox，去掉勾选后，再点击第一项看到的log

2019-11-25 14:29:02.631 9363-9363/com.flx.adaptertest D/SimpleAdapterActivity: onItemClick: position=0;text={anime_name=海贼王,

anime_likecolor=2131034168, anime_checkbox=true, anime_author=尾田荣一郎, anime_coverimg=2131165272};CheckBox changed=false

注意到CheckBox值的变化了吗，整个item中看到的anime_checkbox值并没有变化。个人理解是将静态数据映射到视图，绑定到视图时已经值已经确定了，点击checkbox,视图数据并没有刷新，所以可以通过view获取checkbox获取状态。